Catch up on everthing we announced at this year's Firebase Summit. Learn more

התחל בעבודה עם Creblytics של Firebase

התחלה מהירה זו מתארת ​​כיצד להגדיר את Firebase Crashlytics באפליקציה שלך עם Firebase Crashlytics SDK כדי שתוכל לקבל דוחות קריסה מקיפים במסוף 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: הפעל Crashlytics במסוף Firebase

  1. עבור אל לוח המחוונים Crashlytics במסוף Firebase.

  2. ודאו שהאפליקציה שלכם נבחרת מתוך התפריט הנפתח לצד Crashlytics בראש הדף.

  3. לחץ אפשר Crashlytics.

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

השתמש ב-Swift Package Manager כדי להתקין ולנהל תלות ב-Firebase.

  1. בשנת Xcode, עם פרויקט היישום שלך פתוח, נווט אל קובץ> חבילות סוויפט> הוסף תלות חבילה.
  2. כאשר תתבקש, הוסף את מאגר Firebase Apple platforms 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 ב שלך UIApplicationDelegate :

    מָהִיר

    import Firebase

    Objective-C

    @import Firebase;
  2. & Nbsp הגדר FirebaseApp משותף למשל, בדרך כלל של האפליקציה שלך application:didFinishLaunchingWithOptions: השיטה:

    מָהִיר

    // Use the Firebase library to configure APIs.
    FirebaseApp.configure()
    

    Objective-C

    // Use the Firebase library to configure APIs.
    [FIRApp configure];
    

שלב 3: הגדרת Xcode להעלות קבצים dSYM אוטומטי

כדי להפיק דוחות קריאות קריאות אנושיים, Crashlytics זקוק לקבצי סמל ניפוי באגים (dSYM) של הפרויקט שלך. השלבים הבאים מתארים כיצד להגדיר את Xcode לייצר אוטומטית את ה-dSYMs שלך, לעבד אותם ולהעלות את הקבצים בכל פעם שאתה בונה את האפליקציה שלך.

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

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

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

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

    2. פורמט מידע Debug גדר ננס עם dSYM קובץ לכול סוגי הלבנות שלך.

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

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

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

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

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

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

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

      • הוסף את הנתיב לקבצי dSYM של הפרויקט שלך

        זה מאפשר ל-Crashlytics לעבד dSYMs עבור אפליקציות גדולות מהר יותר.

        ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${TARGET_NAME}
      • מוסיפים את הנתיב אל בנה של הפרויקט שלך Info.plist קובץ

        זה מאפשר ל-Crashlytics לשייך גרסת אפליקציה ל-dSYMs.

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

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

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

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

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

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

    מָהִיר

    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. השתמש בשלבים הבאים כדי להבטיח שמכשיר הבדיקה או הסימולטור שלך מנותקים ממאתר הבאגים של Xcode (מה שמפריע ל-Crashlytics).

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

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

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

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

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

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

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

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


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

הצעדים הבאים