UWP/WinUI 入门

2025-05-05

重要

Visual Studio App Center 于 2025 年 3 月 31 日停用，但分析和诊断功能除外，这些功能将继续受支持，直到 2026 年 6 月 30 日。了解详细信息。

App Center SDK 使用模块化体系结构，因此你可以使用任何或所有服务。

让我们开始在您的应用中配置 App Center SDK，以使用 App Center Analytics 和 App Center 崩溃分析。

1.先决条件

在开始之前，请确保满足以下先决条件：

对于 UWP 项目：

您的项目已在 Visual Studio 2017 更新 15.9 或更高版本中设置。
你的目标是运行 Windows 10 内部版本 16299 或更高版本的设备。
项目引用通用 Windows 平台 6.2.8 或更高版本（此包通常隐式引用）。
NuGet 4.3 或更高版本。

对于 WinUI 项目：

你的项目已在 Visual Studio 2019 Update 16.9 或更高版本中配置完成。
你的目标是运行 Windows 10 内部版本 17763 或更高版本的设备。
项目引用 WinUI 3 0.8.0 或更高版本。

注释

如果要将 Xamarin.Forms 用于 UWP，请遵循 Xamarin 入门文档，而非本文档。

2.在 App Center 门户中创建应用以获取应用机密

如果已在 App Center 门户中创建了应用，则可以跳过此步骤。

注册或登录并点击门户右上角的蓝色按钮，显示 “添加新 ”，并从下拉菜单中选择“ 添加新应用 ”。
输入应用的名称和可选说明。
根据上述项目选择适当的 OS 和平台。
点击右下角的按钮，显示 “添加新应用”。

创建应用后，可以在 App Center 门户的“设置”页上获取其应用机密。在 “设置” 页面的右上角，单击 三个垂直点 并选择 Copy app secret 获取应用机密。

3.添加 App Center SDK 模块

可以使用 Visual Studio 或包管理器控制台集成 App Center SDK。

Visual Studio

打开 Visual Studio。
单击“文件>打开”并选择解决方案。
在解决方案导航器中，右键单击 “引用 ”并选择“ 管理 NuGet 包”。
在 “浏览”选项卡中，搜索 App Center，并安装 Microsoft.AppCenter.Analytics 和 Microsoft.AppCenter.Crashes 包。

包管理器控制台

在 Visual Studio 中打开控制台。为此，请选择“工具>NuGet 包管理器>控制台”。
键入以下命令：

Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

在应用程序中集成 SDK 后，可以启动 SDK 并使用 App Center 服务。

注释

如果在可移植项目（如 Xamarin.Forms）中使用 App Center SDK，则必须在每个项目中安装包：可移植项目、Android 和 iOS 包。为此，应打开每个子项目，并按照 Visual Studio 部分所述的相应步骤进行作。

4.添加 `Internet (Client)` 功能

在 Visual Studio 解决方案资源管理器中，双击应用程序的 Package.appxmanifest 文件。单击“ 功能 ”选项卡，然后检查 Internet（客户端） 功能。

5.启动 SDK

若要使用 App Center，必须选择加入要使用的模块。默认情况下，不会启动任何模块，并且必须在启动 SDK 时显式调用每个模块。

5.1 添加使用指令

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

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

5.2 添加 `Start()` 方法

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

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

警告

不建议在源代码中嵌入应用机密。

如果需要单独启动 App Center 服务，应：

配置或启动应用密钥。
如果可以多次调用代码，请检查是否已配置 App Center。
在不使用应用机密的情况下启动所需的服务。

AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

5.3 将占位符替换为应用密钥

请确保将 {Your App Secret} 文本替换为您应用程序中的实际值。可以在 App Center 门户的 “入门 ”页面或 “设置” 页上找到应用机密。

“入门”页包含上述代码示例，其中包含应用机密，可以复制粘贴整个示例。

上面的示例演示如何使用 Start() 该方法并包括 App Center Analytics。

除非在 start 方法中显式将每个服务指定为参数，否则不能使用该 App Center 服务。此外， Start() API 只能在应用的生命周期中使用一次 – 所有其他调用都会将警告记录到控制台，并且只有第一次调用中包含的服务可用。

很好，您现在可以在由 SDK 自动收集数据的门户中可视化数据分析。

查看 App Center Analytics 和 App Center 崩溃的文档，了解如何自定义和使用这两个服务的更高级功能。

通过