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

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

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

    אובייקטיבי-ג

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

    מָהִיר

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

    אובייקטיבי-ג

    // 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 לעבד dSYM לאפליקציות גדולות מהר יותר.

        ${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: חיל התרסקות מבחן כדי לסיים את ההגדרה

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


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

הצעדים הבאים