Check out what’s new from Firebase at Google I/O 2022. Learn more

התחל עם Firebase Crashlytics

QuickStart זה מתאר כיצד להגדיר Firebase Crashlytics באפליקציה עם SDK Firebase Crashlytics כך שתוכל לקבל דוחות הקריסה מקיף במסוף Firebase.

הגדרת Crashlytics דורש משימות הן Firebase קונסולת ה- IDE שלך (כמו הוספת קובץ תצורה Firebase ואת Crashlytics SDK). כדי התקנת סיום, אתה תצטרך לכפות התרסקות מבחן שליחת דוח הקריסה הראשונה שלך Firebase.

לפני שאתה מתחיל

  1. אם לא עשית זאת עדיין, להוסיף Firebase לפרויקט האפל שלך. אם אין לך אפליקציה אפלה, אתה יכול להוריד אפליקציה לדוגמה .

  2. מומלץ : כדי לקבל תכונות כמו משתמשי התרסקות ללא, יומני סימני דרך התראות מהירות, אתה צריך להפעיל את Google Analytics בפרויקט Firebase שלך.

    פלטפורמות כל אפל נתמך על ידי Crashlytics (למעט watchOS) יכולים לנצל את התכונות האלה ב- Google Analytics. שים לב שאתה צריך SDK v8.9.0 + עבור יישומי MacOS ו- tvOS.

    • אם הפרויקט Firebase הקיים שלך אין Google Analytics מופעלת, תוכל להפעיל את Google Analytics מן הכרטיסייה ואינטגרציות של שלך > הגדרות הפרויקט במסוף Firebase.

    • אם אתה יוצר פרויקט Firebase חדש, שתאפשר את Google Analytics במהלך העבודה ליצירת פרויקט.

שלב 1 : מוסיפים את Firebase Crashlytics SDK באפליקציה

השתמש סוויפט Package Manager כדי להתקין ולנהל תלות Firebase.

  1. בשנת Xcode, עם פתוח פרוייקט היישום שלך, נווט אל קובץ> הוסף חבילות .
  2. כשתתבקש, להוסיף את פלטפורמות Firebase אפל SDK והמאגר:
  3.   https://github.com/firebase/firebase-ios-sdk
      
  4. בחר את ספריית Crashlytics.
  5. לקבלת חווית שימוש אופטימלית עם Crashlytics, אנו ממליצים לאפשר ל- Google Analytics בפרויקט Firebase שלך והוספת SDK Firebase עבור Google Analytics באפליקציה. אתה יכול לבחור באחת לספרייה בלי אוסף IDFA או עם אוסף IDFA.
  6. בסיום, Xcode יחל באופן אוטומטי לפתרון והורדת התלות שלך ברקע.

כעת, הגדירו את מודול Firebase:

  1. ייבא את מודול Firebase ב שלך App מהמבנים או UIApplicationDelegate :

    מָהִיר

    import Firebase

    Objective-C

    @import Firebase;
  2. & Nbsp הגדר FirebaseApp משותף למשל, בדרך כלל שלך App של מאתחל או אצל הנציג האפליקציה שלך 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 לייצר dSYMs שלך באופן אוטומטי, לעבד אותם, ולהעלות את הקבצים בכל פעם שאתה לבנות את האפליקציה שלך.

  1. פתח סביבת עבודת Xcode של הפרויקט שלך, ולאחר מכן בחר קובץ הפרויקט שלה נווט השמאל.

  2. מרשימת המטרות, לבחור יעד לבנות העיקרי שלך.

  3. לחץ על כרטיסיית הגדרות Build , ולאחר מכן להשלים את השלבים הבאים כדי Xcode מייצרת dSYMs עבור שלך בונה.

    1. לחץ על כל , ואז לחפש debug information format .

    2. פורמט מידע Debug DWARF with dSYM File לכול סוגי הלבנות שלך.

  4. לחץ על כרטיסיית שלבי Build , ולאחר מכן להשלים את השלבים הבאים כדי Xcode יכול לעבד dSYMs שלך ולהעלות את הקבצים.

    1. לחץ > שלב סקריפט חדש הפעלה .

      ודאו שלב סקריפט ההפעלה חדש זו הוא השלב האחרון הלבן של הפרויקט; אחרת, Crashlytics לא יכול לעבד dSYMs כראוי.

    2. להרחיב בקטע הפעל סקריפט החדש.

    3. בתחום סקריפט (הממוקם תחת תווית Shell ), מוסיף את תסריט הריצה הבאה.

      סקריפט זה מעבד קבצי dSYM של הפרויקט שלך וטעינת קבצי Crashlytics.

      "${BUILD_DIR%/Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run"
    4. בקטע קבצי הקלט , להוסיף נתיבים עבור המיקומים של הקבצים הבאים:

      • המיקום של קבצי dSYM של הפרויקט:

        ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${TARGET_NAME}

        לנו את המיקום של קבצי dSYM של הפרוייקט מאפשר Crashlytics לתהליך dSYMs עבור יישומים גדולים יותר מהר.

      • מיקומו של הפרויקט שלך בנוי Info.plist הקובץ :

        $(SRCROOT)/$(BUILT_PRODUCTS_DIR)/$(INFOPLIST_PATH)

        לנו את המיקום של בנה של הפרויקט שלך Info.plist קובץ מאפשר Crashlytics לשייך את גרסת האפליקציה עם dSYMs.

לקבלת מידע מפורט יותר על קבצי dSYM ו Crashlytics (כולל העלאת קבצי dSYM ידנית), ביקור קבל deobfuscated ודוחות קריסה .

שלב 3 : חיל התרסקות מבחן כדי לסיים את ההגדרה

כדי לסיים את הגדרת Crashlytics ותראו נתונים ראשוניים בלוח המחוונים Crashlytics של קונסולת Firebase, אתה צריך להכריח התרסקות מבחן.

  1. הוספת קוד ליישום שאתה יכול להשתמש בו כדי להכריח התרסקות מבחן.

    אתה יכול להשתמש בקוד הבא כדי להוסיף לחצן האפליקציה שלך כי, כאשר נלחץ, גורמת להתרסקות. הלחצן שכותרתו "Crash Test".

    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
    
  2. לבנות ולהפעיל את האפליקציה שלך Xcode.

    1. לחץ לבנות ולהפעיל את הערכה הנוכחית לבנות את האפליקציה למכשיר בדיקה או סימולטור.

    2. חכה עד שהיישום פועל, ולאחר מכן לחץ על עצור הפעלת התכנית או פעולה כדי לסגור את המופע הראשוני של האפליקציה שלך. למשל הראשוני כלל את הבאגים המפריע Crashlytics.

  3. להכריח את התרסקות המבחן כדי לשלוח את דוח הקריסה הראשון של האפליקציה שלך:

    1. פתח את אפליקצית ממסך הבית של המכשיר או סימולטור המבחן שלך.

    2. באפליקציה שלך, ולחץ על כפתור "מבחן ההתרסקות" שהוספת באמצעות הקוד לעיל.

    3. אחרי האפליקציה שלך קורסת, להפעיל אותו שוב Xcode כך שהאפליקציה שלכם יכולה לשלוח את הדו"ח לקרוס אל Firebase.

  4. עבור אל לוח המחוונים Crashlytics של קונסולת Firebase לראות התרסקות הבדיקה שלך.

    אם שתרענן את הקונסולה ואתה עדיין לא רואה את התרסקות המבחן אחרי חמש דקות, להפעיל רישום debug כדי לראות אם היישום שלך שולח ודוחות קריסה.


וזה הכל! Crashlytics כעת ניטור של האפליקציה עבור קריסות. בקר המחוונים Crashlytics להציג לחקור את כל הדוחות והנתונים הסטטיסטיים.

הצעדים הבאים