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

התחל בעבודה עם ניטור ביצועים לאנדרואיד

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

אם לא עשית זאת עדיין, להוסיף Firebase לפרויקט Android שלך .

שלב 1: להוסיף אחר ביצועיהם SDK באפליקציה

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

  1. באמצעות BOM אנדרואיד Firebase , להכריז על התלות עבור מעקב אחר ביצועים הספרייה אנדרואיד במודול שלך (ברמת היישום) קובץ Gradle (בדרך כלל app/build.gradle ).

    ג'אווה

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:29.0.1')
    
        // Declare the dependency for the Performance Monitoring library
        // When using the BoM, you don't specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-perf'
    }
    

    באמצעות Firebase אנדרואיד BOM , האפליקציה שלך תמיד ישתמשו גירסאות תואמות של ספריות אנדרואיד Firebase.

    (אלטרנטיבי) הצהר תלות הספרייה Firebase ללא שימוש BOM

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

    שים לב שאם אתה משתמש בספריות Firebase מרובים באפליקציה, אנו ממליצים בחום להשתמש בתמונה BOM לנהל גרסאות הספרייה, אשר מבטיח כי כל הגרסאות תואמות.

    dependencies {
        // Declare the dependency for the Performance Monitoring library
        // When NOT using the BoM, you must specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-perf:20.0.4'
    }
    

    קוטלין+KTX

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:29.0.1')
    
        // Declare the dependency for the Performance Monitoring library
        // When using the BoM, you don't specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-perf-ktx'
    }
    

    באמצעות Firebase אנדרואיד BOM , האפליקציה שלך תמיד ישתמשו גירסאות תואמות של ספריות אנדרואיד Firebase.

    (אלטרנטיבי) הצהר תלות הספרייה Firebase ללא שימוש BOM

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

    שים לב שאם אתה משתמש בספריות Firebase מרובים באפליקציה, אנו ממליצים בחום להשתמש בתמונה BOM לנהל גרסאות הספרייה, אשר מבטיח כי כל הגרסאות תואמות.

    dependencies {
        // Declare the dependency for the Performance Monitoring library
        // When NOT using the BoM, you must specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-perf-ktx:20.0.4'
    }
    

  2. הידור מחדש של האפליקציה שלך.

שלב 2: מוסיפים את תוסף מעקב אחר ביצועים באפליקציה

לאחר שהוספת אחר ביצועיהם תוסף Gradle, Firebase מתחיל באופן אוטומטי איסוף נתונים עבור בקשות רשת HTTP / S . התוסף גם מאפשר לכם עקבות קוד מותאם אישית במכשיר באמצעות ביאור @AddTrace .

  1. במודול שלך (ברמת היישום) קובץ Gradle (בדרך כלל app/build.gradle ), להחיל את תוסף מעקב אחר ביצועים:

    apply plugin: 'com.android.application'
    apply plugin: 'com.google.gms.google-services'
    // Apply the Performance Monitoring plugin
    apply plugin: 'com.google.firebase.firebase-perf'
    
    android {
      // ...
    }
    
  2. בשנת ברמת השורש שלך (פרויקט ברמה) קובץ Gradle ( build.gradle ), להוסיף את הכללים כדי לכלול את תוסף מעקב אחר ביצועים.

    buildscript {
    
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // Add the Bintray repository
          jcenter()
        }
    
        dependencies {
          // ...
    
          // To benefit from the latest Performance Monitoring plugin features,
          // update your Android Gradle Plugin dependency to at least v3.4.0
          classpath 'com.android.tools.build:gradle:3.4.0'
    
          classpath 'com.google.gms:google-services:4.3.10'  // Google Services plugin
    
          // Add the dependency for the Performance Monitoring plugin
          classpath 'com.google.firebase:perf-plugin:1.4.0'  // Performance Monitoring plugin
        }
    }
    
  3. הידור מחדש של האפליקציה שלך.

שלב 3: צור אירועי ביצועים לתצוגת נתונים ראשוניים

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

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

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

    אם אינך רואה תצוגה של הנתונים ההתחלתי, לסקור את הטיפים .

שלב 4: (אופציונלי) הודעות יומן עבור אירועי ביצועים

  1. לאפשר רישום הסרת באגים עבור מעקב אחר ביצועים בשלב לבנות על ידי הוספת <meta-data> אלמנט של האפליקציה שלך AndroidManifest.xml קובץ, כך:

    <application>
        <meta-data
          android:name="firebase_performance_logcat_enabled"
          android:value="true" />
    </application>
    
  2. בדוק אם יש הודעות שגיאה בהודעות היומן שלך.

  3. מעקב אחר ביצועים מתייגים הודעות יומן עם FirebasePerformance . באמצעות סינון logcat, תוכל לצפות במעקב אחר משך זמן ורישום בקשות רשת HTTP/S על ידי הפעלת הפקודה הבאה:

    adb logcat -s FirebasePerformance
  4. בדוק את סוגי היומנים הבאים המציינים כי ניטור ביצועים הוא רישום אירועי ביצועים:

    • Logging trace metric: TRACE_NAME , FIREBASE_PERFORMANCE_CONSOLE_URL
    • Logging network request trace: URL
  5. לחץ על כתובת האתר כדי להציג את הנתונים שלך במסוף Firebase. ייתכן שיחלפו מספר רגעים עד שהנתונים יתעדכנו בלוח המחוונים.

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

שלב 5: (אופציונלי) הוסף ניטור מותאם אישית עבור קוד ספציפי

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

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

בקוד שלך, אתה מגדיר את ההתחלה והסוף של עקבות קוד מותאמות אישית (ומוסיפים כל מדד מותאם אישית רצוי) באמצעות ה- API המסופק על ידי SDK ניטור ביצועים. במקרה של אפליקציות Android, אתה יכול גם לעקוב אחר משך שיטות ספציפיות באמצעות ביאור @AddTrace .

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

שלב 6: האפליקציה שלך לפרוס אז תוצאות הסקירה

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

אתה יכול לעקוב אחר נתוני ביצועים של לוח המחוונים ביצועים של קונסולת Firebase.

בעיות ידועות

  • תוסף Gradle Monitoring Performance Gradle v1.1.0 יכול לגרום לאי התאמה בתלות של גויאבה, וכתוצאה מכך השגיאה הבאה:

    Error:Execution failed for task ':app:packageInstantRunResourcesDebug'.
    > com.google.common.util.concurrent.MoreExecutors.directExecutor()Ljava/util/concurrent/Executor;

    אם אתה רואה שגיאה זו, אתה יכול או:

    • שדרג את הפלאגין ניטור ביצועים ל- v1.1.1 ואילך (האחרונה היא v1.4.0).

    • חלף אחר ביצועיהם תוסף קו תלות ב ברמת השורש שלך (פרויקט ברמה) קובץ Gradle ( build.gradle ), כדלקמן:

      buildscript {
        // ...
      
        dependencies {
          // ...
      
          // Replace the standard Performance Monitoring plugin dependency line, as follows:
          classpath ('com.google.firebase:perf-plugin:1.1.0') {
                      exclude group: 'com.google.guava', module: 'guava-jdk5'
          }
        }
      }
      
  • ניטור ביצועים מדווח על גודל המטען הכולל לבקשות רשת HTTP בהתבסס על הערך שנקבע בכותרת באורך תוכן HTTP. לא תמיד ערך זה מדויק.

  • ניטור ביצועים תומך רק בתהליך העיקרי ביישומי אנדרואיד מרובי תהליכים.

הצעדים הבאים