Google is committed to advancing racial equity for Black communities. See how.
หน้านี้ได้รับการแปลโดย Cloud Translation API
Switch to English

เริ่มต้นกับการตรวจสอบประสิทธิภาพสำหรับ Android

ก่อนที่จะเริ่ม

หากคุณยังไม่ได้ เพิ่ม Firebase ให้กับโครงการ Android ของคุณ

ในโครงการระดับของ build.gradle file ให้แน่ใจว่าจะรวมถึงพื้นที่เก็บข้อมูล Maven ของ Google ในทั้งสองของคุณ buildscript และ allprojects ส่วน

ขั้นตอนที่ 1 : เพิ่ม SDK การตรวจสอบประสิทธิภาพลงในแอพของคุณ

Performance Monitoring SDK ช่วยให้สามารถตรวจสอบการติดตาม ระยะเวลาอัตโนมัติ และการ ติดตามที่กำหนดเอง เพิ่มเติมในแอปของคุณ

  1. ในไฟล์ โมดูล Gradle ( ระดับแอป) ของ คุณ (โดยปกติจะเป็น app/build.gradle ):

    // ...
    
    dependencies {
      // ...
    
      // Add the dependency for the Performance Monitoring library
      implementation 'com.google.firebase:firebase-perf:19.0.8'
    }
    
  2. คอมไพล์แอปของคุณใหม่

ขั้นตอนที่ 2 : เพิ่มปลั๊กอินการตรวจสอบประสิทธิภาพลงในแอพของคุณ

ปลั๊กอิน Performance Monitoring Gradle เปิดใช้งานเครื่องมือที่ให้ การประมวลผลคำอธิบายประกอบ @AddTrace และ การตรวจสอบคำขอเครือข่าย HTTP / S อัตโนมัติ

วิธีเพิ่มปลั๊กอินการตรวจสอบประสิทธิภาพลงในแอพของคุณ:

  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. ในไฟล์ build.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.3'  // Google Services plugin
    
          // Add the dependency for the Performance Monitoring plugin
          classpath 'com.google.firebase:perf-plugin:1.3.1'  // Performance Monitoring plugin
        }
    }
    
  3. คอมไพล์แอปของคุณใหม่

ขั้นตอนที่ 3 : สร้างกิจกรรมประสิทธิภาพสำหรับการแสดงข้อมูลเริ่มต้น

Firebase สามารถตรวจพบว่าคุณได้เพิ่ม SDK ลงในแอปของคุณเรียบร้อยแล้วเมื่อได้รับข้อมูลเหตุการณ์ (เช่นการโต้ตอบแอป) จากแอปของคุณ หากคุณยังคงพัฒนาในพื้นที่ให้โต้ตอบกับแอปของคุณเพื่อสร้างกิจกรรมสำหรับการตรวจจับ SDK รวมถึงการรวบรวมและประมวลผลข้อมูลเริ่มต้น

  1. พัฒนาแอปของคุณต่อไปโดยใช้อีมูเลเตอร์หรืออุปกรณ์ทดสอบที่ตรงตามข้อกำหนดต่อไปนี้:

    • ตัวจำลอง Android พร้อมรูปภาพล่าสุดและบริการ Google Play 15.0.0 หรือใหม่กว่า

    • อุปกรณ์ทดสอบที่มีบริการ Google Play 15.0.0 หรือใหม่กว่า

  2. สร้างกิจกรรมโดยสลับแอปของคุณระหว่างพื้นหลังและเบื้องหน้าหลายครั้งโต้ตอบกับแอพของคุณโดยไปที่หน้าจอต่างๆและ / หรือเรียกใช้คำขอเครือข่าย

  3. ไปที่ ส่วน ประสิทธิภาพ ของคอนโซล Firebase เพื่อดูว่า Firebase ตรวจพบ SDK หรือไม่

    หากคุณไม่เห็นข้อความ "ตรวจพบ SDK" ภายใน 2 ชั่วโมงของการเพิ่ม SDK ไปยังแอปของคุณให้อ่าน เคล็ดลับการแก้ไขปัญหา

  4. การตรวจสอบประสิทธิภาพประมวลผลข้อมูลเหตุการณ์ประสิทธิภาพก่อนแสดงใน แดชบอร์ด ประสิทธิภาพ คุณควรเห็นข้อมูลเริ่มต้นแสดงภายใน 24 ชั่วโมงหลังจากเห็นข้อความตรวจจับ SDK

    หากคุณไม่เห็นข้อมูลเริ่มต้นของคุณให้อ่าน เคล็ดลับการแก้ไขปัญหา

ขั้นตอนที่ 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
    • Logging network request trace: URL

หากแอปของคุณไม่ได้บันทึกเหตุการณ์ประสิทธิภาพตรวจสอบ เคล็ดลับการแก้ไขปัญหา

ขั้นตอนที่ 5 : (ไม่บังคับ) เพิ่มการตรวจสอบที่กำหนดเองสำหรับรหัสเฉพาะ

คุณสามารถสร้างการ ติดตามที่กำหนดเอง เพื่อตรวจสอบข้อมูลประสิทธิภาพที่เกี่ยวข้องกับรหัสเฉพาะในแอปของคุณ

ด้วยการติดตามที่กำหนดเองคุณสามารถวัดระยะเวลาที่แอพของคุณใช้เพื่อทำงานที่เฉพาะเจาะจงหรือชุดของงานให้สมบูรณ์เช่นการโหลดชุดภาพหรือการสืบค้นฐานข้อมูลของคุณ เมทริกเริ่มต้นสำหรับการติดตามที่กำหนดเองคือระยะเวลา แต่คุณยังสามารถเพิ่มเมตริกที่กำหนดเองได้เช่นการเข้าชมแคชและการเตือนหน่วยความจำ

ในรหัสของคุณคุณกำหนดจุดเริ่มต้นและจุดสิ้นสุดของการติดตามที่กำหนดเอง (และเพิ่มการวัดที่กำหนดเองที่ต้องการ) โดยใช้ API ที่จัดทำโดย SDK การตรวจสอบประสิทธิภาพ สำหรับแอพ Android คุณสามารถตรวจสอบระยะเวลาของวิธีการเฉพาะโดยใช้ คำอธิบายประกอบ @AddTrace

เยี่ยมชม เพิ่มการตรวจสอบที่กำหนดเองสำหรับรหัสแอปเฉพาะ เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับคุณสมบัติเหล่านี้และวิธีเพิ่มลงในแอปของคุณ

ขั้นตอนที่ 6 : ปรับใช้แอปของคุณจากนั้นตรวจสอบผลลัพธ์

หลังจากที่คุณตรวจสอบความถูกต้องของการตรวจสอบประสิทธิภาพโดยใช้อุปกรณ์ทดสอบอย่างน้อยหนึ่งอุปกรณ์คุณสามารถปรับใช้แอพเวอร์ชันที่อัปเดตของคุณกับผู้ใช้ของคุณ

คุณสามารถตรวจสอบข้อมูลประสิทธิภาพได้ใน แผงควบคุม ประสิทธิภาพ ของคอนโซล Firebase

ปัญหาที่ทราบ

  • ปลั๊กอิน Performance Monitoring Gradle v1.1.0 อาจทำให้เกิดการไม่ตรงกันในการพึ่งพา Guava ซึ่งทำให้เกิดข้อผิดพลาดต่อไปนี้:

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

    หากคุณเห็นข้อผิดพลาดนี้คุณสามารถ:

    • อัพเกรดปลั๊กอินการตรวจสอบประสิทธิภาพการทำงานเป็น v1.1.1 หรือใหม่กว่า (ล่าสุดคือ v1.3.1)

    • แทนที่บรรทัดการพึ่งพาปลั๊กอินการตรวจสอบประสิทธิภาพในไฟล์ build.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 / S ตามค่าที่ตั้งในส่วนหัวความยาวเนื้อหา HTTP ค่านี้อาจไม่ถูกต้องเสมอไป

  • การตรวจสอบประสิทธิภาพรองรับเฉพาะกระบวนการหลักในแอพ Android แบบหลายกระบวนการ

ขั้นตอนถัดไป