Phân phối các bản phát hành gói ứng dụng cho người thử nghiệm - Codelab

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

1. Sơ lượt

image10.png

Trong bảng mã này, bạn sẽ học cách phân phối các bản phát hành Android App Bundle cho người thử nghiệm bằng cách sử dụng Firebase App Distribution và plugin Gradle của nó. Phân phối ứng dụng cung cấp một trung tâm trung tâm để bạn quản lý các phiên bản trước khi phát hành của ứng dụng và những người thử nghiệm mà bạn mời vào mỗi bản phát hành.

Những gì bạn sẽ học

  • Cách liên kết ứng dụng Firebase của bạn với Google Play
  • Cách đóng gói và xây dựng ứng dụng của bạn dưới dạng một gói ứng dụng
  • Cách tạo bản phát hành và chia sẻ nó với những người thử nghiệm trực tiếp
  • Cách tải xuống và thử nghiệm các bản phát hành mới với tư cách người thử nghiệm

Những gì bạn cần

  • Android Studio v4.0 +
  • Tệp gói đã ký mà bạn đã tạo từ Android Studio
  • Tài khoản nhà phát triển trên Google Play mà bạn là Chủ sở hữu hoặc Quản trị viên
  • Ứng dụng của bạn trong Google Play được thiết lập trên trang tổng quan ứng dụng Google Play và có trạng thái sau:
    • Ứng dụng được phân phối cho một trong các phiên bản của Google Play (Thử nghiệm nội bộ, Thử nghiệm kín, Thử nghiệm mở hoặc Sản xuất).
    • Quá trình đánh giá ứng dụng trong Google Play đã hoàn tất và ứng dụng đã được xuất bản. Ứng dụng của bạn được xuất bản nếu cột Trạng thái ứng dụng hiển thị một trong các trạng thái sau: Thử nghiệm nội bộ (không phải Thử nghiệm nội bộ bản nháp), Thử nghiệm kín, Thử nghiệm mở hoặc Sản xuất.
  • Địa chỉ email bạn có thể sử dụng làm người thử nghiệm để nhận lời mời xây dựng mới từ Firebase

2. Tạo dự án Firebase

  1. Đăng nhập vào Firebase .
  2. Trong bảng điều khiển Firebase, nhấp vào Thêm dự án , sau đó đặt tên cho dự án của bạn là "AppBundlesCodelab". Hãy nhớ ID dự án cho dự án Firebase của bạn. Nếu bạn không chỉnh sửa ID dự án, Firebase sẽ tự động chỉ định một ID duy nhất cho dự án của bạn.

    image8.png
  3. (Tùy chọn) Khi được nhắc, hãy bật Google Analytics.
  4. Hoàn thành các bước còn lại, sau đó nhấp vào Tạo dự án .

Thêm gói ứng dụng của bạn vào dự án

  1. Trong bảng điều khiển Firebase, nhấp vào Thêm ứng dụng .

    image5.png
  2. Khi đăng ký ứng dụng của bạn, hãy đảm bảo sử dụng cùng tên gói với ứng dụng được tải lên tài khoản nhà phát triển Google Play của bạn. Cuối cùng, bấm Đăng ký ứng dụng .
  3. Hoàn thành các bước còn lại để thêm tệp cấu hình Firebase của ứng dụng ( google-services.json ) vào ứng dụng của bạn. Lưu ý rằng đối với Android, Phân phối ứng dụng không có SDK Firebase để thêm vào ứng dụng của bạn.
  4. Nhấp vào Tiếp tục để giao diện điều khiển .
  1. Trong bảng điều khiển Firebase, hãy chuyển đến cài đặt Dự án của bạn.

    image2.png
  2. Trong tab Tích hợp , nhấp vào Liên kết trên thẻ Google Play .
  3. Làm theo hướng dẫn trên màn hình để bật tích hợp Phân phối ứng dụng, sau đó chọn ứng dụng Firebase mới tạo của bạn để liên kết với Google Play.

Bây giờ bạn đã hoàn thành các bước này, ứng dụng Firebase sẽ được liên kết với ứng dụng của bạn trong tài khoản nhà phát triển Google Play của bạn, miễn là tên gói của ứng dụng khớp với nhau.

3. Thêm Phân phối ứng dụng vào dự án của bạn

Thêm plugin Gradle phân phối ứng dụng

Bây giờ, bạn sẽ sử dụng Android Studio để thêm Phân phối ứng dụng và plugin Gradle của nó dưới dạng phụ thuộc bản xây dựng vào ứng dụng của bạn.

  1. Trong tệp Gradle cấp dự án của bạn ( android/build.gradle ), hãy thêm plugin App Distribution Gradle và kho lưu trữ Maven của Google.
    buildscript {
        repositories {
            // Check that you have Google's Maven repository (if not, add it).
            google()
            mavenCentral()
        }
        dependencies {
            // Add the App Distribution Gradle plugin
            classpath `com.google.firebase:firebase-appdistribution-gradle:2.1.2`
        }
    }
    
  2. Trong tệp Gradle cấp ứng dụng của bạn ( android/app/build.gradle ), hãy thêm plugin Phân phối ứng dụng:
    apply plugin: `com.android.application`
    
    // ...
    
    // Apply the App Distribution Gradle plugin
    apply plugin: `com.google.firebase.appdistribution`
    
    // ...
    
  3. Nếu bạn đang sử dụng proxy hoặc Tường lửa của công ty, hãy thêm thuộc tính hệ thống Java sau để cho phép Phân phối ứng dụng tải các bản phân phối của bạn lên Firebase:
    -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
    

Xác thực dự án Firebase của bạn

Trước khi có thể sử dụng plugin Gradle, bạn cần xác thực dự án Firebase của mình. Đối với bảng mã này, bạn sẽ đăng nhập vào tài khoản Google của mình bằng hành động đăng nhập của plugin.

  1. Chạy lệnh sau tại thư mục gốc của dự án Android của bạn:
    ~/your-android-project$ ./gradlew appDistributionLogin
    
  2. Khi lệnh in một liên kết xác thực, hãy mở nó trong trình duyệt. Khi được nhắc, hãy đăng nhập vào tài khoản Google của bạn và cấp quyền truy cập vào dự án Firebase của bạn. Lệnh Gradle in mã thông báo làm mới, mà plugin Phân phối ứng dụng sử dụng để xác thực với Firebase.
  3. Đặt biến môi trường FIREBASE_TOKEN thành mã thông báo từ bước trước:
    ~/your-android-project$ export FIREBASE_TOKEN=your_firebase_token
    

4. Định cấu hình thuộc tính gói của bạn trong Android Studio

Trong bước này, bạn sẽ tự thêm mình làm người thử nghiệm cho bản dựng mà bạn sẽ phân phối sau này. Sau khi bạn phân phối bản dựng, người thử nghiệm sẽ nhận được thông báo qua email từ Firebase mời họ thử nghiệm bản dựng mới.

Trong app/build.gradle của bạn, hãy thêm phần firebaseAppDistribution và bao gồm các thông số sau:

  • appID : ID ứng dụng Firebase của ứng dụng của bạn. Bạn có thể tìm thấy nó trong tab Chung của cài đặt Dự án của bạn.
  • artifactType : Loại tệp ứng dụng của bạn ( AAB ).
  • testers : Địa chỉ email của người thử nghiệm của bạn. Đối với codelab này, hãy thêm email của riêng bạn để bạn có thể kiểm tra bản dựng của mình sau khi nó được phân phối.

Ví dụ:

android {

   // ...

   buildTypes {
       release {
           firebaseAppDistribution {
               appId="yourAppId"
               artifactType="AAB"
               testers="your@exampleemail.com, cerseimartell.772371@email.com"
           }
       }
   }

// ...
}

Là một tùy chọn, bạn cũng có thể ghi đè các giá trị được đặt trong build.gradle của mình bằng cách chuyển các đối số dòng lệnh ở dạng -PappDistribution- property-name = property-value .

5. Xây dựng và phân phối một bản phát hành

  1. Chạy tác vụ bundle Variant Gradle để tạo tệp gói ứng dụng của bạn:
    $ ./gradlew :base:bundleRelease
    
  2. Tìm gói trong thư mục xây dựng ứng dụng của bạn (vị trí mặc định là app/build/outputs/bundle/release ).
  3. Để phân phối bản phát hành, hãy tạo gói mục tiêu và bundleRelease appDistributionUploadRelease trình bao bọc Gradle của dự án của bạn. Bao gồm mã thông báo Firebase (mã bạn nhận được ở bước 3: Thêm Phân phối ứng dụng vào ứng dụng của bạn).
    export FIREBASE_TOKEN=your_firebase_token
    
    ./gradlew --stop // Only needed for environment variable changes
    
    ./gradlew bundleRelease appDistributionUploadRelease
    

Người kiểm tra bây giờ sẽ nhận được lời mời qua email để tải xuống và kiểm tra bản dựng. Với tư cách là nhà phát triển, giờ đây bạn có thể theo dõi bản dựng trong tab Bản phát hành của trang tổng quan Phân phối ứng dụng.

6. Tải xuống và kiểm tra bản phát hành của bạn

Trong phần này, bạn sẽ được thiết lập làm người thử nghiệm để tải xuống bản phát hành mà bạn đã phân phối. Với tư cách là người thử nghiệm, bạn sẽ cần xác thực thiết bị thử nghiệm của mình và bật chia sẻ ứng dụng nội bộ trong ứng dụng Cửa hàng Google Play.

  1. Trên thiết bị thử nghiệm của bạn, hãy đăng nhập vào tài khoản email của người thử nghiệm và mở lời mời từ Firebase.

    image6.png
  2. Đăng nhập bằng tài khoản Google của bạn và chấp nhận lời mời để kiểm tra bản phát hành được phân phối. Theo một tùy chọn, bạn cũng có thể tải xuống Firebase App Tester , tính năng này ngăn các bản phát hành đã tải xuống được thêm vào thư mục Downloads của thiết bị của bạn. Nó cũng hiển thị thông tin bổ sung về các bản phát hành, chẳng hạn như tiến trình tải xuống và phiên bản phát hành.

    image9.png
  3. Nhấn vào Tải xuống trên bản phát hành để cài đặt nó từ Cửa hàng Play.
  4. Khi được nhắc, hãy hoàn thành các bước còn lại để bật chia sẻ ứng dụng nội bộ (hướng dẫn được hiển thị trên thiết bị thử nghiệm của bạn và chỉ cần hoàn thành một lần).

Sau khi quá trình tải xuống hoàn tất, bản phát hành của bạn sẽ tự động xuất hiện dưới dạng lối tắt trên màn hình chính của thiết bị.

7. Xin chúc mừng!

Bạn vừa sử dụng Phân phối ứng dụng Firebase để tải gói ứng dụng lên và phân phối bản phát hành cho người thử nghiệm.

Bước tiếp theo