Trang này được dịch bởi Cloud Translation API.

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

1. Khái quát chung

Trong phòng thí nghiệm lập trình này, bạn sẽ tìm hiểu 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 tính năng Phân phối ứng dụng Firebase 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 phát hành trước của ứng dụng và những người thử nghiệm mà bạn mời tham gia mỗi bản phát hành.

Bạn sẽ học được gì

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 gói ứng dụng
Cách tạo bản phát hành và chia sẻ với 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 là người thử nghiệm

Những gì bạn cần

Phiên bản Android Studio mới nhất
Tệp gói đã ký mà bạn đã tạo từ Android Studio
Tài khoản nhà phát triể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 bảng điều khiển ứng dụng Google Play và có trạng thái sau:
- Ứng dụng được phân phối tới một trong các kênh 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 xem xét ứ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ộ Dự thảo), Thử nghiệm kín, Thử nghiệm mở hoặc Sản xuất.
Địa chỉ email mà 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

Đăng nhập vào Firebase .
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." Ghi 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.
(Tùy chọn) Khi được nhắc, hãy bật Google Analytics.
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

Trong bảng điều khiển Firebase, nhấp vào Thêm ứng dụng .
Khi đăng ký ứng dụng của bạn, hãy đảm bảo sử dụng tên gói giống với tên ứng dụng được tải lên tài khoản nhà phát triển trên Google Play của bạn.
Lưu ý: Cần có cùng một tên gói để liên kết ứng dụng Firebase với tài khoản nhà phát triển trên Google Play của bạn. Bạn sẽ thực hiện việc này trong phần tiếp theo.
Cuối cùng nhấn Đăng ký ứng dụng .
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.
Nhấp vào Tiếp tục đến bảng điều khiển .

Liên kết với Google Play

Trong bảng điều khiển Firebase, chuyển đến cài đặt Dự án của bạn.
Trong tab Tích hợp , nhấp vào Liên kết trên thẻ Google Play .
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 của bạn 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 Lớp 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ó vào ứng dụng của mình.

Trong tệp Gradle cấp dự án của bạn ( android/build.gradle.kts ), hãy thêm plugin Cấp độ phân phối ứng dụng vào khối plugins .
```
plugins {
     //...

     // Add the App Distribution Gradle plugin
     id("com.google.firebase.appdistribution") version "4.0.0" apply false
}
```
Trong tệp Cấp độ cài đặt cấp dự án của bạn ( android/settings.gradle.kts ), hãy thêm kho lưu trữ Maven của Google vào khối pluginManagement .
```
 pluginManagement {
     // Check that you have Google's Maven repository (if not, add it).
     repositories {
         google()
         mavenCentral()
     }
 }
```
Trong tệp Gradle cấp ứng dụng của bạn ( android/app/build.gradle.kts ), hãy thêm plugin Phân phối ứng dụng vào khối plugins .
```
plugins {
     //...

     // Add the App Distribution plugin
     id("com.google.firebase.appdistribution")
}
```
Nếu bạn đang sử dụng proxy công ty hoặc Tường lửa, 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 phòng thí nghiệm lập trình này, bạn sẽ đăng nhập vào tài khoản Google của mình bằng Firebase CLI .

Chạy lệnh sau tại thư mục gốc của dự án Android của bạn:

~/your-android-project$ firebase login

Tài liệu tham khảo chứa nhiều chi tiết hơn.

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.kts của bạn, hãy thêm phần firebaseAppDistribution và bao gồm các tham 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 .
artifactType : Loại tệp ứng dụng của bạn ( AAB ).
testers : Địa chỉ email của người kiểm tra của bạn. Đối với phòng thí nghiệm mã 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 {
            getByName("release") {
                firebaseAppDistribution {
                  appId = "yourAppId"
                  artifactType = "AAB"
                  testers = "ali@example.com, bri@example.com, cal@example.com"
                }
            }
        }

        // ...
    }

Là một tùy chọn, bạn cũng có thể ghi đè các giá trị được đặt trong build.gradle.kts 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 bản phát hành

Chạy tác vụ Cấp bundle Variant để tạo tệp gói ứng dụng của bạn:
```
$ ./gradlew :base:bundleRelease
```
Định vị gói trong thư mục bản dựng của ứng dụng (vị trí mặc định là app/build/outputs/bundle/release ).
Để phân phối bản phát hành, hãy xây dựng gói mục tiêu bundleRelease và appDistributionUploadRelease với trình bao bọc Gradle của dự á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
```

Giờ đây, những người thử nghiệm sẽ nhận được lời mời qua email để tải xuống và thử nghiệm bản dựng. Với tư cách là nhà phát triển, giờ đây bạn có thể theo dõi quá trình xây dựng trong tab Bản phát hành của bảng điều khiển 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ẽ thiết lập với tư cách là người thử nghiệm để tải xuống bản phát hành mà bạn đã phân phối. Là người thử nghiệm, bạn cần xác thực thiết bị thử nghiệm của mình và bật tính năng chia sẻ ứng dụng nội bộ trong ứng dụng Cửa hàng Google Play.

Trên thiết bị thử nghiệm của bạn, hãy đăng nhập vào tài khoản email người thử nghiệm của bạn và mở lời mời từ Firebase.
Đăng nhập bằng tài khoản Google của bạn và chấp nhận lời mời thử nghiệm bản phát hành được phân phối. Như một tùy chọn, bạn cũng có thể tải xuống Trình kiểm tra ứng dụng Firebase , điều này ngăn không cho các bản phát hành đã tải xuống được thêm vào thư mục Downloads trên 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.
Nhấn vào Tải xuống trên bản phát hành để cài đặt từ Cửa hàng Play.
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 phím 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 tính nă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

Truy cập tài liệu về Phân phối ứng dụng để tìm hiểu thêm về cách quản lý người thử nghiệm cho bản phát hành của bạn.
Xem Xây dựng và thử nghiệm Android App Bundle của bạn để biết thông tin về các công cụ khác mà bạn có thể sử dụng để triển khai ứng dụng của mình.