Начните работу с 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 platform SDK:

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

3. Выберите библиотеку Crashlytics .
4. Чтобы воспользоваться преимуществами breadcrumb logs , также добавьте 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 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 позволяет скрипту запуска получать доступ только к файлам, указанным в Input Files .

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

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

Шаг 3 : Принудительный тестовый сбой для завершения настройки

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

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

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

   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 , чтобы просмотреть и изучить все ваши отчеты и статистику.

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

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