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

Статья
03/15/2024

Важно!

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

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

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

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

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

Откройте окно терминала, перейдите в папку проекта Cordova и выполните следующую команду:
```
cordova plugin add cordova-plugin-appcenter-analytics
```
Перейдите в папку Ваши платформы > приложений > 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 в коде приложения

Удалите инициализацию HockeyApp внутри обработчика deviceready :
```
hockeyapp.start(null, null, "APP_ID");
```
Настройка пакета SDK для Центра приложений

Откройте файл config.xml проекта Apache Cordova; Для каждого целевого platform элемента проекта Apache Cordova (сейчас только android и iOS) добавьте дочерний preference элемент в следующем формате:
```
<preference name="APP_SECRET" value="{App Secret from the previous step}" />
```
Дополнительные сведения см. в документации по Центру приложений Cordova.
Замените все вызовы 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.

Поделиться через