Миграция из HockeySDK в ЦЕНТР приложений WPF/Winforms

  • Статья

Важно!

Прекращение поддержки Центра приложений Visual Studio запланировано на 31 марта 2025 г. Хотя вы можете продолжать использовать Центр приложений Visual Studio до полного прекращения его использования, существует несколько рекомендуемых вариантов, на которые можно перейти.

Узнайте больше о сроках поддержки и альтернативных вариантах.

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

1. Обновление библиотек

Замените пакет NuGet HockeySDK.WPF на пакет Центра приложений во всех проектах решения.

Visual Studio для Windows

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

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

  • Откройте консоль в Visual Studio. Для этого выберите Инструменты> Диспетчер >пакетов NuGetКонсоль диспетчера пакетов.
  • Если вы работаете в Visual Studio для Mac, убедитесь, что у вас установлены расширения управления пакетами NuGet. Для этого выберитеРасширенияVisual Studio>, найдите NuGet и при необходимости установите.
  • Введите в консоли следующие команды:
Uninstall-Package HockeySDK.WPF
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

Пакет SDK центра приложений использует модульный подход— вы можете выбрать, какие службы вы хотите интегрировать. Каждый модуль ПАКЕТА SDK необходимо добавить в качестве отдельной зависимости в этом разделе.

2. Обновление кода установки пакета SDK

2.1. Преобразование идентификатора приложения

Пакет SDK центра приложений использует идентификаторы приложений в формате GUID. Ваш идентификатор приложения HockeyApp может использоваться Центром приложений, но его необходимо преобразовать в другой формат. Чтобы преобразовать идентификатор, необходимо добавить четыре дефиса для получения 8-4-4-4-12 представления.

Before (HockeyApp): 00112233445566778899aabbccddeeff

После (Центр приложений): 00112233-4455-6677-8899-aabbccddeeff

2.2. Замена инициализации пакета SDK в коде приложения

  1. Удалите старый код регистрации HockeyApp. В объявлении using оператора удалите следующую строку:

    using Microsoft.HockeyApp;

    В начале конструктора класса App удалите следующую строку:

    HockeyClient.Current.Configure("Your_App_ID");

  2. Запустите пакет 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 Обработано ошибок

Distribution

Пакет SDK центра приложений пока не поддерживает распространение приложений WPF/Winforms.

Служба отзывов

Служба обратной связи не будет поддерживаться в Центре приложений. См . отзывы о HockeyApp.