从 HockeySDK 迁移到适用于 Unity 的 App Center SDK
重要
Visual Studio App Center 计划于 2025 年 3 月 31 日停用。 虽然可以继续使用 Visual Studio App Center，直到它完全停用，但你可以考虑迁移到几个建议的替代方法。
如果要更新应用程序以使用 App Center SDK 而不是 HockeySDK，请遵循此文档。
1. 更新库
1.1 删除旧的 HockeySDK
选择为 SDK 创建的游戏对象，并通过单击“设置”图标>“删除
HockeyAppAndroid/HockeyAppiOS组件”删除组件来删除组件。从 Unity 项目内的 Assets 文件夹中删除 HockeyAppUnityAndroid / HockeyAppUnityiOS 文件夹 () 。
1.2 添加新的 App Center SDK
通过将 Unity 包导入项目来集成 App Center SDK。 为此，请先安装 App Center Unity 编辑器 Extensions 插件。 通过 Unity 菜单打开“编辑器扩展”：“窗口>应用中心>编辑器扩展”，然后选择“安装 App Center SDK”。
App Center SDK 采用模块化方法设计， 你只能集成你感兴趣的服务。 请参阅下表中的等效性：
| HockeyApp 模块 | App Center 模块 |
|---|---|
Crashes and Exceptions |
Crashes |
Metrics |
Analytics |
Version Updates |
Distribute |
若要单独安装服务，可以在每个选项卡中选择“ 安装 SDK ”。
注意
App Center Unity SDK 适用于所有三个平台：Android、iOS 和 UWP。 无需单独安装每个 SDK。
集成 App Center Unity SDK 的建议方法是使用 App Center 编辑器 扩展，但我们支持其他方案。 有关详细信息，请参阅 App Center Unity 文档。
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
附加 App Center 脚本
在“项目”窗口中，导航到已添加到项目的 AppCenter 文件夹。 找到名为 的 App Center 徽标作为图标的脚本， AppCenterBehavior并将其拖到之前用于 HockeySDK 的游戏对象上。
配置 App Center 设置
单击此游戏对象，在 “检查器” 窗口中，你将看到 App Center 配置。
使用下面给出的详细配置映射表填写其他信息。
3. 服务和功能比较
| HockeyApp 设置 | App Center 设置 | 备注 |
|---|---|---|
| 应用 ID | Android/iOS 应用机密 | 使用在上一步中转换的应用 ID |
| 服务器 URL | “自定义日志 URL ”，“其他设置” 部分 | 选中 “使用自定义日志 URL” |
| 受限的应用内更新 | NA | Distribute.UpdateTrack |
| 默认情况下 (启用崩溃和异常) | 使用崩溃 | 崩溃模块 |
| 自动上传崩溃 | 默认情况下启用 NA () | 文档 (默认启用，可以配置) |
| 异常日志记录 | “初始日志级别”， “其他设置” 部分 | 如果需要更详细的日志记录，请使用 Verbose |
| 用户指标 | 使用 Analytics | 分析模块 |
| 默认启用版本汇报 () | 使用分发 | 分发模块 |
| 更新警报 | NA | 必须配置文档 () |
注意
如果项目不支持设置中列出的三个平台之一，请将应用机密字段保留原样;它将不起作用。 如果项目支持 App Center 不支持的平台，则 API 和配置对这些平台不起作用。
如果项目在整个应用程序中都有 HockeySDK API 调用，请使用下面给出的详细 API 映射表替换它们。
| 功能 | HockeyApp | 应用中心 |
|---|---|---|
| 具有属性的自定义事件 | HockeyAppIOS.TrackEvent 或 HockeyAppAndroid.TrackEvent | Analytics.TrackEvent |
| 显式检查更新 | HockeyAppIOS.CheckForUpdate 或 HockeyAppAndroid.CheckForUpdate | Distribute.CheckforUpdate |
| 显示反馈表单 | HockeyAppIOS.ShowFeedbackForm 或 HockeyAppAndroid.ShowFeedbackForm | NA (请参阅下面的部分) |
反馈服务
App Center 不支持反馈服务。 请参阅 HockeyApp 反馈。