Firebase Crashlytics to prosty raport o awariach w czasie rzeczywistym, który ułatwia zarządzanie problemami ze stabilnością aplikacji. Crashlytics pozwala szybko rozwiązywać problemy dzięki inteligentnemu grupowaniu awarii i wyróżnianiu okoliczności, które je spowodowały.
Ten przewodnik opisuje, jak zintegrować Crashlytics z projektem Xcode, by rejestrować identyfikatory odpowiedzi na reklamy. Później, podczas rozwiązywania problemów z awariami aplikacji, możesz wyszukać identyfikator odpowiedzi na reklamę i skorzystać z Centrum oceny reklam w AdMob , aby znaleźć i zablokować reklamy.
Krok 1. Dodaj Firebase do aplikacji na iOS
Jeśli chcesz zalogować się w Firebase z czystej aplikacji, możesz pobrać lub skopiować z GitHuba przykładowe repozytorium pakietu SDK do reklam mobilnych Google na iOS. W tym przewodniku używany jest Przykład banera.
Jeśli masz już aplikację, możesz wykonać inne kroki, używając identyfikatora pakietu swojej aplikacji. Te same czynności można też zastosować do innych przykładów w repozytorium z niewielkimi zmianami.
Aby korzystać z Firebase Crashlytics, musisz utworzyć projekt Firebase i dodać do niego swoją aplikację. Utwórz projekt Firebase, jeśli jeszcze go nie masz. Pamiętaj, aby zarejestrować w nim swoją aplikację.
Na stronie Crashlytics w konsoli Firebase kliknij Skonfiguruj Crashlytics.
Na wyświetlonym ekranie kliknij Nie > Skonfiguruj nową aplikację Firebase.
W pliku Podfile dodaj pody Google Analytics i 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
Zainstaluj i zaktualizuj pody w terminalu lub w wierszu polecenia:
pod install --repo-update
Otwórz plik
BannerExample.xcworkspacedla Xcode, aby wczytać projekt.
Krok 2. Skonfiguruj Firebase dla swojej aplikacji
Swift
W AppDelegate.swift dodaj te wiersze:
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
W AppDelegate.m dodaj te wiersze:
@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;
}
W Xcode otwórz Ustawienia kompilacji i kliknij kartę Etapy kompilacji. Dodaj skrypt uruchamiania Fabric:
Wyczyść folder kompilacji, a potem skompiluj i uruchom aplikację. Teraz możesz się zalogować do konsoli internetowej Firebase i uzyskać dostęp do panelu Crashlytics.
(Opcjonalnie). Testowanie konfiguracji
Dodając przycisk awarii, możesz wymuszać awarię aplikacji przy każdym naciśnięciu przycisku. Ta konfiguracja testowa aktywuje kod w kroku 3 służący do wysyłania logów niestandardowych do paneli Firebase Crashlytic.
Swift
W ViewController.swift dodaj do funkcji viewDidLoad() te wiersze:
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)
}
Następnie dodaj element @IBAction u dołu deklaracji zajęć:
@IBAction func crashButtonTapped(_ sender: AnyObject) {
fatalError("Test Crash Happened")
}
Objective-C
W ViewController.m dodaj do metody viewDidLoad te wiersze:
‐ (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];
}
Następnie dodaj element IBAction u dołu deklaracji zajęć:
‐ (IBAction)crashButtonTapped:(id)sender {
assert(NO);
}
Na pasku narzędzi Xcode naciśnij przycisk Stop, a następnie ponownie uruchom aplikację za pomocą symulatora. Po załadowaniu aplikacji możesz kliknąć przycisk Awarie. Wróć do Xcode i kliknij przycisk Odtwórz, by przesłać dziennik awarii do Crashlytics.
Krok 3. Zapisz identyfikator odpowiedzi na reklamę
Jeśli wczytujesz wiele reklam i wyświetlasz je w różnym czasie, warto rejestrować każdy identyfikator odpowiedzi na reklamę za pomocą osobnego klucza. W tym przewodniku wykorzystamy przykład
z tylko 1 banerem reklamowym. Dlatego identyfikator odpowiedzi na reklamę rejestrujemy jako klucz banner_ad_response_id w poniższym fragmencie.
W Firebase Crashlytics możesz też utworzyć wiele niestandardowych par klucz / wartość na potrzeby różnych typów reklam i zdarzeń reklamowych. Zapoznaj się z powiadomieniami o cyklu życia żądania reklamy
- Banners
- Reklamy pełnoekranowe
- Ujednolicone reklamy natywne
- Reklama z nagrodą
- Reklama wideo z nagrodą
Więcej informacji o logowaniu niestandardowym znajdziesz w artykule Dostosowywanie raportów o awariach Firebase Crashlytics.
Swift
Dodaj ten kod do karty ViewController.swift. Zasadniczo używa on funkcji Crashlytics.setCustomValue() w funkcji wywołania zwrotnego 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
Dodaj ten kod do karty ViewController.m. Zasadniczo używa on funkcji [FIRCrashlytics crashlytics]
setCustomValue w funkcji 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
Gratulacje! Najnowsze adResponseId będzie teraz widoczne w sekcji najważniejszych sesji awarii w panelu Crashlytics. Niektóre klucze mogą być widoczne w panelu dopiero po upływie godziny.
