从 2.x.x 迁移到 3.0.0

DotNetBrowser 3.0.0 版对该库的内部功能和公共 API 都进行了一些改进。本指南将向您展示如何将使用 DotNetBrowser 2.x.x 版本编写的应用程序代码与 3.0.0 版本兼容。

为什么要迁移？

我们建议您将代码更新到最新版本，因为所有新功能、Chromium 升级、对新操作系统和 .NET 版本的支持、错误修复、安全补丁以及性能和内存使用方面的改进都是基于最新版本进行的。

需要多长时间？

根据我们的经验，升级到新版本可能需要几个小时到几天的时间，具体取决于您的应用程序中使用的功能数量。通常，我们强烈建议在升级后，在所有支持的环境中测试您的软件。

获取帮助

如果您在本指南中未找到所需答案，且在迁移过程中需要帮助，请联系我们。我们将竭诚为您提供帮助。

主要变更

已移除弃用的 API

在 DotNetBrowser 2 中标记为弃用的 API，在 3.0.0 版本中已不再可用。

以下是已移除的 API 及其替代项：

LoadUrlParameters.PostData，已替换为 LoadUrlParameters.UploadData；
VerifyCertificateParameters.VerifyStatuses，已替换为 VerifyCertificateParameters.VerifyErrors；
BinariesExtractionOptions.CheckLastModificationDate，已替换为 BinariesExtractionOptions.VerificationLevel；
ISpellChecker.DictionaryNames，已替换为 ISpellChecker.Languages。

以下属性曾经在 IEngine 接口中可用，但它们与默认配置文件相关，并已标记为弃用：

IEngine.CookieStore
IEngine.Downloads
IEngine.HttpCache
IEngine.Network
IEngine.Permissions
IEngine.Plugins
IEngine.Proxy
IEngine.SpellChecker
IEngine.ZoomLevels

这些属性已从 IEngine 接口中移除，现在仅在默认配置文件中可用。例如，如果您之前使用 engine.Network，现在需要改用 engine.Profiles.Default.Network。

`GoogleTrafficDisabled` 选项已被移除

部分客户反映，Chromium 有时会向外部网络服务发送意外请求。我们查明，Chromium 的一些功能，如 Google Cloud Messaging、Translate Ranker、Extensions Updater、Safe Browsing、Spell Checker、Widevine 等，为了正常工作，会向 Google 的外部网络服务，如 https://ssl.gstatic.com 和 https://clients4.google.com 发送请求。

我们理解，任何对外部网络服务的意外请求都可能被视为安全威胁，因此需要加以阻止。对此，我们分析了所有会向外部网络服务发送请求的 Chromium 功能，并确保您可以通过 JxBrowser API 完全控制这些功能。而对于无法通过 API 控制的功能，我们已默认禁用，以防止意外的外部请求。

关于这一改进，我们移除了 GoogleTrafficDisabled Engine 选项，因为它已不再需要。

Go Top

介绍

安装

指南

故障排除

迁移