Миграция из HockeySDK в UWP в Центре приложений

  • Статья

Важно!

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

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

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

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

Примечание

Такие платформы, как WinRT, Windows Phone 8.0 и 8.1, WPF и PCL, не поддерживаются в пакете SDK центра приложений. Вы можете продолжать использовать HockeySDK с ними.

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

Visual Studio для Windows

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

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

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

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

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

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

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

До (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 центра приложений еще не поддерживает распространение приложений UWP.

Служба обратной связи

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