תחילת העבודה עם Crashlytics לפלטפורמות של אפל

בחירת פלטפורמה: iOS+‎ Android Android NDK Flutter Unity


במדריך הזה מוסבר איך להתחיל להשתמש ב-Firebase Crashlytics באפליקציה לפלטפורמות של אפל (לדוגמה, אפליקציה ל-iOS).

אחרי שמגדירים את ה-SDK של Firebase Crashlytics באפליקציה, אפשר לקבל דוחות קריסה מקיפים במסוף Firebase. עם Crashlytics לפלטפורמות של אפל, אתם מקבלים דוחות על קריסות ושגיאות לא קריטיות.

כדי לקבל עזרה מ-AI, מעתיקים את ההנחיה שבהמשך לסוכן התכנות מבוסס ה-AI (כמו Antigravity, ‏Claude Code, ‏Codex ו-Cursor). אתם יכולים להתאים אישית את ההנחיה ולשפר את הסוכן. מידע מפורט על ההתקנה זמין במאמר סקילים אג'נטיים ב-Firebase. 

Help me use Firebase in my app.
1. Make sure that **Firebase agent skills** are installed and updated. For Claude Code, Codex, or Cursor agents, help me install the Firebase plugin. For other agents, run `npx skills add firebase/agent-skills`.  Always try to use **Firebase agent skills** for Firebase-related tasks.
2. Help me set up Firebase Crashlytics for my app.

לפני שמתחילים

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

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

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

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

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

    שימו לב שיומני פעולות המשתמש זמינים בכל הפלטפורמות של אפל שנתמכות על ידי Crashlytics, חוץ מ-watchOS.

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

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

  1. ב-Xcode, כשהפרויקט של האפליקציה פתוח, עוברים אל File > Add Packages (קובץ > הוספת חבילות).
  2. כשמוצגת בקשה, מוסיפים את מאגר ה-SDK של Firebase לפלטפורמות של אפל:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. בוחרים את הספרייה Crashlytics.
  4. כדי להשתמש ביומני פעולות משתמש, צריך להוסיף לאפליקציה גם את Firebase SDK for Google Analytics. חשוב לוודא שGoogle Analytics מופעל בפרויקט Firebase.
  5. מוסיפים את הדגל -ObjC לקטע Other Linker Flags (דגלים אחרים של מקשרים) בהגדרות ה-build של היעד.
  6. (macOS בלבד) בקובץ Info.plist, מוסיפים את המפתח NSApplicationCrashOnExceptions ומגדירים אותו כ-YES.
  7. אחרי שתסיימו, פלטפורמת Xcode תתחיל לטפל ביחסי התלות ולהוריד אותם באופן אוטומטי ברקע.

בשלב הבא, מגדירים את מודול Firebase:

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

    Swift 

    import Firebase

    Objective-C 

    @import Firebase;

  2. מגדירים מופע משותף של FirebaseApp, בדרך כלל ב-method‏ application(_:didFinishLaunchingWithOptions:) של ה-delegate של האפליקציה:

    Swift 

    // 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 כך שיפיק באופן אוטומטי את קובצי ה-dSYM, יעבד אותם ויעלה את הקבצים בכל פעם שאתם יוצרים את האפליקציה.

  1. פותחים את סביבת העבודה של הפרויקט ב-Xcode ובוחרים את קובץ הפרויקט בסרגל הניווט שמימין.

  2. ברשימה TARGETS, בוחרים את יעד ה-build הראשי.

  3. לוחצים על הכרטיסייה Build Settings (הגדרות גרסאות build) ומשלימים את השלבים הבאים כדי ש-Xcode ייצור קובצי dSYM לגרסאות ה-build.

    1. לוחצים על הכול ומחפשים את debug information format.

    2. מגדירים את Debug Information Format ל-DWARF with dSYM File לכל סוגי ה-build.

  4. לוחצים על הכרטיסייה Build Phases (שלבי פיתוח) ומבצעים את השלבים הבאים כדי ש-Xcode יוכל לעבד את קובצי ה-dSYM ולהעלות אותם.

    1. לוחצים על > New Run Script Phase.

      חשוב לוודא שהשלב החדש של Run Script הוא שלב ה-build האחרון של הפרויקט, אחרת Crashlytics לא יוכל לעבד קובצי dSYM כמו שצריך.

    2. מרחיבים את הקטע החדש Run Script.

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

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

      "${BUILD_DIR%/Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run"

    4. בקטע Input Files, מוסיפים את הנתיבים למיקומים של הקבצים הבאים:

      ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}
       
      ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${PRODUCT_NAME}
       
      ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Info.plist
       
      $(TARGET_BUILD_DIR)/$(UNLOCALIZED_RESOURCES_FOLDER_PATH)/GoogleService-Info.plist
       
      $(TARGET_BUILD_DIR)/$(EXECUTABLE_PATH)
       אם בהגדרות ה-build של הפרויקט יש את ENABLE_USER_SCRIPT_SANDBOXING=YES ו-ENABLE_DEBUG_DYLIB=YES, צריך לכלול את הקוד הבא: 
      ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${PRODUCT_NAME}.debug.dylib

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

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

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

  1. מוסיפים לאפליקציה קוד שמאפשר לאלץ קריסה לבדיקה.

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

    SwiftUI 

    Button("Crash") {
  fatalError("Crash was triggered")
}

    UIKit

    Swift 

    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 מנותק.

    1. לוחצים על Build and then run the current scheme כדי ליצור את האפליקציה במכשיר בדיקה או בסימולטור.

    2. מחכים עד שהאפליקציה תפעל, ואז לוחצים על Stop running the scheme or action כדי לסגור את המכונה הראשונית של האפליקציה. המכונה הראשונית הזו כללה את מנקה הבאגים שמפריע ל-Crashlytics.

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

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

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

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

  4. במסוף Firebase, נכנסים לדף DevOps & Engagement (DevOps ומעורבות) > לוח הבקרה של Crashlytics כדי לבדוק את דוח הקריסה לבדיקה.

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


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

השלבים הבאים