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 门户中创建应用,则可以跳过此步骤。

  1. 注册或登录到门户右上角,单击 " 新建 ",然后从下拉菜单中选择 " 添加新应用 "。
  2. 输入应用的名称和可选说明。
  3. 根据上面所述的项目,选择适当的操作系统和平台。
  4. 点击右下角的 " 添加新应用" 按钮。

创建应用后,可以在 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.AnalyticsMicrosoft.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 服务,应执行以下操作:

  1. 配置或启动应用程序机密。
  2. 如果可以多次调用代码,请检查是否已配置 App Center。
  3. 在没有应用机密的情况下,启动所需服务 () 。
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 服务,应执行以下操作:

  1. 配置或启动应用程序机密。
  2. 如果可以多次调用代码,请检查是否已配置 App Center。
  3. 在没有应用机密的情况下,启动所需服务 () 。
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 崩溃 的相关文档,了解如何自定义和使用这两项服务的更高级功能。