WPF/WinForms 入门
App Center SDK 使用模块化体系结构,以便你可以使用任何或所有服务。
让我们开始在应用程序中设置 App Center SDK,以使用 App Center 分析和 App Center 崩溃。
1.先决条件
在开始之前,请确保满足以下先决条件:
- 你的项目面向的是 .NET Framework 4.6.1 (或更高版本) 或 .NET Core 3.0 (或更高) 版本。
- 仅当 WPF/WinForms 应用程序在 Windows 上运行时,才支持 .NET Core。
- 如果你使用的是可移植库中的 SDK,则它必须面向 .NET standard 1.0 或更高版本, (不支持 PCL) 。
2. 在 App Center 门户中创建你的应用程序以获取应用程序机密
如果已在 App Center 门户中创建应用,则可以跳过此步骤。
- 注册或登录到门户右上角,单击 " 新建 ",然后从下拉菜单中选择 " 添加新应用 "。
- 输入应用的名称和可选说明。
- 根据上面所述的项目,选择适当的操作系统和平台。
- 点击右下角的 " 添加新应用" 按钮。
创建应用后,可以在 App Center 门户的 "设置" 页上获取其 应用密码。 在 " 设置 " 页的右上角,单击 三个垂直点 ,然后选择 Copy app secret 以获取您的应用程序机密。
3. 添加 App Center SDK 模块
可以使用 Visual Studio 或程序包管理器控制台来集成 App Center SDK。
备注
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
备注
如果在可App Center项目中使用 App Center SDK,则必须在每个项目中安装包:可移植和运行 WPF/WinForms 应用的项目。 为此,应打开每个子项目,并遵循以下部分所述的Visual Studio步骤。
5.启动 SDK
若要App Center,请 (模块) 使用模块。 默认情况下,不会启动任何模块,并且必须在启动 SDK 时显式调用每个模块。
5.1 添加 Start() 方法
WPF
对于 WPF 应用程序,请修改 App.xaml.cs 并添加以下 using 语句:
using Microsoft.AppCenter;
using Microsoft.AppCenter.Analytics;
using Microsoft.AppCenter.Crashes;
然后在同一文件中,在 方法中添加以下 OnStartup 代码:
AppCenter.Start("{Your App Secret}", typeof(Analytics), typeof(Crashes));
如果 App.xaml.cs 文件没有 方法 OnStartup ,可以添加 Application.OnStartup(StartupEventArgs) 方法。 App.xaml.cs文件应如下所示:
public partial class App : Application
{
protected override void OnStartup(StartupEventArgs e)
{
base.OnStartup(e);
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));
}
WinForms
对于 WinForms 应用程序,请修改 Program.cs 文件并添加以下 using 语句:
using Microsoft.AppCenter;
using Microsoft.AppCenter.Analytics;
using Microsoft.AppCenter.Crashes;
然后在同一文件中,在 方法中的 语句之前 Main 添加以下 Application.Run 代码。
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.2 将 占位符替换为应用机密
请确保将 {Your App Secret} 文本替换为应用程序的实际值。 可在 App Center 门户中的 " 入门 " 页或 " 设置 " 页上找到该应用程序机密。
入门页面包含上面的代码示例,其中包含你的应用程序机密,你可以复制并粘贴整个示例。
上面的示例演示如何使用 Start() 方法并包括 App Center 分析。
除非将每个服务显式指定为 start 方法中的参数,否则不能使用该服务 App Center。 此外,在 Start() 应用程序的生命周期中,API 只能使用一次,所有其他调用都将向控制台记录一条警告,并且只有第一次调用中包含的服务可用。
很好,你已经设置了 SDK 自动收集的门户上的故障。
查看 App Center 分析 和 App Center 崩溃 的相关文档,了解如何自定义和使用这两项服务的更高级功能。