从 HockeySDK 迁移到 App Center UWP

项目
03/15/2024

重要

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

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

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

1. 更新库

注意

App Center SDK 不支持 WinRT、Windows Phone 8.0 和 8.1、WPF 和 PCL 等平台。可以继续使用 HockeySDK。

将 HockeySDK.UWP NuGet 包替换为解决方案中所有项目中的 App Center 包。

适用于 Windows 的 Visual Studio

打开 Visual Studio for Windows。
单击“ 文件>打开 ”并选择解决方案。
在解决方案导航器中，右键单击“ 引用 ”，然后选择“ 管理 NuGet 包”。
删除 HockeySDK.UWP 包。
搜索 App Center，并安装 Microsoft.AppCenter.Analytics 和 Microsoft.AppCenter.Crashes 包。

程序包管理器控制台

在 Visual Studio 中打开控制台。为此，请选择 “工具”>“NuGet 包管理器>包管理器控制台”。
如果使用的是 Visual Studio for Mac，请确保已安装 NuGet 包管理扩展。为此，请选择 “Visual Studio>扩展”，搜索 “NuGet” 并根据需要安装。
在控制台中键入以下命令：

Uninstall-Package HockeySDK.UWP
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

App Center SDK 使用模块化方法 - 只能集成感兴趣的服务。必须在本节中将每个 SDK 模块添加为单独的依赖项。

2.更新 SDK 设置代码

2.1 转换应用程序标识符

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

在 (HockeyApp) 之前：

00112233445566778899aabbccddeeff

(App Center) 后：

00112233-4455-6677-8899-aabbccddeeff

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

删除旧的 HockeyApp 注册代码。

在 using 语句声明中，删除以下行：
```
using Microsoft.HockeyApp;
```
在 App 类构造函数的开头，删除以下行：
```
HockeyClient.Current.Configure("Your_App_ID");
```

启动 App Center SDK。

使用 API 之前，请添加相应的命名空间。

using Microsoft.AppCenter;
using Microsoft.AppCenter.Analytics;
using Microsoft.AppCenter.Crashes;

将以下调用添加到应用程序的构造函数：

AppCenter.Start("{Your App Secret}",  typeof(Analytics), typeof(Crashes));

3. 服务和功能比较

核心

功能	HockeyApp	应用中心
调整日志级别	是	AppCenter.LogLevel

分析

功能	HockeyApp	应用中心
自动跟踪会话	是	会话和设备信息
具有属性的自定义事件	`HockeyClient.TrackEvent`	Analytics.TrackEvent

崩溃

功能	HockeyApp	应用中心
自动发送崩溃	默认情况下启用	故障报告
附加其他元数据	是	不支持
跟踪处理的异常	`HockeyClient.Current.TrackException`	不支持

分发

App Center SDK 尚不支持 UWP 应用的分发。

反馈服务

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

通过