目录

从 3.x.x 迁移到 4.0.0

DotNetBrowser 4.0.0 版本在库的内部功能和公共 API 两方面都带来了一些改进。本指南将说明如何使使用 DotNetBrowser 3.x.x 版本编写的应用程序代码兼容 4.0.0 版本。

为什么要迁移? 

我们建议将代码升级到最新版本,因为所有新功能、Chromium 升级、新操作系统和 .NET 版本支持、错误修复、安全补丁,以及性能和内存占用优化,都是基于最新版本提供的。

需要多长时间? 

根据我们的经验,升级到新版本通常需要几个小时到几天不等,具体取决于你的应用程序使用了多少功能。和往常一样,我们强烈建议你在升级完成后,在软件所支持的所有环境中进行测试。

获取帮助 

如果你没有在本指南中找到答案,并且在迁移过程中需要帮助,请联系我们。我们很乐意为你提供帮助。

主要变更 

已废弃和已移除的 API 变更 

此版本引入了以下 API 变更:

  • ProprietaryFeatures.Widevine 标志已被移除。 它已替换为 IEngine.Widevine 属性。
  • ShowContextMenuParameters.CustomMenuItems 已被移除,且没有替代项。

PermissionType 枚举更新 

已重新编号的现有值:

成员旧值新值
WakeLockScreen1516
WakeLockSystem1617
ClipboardReadWrite1218
ClipboardSanitizedWrite1319
LocalFonts1424
LocalNetworkAccess1733

新增的值(范围 12–36): PaymentHandler, BackgroundFetch, IdleDetection, PeriodicBackgroundSync, Vr, StorageAccessGrant, CameraPanTiltZoom, WindowManagement, DisplayCapture, TopLevelStorageAccess, CapturedSurfaceControl, SpeakerSelection, KeyboardLock, PointerLock, AutomaticFullscreen, HandTracking, LocalNetwork, LoopbackNetwork, GeolocationApproximate