Переход с HockeySDK на пакет SDK центра приложений для Cordova

  • Статья

Важно!

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

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

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

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

1.1 Удаление старого HockeySDK

  1. Откройте окно терминала, перейдите в папку проекта Cordova и выполните следующую команду:

    cordova plugin add cordova-plugin-appcenter-analytics

  2. Перейдите в папку Ваши платформы > приложений > android > platform_www > plugins и удалите из нее cordova-plugin-hockeyapp.

1.2. Добавление нового пакета SDK для Центра приложений

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

Модуль HockeyApp Модуль Центра приложений Команда Install
Crashes and Exceptions Crashes cordova plugin add cordova-plugin-appcenter-crashes
Metrics Analytics cordova plugin add cordova-plugin-appcenter-analytics

Выполните одну из команд, чтобы установить необходимый модуль (или обе).

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 внутри обработчика deviceready :

    hockeyapp.start(null, null, "APP_ID");

  2. Настройка пакета SDK для Центра приложений

    Откройте файл config.xml проекта Apache Cordova; Для каждого целевого platform элемента проекта Apache Cordova (сейчас только android и iOS) добавьте дочерний preference элемент в следующем формате:

    <preference name="APP_SECRET" value="{App Secret from the previous step}" />

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

  3. Замените все вызовы API HockeyApp в приложении. Ниже приведены подробные таблицы сопоставления API.

3. Сравнение служб и функций

Основные сведения

Компонент HockeyApp Центр приложений
Идентификация пользователей hockeyapp.setUserName или hockeyapp.setUserEmail AppCenter.setUserId

Аналитика

Компонент HockeyApp Центр приложений
Автоматическое отслеживание сеансов Документация (не может быть отключена) Документация (включена по умолчанию)
Отслеживание событий hockeyapp.trackEvent Analytics.trackEvent

Сбои

Компонент HockeyApp Центр приложений
Автоматическая отправка сбоев Параметр autoSend (отключен по умолчанию) APPCENTER_CRASHES_ALWAYS_SEND (включено по умолчанию)
Присоединение дополнительных метаданных hockeyapp.addMetaData Документация (может быть присоединена из прослушивателя)
Создание аварийного завершения теста hockeyapp.forceCrash AppCenter.Crashes.generateTestCrash
Отображение диалогового окна при сбое ignoreDefaultHandler (отключен по умолчанию, только Для Android) AppCenter.Crashes.process (обратный вызов при обработке сбоя)

Обновления версий

Служба распространения центра приложений пока не поддерживается в пакете SDK Cordova для Центра приложений.

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

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