从 HockeySDK 迁移到适用于 Cordova 的 App Center SDK

  • 项目

重要

Visual Studio App Center 计划于 2025 年 3 月 31 日停用。 虽然可以继续使用 Visual Studio App Center，直到它完全停用，但你可以考虑迁移到几个建议的替代方法。

详细了解支持时间线和替代方法。

如果要更新应用程序以使用 App Center SDK 而不是 HockeySDK，请遵循此文档。

1. 更新库

1.1 删除旧的 HockeySDK

  1. 打开终端窗口，导航到 Cordova 项目文件夹，并执行以下命令：

    cordova plugin add cordova-plugin-appcenter-analytics

  2. 导航到 “你的应用 > 平台 > android > platform_www > 插件 ”文件夹，并从中删除 cordova-plugin-hockeyapp 。

1.2 添加新的 App Center SDK

App Center SDK 采用模块化方法设计， 你只能集成你感兴趣的服务。 请参阅下表中的等效性：

HockeyApp 模块 App Center 模块 安装命令
Crashes and Exceptions Crashes cordova plugin add cordova-plugin-appcenter-crashes
Metrics Analytics cordova plugin add cordova-plugin-appcenter-analytics

运行其中一个命令以安装所需的模块 (或同时安装) 。

2.更新 SDK 设置代码

2.1 转换应用程序标识符

App Center SDK 使用全局唯一标识符 (GUID) 格式的应用程序标识符。 你的 HockeyApp 应用 ID 可由 App Center 使用，但你需要将其转换为不同的格式。 若要转换标识符，必须添加四个连字符才能获取 8-4-4-4-12 表示形式。

在 (HockeyApp) 之前： 00112233445566778899aabbccddeeff

(App Center) 后： 00112233-4455-6677-8899-aabbccddeeff

2.2 替换应用程序代码中的 SDK 初始化

  1. 删除处理程序中的 deviceready HockeyApp 初始化：

    hockeyapp.start(null, null, "APP_ID");

  2. 配置 App Center SDK

    打开 Apache Cordova 项目的 config.xml 文件;对于 Apache Cordova 项目的每个目标 platform 元素，目前仅 (Android 和 iOS) ，请添加采用以下格式的子 preference 元素：

    <preference name="APP_SECRET" value="{App Secret from the previous step}" />

    有关详细信息，请参阅 App Center Cordova 文档。

  3. 替换整个应用程序中的所有 HockeyApp API 调用。 下面提供了详细的 API 映射表。

3. 服务和功能比较

核心

功能 HockeyApp 应用中心
标识用户 hockeyapp.setUserName 或 hockeyapp.setUserEmail AppCenter.setUserId

分析

功能 HockeyApp 应用中心
自动跟踪会话 无法禁用文档 () 默认启用文档 ()
跟踪事件 hockeyapp.trackEvent Analytics.trackEvent

崩溃

功能 HockeyApp 应用中心
自动发送崩溃 autoSend 参数 (默认禁用) 默认启用APPCENTER_CRASHES_ALWAYS_SEND ()
附加其他元数据 hockeyapp.addMetaData 可以从侦听器) 附加文档 (
生成测试崩溃 hockeyapp.forceCrash AppCenter.Crashes.generateTestCrash
在崩溃时显示对话框 ignoreDefaultHandler (默认禁用，仅 Android) 处理崩溃) 时 AppCenter.Crashes.process (回调

版本更新

App Center Cordova SDK 尚不支持 App Center 分发服务。

反馈服务

App Center 不支持反馈服务。 请参阅 HockeyApp 反馈。