Миграция из HockeySDK в пакет SDK центра приложений для Unity
Важно!
Прекращение поддержки Центра приложений Visual Studio запланировано на 31 марта 2025 г. Хотя вы можете продолжать использовать Центр приложений Visual Studio, пока он не будет полностью выведен из эксплуатации, существует несколько рекомендуемых вариантов, на которые вы можете рассмотреть возможность миграции.
Узнайте больше о сроках поддержки и альтернативных вариантах.
Следуйте этой документации, если вы хотите обновить приложение для использования пакета SDK центра приложений вместо HockeySDK.
1. Обновление библиотек
1.1 Удаление старого HockeySDK
Выберите игровой объект, созданный для пакета SDK, и удалите
HockeyAppAndroid/HockeyAppiOSего, щелкнув значок >ПараметрыУдалить компонент.Удалите папки 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.