Устранение неполадок пакета SDK для Unity

Это важно

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

Данные аналитики не отображаются на портале

  1. Убедитесь, что вы правильно интегрировали модули SDK.
  2. Убедитесь, что проект включен в присоединенный объект App Center, AppCenterBehavior а секреты приложения добавляются в соответствующие поля в окне Инспектора. Обязательно установите флажки "Использовать {service}" для каждой службы Центра приложений, которую вы планируете использовать.
  3. Убедитесь, что в журналах указано "App Center SDK настроен успешно" (на уровне подробного журнала), а затем проверьте, отображаются ли журналы запросов HTTPS.
  4. Убедитесь, что устройство подключено к сети.
  5. Иногда требуется несколько минут, чтобы журналы появились на портале. Подождите некоторое время, если это так.
  6. Чтобы проверить, получены ли ваши данные серверной частью Центра приложений, перейдите в раздел потока журнала в службе Analytics. Ваши события должны появляться после того, как они были отправлены.

Сбои не отображаются на портале

  1. Убедитесь, что вы правильно интегрировали модули SDK.
  2. Убедитесь, что проект включен в присоединенный объект App Center, AppCenterBehavior а секреты приложения добавляются в соответствующие поля в окне Инспектора. Обязательно установите флажки "Использовать {service}" для каждой службы Центра приложений, которую вы планируете использовать.
  3. Перезапустите приложение после сбоя. App Center Crashes отправляет журнал сбоев только после перезапуска. Пакет SDK не сохранит журнал сбоев при присоединении отладчика. Убедитесь, что отладчик не подключен при сбое приложения.
  4. Убедитесь, что в журналах указано "App Center SDK настроен успешно" (на уровне подробного журнала), а затем проверьте, отображаются ли журналы запросов HTTPS.
  5. Убедитесь, что устройство подключено к сети.
  6. Иногда требуется несколько минут, чтобы журналы появились на портале. Подождите некоторое время, если это так.
  7. Если вы хотите проверить, обнаружил ли SDK сбой при следующем запуске приложения, можно вызвать API, чтобы проверить, было ли приложение аварийно завершено в последнем сеансе, и увидеть отображение соответствующего оповещения. Кроме того, можно расширить обратный вызов аварийного восстановления, чтобы узнать, был ли он успешно отправлен на сервер.
  8. Чтобы проверить, получила ли серверная часть Центра приложений отчет о сбое, перейдите в раздел Журнал событий в службе Аналитики. Ваши сбои должны появиться там, как только они будут отправлены.
  9. Убедитесь, что приложение по факту завершило работу и было перезапущено: Unity по умолчанию перехватывает большинство необработанных исключений, что означает, что приложение не выходит из работы и не считается сбойным. Если сбой будет перехвачен Unity, SDK сообщит о нем как об "Ошибке".

Сбой сборки проекта Android

Модуль распространения версии 4.1.0 или более поздней версии имеет новый тег манифеста для поддержки Android 11. Если вы используете Unity верcии до 2019.4, необходимо явно указать версию Gradle, чтобы избежать ошибки AAPT: error: unexpected element <queries> found in <manifest>.. Чтобы избежать проблем со сборкой проекта, необходимо добавить mainTemplate.gradle и launcherTemplate.gradle (этот файл следует добавить только в том случае, если вы используете файлы Unity 2019.4), чтобы явно указать версию gradle. Откройте Параметры проекта> вкладку Player>Android>Параметры публикации>Сборка, и выберите Пользовательский шаблон main Gradle и Пользовательский шаблон Gradle средства запуска. После создания файлов вставьте следующие строки в верхней части файлов:

buildscript {
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:3.4.3'
    }
}

allprojects {
   repositories {
      google()
      mavenCentral()
      flatDir {
        dirs 'libs'
      }
   }
}

Дополнительные сведения о сборке для Android 11 с помощью руководства по Unity .

Защита секретного значения Центра приложений

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

Чтобы получить конфиденциальные данные, необходимо предоставить маркер приложения или пользователя, который создается на стороне клиента. Нет способа сделать данные на стороне клиента полностью безопасными.

Вы можете улучшить безопасность приложения с помощью переменной среды для внедрения секрета приложения в код. Таким образом, секрет не отображается в коде.

  • Last updated on