Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.
Trang này được dịch bởi Cloud Translation API.
Switch to English

Bắt đầu với Giám sát hiệu suất cho Android

Trước khi bắt đầu

Nếu bạn chưa có, hãy thêm Firebase vào dự án Android của bạn .

Bước 1 : Thêm SDK giám sát hiệu suất vào ứng dụng của bạn

Sau khi bạn đã thêm SDK theo dõi hiệu suất, Firebase tự động bắt đầu thu thập dữ liệu để hiển thị màn hình ứng dụng của bạn và dữ liệu liên quan đến vòng đời của ứng dụng (như thời gian bắt đầu ứng dụng ). Để bật Firebase giám sát các yêu cầu mạng, bạn cũng phải thêm plugin Gradle Giám sát Hiệu suất (bước tiếp theo).

  1. Sử dụng Firebase Android BoM , khai báo sự phụ thuộc cho thư viện Android Giám sát hiệu suất trong tệp Gradle mô-đun (cấp ứng dụng) của bạn (thường là app/build.gradle ).

    Java

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:26.1.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'
    }
    

    Bằng cách sử dụng Firebase Android BoM , ứng dụng của bạn sẽ luôn sử dụng các phiên bản tương thích của thư viện Firebase Android.

    (Thay thế) Khai báo các phụ thuộc thư viện Firebase mà không cần sử dụng BoM

    Nếu bạn chọn không sử dụng Firebase BoM, bạn phải chỉ định từng phiên bản thư viện Firebase trong dòng phụ thuộc của nó.

    Lưu ý rằng nếu bạn sử dụng nhiều thư viện Firebase trong ứng dụng của mình, chúng tôi thực sự khuyên bạn nên sử dụng BoM để quản lý các phiên bản thư viện, điều này đảm bảo rằng tất cả các phiên bản đều tương thích.

    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:19.0.10'
    }
    

    Kotlin + KTX

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:26.1.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'
    }
    

    Bằng cách sử dụng Firebase Android BoM , ứng dụng của bạn sẽ luôn sử dụng các phiên bản tương thích của thư viện Firebase Android.

    (Thay thế) Khai báo các phụ thuộc thư viện Firebase mà không cần sử dụng BoM

    Nếu bạn chọn không sử dụng Firebase BoM, bạn phải chỉ định từng phiên bản thư viện Firebase trong dòng phụ thuộc của nó.

    Lưu ý rằng nếu bạn sử dụng nhiều thư viện Firebase trong ứng dụng của mình, chúng tôi thực sự khuyên bạn nên sử dụng BoM để quản lý các phiên bản thư viện, điều này đảm bảo rằng tất cả các phiên bản đều tương thích.

    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:19.0.10'
    }
    

  2. Biên dịch lại ứng dụng của bạn.

Bước 2 : Thêm plugin Giám sát hiệu suất vào ứng dụng của bạn

Sau khi bạn đã thêm plugin Gradle theo dõi hiệu suất, Firebase tự động bắt đầu thu thập dữ liệu cho các yêu cầu mạng HTTP / S. Plugin cũng cho phép bạn tạo công cụ theo dõi mã tùy chỉnh bằng cách sử dụng chú thích @AddTrace .

  1. Trong tệp Gradle mô-đun (cấp ứng dụng) của bạn (thường là app/build.gradle ), hãy áp dụng plugin Giám sát hiệu suất:

    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. Trong tệp Gradle cấp gốc (cấp dự án) của bạn ( build.gradle ), hãy thêm các quy tắc để bao gồm plugin Giám sát hiệu suất.

    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.4'  // Google Services plugin
    
          // Add the dependency for the Performance Monitoring plugin
          classpath 'com.google.firebase:perf-plugin:1.3.4'  // Performance Monitoring plugin
        }
    }
    
  3. Biên dịch lại ứng dụng của bạn.

Bước 3 : Tạo các sự kiện hiệu suất để hiển thị dữ liệu ban đầu

Firebase có thể phát hiện ra rằng bạn đã thêm thành công SDK vào ứng dụng của mình khi nó nhận được thông tin sự kiện (như tương tác với ứng dụng) từ ứng dụng của bạn. Nếu bạn vẫn đang phát triển cục bộ, hãy tương tác với ứng dụng của bạn để tạo các sự kiện nhằm phát hiện SDK cũng như thu thập và xử lý dữ liệu ban đầu.

  1. Tiếp tục phát triển ứng dụng của bạn bằng trình giả lập hoặc thiết bị thử nghiệm đáp ứng các yêu cầu sau:

    • Trình giả lập Android với hình ảnh gần đây và các dịch vụ của Google Play 15.0.0 trở lên

    • Một thiết bị thử nghiệm với các dịch vụ của Google Play 15.0.0 trở lên

  2. Tạo sự kiện bằng cách chuyển đổi ứng dụng của bạn giữa nền và nền nhiều lần, tương tác với ứng dụng của bạn bằng cách điều hướng trên các màn hình và / hoặc kích hoạt các yêu cầu mạng.

  3. Chuyển đến Trang tổng quan về hiệu suất của bảng điều khiển Firebase để xem liệu Firebase có phát hiện thấy SDK hay không.

    Nếu bạn không thấy thông báo "Đã phát hiện SDK" trong vòng 2 giờ sau khi thêm SDK vào ứng dụng của mình, hãy xem lại các mẹo khắc phục sự cố .

  4. Giám sát hiệu suất xử lý dữ liệu sự kiện hiệu suất trước khi hiển thị trong bảng điều khiển Hiệu suất . Bạn sẽ thấy hiển thị dữ liệu ban đầu của mình trong vòng 24 giờ sau khi thấy thông báo phát hiện SDK.

    Nếu bạn không thấy hiển thị dữ liệu ban đầu của mình, hãy xem lại các mẹo khắc phục sự cố .

Bước 4 : (Tùy chọn) Xem thông báo nhật ký cho các sự kiện hiệu suất

  1. Bật ghi nhật ký gỡ lỗi cho Giám sát hiệu suất tại thời điểm xây dựng bằng cách thêm phần tử <meta-data> vào tệp AndroidManifest.xml của ứng dụng, như sau:

    <application>
        <meta-data
          android:name="firebase_performance_logcat_enabled"
          android:value="true" />
    </application>
    
  2. Kiểm tra thông báo nhật ký của bạn để tìm bất kỳ thông báo lỗi nào.

  3. Giám sát hiệu suất gắn thẻ thông báo nhật ký của nó bằng FirebasePerformance . Sử dụng tính năng lọc logcat, bạn có thể xem cụ thể theo dõi thời lượng và ghi nhật ký yêu cầu mạng HTTP / S bằng cách chạy lệnh sau:

    adb logcat -s FirebasePerformance
  4. Kiểm tra các loại nhật ký sau cho biết rằng Giám sát hiệu suất đang ghi lại các sự kiện hiệu suất:

    • Logging trace metric: TRACE_NAME
    • Logging network request trace: URL

Nếu ứng dụng của bạn không ghi lại các sự kiện hiệu suất, hãy xem lại các mẹo khắc phục sự cố .

Bước 5 : (Tùy chọn) Thêm giám sát tùy chỉnh cho mã cụ thể

Để theo dõi dữ liệu hiệu suất được liên kết với mã cụ thể trong ứng dụng của bạn, bạn có thể tạo công cụ theo dõi mã tùy chỉnh .

Với dấu vết mã tùy chỉnh, bạn có thể đo lường thời gian ứng dụng của mình hoàn thành một nhiệm vụ cụ thể hoặc một tập hợp các tác vụ, chẳng hạn như tải một tập hợp hình ảnh hoặc truy vấn cơ sở dữ liệu của bạn. Số liệu mặc định cho dấu vết mã tùy chỉnh là thời lượng của nó, nhưng bạn cũng có thể thêm số liệu tùy chỉnh, chẳng hạn như số lần truy cập bộ nhớ cache và cảnh báo bộ nhớ.

Trong mã của mình, bạn xác định phần đầu và phần cuối của dấu vết mã tùy chỉnh (và thêm bất kỳ chỉ số tùy chỉnh mong muốn nào) bằng cách sử dụng API do SDK giám sát hiệu suất cung cấp. Đối với các ứng dụng Android, bạn cũng có thể theo dõi thời lượng của các phương pháp cụ thể bằng cách sử dụng chú thích @AddTrace .

Truy cập Thêm giám sát để biết mã cụ thể để tìm hiểu thêm về các tính năng này và cách thêm chúng vào ứng dụng của bạn.

Bước 6 : Triển khai ứng dụng của bạn sau đó xem xét kết quả

Sau khi xác thực tính năng Giám sát hiệu suất bằng một hoặc nhiều thiết bị thử nghiệm, bạn có thể triển khai phiên bản cập nhật của ứng dụng cho người dùng của mình.

Bạn có thể theo dõi dữ liệu hiệu suất trong Bảng điều khiển hiệu suất của bảng điều khiển Firebase.

Các vấn đề đã biết

  • Plugin Gradle theo dõi hiệu suất v1.1.0 có thể gây ra lỗi phụ thuộc Guava không khớp, dẫn đến lỗi sau:

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

    Nếu gặp lỗi này, bạn có thể:

    • Nâng cấp plugin Giám sát hiệu suất lên v1.1.1 trở lên (phiên bản gần đây nhất là v1.3.4).

    • Thay thế dòng phụ thuộc plugin Giám sát hiệu suất trong tệp Gradle cấp gốc (cấp dự án) của bạn ( build.gradle ), như sau:

      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'
          }
        }
      }
      
  • Giám sát hiệu suất báo cáo tổng kích thước trọng tải cho các yêu cầu mạng HTTP dựa trên giá trị được đặt trong tiêu đề độ dài nội dung HTTP. Giá trị này có thể không phải lúc nào cũng chính xác.

  • Giám sát hiệu suất chỉ hỗ trợ quy trình chính trong các ứng dụng Android đa quy trình.

Bước tiếp theo