Начните работу с Firebase Crashlytics

Посмотреть инструкции для этого варианта

Стандартная задача загрузки символов Crashlytics предполагает, что вы создаете собственные библиотеки как часть сборки Gradle-модуля вашего приложения, используя стандартные инструменты сборки NDK, такие как CMake.

Однако, если вы используете настроенный процесс сборки NDK в Gradle или ваши нативные библиотеки собраны в модуле библиотеки/функции или предоставлены сторонним поставщиком, вам может потребоваться явно указать путь к вашим необработанным библиотекам. Для этого можно добавить свойство unstrippedNativeLibsDir в расширение Crashlytics в файле сборки Gradle.

1. Убедитесь, что вы выполнили следующие начальные задачи из основного рабочего процесса, описанного ранее на этой странице:

   1. Включил Crashlytics в консоли Firebase .

   2. Добавлены Crashlytics SDK для NDK и плагин Crashlytics Gradle .

   3. Добавил расширение Crashlytics в вашу сборку.

   4. Настройте автоматическую загрузку собственных символов.

2. Чтобы задача автоматической загрузки символов могла найти информацию о ваших символах, добавьте следующее в файл Gradle вашего модуля (уровня приложения) (обычно <project>/<app-module>/build.gradle.kts или <project>/<app-module>/build.gradle ):

   Kotlin

   import com.google.firebase.crashlytics.buildtools.gradle.CrashlyticsExtension
   
   // ...
   
   android {
       // ...
       buildTypes {
           release {
               configure<CrashlyticsExtension> {
                   nativeSymbolUploadEnabled = true
                   unstrippedNativeLibsDir = file("PATH/TO/UNSTRIPPED/DIRECTORY")
               }
           }
       }
   }

   Groovy

   // ...
   
   android {
       // ...
       buildTypes {
           release {
               firebaseCrashlytics {
                   nativeSymbolUploadEnabled true
                   unstrippedNativeLibsDir file("PATH/TO/UNSTRIPPED/DIRECTORY")
               }
           }
       }
   }

   Плагин Crashlytics рекурсивно ищет нативные библиотеки с расширением .so в указанном каталоге. Затем Crashlytics извлекает отладочные символы из всех таких библиотек и загружает их на серверы Firebase.

   Вот что можно указать в свойстве unstrippedNativeLibsDir :

   • Любой аргумент, допустимый для org.gradle.api.Project#files(Object...) , включая: java.lang.String , java.io.File или org.gradle.api.file.FileCollection

   • Несколько каталогов для одной разновидности сборки путем предоставления списка или экземпляра FileCollection

   • (Начиная с плагина Crashlytics Gradle v3.0.0) Накапливайте несколько каталогов в отдельных продуктах и создавайте варианты.

   Посмотреть пример с несколькими каталогами

     buildTypes {
       release {
         configure<CrashlyticsExtension> {
           nativeSymbolUploadEnabled = true
           unstrippedNativeLibsDir = file("MY/NATIVE/LIBS")
         }
       }
       productFlavors {
         flavorDimensions += "feature"
         create("basic") {
           dimension = "feature"
           // ...
         }
         create("featureX") {
           dimension = "feature"
           configure<CrashlyticsExtension> {
             unstrippedNativeLibsDir = file("MY/FEATURE_X/LIBS")
           }
         }
       }
     }
     

   Задача uploadCrashlyticsSymbolFilesBasicRelease загрузит символы только в MY/NATIVE/LIBS , но uploadCrashlyticsSymbolFilesFeatureXRelease загрузит символы как в MY/NATIVE/LIBS так и MY/FEATURE_X/LIBS .

3. Наконец, принудительно запустите тестовый сбой , чтобы завершить настройку Crashlytics и увидеть начальные данные на панели управления Crashlytics консоли Firebase .

Посмотреть инструкции для этого варианта

Этот параметр требует запуска команды Firebase CLI при создании сборки релиза или любой сборки, для которой вы хотите увидеть символьные трассировки стека в консоли Firebase .

1. Убедитесь, что вы выполнили следующие начальные задачи из основного рабочего процесса, описанного ранее на этой странице:

   1. Включил Crashlytics в консоли Firebase .

   2. Добавлены Crashlytics SDK для NDK и плагин Crashlytics Gradle .

   Обратите внимание, что при использовании этой опции вам не нужно добавлять расширение firebaseCrashlytics или настраивать автоматическую загрузку символов, поскольку вместо этого вы будете использовать Firebase CLI (следующие шаги ниже) для создания и загрузки файлов символов.

2. Настройте среду и проект для загрузки символов:

   1. Следуйте инструкциям по установке Firebase CLI .

      Если вы уже установили CLI, обязательно обновите его до последней версии .

   2. (только для приложений, использующих API Android уровня 30+) Обновите шаблон AndroidManifest.xml вашего приложения, чтобы отключить тегирование указателей:

      1. Установите флажок для Настройки проигрывателя Android > Настройки публикации > Сборка > Пользовательский основной манифест .

      2. Откройте шаблон манифеста, расположенный по адресу Assets/Plugins/Android/AndroidManifest.xml .

      3. Добавьте следующий атрибут к тегу приложения: <application android:allowNativeHeapPointerTagging="false" ... />

3. Создайте свой проект.

4. Загрузите информацию о ваших символах.

   После завершения сборки сгенерируйте файл символов, совместимый с Crashlytics , и загрузите его на серверы Firebase, выполнив следующую команду Firebase CLI:

   firebase crashlytics:symbols:upload --app=FIREBASE_APP_ID PATH/TO/SYMBOLS

   • FIREBASE_APP_ID : идентификатор вашего приложения Firebase Android (не имя вашего пакета)
     Пример идентификатора приложения Firebase для Android: 1:567383003300:android:17104a2ced0c9b9b

     Хотите узнать идентификатор приложения Firebase?

     Вот два способа найти идентификатор приложения Firebase:

     • В файле google-services.json ваш идентификатор приложения — это значение mobilesdk_app_id ; или

     • В консоли Firebase перейдите в настройки проекта . Прокрутите вниз до карточки «Ваши приложения» , затем нажмите на нужное приложение Firebase, чтобы узнать его идентификатор.

   • PATH/TO/SYMBOLS : Путь к файлу символов, созданному CLI

     • Экспортировано в проект Android Studio — PATH/TO/SYMBOLS может быть любым каталогом. Firebase CLI выполнит рекурсивный поиск нативных библиотек с расширением .so в указанном каталоге.

     • Сборка APK производилась непосредственно в Unity. PATH/TO/SYMBOLS — это путь к архивному файлу символов, сгенерированному в корневом каталоге проекта после завершения сборки (например: myproject/myapp-1.0-v100.symbols.zip ).

   Просмотреть расширенные параметры использования команды Firebase CLI для создания и загрузки файлов символов.

   Флаг	Описание
   --generator=csym	Использует устаревший генератор файлов символов cSYM вместо генератора Breakpad по умолчанию. Не рекомендуется к использованию. Мы рекомендуем использовать стандартный генератор файлов символов Breakpad.
   --generator=breakpad	Использует генератор файлов символов Breakpad Обратите внимание, что по умолчанию для создания файла символов используется Breakpad. Используйте этот флаг только если вы добавили symbolGenerator { csym() } в конфигурации вашей сборки, и вы хотите переопределить его, чтобы вместо него использовать Breakpad.
   --dry-run	Генерирует файлы символов, но не загружает их Этот флаг полезен, если вы хотите проверить содержимое отправляемых файлов.
   --debug	Предоставляет дополнительную отладочную информацию

5. Наконец, принудительно запустите тестовый сбой , чтобы завершить настройку Crashlytics и увидеть начальные данные на панели управления Crashlytics консоли Firebase .

   После сборки приложения в рамках процедуры принудительного сбоя обязательно запустите команду Firebase CLI crashlytics:symbols:upload , чтобы загрузить файл символов.