Эта страница переведена с помощью Cloud Translation API.

Начните работу с Crashlytics для платформ Apple

Выберите платформу:

В этом руководстве описано, как начать работу с Firebase Crashlytics в вашем приложении для платформ Apple (например, в приложении для iOS).

После установки SDK Firebase Crashlytics в ваше приложение вы сможете получать подробные отчеты о сбоях в консоли Firebase . С Crashlytics для платформ Apple вы получаете отчеты как о сбоях, так и о некритических ошибках.

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

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

Если вы еще этого не сделали, добавьте Firebase в свой проект Apple. Если у вас нет приложения Apple, вы можете скачать пример приложения .
Рекомендуется : Чтобы автоматически получать навигационные цепочки и понимать действия пользователей, предшествовавшие сбою или некритическому событию, необходимо включить Google Analytics в вашем проекте Firebase.
- Если в вашем существующем проекте Firebase не включена Google Analytics , вы можете включить Google Analytics на вкладке «Интеграции» вашего проекта. > Настройки проекта в консоли Firebase .
- При создании нового проекта Firebase включите Google Analytics в процессе создания проекта.
Обратите внимание, что навигационная цепочка доступна для всех платформ Apple, поддерживаемых Crashlytics , за исключением watchOS.

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

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

В Xcode, открыв проект приложения, перейдите в меню File > Add Packages .
При появлении запроса добавьте репозиторий Firebase Apple Platforms SDK:

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

Выберите библиотеку Crashlytics .

Чтобы использовать функцию "хлебные крошки" (breadcrumb logs) , добавьте в приложение также Firebase SDK для Google Analytics . Убедитесь, что Google Analytics включен в вашем проекте Firebase.

Добавьте флаг -ObjC в раздел «Другие флаги компоновщика» в настройках сборки вашей целевой системы.

(Только для macOS) В файле Info.plist добавьте ключ NSApplicationCrashOnExceptions и установите для него значение YES .

После завершения Xcode автоматически начнет разрешение и загрузку ваших зависимостей в фоновом режиме.

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

Импортируйте модуль Firebase в структуру App или UIApplicationDelegate :
Быстрый
import Firebase
Objective-C
@import Firebase;
Настройте общий экземпляр 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, их обработки и загрузки при каждой сборке приложения.

Откройте рабочую область Xcode вашего проекта, затем выберите файл проекта в левой панели навигации.
В списке ЦЕЛЕЙ выберите основную цель сборки.
Перейдите на вкладку «Настройки сборки» , затем выполните следующие действия, чтобы Xcode создал файлы dSYM для ваших сборок.
1. Нажмите «Все» , затем найдите debug information format .
2. Установите формат отладочной информации на DWARF with dSYM File для всех типов сборки.
Перейдите на вкладку «Этапы сборки» , затем выполните следующие шаги, чтобы Xcode мог обработать ваши dSYM-файлы и загрузить их.
1. Нажмите > «Новый этап выполнения скрипта» .
  Убедитесь, что этот новый этап выполнения скрипта является последним этапом сборки вашего проекта; в противном случае Crashlytics не сможет корректно обрабатывать файлы dSYM.
2. Разверните новый раздел «Выполнить скрипт» .
  Примечание: Для остальных шагов скопируйте и вставьте пути точно так, как указано, и Xcode их распознает. Однако, если у вас возникнут проблемы с распознаванием этих путей в Xcode или с уникальной структурой проекта, вы можете указать пути вручную.
3. В поле «Скрипт» (расположенное под заголовком «Оболочка ») добавьте следующий скрипт выполнения.
  Этот скрипт обрабатывает файлы 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 обрабатывать эти файлы.
  - Указав расположение файла GoogleService-Info.plist , созданного для вашего приложения, Crashlytics сможет связать dSYM-файлы с вашим приложением Firebase.
  - Указание местоположения исполняемого файла вашего приложения позволяет скрипту запуска предотвратить повторную загрузку одного и того же файла dSYM. Обратите внимание, что исполняемые файлы приложения не загружаются .

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

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

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

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

Следующий код позволит добавить в приложение кнопку, при нажатии на которую произойдет сбой. Кнопка будет называться "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

Соберите и запустите приложение в Xcode с отключенным отладчиком Xcode.
Отладчик Xcode предотвращает отправку отчетов о сбоях в Crashlytics . Выполните следующие шаги, чтобы отключить тестовое устройство или симулятор от отладчика Xcode перед принудительным сбоем.
1. Нажмите кнопку Build, а затем запустите текущую схему , чтобы собрать приложение на тестовом устройстве или симуляторе.
2. Дождитесь завершения работы приложения, затем нажмите . Остановите выполнение схемы или действия , чтобы закрыть исходный экземпляр приложения. Этот исходный экземпляр включал отладчик, который мешает работе Crashlytics .
Чтобы отправить первый отчет о сбое вашего приложения, необходимо принудительно вызвать сбой в тестовой среде:
1. Откройте приложение с главного экрана вашего тестового устройства или симулятора.
2. В вашем приложении нажмите кнопку "Проверить на наличие ошибок", которую вы добавили, используя приведенный выше код.
3. После сбоя приложения запустите его снова из Xcode, чтобы приложение могло отправить отчет о сбое в Firebase.
Чтобы увидеть сбой вашего теста, перейдите на панель Crashlytics в консоли Firebase .
Если после обновления консоли сбой теста по-прежнему не наблюдается через пять минут, включите отладочное логирование, чтобы проверить, отправляет ли ваше приложение отчеты о сбоях.

Вот и всё! Crashlytics теперь отслеживает сбои в вашем приложении. Перейдите на панель управления Crashlytics , чтобы просмотреть и проанализировать все ваши отчеты и статистику.

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

Настройте параметры отчетов о сбоях , добавив возможность включения отчетов по желанию пользователя, журналы, ключи и отслеживание некритических ошибок.
Интеграция с Google Play позволит вам фильтровать отчеты о сбоях вашего Android-приложения по отслеживанию Google Play непосредственно на панели Crashlytics . Это позволит вам более точно сфокусировать панель мониторинга на конкретных сборках.

Начните работу с Crashlytics для платформ Apple Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

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

Быстрый

Objective-C

Быстрый

Objective-C

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

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

SwiftUI

UIKit

Быстрый

Objective-C

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

Начните работу с Crashlytics для платформ Apple