Firebase Crashlytics 是輕量的即時當機回報工具，可讓您輕鬆管理應用程式的穩定性問題。Crashlytics 能以智慧型方式將當機事件分組，並醒目顯示引發當機情況的情況，為您節省疑難排解時間。
本指南說明如何將 Crashlytics 整合至 Xcode 專案，以便記錄廣告回應 ID。日後，當您要排解應用程式當機問題時，可以查詢廣告回應 ID，並使用 AdMob 中的廣告審核中心，找出並封鎖廣告。
步驟 1：將 Firebase 新增至 iOS 應用程式
如果您想嘗試透過 Firebase 從乾淨應用程式記錄資料，可以下載或複製 GitHub 上的 iOS 版 Google 行動廣告 SDK 範例存放區。本指南特別使用 橫幅廣告範例。
如果您已有應用程式，應該可以繼續執行其他步驟，並使用應用程式的軟體包 ID。相同的步驟也適用於存放區中的其他範例，只需進行微幅調整。
如要使用 Firebase Crashlytics，您必須建立 Firebase 專案，並將應用程式新增至該專案。如果您尚未建立 Firebase 專案，請先建立。請務必將應用程式註冊至該服務。
在 Firebase 控制台的 Crashlytics 頁面中，按一下「Set up Crashlytics」(設定 Crashlytics)。
在隨即顯示的畫面中，依序按一下「否」>「建立新的 Firebase 應用程式」。
在 Podfile 中新增 Google Analytics 和 Firebase Crashlytics 的 Pod。
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：
pod install --repo-update
開啟
BannerExample.xcworkspace檔案，讓 Xcode 載入專案。
步驟 2：為應用程式設定 Firebase
Swift
在 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 中開啟「Build Settings」，然後按一下「Build Phases」分頁標籤。新增 Fabric 執行指令碼：
清理建構資料夾，然後建構並執行應用程式。現在您可以登入 Firebase 網頁版控制台，並存取 Crashlytics 資訊主頁。
(選用)：測試設定
新增當機按鈕後，您可以強制當機，讓每次按下按鈕都導致應用程式當機。這項測試設定會觸發步驟 3 中的程式碼，將自訂記錄傳送至 Firebase Crashlytic 資訊主頁。
Swift
在 ViewController.swift 中，將下列行新增至 viewDidLoad() 函式：
override func viewDidLoad() {
super.viewDidLoad()
print("Google Mobile Ads SDK version: \(GADRequest.sdkVersion())")
bannerView.delegate = self
bannerView.adUnitID = "ca-app-pub-3940256099942544/2934735716"
bannerView.rootViewController = self
bannerView.load(GADRequest())
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 工具列中按下「Stop」按鈕，然後透過模擬器重新啟動應用程式。應用程式載入後，您可以按一下「Crash」按鈕。返回 Xcode 並按一下「Play」(播放) 按鈕，即可將當機記錄上傳至 Crashlytics。
步驟 3：記錄廣告回應 ID
如果您載入多個廣告並在不同時間顯示，建議您為每個廣告回應 ID 使用不同的鍵來記錄。舉例來說，本指南使用的範例只有一個橫幅廣告。因此，我們會在以下程式碼片段中，將廣告回應 ID 記錄為 banner_ad_response_id 鍵。
您也可以在 Firebase Crashlytics 中為不同的廣告類型和廣告事件建立多個自訂鍵/值組合。請參閱廣告請求生命週期通知的
如要進一步瞭解自訂記錄，請參閱「自訂 Firebase Crashlytics 當機報告」。
Swift
將下列程式碼新增至 ViewController.swift。基本上，此函式會使用 adViewDidReceiveAd 回呼函式中的 Crashlytics.setCustomValue() 函式。
import GoogleMobileAds
import UIKit
class ViewController: UIViewController, GADBannerViewDelegate {
/// The banner view.
@IBOutlet weak var bannerView: GADBannerView!
override func viewDidLoad() {
super.viewDidLoad()
...
bannerView.delegate = self
...
}
/// Tells the delegate an ad request loaded an ad.
func adViewDidReceiveAd(_ bannerView: GADBannerView) {
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。基本上，此方法會使用 adViewDidReceiveAd 函式中的 [FIRCrashlytics crashlytics]
setCustomValue 函式。
@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
恭喜！Crashlytics 資訊主頁的當機工作階段主要部分會顯示最新的 adResponseId。請注意，部分鍵可能需要一小時才會顯示在資訊主頁中。
