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

Phân phối bản phát hành gói ứng dụng cho người kiểm thử – Lớp học lập trình

1. Tổng quan

hình10.png

Trong lớp học lập trình này, bạn sẽ tìm hiểu cách phân phối bản phát hành Android App Bundle cho người kiểm thử bằng tính năng Phân phối ứng dụng Firebase và trình bổ trợ Gradle của Firebase. Phân phối ứng dụng là một trung tâm tập trung để 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 kiểm thử mà bạn mời tham gia mỗi bản phát hành.

Kiến thức bạn sẽ học được

Cách liên kết ứng dụng trong Firebase với Google Play
Cách đóng gói và tạo ứng dụng dưới dạng gói ứng dụng
Cách tạo một bản phát hành và chia sẻ bản phát hành đó với những người kiểm thử phiên bản đang hoạt động
Cách tải xuống và kiểm thử bản phát hành mới với tư cách người kiểm thử

Bạn cần có

Phiên bản Android Studio mới nhất
Tệp gói có chữ ký mà bạn đã tạo qua 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 của ứng dụng trên Google Play và có trạng thái sau:
- Ứng dụng được phân phối trên một trong các kênh Google Play (Thử nghiệm nội bộ, Thử nghiệm khép kín, Thử nghiệm công khai hoặc Phát hành công khai).
- Quá trình xem xét ứng dụng trên Google Play đã hoàn tất và ứng dụng đã được xuất bản. Ứng dụng đã được phát hành 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 khép kín, Thử nghiệm công khai hoặc Phát hành công khai.
Địa chỉ email mà bạn có thể dùng làm người kiểm thử để nhận lời mời tạo bản dựng mới từ Firebase

2. Tạo một dự án Firebase

Đăng nhập vào Firebase.
Trong bảng điều khiển của Firebase, hãy nhấp vào Add Project (Thêm dự án), sau đó đặt tên cho dự án là "AppBundlesCodelab". Ghi nhớ Mã dự án cho dự án Firebase của bạn. Nếu bạn không chỉnh sửa Mã dự án, Firebase sẽ tự động chỉ định một mã duy nhất cho dự án của bạn.
(Không bắt buộc) Khi được nhắc, hãy bật Google Analytics.
Hoàn tất các bước còn lại, rồi nhấp vào Tạo dự án.

Thêm gói ứng dụng vào dự án

Trong bảng điều khiển của Firebase, hãy nhấp vào Thêm ứng dụng.
Khi đăng ký ứng dụng, hãy nhớ dùng tên gói giống với ứng dụng mà bạn đã tải lên tài khoản nhà phát triển của mình trên Google Play.
Lưu ý: Bạn phải chọn cùng một tên gói để liên kết ứng dụng trên Firebase với tài khoản nhà phát triển trên Google Play. Bạn sẽ thực hiện việc này trong phần tiếp theo.

Cuối cùng, nhấp vào Đăng ký ứng dụng.
Hãy hoàn tất các bước còn lại để thêm tệp cấu hình Firebase (google-services.json) vào ứng dụng của bạn. Lưu ý rằng đối với Android, tính năng 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 của Firebase, hãy chuyển đến phần Cài đặt dự án.
Trong thẻ Tích hợp, hãy 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ính năng tích hợp Phân phối ứng dụng, sau đó chọn ứng dụng Firebase mới tạo để 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 trên Google Play miễn là các ứng dụng đó tên gói khớp.

3. Thêm tính năng Phân phối ứng dụng vào dự án

Thêm trình bổ trợ Gradle cho Phân phối ứng dụng

Bây giờ, bạn sẽ sử dụng Android Studio để thêm tính năng Phân phối ứng dụng và trình bổ trợ Gradle vào ứng dụng.

Trong tệp Gradle cấp dự án (android/build.gradle.kts), hãy thêm trình bổ trợ Gradle cho 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 Gradle cài đặt cấp dự á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 (android/app/build.gradle.kts), hãy thêm trình bổ trợ 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 đây để cho phép tính năng Phân phối ứng dụng tải 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

Trước khi có thể sử dụng trình bổ trợ Gradle, bạn cần xác thực dự án Firebase của mình. Đối với lớp học 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 ở gốc của dự án Android:

~/your-android-project$ firebase login

Tài liệu tham khảo có thêm thông tin chi tiết.

4. Định cấu hình các thuộc tính gói trong Android Studio

Ở bước này, bạn sẽ tự thêm mình làm người kiểm thử 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, Firebase sẽ gửi thông báo qua email để mời họ thử nghiệm bản dựng mới.

Trong app/build.gradle.kts, hãy thêm phần firebaseAppDistribution và thêm các tham số sau:

appID: Mã ứng dụng Firebase của ứng dụng. Bạn có thể tìm thấy mã này trong thẻ Chung trong phần Cài đặt dự án.
artifactType: Loại tệp của ứng dụng (AAB).
testers: Dành cho người kiểm thử địa chỉ email. Đối với lớp học lập trình này, hãy thêm email của riêng bạn để có thể kiểm thử bản dựng sau khi 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"
                }
            }
        }

        // ...
    }

Bạn cũng có thể ghi đè các giá trị được đặt trong build.gradle.kts bằng cách truyền đố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ụ bundleVariant của Gradle để tạo tệp gói ứng dụng:
```
$ ./gradlew :base:bundleRelease
```
Tìm gói này 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 tạo các mục tiêu bundleRelease và appDistributionUploadRelease bằng trình bao bọc Gradle của dự án. Bao gồm mã thông báo Firebase (mã mà bạn nhận được ở bước 3: Thêm tính năng Phân phối ứng dụng vào ứng dụng).
```
export FIREBASE_TOKEN=your_firebase_token

./gradlew --stop // Only needed for environment variable changes

./gradlew bundleRelease appDistributionUploadRelease
```

Giờ đây, người kiểm thử sẽ nhận được lời mời qua email để tải xuống và kiểm thử bản dựng. Với vai trò là nhà phát triển, giờ đây, bạn có thể giám sát bản dựng trong thẻ 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 thử bản phát hành

Trong phần này, bạn sẽ được thiết lập như một người kiểm thử để tải bản phát hành mà bạn đã phân phối xuống. Là người kiểm thử, bạn sẽ cần xác thực thiết bị thử nghiệm 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, hãy đăng nhập vào tài khoản email của người kiểm thử rồi mở lời mời từ Firebase.
Đăng nhập bằng Tài khoản Google của bạn rồi chấp nhận lời mời kiểm thử bản phát hành được phân phối. Bạn cũng có thể tải Trình kiểm tra ứng dụng Firebase xuống để có thể ngăn chặn việc thêm các bản phát hành đã tải xuống vào thư mục Downloads trên thiết bị. Trang này 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 Download (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 tất các bước còn lại để bật tính năng chia sẻ ứng dụng nội bộ (hướng dẫn sẽ hiển thị trên thiết bị thử nghiệm và bạn 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 một 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 tính năng Phân phối ứng dụng Firebase để tải một gói ứng dụng lên và phân phối một bản phát hành cho người kiểm thử.

Các 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 kiểm thử cho bản phát hành.
Xem bài viết Tạo và kiểm thử Android App Bundle để 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.