Переход из HockeySDK в пакет SDK для Android для Центра приложений

Статья
01/16/2025

Важно!

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

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

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

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

Откройте файл build.gradle на уровне приложения проекта (app/build.gradle) и замените следующую строку в конфигурации dependencies { ... } .

Перед следующей операцией.

implementation 'net.hockeyapp.android:HockeySDK:...'

После следующих операций.

def appCenterSdkVersion = '5.0.6'
implementation "com.microsoft.appcenter:appcenter-analytics:${appCenterSdkVersion}"
implementation "com.microsoft.appcenter:appcenter-crashes:${appCenterSdkVersion}"
implementation "com.microsoft.appcenter:appcenter-distribute:${appCenterSdkVersion}"

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

Класс HockeyApp	Модуль Центра приложений
`MetricsManager`	`Analytics`
`CrashManager`	`Crashes`
`UpdateManager`	`Distribute`

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

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

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

До (HockeyApp): 00112233445566778899aabbccddeeff

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

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

Замените следующие импорты в классе действия.

Перед следующей операцией.

import net.hockeyapp.android.CrashManager;
import net.hockeyapp.android.metrics.MetricsManager;
import net.hockeyapp.android.UpdateManager;

После следующих операций.

import com.microsoft.appcenter.AppCenter;
import com.microsoft.appcenter.analytics.Analytics;
import com.microsoft.appcenter.crashes.Crashes;
import com.microsoft.appcenter.distribute.Distribute;

Замените код регистрации внутри main класса onCreateдействия -callback вашего приложения.

Перед следующей операцией.
```
CrashManager.register(this);
MetricsManager.register(getApplication());
UpdateManager.register(this);
```
После следующих операций.
```
AppCenter.start(getApplication(), "{Your App Secret}", Analytics.class, Crashes.class, Distribute.class);
```
Если вы использовали метаданные для предоставления идентификатора приложения, необходимо скопировать его оттуда в код инициализации и удалить.
```
<meta-data android:name="net.hockeyapp.android.appIdentifier" android:value="..." />
```
из файлаAndroidManifest.xml .
Замените вызовы API HockeyApp во всем приложении. Подробные таблицы сопоставления API приведены ниже.

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

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

Компонент	HockeyApp	Центр приложений
Настройка уровня журнала	`HockeyLog.setLogLevel`	AppCenter.setLogLevel
Определение установок	Только для внутреннего использования.	AppCenter.getInstallId
Идентификация пользователей	Только сбои	AppCenter.setUserId

Аналитика

Компонент	HockeyApp	Центр приложений
Автоматическое отслеживание сеансов	Да, может быть отключен с помощью `MetricsManager.setSessionTrackingDisabled`	Документация (не может быть отключена)
Пользовательские события со свойствами	`MetricsManager.trackEvent`	Analytics.trackEvent
Отключение службы во время выполнения	`MetricsManager.disableUserMetrics` и `MetricsManager.enableUserMetrics`	Analytics.setEnabled

Сбои

Компонент	HockeyApp	Центр приложений
Автоматическая отправка сбоев	Отключено по умолчанию	Документация (включена по умолчанию)
Присоединение дополнительных метаданных	Да	Документация (может быть присоединена из прослушивателя)
Диалоговое окно "Настройка пользователя"	Да	Документация (не предоставляется по умолчанию)
Получение сведений о состоянии отправки	Да	Документация
Сведения о предыдущем сбое	`CrashManager.getLastCrashDetails`	Crashes.getLastSessionCrashReport

Распространение

Примечание

В отличие от HockeyApp, функция обновлений в приложении центра приложений работает только с сборками RELEASE (по умолчанию), которые распространяются с помощью службы распространения Центра приложений . Если приложение использует частную группу рассылки, после установки и открытия приложения в первый раз после добавления пакета SDK для распространения центра приложений откроется браузер для проверки подлинности пользователя и включения обновлений из приложения. Этот браузер также откроется, если вы задали частную дорожку обновления в приложении во время выполнения. Это однократный шаг, который не будет выполняться для последующих выпусков вашего приложения. Дополнительные сведения см. в документации по распространению в Центре приложений .

Компонент	HockeyApp	Центр приложений
Ограниченные обновления в приложении	`LoginManager.verifyLogin`	Distribute.setUpdateTrack
Отключение службы во время выполнения	`UpdateManager.unregister`	Distribute.setEnabled
Настройка диалогового окна обновления	Да	Документация

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

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

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