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

  • Статья

Важно!

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

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

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

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

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

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

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

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

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

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