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

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

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

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

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

  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. הורד את ה- SDK האחדות Firebase , אז לפתוח את SDK איפשהו נוח.

    Firebase Unity SDK אינו ספציפי לפלטפורמה.

  2. בפרויקט האחדות פתוח, נווט הנכסים> חבילת יבוא> חבילה מותאמת אישית.

  3. מתוך SDK רוכסן, ובחר לייבא את ה- SDK Crashlytics ( FirebaseCrashlytics.unitypackage ).

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

  4. בחלון חבילת אחדות ייבוא, לחץ על ייבוא.

שלב 3: Initialize Crashlytics

  1. צור סקריפט # C חדש, ולאחר מכן להוסיף אותו GameObject בסצנה.

    1. פתח הסצינה הראשונה שלך, ולאחר מכן ליצור ריק GameObject בשם CrashlyticsInitializer .

    2. לחץ להוסיף רכיב של המפקח על האובייקט החדש.

    3. בחר שלך CrashlyticsInit סקריפט כדי להוסיף אותו CrashlyticsInitializer האובייקט.

  2. Initialize Crashlytics בבית של תסריט Start שיטה:

    using System.Collections;
    using System.Collections.Generic;
    using UnityEngine;
    
    // Import Firebase
    using Firebase;
    
    public class CrashlyticsInit : MonoBehaviour {
        // Use this for initialization
        void Start () {
            // Initialize Firebase
            Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(task => {
                var dependencyStatus = task.Result;
                if (dependencyStatus == Firebase.DependencyStatus.Available)
                {
                    // Create and hold a reference to your FirebaseApp,
                    // where app is a Firebase.FirebaseApp property of your application class.
                    // Crashlytics will use the DefaultInstance, as well;
                    // this ensures that Crashlytics is initialized.
                    Firebase.FirebaseApp app = Firebase.FirebaseApp.DefaultInstance;
    
                    // Set a flag here for indicating that your project is ready to use Firebase.
                }
                else
                {
                    UnityEngine.Debug.LogError(System.String.Format(
                      "Could not resolve all Firebase dependencies: {0}",dependencyStatus));
                    // Firebase Unity SDK is not safe to use here.
                }
            });
        }
    
      // Update is called once per frame
      void Update()
        // ...
    }

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

  1. ייצא את הפרויקט שלך ל- iOS או ל- Android.

  2. לאחר השלמת הייצוא, ודא שהפרויקט מיוצא כהלכה על ידי השוואת הפרויקט המיוצא שלך לתצורות הייצוא לדוגמא להלן.

    אם נראה שקבצים חסרים לאחר השוואת הפרויקט שלך, פתח את עורך האחדות שלך ולאחר מכן הפעל את פותר שירותי Google Play (מצא את ההוראות להלן).

    iOS

    דְמוּי אָדָם

הפעל המפענח אם קבצים חסרים לאחר הייצוא (לפי הצורך)

פתרונות שירותי Google Play מוודאים שלפרויקט Unity שלך יש את התלות המתאימות לייצוא האפליקציה שלך ל- iOS או ל- Android. לקבלת מידע נוסף על המפענח, לבקר README עבור Resolver Jar האחדות .

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

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

  1. מחלון ההיררכיה, ליצור אובייקט חדש:

    1. קליק ימני ובחר צור רוקן להוסיף חדשים ריק GameObject כדי סצנה במשחק שלך.

    2. שם האובייקט החדש CrashlyticsTester .

    3. ודא CrashlyticsTester האובייקט שנבחר לפני שתמשיך.

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

    1. לחץ להוסיף רכיב.

    2. בחר סקריפט חדש בתחתית רשימת המרכיבים.

    3. שם התסריט החדש CrashlyticsTester כמו גם, ואז מוסיפים את התוכן הבא בסקריפט:

      using System;
      using UnityEngine;
      
      public class CrashlyticsTester : MonoBehaviour {
      
          int updatesBeforeException;
      
          // Use this for initialization
          void Start () {
            updatesBeforeException = 0;
          }
      
          // Update is called once per frame
          void Update()
          {
              // Call the exception-throwing method here so that it's run
              // every frame update
              throwExceptionEvery60Updates();
          }
      
          // A method that tests your Crashlytics implementation by throwing an
          // exception every 60 frame updates. You should see non-fatal errors in the
          // Firebase console a few minutes after running your app with this method.
          void throwExceptionEvery60Updates()
          {
              if (updatesBeforeException > 0)
              {
                  updatesBeforeException--;
              }
              else
              {
                  // Set the counter to 60 updates
                  updatesBeforeException = 60;
      
                  // Throw an exception to test your Crashlytics implementation
                  throw new System.Exception("test exception please ignore");
              }
          }
      }
      
  3. בנה והפעל את האפליקציה שלך:

    1. עבור אל קובץ> הגדרת Build, אז לבחור אנדרואיד או iOS מרשימת פלטפורמות.

    2. לחץ לבנות ולהפעיל את האפליקציה שלך עבור iOS או Android.

  4. ברגע שהאפליקציה שלך רצתה, לצפות ביומן המכשיר ולחכות חריג ההדק מן CrashlyticsTester .

    • iOS: הצגת יומנים בחלונית התחתונה של Xcode.

    • אנדרואיד: להציג יומני ידי הפעלת הפקודה הבאה בטרמינל: adb logcat .

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

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

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


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

הצעדים הבאים