В этом кратком руководстве описывается, как настроить Firebase Crashlytics в вашем приложении с помощью Firebase Crashlytics SDK, чтобы вы могли получать исчерпывающие отчеты о сбоях в консоли Firebase .
Прежде чем вы начнете
Если вы еще этого не сделали, добавьте Firebase в свой проект iOS. Если у вас нет приложения для iOS, вы можете загрузить образец приложения .
Необязательно : чтобы получить такие показатели сбоев, как количество пользователей без сбоев, хлебные крошки и настраиваемые события, вам необходимо включить Google Analytics в своем проекте Firebase.
Если в вашем существующем проекте Firebase не включена Google Analytics, вы можете включить Google Analytics на вкладке « Интеграция » в > Настройки проекта .
Если вы создаете новый проект Firebase, включите Google Analytics во время рабочего процесса создания проекта.
Наконец, в консоли Google Analytics включите совместное использование данных на вкладке « Администратор »> « Настройки учетной записи »> « Настройки обмена данными» .
Обратите внимание, что для более старых проектов Firebase вам может потребоваться включить совместное использование данных на вкладке « Интеграция » в > Настройки проекта (в консоли Firebase).
Шаг 1. Настройте Crashlytics в консоли Firebase
Нажмите Crashlytics на левой навигационной панели консоли Firebase .
Если в вашем проекте Firebase зарегистрировано несколько приложений, выберите приложение, которое вы только что добавили, из раскрывающегося списка рядом с Crashlytics на верхней панели консоли.
Щелкните Включить Crashlytics .
Шаг 2. Добавьте Firebase Crashlytics в свое приложение
Откройте подфайл, который вы создали для своего проекта Firebase, и добавьте модуль
FirebaseCrashlytics
. Для оптимальной работы с Firebase Crashlytics мы рекомендуем включить Google Analytics в вашем проекте, добавив также модуль Firebase для Analytics в ваше приложение. Убедитесь, что вы добавили Google Analytics версии 6.3.1 или более поздней, чтобы получать пользователей и хлебные крошки без сбоев в реальном времени.pod 'Firebase/Crashlytics' # Recommended: Add the Firebase pod for Google Analytics pod 'Firebase/Analytics'
Установите
.xcworkspace
, затем повторно откройте файл.xcworkspace
чтобы увидеть проект в Xcode:pod install
open your-project.xcworkspace
Импортируйте модуль Firebase в свой
UIApplicationDelegate
:Быстрый
import Firebase
Цель-C
@import Firebase;
Настройте общий экземпляр
FirebaseApp
, как правило, в методеapplication:didFinishLaunchingWithOptions:
вашего приложения:Быстрый
// Use the Firebase library to configure APIs. FirebaseApp.configure()
Цель-C
// Use the Firebase library to configure APIs. [FIRApp configure];
Перекомпилируйте свое приложение.
Шаг 3. Инициализируйте Crashlytics
Вы можете инициализировать Crashlytics, добавив сценарий выполнения на этап сборки проекта. Скрипт запуска позволяет Xcode автоматически загружать файл dSYM вашего проекта всякий раз, когда ваше приложение выходит из строя, так что Crashlytics может автоматически генерировать отчеты о сбоях.
Откройте свой проект в Xcode, затем выберите его файл проекта в левом навигаторе.
В раскрывающемся списке Выберите проект или цель выберите основную цель сборки.
Выберите вкладку Build Phases , затем нажмите
> New Run Script Phase .Разверните появившийся новый раздел « Выполнить сценарий ». В поле сценария (находится под полем Shell ) добавьте новый сценарий запуска:
"${PODS_ROOT}/FirebaseCrashlytics/run"
Добавьте местоположение dSYM вашего приложения в качестве входного файла, который позволит Crashlytics быстрее автоматически генерировать dSYM для больших приложений. Например:
${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${TARGET_NAME}
Вы также можете
Info.plist
расположениеInfo.plist
созданное вашим приложением, в поле Input Files фазы сборки:$(SRCROOT)/$(BUILT_PRODUCTS_DIR)/$(INFOPLIST_PATH)
После добавления SDK в приложение Crashlytics автоматически приступает к работе, отслеживая и собирая отчеты о сбоях.
Шаг 4. Запустите свой проект
Наконец, запустите ваше приложение. В журналах вашего устройства отображается проверка Firebase завершения инициализации.
Следующие шаги
Проверьте настройку Crashlytics, вызвав сбой в консоли Firebase.
Настройте настройку отчета о сбоях , добавив отчеты о подписке, журналы, ключи и отслеживание нефатальных ошибок.