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

  • Статья

Важно!

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

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

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

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

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

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

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

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

def appCenterSdkVersion = '5.0.4'
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 в коде приложения

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

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

    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;

  2. Замените код регистрации внутри 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 .

  3. Замените вызовы 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.