Миграция из HockeySDK в пакет SDK центра приложений для Unity

  • Статья

Важно!

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

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

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

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

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

  1. Выберите игровой объект, созданный для пакета SDK, и удалите HockeyAppAndroid / HockeyAppiOS его, щелкнув значок >ПараметрыУдалить компонент.

  2. Удалите папки HockeyAppUnityAndroid / HockeyAppUnityiOS из папки Assets в проекте Unity.

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

Пакет SDK центра приложений интегрируется путем импорта пакетов Unity в проект. Для этого сначала установите подключаемый модуль Unity Редактор Extensions в Центре приложений. Откройте расширения Редактор в меню Unity: Центрприложений>окна>Редактор Расширения и выберите Установить пакет SDK центра приложений.

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

Модуль HockeyApp Модуль Центра приложений
Crashes and Exceptions Crashes
Metrics Analytics
Version Updates Distribute

Чтобы установить службы отдельно, на каждой вкладке можно выбрать Установить пакет SDK .

Примечание

Пакет SDK для Unity центра приложений является одним для всех трех платформ: Android, iOS и UWP. Вам не нужно устанавливать каждый пакет SDK отдельно.

Рекомендуемый способ интеграции пакета SDK центра приложений Unity — использовать расширение Редактор Центра приложений, но мы поддерживаем другие сценарии. Дополнительные сведения см. в документации по Unity в Центре приложений.

2. Настройка пакета SDK

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

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

До (HockeyApp): 00112233445566778899aabbccddeeff

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

2.2. Настройка пакета SDK

Присоединение скрипта Центра приложений

В окне Проект перейдите в папку AppCenter , которая была добавлена в проект. Найдите скрипт с логотипом Центра приложений в качестве значка с именем AppCenterBehaviorи перетащите его на игровой объект, который использовался ранее для HockeySDK.

Настройка параметров Центра приложений

Щелкните этот игровой объект, и в окне Инспектор вы увидите конфигурацию Центра приложений.

Настройка скрипта центра приложений

Заполните дополнительные сведения с помощью подробной таблицы сопоставления конфигураций, которая приведена ниже.

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

Параметр HockeyApp Параметры центра приложений Примечания
ИД приложения; Секрет приложения Android/iOS Используйте идентификатор приложения, преобразованный на предыдущем шаге.
URL-адрес сервера Настраиваемый URL-адрес журнала, раздел "Другая настройка" Проверка использования URL-адреса пользовательского журнала
Ограниченные обновления в приложении Н/Д Distribute.UpdateTrack
Сбои и исключения (включены по умолчанию) Использование сбоев Сбои модуля
Сбои автоматической отправки NA (включен по умолчанию) Документация (включена по умолчанию, может быть настроена)
Ведение журнала исключений Начальный уровень журнала, раздел "Другая настройка" Если требуется более подробное ведение журнала, используйте Verbose
Пользовательские метрики Использование аналитики Модуль аналитики
Обновления версии (включена по умолчанию) Использование распространения Модуль распространения
Обновление оповещения Н/Д Документация (необходимо настроить)

Примечание

Если проект не поддерживает одну из трех платформ, перечисленных в параметрах, оставьте поле секрета приложения как есть; это не будет иметь никакого эффекта. Если ваш проект поддерживает платформы, которые не поддерживаются Центром приложений, api-интерфейсы и конфигурация не будут влиять на эти платформы.

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

Компонент HockeyApp Центр приложений
Пользовательские события со свойствами HockeyAppIOS.TrackEvent или HockeyAppAndroid.TrackEvent Analytics.TrackEvent
Явный проверка обновлений HockeyAppIOS.CheckForUpdate или HockeyAppAndroid.CheckForUpdate Distribute.CheckforUpdate
Отображение формы обратной связи HockeyAppIOS.ShowFeedbackForm или HockeyAppAndroid.ShowFeedbackForm NA (см. раздел ниже)

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

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