Начало работы с WPF/WinForms

Пакет SDK центра приложений использует модульную архитектуру, поэтому вы можете использовать любую или все службы.

Давайте приступим к настройке пакета SDK центра приложений в приложении для использования аналитики Центра приложений и сбоев Центра приложений.

1. Предварительные требования

Прежде чем приступить к работе, убедитесь, что у вас есть следующие необходимые компоненты.

• Проект предназначен для платформа .NET Framework 4.6.2 (или более поздней версии) или .NET Core 3.1 (или более поздней версии).
• .NET Core поддерживается только в том случае, если приложение WPF/WinForms работает в Windows.
• Если вы используете пакет SDK из переносимой библиотеки, он должен быть предназначен для .NET Standard 2.0 или более поздней версии (PCL не поддерживается).
• Тип проекта PackageReference. Это требование исходит из библиотеки SQLitePCL.raw . Дополнительные сведения см. в .https://github.com/ericsink/SQLitePCL.raw/issues/537
• Существует известная проблема при интеграции пакета SDK в проекты VSTO. Дополнительные сведения см. на странице https://github.com/microsoft/appcenter-sdk-dotnet/issues/1583/.

2. Создайте приложение на портале Центра приложений, чтобы получить секрет приложения

Если вы уже создали приложение на портале Центра приложений, этот шаг можно пропустить.

1. Зарегистрируйтесь или войдите в систему и нажмите синюю кнопку в правом верхнем углу портала с надписью Добавить и выберите Добавить новое приложение в раскрывающемся меню.
2. Введите имя и необязательное описание приложения.
3. Выберите соответствующую ОС и платформу в зависимости от проекта, как описано выше.
4. Нажмите кнопку в правом нижнем углу с надписью Добавить новое приложение.

После создания приложения его секрет можно получить на странице Параметры на портале Центра приложений. В правом верхнем углу страницы Параметры щелкните тройную вертикальную точку и выберите Copy app secret , чтобы получить секрет приложения.

3. Добавление модулей пакета SDK центра приложений

Пакет SDK центра приложений можно интегрировать с помощью Visual Studio или консоли диспетчера пакетов.

Visual Studio

• Запустите Visual Studio.
• Щелкните Файл>Открыть и выберите решение.
• В навигаторе решения щелкните правой кнопкой мыши Ссылки и выберите Управление пакетами NuGet.
• На вкладке Обзор найдите Центр приложений и установите пакеты Microsoft.AppCenter.Analytics и Microsoft.AppCenter.Crashes .

Консоль диспетчера пакетов

• Откройте консоль в Visual Studio. Для этого выберите Сервис>Консоль диспетчера>пакетов NuGet.
• Введите такие команды:

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

4. Запустите пакет SDK

Чтобы использовать Центр приложений, согласитесь на нужные модули. По умолчанию модули не запускаются, и необходимо явно вызывать каждый из них при запуске пакета SDK.

4.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));
    }
  }
}

Если вам нужно запустить службы Центра приложений отдельно, выполните следующие действия:

1. Настройте или запустите его с помощью секрета приложения.
2. Если код можно вызвать несколько раз, проверка, если центр приложений уже настроен.
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));

Если вам нужно запустить службы Центра приложений отдельно, выполните следующие действия:

1. Настройте или запустите его с помощью секрета приложения.
2. Если код можно вызвать несколько раз, проверка, если центр приложений уже настроен.
3. Запустите необходимые службы без секрета приложения.

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

4.2. Замените заполнитель секретом приложения

Обязательно замените {Your App Secret} текст фактическим значением для приложения. Секрет приложения можно найти на странице начало работы или на странице параметров на портале Центра приложений.

Страница начало работы содержит приведенный выше пример кода с секретом приложения. Вы можете скопировать и вставить весь пример.

В приведенном выше примере показано, как использовать метод и включить аналитику Start() Центра приложений.

Если вы явно не указали каждую службу в качестве параметров в методе start, вы не сможете использовать эту службу Центра приложений. Кроме того, Start() API можно использовать только один раз в жизненном цикле приложения. Все остальные вызовы будут записывать предупреждение в консоль, и будут доступны только службы, включенные в первый вызов.

Хорошо, вы все настроены для визуализации сбоев на портале, которые пакет SDK собирает автоматически.

Ознакомьтесь с документацией по аналитике Центра приложений и сбоям центра приложений , чтобы узнать, как настроить и использовать более сложные функции обеих служб.