从 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 枚举更新
已重新编号的现有值:
| 成员 | 旧值 | 新值 |
|---|---|---|
WakeLockScreen | 15 | 16 |
WakeLockSystem | 16 | 17 |
ClipboardReadWrite | 12 | 18 |
ClipboardSanitizedWrite | 13 | 19 |
LocalFonts | 14 | 24 |
LocalNetworkAccess | 17 | 33 |
新增的值(范围 12–36):
PaymentHandler, BackgroundFetch, IdleDetection, PeriodicBackgroundSync, Vr, StorageAccessGrant, CameraPanTiltZoom, WindowManagement, DisplayCapture, TopLevelStorageAccess, CapturedSurfaceControl, SpeakerSelection, KeyboardLock, PointerLock, AutomaticFullscreen, HandTracking, LocalNetwork, LoopbackNetwork, GeolocationApproximate