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

В этом кратком руководстве описывается, как настроить Firebase Crashlytics в вашем приложении с помощью Firebase Crashlytics SDK, чтобы вы могли получать подробные отчеты о сбоях в консоли Firebase .

Для настройки Crashlytics необходимо выполнить ряд действий как в консоли Firebase , так и в вашей IDE (например, добавить файл конфигурации Firebase и Crashlytics SDK). Для завершения настройки необходимо принудительно вызвать тестовый сбой, чтобы отправить первый отчёт о сбое в Firebase.

Прежде чем начать

1. Добавьте Firebase в свой проект Apple, если вы ещё этого не сделали. Если у вас нет приложения Apple, вы можете скачать пример приложения .

2. Рекомендуется : для автоматического получения журналов хлебных крошек для понимания действий пользователя, приводящих к сбою, нефатальному событию или событию ANR, вам необходимо включить Google Analytics в вашем проекте Firebase.

   • Если в вашем существующем проекте Firebase не включен Google Analytics , вы можете включить Google Analytics на вкладке «Интеграции» вашего проекта. settings > Настройки проекта в консоли Firebase .

   • Если вы создаете новый проект Firebase, включите Google Analytics во время процесса создания проекта.

   Обратите внимание, что журналы навигации доступны для всех платформ Apple, поддерживаемых Crashlytics , за исключением watchOS.

Шаг 1 : Добавьте Crashlytics SDK в свое приложение

Используйте Swift Package Manager для установки и управления зависимостями Firebase.

1. В Xcode откройте проект приложения и перейдите в Файл > Добавить пакеты .
2. При появлении запроса добавьте репозиторий Firebase Apple Platforms SDK:

  https://github.com/firebase/firebase-ios-sdk.git

3. Выберите библиотеку Crashlytics .
4. Чтобы воспользоваться журналами навигации , добавьте в приложение Firebase SDK для Google Analytics . Убедитесь, что Google Analytics включен в вашем проекте Firebase.
5. Добавьте флаг -ObjC в раздел «Другие флаги компоновщика» настроек сборки вашей целевой системы.
6. (только для macOS) В файле Info.plist добавьте ключ NSApplicationCrashOnExceptions и задайте для него значение YES .
7. После завершения Xcode автоматически начнет разрешать и загружать ваши зависимости в фоновом режиме.

Далее настраиваем модуль Firebase:

1. Импортируйте модуль Firebase в структуру App или UIApplicationDelegate :

   Быстрый

   import Firebase

   Objective-C

   @import Firebase;

2. Настройте общий экземпляр FirebaseApp , обычно в методе делегата вашего приложения application(_:didFinishLaunchingWithOptions:) :

   Быстрый

   // Use the Firebase library to configure APIs.
   FirebaseApp.configure()

   Objective-C

   // Use the Firebase library to configure APIs.
   [FIRApp configure];

Шаг 2 : Настройте Xcode для автоматической загрузки файлов dSYM

Для создания удобочитаемых отчётов о сбоях Crashlytics требуются файлы отладочных символов (dSYM) вашего проекта. Ниже описано, как настроить Xcode для автоматического создания dSYM-файлов, их обработки и загрузки при каждой сборке приложения.

1. Откройте рабочее пространство Xcode вашего проекта, затем выберите файл проекта в левом навигаторе.

2. В списке ЦЕЛИ выберите основную цель сборки.

3. Откройте вкладку «Параметры сборки» , затем выполните следующие шаги, чтобы Xcode создавал файлы dSYM для ваших сборок.

   1. Нажмите Все , затем выполните поиск по debug information format .

   2. Установите формат отладочной информации на DWARF with dSYM File для всех типов сборок.

4. Откройте вкладку «Фазы сборки» , затем выполните следующие шаги, чтобы Xcode мог обработать ваши dSYM-файлы и загрузить файлы.

   1. Нажмите add > «Новая фаза сценария выполнения» .

      Убедитесь, что эта новая фаза запуска скрипта является последней фазой сборки вашего проекта; в противном случае Crashlytics не сможет правильно обрабатывать dSYM-файлы.

   2. Разверните новый раздел «Выполнить сценарий» .

   3. В поле скрипта (расположенном под меткой Shell ) добавьте следующий скрипт запуска.

      Этот скрипт обрабатывает файлы dSYM вашего проекта и загружает их в Crashlytics .

      "${BUILD_DIR%/Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run"

   4. В разделе «Входные файлы» добавьте пути к расположению следующих файлов:

      ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}

      ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${PRODUCT_NAME}

      ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Info.plist

      $(TARGET_BUILD_DIR)/$(UNLOCALIZED_RESOURCES_FOLDER_PATH)/GoogleService-Info.plist

      $(TARGET_BUILD_DIR)/$(EXECUTABLE_PATH)

      Если в настройках сборки вашего проекта есть ENABLE_USER_SCRIPT_SANDBOXING=YES и ENABLE_DEBUG_DYLIB=YES , то включите следующее:

      ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${PRODUCT_NAME}.debug.dylib

      Понять, зачем нужны местоположения этих файлов

      Xcode ищет эти входные файлы в указанных расположениях, чтобы убедиться, что файлы сборки доступны для скрипта запуска. Кроме того, если включена опция «Песочница пользовательских скриптов» , Xcode разрешает скрипту запуска доступ только к файлам, указанным в поле «Входные файлы» .

      • Указав местоположение файлов dSYM вашего проекта, Crashlytics сможет обрабатывать файлы dSYM.
      • Указав расположение созданного вами файла GoogleService-Info.plist Crashlytics сможет связать dSYM-файлы с вашим приложением Firebase.
      • Указав расположение исполняемого файла приложения, вы сможете предотвратить дублирование загрузки одного и того же dSYM-файла. Обратите внимание, что исполняемые файлы приложения не загружаются .

Более подробную информацию о файлах dSYM и Crashlytics (включая информацию о том, как вручную загружать файлы dSYM), см. на странице Получение деобфусцированных отчетов о сбоях .

Шаг 3 : Заставьте испытательный сбой, чтобы закончить настройку

Чтобы закончить настройку Crashlytics и увидеть начальные данные на приборной панели Crashlytics на консоли Firebase , вам необходимо установить тестовый аварий.

1. Добавьте код в свое приложение, которое вы можете использовать, чтобы вызвать тестовый сбой.

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

   SwiftUI

   Button("Crash") {
     fatalError("Crash was triggered")
   }

   UIKit

   Быстрый

   import UIKit
   
   class ViewController: UIViewController {
     override func viewDidLoad() {
         super.viewDidLoad()
   
         // Do any additional setup after loading the view, typically from a nib.
   
         let button = UIButton(type: .roundedRect)
         button.frame = CGRect(x: 20, y: 50, width: 100, height: 30)
         button.setTitle("Test Crash", for: [])
         button.addTarget(self, action: #selector(self.crashButtonTapped(_:)), for: .touchUpInside)
         view.addSubview(button)
     }
   
     @IBAction func crashButtonTapped(_ sender: AnyObject) {
         let numbers = [0]
         let _ = numbers[1]
     }
   }

   Objective-C

   #import "ViewController.h"
   
   @implementation ViewController
   ‐ (void)viewDidLoad {
       [super viewDidLoad];
   
       // Do any additional setup after loading the view, typically from a nib.
   
       UIButton* button = [UIButton buttonWithType:UIButtonTypeRoundedRect];
       button.frame = CGRectMake(20, 50, 100, 30);
       [button setTitle:@"Test Crash" forState:UIControlStateNormal];
       [button addTarget:self action:@selector(crashButtonTapped:)
           forControlEvents:UIControlEventTouchUpInside];
       [self.view addSubview:button];
   }
   
   ‐ (IBAction)crashButtonTapped:(id)sender {
       @[][1];
   }
   
   @end

2. Создайте и запустите свое приложение в XCode с отключенным отладчиком XCode.

   1. Нажмите play_arrow , а затем запустите текущую схему , чтобы построить приложение на тестовом устройстве или симуляторе.

   2. Подождите, пока ваше приложение не будет запущено, затем нажмите stop запуск схемы» или «Действие» , чтобы закрыть начальный экземпляр вашего приложения. Этот начальный экземпляр включал отладчик, который мешает Crashlytics .

3. Заставьте испытательный сбой, чтобы отправить первое отчет о сбое вашего приложения:

   1. Откройте приложение с домашнего экрана вашего тестового устройства или симулятора.

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

   3. После сбоя приложения запустите его снова из XCode, чтобы ваше приложение могло отправить отчет о сбое в Firebase.

4. Перейдите к приборной панели Crashlytics на консоли Firebase , чтобы увидеть ваш тестовый аварий.

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

И это все! Crashlytics теперь контролирует ваше приложение на предмет сбоев. Посетите панель панели Crashlytics , чтобы просмотреть и расследовать все ваши отчеты и статистику.

Следующие шаги

• Настройте настройку отчета об аварии , добавив отчеты OPT-In, журналы, ключи и отслеживание нерадостных ошибок.