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

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

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

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

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

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

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

שלב 1: הפעל Crashlytics במסוף Firebase

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

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

  3. לחץ אפשר Crashlytics.

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

  1. פתח את podfile שיצרת עבור פרויקט Firebase שלך ולהוסיף את FirebaseCrashlytics תרמיל.

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

    pod 'Firebase/Crashlytics'
    
    # Recommended: Add the Firebase pod for Google Analytics
    pod 'Firebase/Analytics'
    
  2. התקן את התרמילים, אז לפתוח מחדש שלך .xcworkspace קובץ כדי לראות את הפרויקט ב Xcode:

    pod install
    open your-project.xcworkspace
    
  3. ייבא את מודול Firebase ב שלך UIApplicationDelegate :

    מָהִיר

    import Firebase

    Objective-C

    @import Firebase;
  4. & 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 לייצר אוטומטית את ה- dSYM שלך, לעבד אותם ולהעלות את הקבצים בכל פעם שאתה בונה את האפליקציה שלך.

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

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

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

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

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

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

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

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

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

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

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

      "${PODS_ROOT}/FirebaseCrashlytics/run"
    4. בקטע קבצי הקלט, להוסיף נתיבים עבור הקבצים הבאים.

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

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

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

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

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

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

שלב 4: הפעל את הפרויקט

הפעל את האפליקציה שלך. יומני המכשיר שלך אמורים להציג את אימות Firebase שהאתחול הושלם.

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

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

לפרטים על איך לעשות את זה, לבקר מבחן הביצוע שלך .

הצעדים הבאים