Firebase Crashlytics là một trình báo cáo sự cố gọn nhẹ, theo thời gian thực giúp bạn dễ dàng quản lý các vấn đề về độ ổn định trong ứng dụng của mình. Crashlytics giúp bạn tiết kiệm thời gian khắc phục sự cố bằng cách nhóm các sự cố một cách rõ ràng và làm nổi bật những trường hợp dẫn đến các sự cố đó.
Hướng dẫn này mô tả cách tích hợp Crashlytics vào dự án Xcode để bạn có thể ghi nhật ký mã phản hồi quảng cáo. Sau này, khi khắc phục sự cố trong ứng dụng, bạn có thể tra cứu mã phản hồi quảng cáo và sử dụng Trung tâm xem xét quảng cáo trong AdMob để tìm và chặn quảng cáo.
Bước 1: Thêm Firebase vào một ứng dụng iOS
Nếu muốn thử ghi nhật ký bằng Firebase trong một ứng dụng sạch, bạn có thể tải hoặc sao chép các ví dụ về SDK quảng cáo trên thiết bị di động của Google cho kho lưu trữ iOS trên GitHub. Cụ thể, hướng dẫn này sử dụng Ví dụ về quảng cáo biểu ngữ.
Nếu đã có một ứng dụng, bạn có thể chuyển sang các bước khác bằng mã nhận dạng gói của ứng dụng đó. Bạn cũng có thể áp dụng các bước tương tự cho các ví dụ khác trong kho lưu trữ bằng các điều chỉnh nhỏ.
Để sử dụng Firebase Crashlytics, bạn phải tạo một dự án Firebase và thêm ứng dụng của bạn vào dự án đó. Hãy tạo một dự án Firebase nếu bạn chưa tạo. Hãy nhớ đăng ký ứng dụng của bạn cho dự án đó.
Trên trang Crashlytics trong bảng điều khiển của Firebase, hãy nhấp vào Thiết lập Crashlytics.
Trên màn hình xuất hiện, hãy nhấp vào Không > Thiết lập ứng dụng Firebase mới.
Trong Podfile, hãy thêm các Nhóm cho Google Analytics và 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
Trên Cửa sổ dòng lệnh hoặc lời nhắc lệnh, hãy cài đặt và cập nhật Nhóm của bạn:
pod install --repo-update
Mở tệp
BannerExample.xcworkspace
cho Xcode để tải dự án.
Bước 2: Định cấu hình Firebase cho ứng dụng của bạn
Swift
Trong AppDelegate.swift
, hãy thêm các dòng sau:
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
Trong AppDelegate.m
, hãy thêm các dòng sau:
@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; }
Trong Xcode, hãy mở phần Cài đặt bản dựng, nhấp vào thẻ Tạo giai đoạn. Thêm tập lệnh chạy Fabric:
Dọn dẹp thư mục bản dựng của bạn; sau đó tạo và chạy ứng dụng. Bây giờ, bạn có thể đăng nhập vào bảng điều khiển web của Firebase và truy cập vào trang tổng quan của Crashlytics.
(Không bắt buộc): Kiểm tra thông tin thiết lập của bạn
Bằng cách Thêm nút sự cố, bạn có thể xác định sự cố gây ra một sự cố ứng dụng sau mỗi lần nhấn nút. Quá trình thiết lập thử nghiệm này sẽ kích hoạt mã ở Bước 3 để gửi nhật ký tuỳ chỉnh đến trang tổng quan Firebase Crashlytic.
Swift
Trong ViewController.swift
, hãy thêm các dòng sau vào hàm 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) }
Sau đó, hãy thêm @IBAction
này vào cuối phần khai báo về lớp:
@IBAction func crashButtonTapped(_ sender: AnyObject) { fatalError("Test Crash Happened") }
Objective-C
Trong ViewController.m
, hãy thêm các dòng sau vào phương thức 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]; }
Sau đó, hãy thêm IBAction
này vào cuối phần khai báo về lớp:
‐ (IBAction)crashButtonTapped:(id)sender { assert(NO); }
Trong thanh công cụ Xcode, hãy nhấn vào nút Stop (Dừng), sau đó chạy lại ứng dụng thông qua một trình mô phỏng. Sau khi tải ứng dụng, bạn có thể nhấp vào nút Sự cố. Quay lại Xcode và nhấp vào nút Phát để tải nhật ký sự cố lên Crashlytics.
Bước 3: Ghi nhật ký mã phản hồi quảng cáo
Nếu tải nhiều quảng cáo và hiển thị các quảng cáo đó vào các thời điểm khác nhau, bạn nên
ghi nhật ký từng mã phản hồi quảng cáo bằng một khoá riêng. Ví dụ: hướng dẫn này sử dụng
ví dụ chỉ có một quảng cáo biểu ngữ. Do đó, chúng tôi ghi nhật ký mã phản hồi quảng cáo làm khoá
banner_ad_response_id
trong đoạn mã sau.
Bạn cũng có thể tạo nhiều cặp giá trị / khoá tuỳ chỉnh trong Firebase Crashlytics cho nhiều loại quảng cáo và sự kiện quảng cáo. Hãy tham khảo thông báo về vòng đời của yêu cầu quảng cáo để biết
- Quảng cáo biểu ngữ
- Quảng cáo xen kẽ
- Quảng cáo gốc hợp nhất
- Quảng cáo có tặng thưởng
- Video có tặng thưởng
Hãy xem bài viết Tuỳ chỉnh báo cáo sự cố trong Firebase Crashlytics để biết thêm thông tin về cách ghi nhật ký tuỳ chỉnh.
Swift
Thêm mã sau vào ViewController.swift
của bạn. Về cơ bản, mã này sử dụng hàm Crashlytics.setCustomValue()
trong hàm callback adViewDidReceiveAd
.
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
Thêm mã sau vào ViewController.m
của bạn. Về cơ bản, hàm này sử dụng hàm
[FIRCrashlytics crashlytics]
setCustomValue
trong hàm 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
Xin chúc mừng! Bây giờ, bạn sẽ thấy adResponseId
gần đây nhất trong mục
khoá của các phiên hoạt động có sự cố trên trang tổng quan Crashlytics. Xin lưu ý rằng
có thể mất tới một giờ thì một số khoá mới xuất hiện trên trang tổng quan của bạn.