Firebase Crashlytics — это лёгкий инструмент для отчётности о сбоях в режиме реального времени, который упрощает управление проблемами стабильности в вашем приложении. Crashlytics экономит время на устранение неполадок, грамотно группируя сбои и выделяя обстоятельства, которые к ним привели.
В этом руководстве описывается, как интегрировать Crashlytics в ваш проект Xcode для регистрации идентификаторов ответов на рекламу. Позже, при устранении сбоев в приложении, вы сможете найти идентификатор ответа на рекламу и использовать Центр просмотра рекламы в AdMob для поиска и блокировки рекламы.
Шаг 1: Добавьте Firebase в приложение iOS
Если вы хотите попробовать вести логирование с помощью Firebase из чистого приложения, вы можете скачать или клонировать репозиторий примеров Google Mobile Ads SDK для iOS на GitHub. В этом руководстве используется пример баннера .
Если у вас уже есть приложение, вы сможете перейти к другим шагам, используя идентификатор пакета вашего приложения. Те же шаги можно применить и к другим примерам в репозитории, внеся небольшие изменения.
Чтобы использовать Firebase Crashlytics, необходимо создать проект Firebase и добавить в него своё приложение. Создайте проект Firebase, если вы ещё этого не сделали. Не забудьте зарегистрировать в нём своё приложение .
На странице Crashlytics консоли Firebase нажмите Настроить Crashlytics .
На появившемся экране нажмите Нет > Настроить новое приложение Firebase .
В Podfile добавьте Pods для Google Analytics и Firebase Crashlytics.
source 'https://github.com/CocoaPods/Specs.git' platform :ios, '8.0' target 'BannerExample' do use_frameworks! pod 'Google-Mobile-Ads-SDK' pod 'Firebase/Crashlytics' pod 'Firebase/Analytics' end
В Терминале или командной строке установите и обновите свои модули:
pod install --repo-update
Откройте файл
BannerExample.xcworkspaceв Xcode, чтобы загрузить проект.
Шаг 2: Настройте Firebase для вашего приложения
Быстрый
В AppDelegate.swift добавьте следующие строки:
import UIKit // Import the Firebase library import FirebaseCore @UIApplicationMain class AppDelegate: UIResponder, UIApplicationDelegate { var window: UIWindow? func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool { // Configure an instance of Firebase FirebaseApp.configure() return true } }
Objective-C
В AppDelegate.m добавьте следующие строки:
@import AppDelegate.h; // Import the Firebase library @import FirebaseCore; @interface AppDelegate () @end @implementation AppDelegate ‐ (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { // Override point for customization after application launch. // Initialize Firebase [FIRApp configure]; return YES; }
В Xcode откройте «Настройки сборки» и перейдите на вкладку «Фазы сборки» . Добавьте скрипт запуска Fabric:
Очистите папку сборки, затем соберите и запустите приложение. Теперь вы можете войти в веб-консоль Firebase и получить доступ к панели управления Crashlytics.
(Необязательно): Проверьте свою настройку
Добавив кнопку аварийного завершения, вы можете принудительно вызывать аварийное завершение работы приложения при каждом нажатии кнопки. Эта тестовая настройка активирует код из шага 3 для отправки пользовательских журналов на панели мониторинга Firebase Crashlytic.
Быстрый
В файле ViewController.swift добавьте следующие строки в функцию viewDidLoad() :
override func viewDidLoad() { super.viewDidLoad() bannerView.delegate = self bannerView.adUnitID = "ca-app-pub-3940256099942544/2934735716" bannerView.rootViewController = self bannerView.load(Request) let button = UIButton(type: .roundedRect) button.frame = CGRect(x: 20, y: 50, width: 100, height: 30) button.setTitle("Crash", for: []) button.addTarget(self, action: #selector(self.crashButtonTapped(_:)), for: .touchUpInside) view.addSubview(button) }
Затем добавьте этот @IBAction в конец объявления вашего класса:
@IBAction func crashButtonTapped(_ sender: AnyObject) { fatalError("Test Crash Happened") }
Objective-C
В файле ViewController.m добавьте следующие строки в метод viewDidLoad :
‐ (void)viewDidLoad { [super viewDidLoad]; /// ... UIButton* button = [UIButton buttonWithType:UIButtonTypeRoundedRect]; button.frame = CGRectMake(20, 50, 100, 30); [button setTitle:@"Crash" forState:UIControlStateNormal]; [button addTarget:self action:@selector(crashButtonTapped:) forControlEvents:UIControlEventTouchUpInside]; [self.view addSubview:button]; }
Затем добавьте этот IBAction в конец объявления вашего класса:
‐ (IBAction)crashButtonTapped:(id)sender { assert(NO); }
На панели инструментов Xcode нажмите кнопку «Остановить» , а затем перезапустите приложение через симулятор. После загрузки приложения нажмите кнопку «Сбой» . Вернитесь в Xcode и нажмите кнопку «Воспроизвести» , чтобы загрузить журнал сбоя в Crashlytics.
Шаг 3: Зарегистрируйте идентификатор ответа на объявление
Если вы загружаете несколько объявлений и показываете их в разное время, рекомендуется регистрировать каждый идентификатор ответа на объявление с отдельным ключом. Например, в этом руководстве используется пример только с одним баннером. Поэтому в следующем фрагменте кода мы регистрируем идентификатор ответа на объявление как ключ banner_ad_response_id .
Вы также можете создать несколько пар «ключ-значение» в Firebase Crashlytics для разных типов рекламы и событий. Подробнее см. в разделе «Уведомления о жизненном цикле запроса рекламы».
Дополнительную информацию о пользовательском ведении журнала см. в статье Настройка отчетов о сбоях Firebase Crashlytics .
Быстрый
Добавьте следующий код в ViewController.swift . По сути, он использует функцию Crashlytics.setCustomValue() в функции обратного вызова adViewDidReceiveAd .
import GoogleMobileAds import UIKit class ViewController: UIViewController, BannerViewDelegate { /// The banner view. @IBOutlet weak var bannerView: BannerView! override func viewDidLoad() { super.viewDidLoad() ... bannerView.delegate = self ... } /// Tells the delegate an ad request loaded an ad. func adViewDidReceiveAd(_ bannerView: BannerView) { if let responseInfo = bannerView.responseInfo, responseId = responseInfo.responseId { print("adViewDidReceiveAd from network: \(responseInfo.adNetworkClassName), response Id='\(responseId)'") Crashlytics.sharedInstance().setCustomValue(responseId, forKey: "banner_ad_response_id") } } }
Objective-C
Добавьте следующий код в файл ViewController.m . По сути, он использует функцию [FIRCrashlytics crashlytics] setCustomValue в функции adViewDidReceiveAd .
@import GoogleMobileAds; @interface ViewController () @property(nonatomic, strong) GADBannerView *bannerView; @end @implementation ViewController ‐ (void)viewDidLoad { [super viewDidLoad]; // In this case, we instantiate the banner with desired ad size. self.bannerView = [[GADBannerView alloc] initWithAdSize:GADAdSizeBanner]; [self addBannerViewToView:self.bannerView]; } ‐ (void)addBannerViewToView:(UIView *)bannerView { bannerView.translatesAutoresizingMaskIntoConstraints = NO; [self.view addSubview:bannerView]; [self.view addConstraints:@[ [NSLayoutConstraint constraintWithItem:bannerView attribute:NSLayoutAttributeBottom relatedBy:NSLayoutRelationEqual toItem:self.bottomLayoutGuide attribute:NSLayoutAttributeTop multiplier:1 constant:0], [NSLayoutConstraint constraintWithItem:bannerView attribute:NSLayoutAttributeCenterX relatedBy:NSLayoutRelationEqual toItem:self.view kattribute:NSLayoutAttributeCenterX multiplier:1 constant:0] ]]; } - (void)adViewDidReceiveAd:(GADBannerView *)bannerView { NSString *adResponseId = bannerView.responseInfo.responseId; if (adResponseId) { NSLog(@"adViewDidReceiveAd from network: %@ with response Id: %@", bannerView.responseInfo.adNetworkClassName, adResponseId); [[FIRCrashlytics crashlytics] setCustomValue:adResponseId forKey:@"banner_ad_response_id"]; } } @end
Поздравляем! Теперь вы увидите последний adResponseId в разделе ключей краш-сессий на панели управления Crashlytics. Обратите внимание, что некоторые ключи могут появиться на панели управления в течение часа.
