Thông báo cho người kiểm tra về các bản phát hành ứng dụng mới của bạn với SDK Android phân phối ứng dụng Firebase - Codelab

1. Khái quát chung

Chào mừng bạn đến với Tích hợp SDK phân phối ứng dụng Firebase trong phòng thí nghiệm mã ứng dụng Android của bạn. Trong phòng thí nghiệm lập trình này, bạn sẽ thêm SDK Android phân phối ứng dụng vào ứng dụng của mình để hiển thị cảnh báo trong ứng dụng cho người thử nghiệm khi có bản dựng mới để tải xuống. Bạn sẽ tìm hiểu cách sử dụng cả cấu hình cơ bản và cấu hình tùy chỉnh để những người thử nghiệm của bạn đăng nhập để nhận các bản cập nhật. Sau đó, bạn sẽ đẩy một bản phát hành mới lên Phân phối ứng dụng và kích hoạt cảnh báo bản dựng mới ngay trong ứng dụng.

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

• Cách sử dụng Phân phối ứng dụng để phân phối ứng dụng phát hành trước cho người thử nghiệm
• Cách tích hợp SDK Android phân phối ứng dụng vào ứng dụng của bạn
• Cách thông báo cho người thử nghiệm khi có bản dựng tiền phát hành mới sẵn sàng để cài đặt
• Cách tùy chỉnh SDK để phù hợp với nhu cầu thử nghiệm của bạn

Những gì bạn cần

• Phiên bản Android Studio mới nhất.
• Mã mẫu.
• Thiết bị thử nghiệm chạy Android 4.4+ và dịch vụ Google Play 9.8 trở lên hoặc Trình giả lập chạy dịch vụ Google Play 9.8 trở lên.
• Nếu sử dụng thiết bị, cáp kết nối.

2. Lấy mã mẫu

Sao chép kho lưu trữ GitHub từ dòng lệnh.

$ git clone https://github.com/FirebaseExtended/codelab-appdistribution-android.git

Nếu bạn chưa cài đặt git, bạn cũng có thể tải xuống dự án mẫu từ trang GitHub của nó hoặc bằng cách nhấp vào liên kết này .

3. Nhập ứng dụng khởi động

Từ Android Studio, chọn thư mục codelab-appdistribution-android/start ( ) từ bản tải xuống mã mẫu ( Tệp > Mở > .../codelab-appdistribution-android/start).

Bây giờ bạn sẽ mở dự án bắt đầu trong Android Studio.

4. Tạo dự án bảng điều khiển Firebase

Thêm một dự án Firebase mới

1. Mở bảng điều khiển Firebase .
2. Chọn Thêm dự án rồi đặt tên cho dự án của bạn là "Firebase Codelab."

Bạn không cần bật Google Analytics cho dự án này.

3. Nhấp vào Tạo dự án .

Thêm ứng dụng vào Firebase

Đăng ký ứng dụng của bạn với Firebase . Sử dụng "com.google.firebase.appdistributioncodelab" làm tên gói.

Thêm tệp google-services.json vào ứng dụng của bạn

Sau khi thêm tên gói và chọn Đăng ký, hãy làm theo các bước sau để thêm google-services.json vào ứng dụng của bạn:

1. Nhấp vào Tải xuống google-services.json để lấy tệp cấu hình Firebase Android của bạn.
2. Sao chép tệp google-services.json vào thư mục app trong dự án của bạn.
3. Sau khi tệp được tải xuống, bạn có thể Bỏ qua các bước tiếp theo được hiển thị trong bảng điều khiển (chúng đã được thực hiện cho bạn trong dự án xây dựng-android-start).

Cập nhật ID ứng dụng để khớp với ứng dụng Firebase của bạn

1. Trong menu bên trái (Tab Dự án), đảm bảo bạn đang ở Chế độ xem "Android" và tìm tab "Tập lệnh lớp" và mở tệp Lớp mô-đun (cấp ứng dụng) của bạn (thường là app/build.gradle.kts ).
2. Thay đổi thuộc tính applicationId để khớp với ID ứng dụng của ứng dụng Firebase của bạn. Đây phải là "com.google.firebase.appdistributioncodelab"

Đồng bộ hóa dự án của bạn với các tệp Gradle

Để đảm bảo rằng tất cả các phần phụ thuộc đều có sẵn cho ứng dụng của bạn, hãy đồng bộ hóa dự án của bạn với các tệp Gradle bằng cách chọn Tệp > Đồng bộ hóa dự án với các tệp Gradle từ thanh công cụ của Android Studio.

5. Thiết lập cảnh báo bản dựng mới trong ứng dụng với SDK Android phân phối ứng dụng

Trong bước này, bạn sẽ thêm SDK Android phân phối ứng dụng Firebase vào ứng dụng của mình và hiển thị cảnh báo trong ứng dụng cho người thử nghiệm khi có bản dựng mới của ứng dụng để cài đặt. Để thực hiện việc này, hãy đảm bảo bạn đã bật API Trình kiểm tra ứng dụng Firebase cho dự án "Firebase Codelab" (trong Google Cloud Console). Bạn cần đăng nhập bằng cùng một tài khoản và chọn đúng dự án từ trình đơn thả xuống ở trên cùng.

Định cấu hình cảnh báo trong ứng dụng

SDK Android Phân phối ứng dụng cung cấp hai cách thiết lập cảnh báo bản dựng trong ứng dụng cho người thử nghiệm của bạn:

• Cấu hình cảnh báo cơ bản, đi kèm với hộp thoại dựng sẵn để hiển thị cho người kiểm tra.
• Cấu hình cảnh báo nâng cao, cho phép bạn tùy chỉnh giao diện người dùng (UI).

Chúng tôi sẽ bắt đầu với cấu hình cảnh báo cơ bản. Bạn có thể sử dụng updateIfNewReleaseAvailable để hiển thị hộp thoại bật cảnh báo dựng sẵn cho những người kiểm tra chưa bật cảnh báo, sau đó kiểm tra xem có bản dựng mới hay không. Người thử nghiệm bật cảnh báo bằng cách đăng nhập vào tài khoản có quyền truy cập vào ứng dụng trong Phân phối ứng dụng. Khi được gọi, phương thức sẽ thực hiện trình tự sau:

1. Kiểm tra xem người thử nghiệm có bật cảnh báo hay không. Nếu không, phương pháp này sẽ hiển thị hộp thoại dựng sẵn nhắc người kiểm tra đăng nhập vào Phân phối ứng dụng bằng tài khoản Google của họ.

Kích hoạt cảnh báo là quy trình một lần trên thiết bị thử nghiệm, quy trình này sẽ tồn tại trong các bản cập nhật ứng dụng của bạn. Cảnh báo vẫn được bật trên thiết bị thử nghiệm cho đến khi ứng dụng được gỡ cài đặt hoặc cho đến khi phương thức signOutTester được gọi.

2. Kiểm tra các bản dựng mới có sẵn để người thử nghiệm cài đặt.
3. Hiển thị cảnh báo dựng sẵn nhắc người kiểm tra tải xuống bản phát hành mới nhất.
4. Kiểm tra loại bản dựng mới trước khi tiến hành cập nhật:
5. Nếu bản dựng mới là Gói ứng dụng (AAB), hãy chuyển hướng người thử nghiệm đến Cửa hàng Play để hoàn tất quá trình cập nhật.
6. Nếu bản dựng mới là APK, thì SDK sẽ tải xuống bản dựng mới trong nền và nhắc người thử nghiệm cài đặt bản dựng mới khi quá trình tải xuống hoàn tất. SDK gửi thông báo tiến trình tải xuống cho người dùng bằng NotificationManager. Bạn có thể thêm chỉ báo tiến trình của riêng mình bằng cách đính kèm trình xử lý onProgressUpdate vào tác vụ updateIfNewReleaseAvailable .

Bạn có thể gọi updateIfNewReleaseAvailable() tại bất kỳ thời điểm nào trong ứng dụng của mình. Ví dụ: bạn có thể gọi updateIfNewReleaseAvailable() trong phương thức onResume() của MainActivity:

Mở MainActivity.kt và tạo phương thức onResume() như sau:

MainActivity.kt

override fun onResume() {
    super.onResume()
    checkForUpdate()
}

Bây giờ hãy triển khai phương thức checkForUpdate() .

MainActivity.kt

   private fun checkForUpdate() {
        firebaseAppDistribution.updateIfNewReleaseAvailable()
            .addOnProgressListener { updateProgress ->
                // (Optional) Implement custom progress updates in addition to
                // automatic NotificationManager updates.
            }
            .addOnFailureListener { e ->
                if (e is FirebaseAppDistributionException) {
                    // Handle exception.
                }
            }
    }

6. Xây dựng và mời người thử nghiệm tải xuống ứng dụng của bạn

Trong bước này, bạn tạo ứng dụng và thử nghiệm triển khai của mình bằng cách phân phối bản dựng cho người thử nghiệm bằng bảng điều khiển Firebase.

Xây dựng ứng dụng của bạn

Khi bạn đã sẵn sàng phân phối phiên bản phát hành trước của ứng dụng cho người thử nghiệm, hãy tạo APK bằng quy trình thông thường của bạn. Bạn phải ký APK bằng khóa gỡ lỗi hoặc khóa ký ứng dụng của mình.

Phân phối ứng dụng của bạn cho người thử nghiệm

Để phân phối ứng dụng của bạn cho người thử nghiệm, hãy tải tệp APK lên bằng bảng điều khiển Firebase:

1. Mở trang Phân phối ứng dụng của bảng điều khiển Firebase. Chọn dự án Firebase của bạn khi được nhắc.
2. Trên trang Bản phát hành, hãy chọn ứng dụng bạn muốn phân phối từ trình đơn thả xuống.

3. Nhấp vào Bắt đầu

4. Kéo tệp APK của ứng dụng của bạn vào bảng điều khiển để tải lên.
5. Khi quá trình tải lên hoàn tất, hãy chỉ định nhóm người thử nghiệm và từng người thử nghiệm mà bạn muốn nhận bản dựng. (Thêm email của bạn để nhận lời mời.) Sau đó, thêm ghi chú phát hành cho bản dựng. Để tìm hiểu thêm về cách tạo nhóm người thử nghiệm, hãy xem Thêm và xóa người thử nghiệm .

6. Nhấp vào Phân phối để cung cấp bản dựng cho người thử nghiệm.

Trong bảng điều khiển Firebase, giờ đây bạn có thể thấy những người thử nghiệm mà bạn đã thêm trong bản phát hành ứng dụng của mình.

Vì bạn đã bao gồm địa chỉ email của mình nên bạn sẽ nhận được email từ Firebase App Distribution mời bạn thử nghiệm ứng dụng. Bây giờ bạn là người thử nghiệm đầu tiên! Làm theo hướng dẫn trong Chấp nhận lời mời để thiết lập làm người thử nghiệm trên thiết bị thử nghiệm của bạn.

Chấp nhận lời mời

Trước tiên, bạn cần chấp nhận lời mời tải xuống và kiểm tra bản phát hành.

1. Trên thiết bị thử nghiệm Android của bạn, hãy mở email được gửi từ Firebase App Distribution và nhấn vào Bắt đầu .
2. Trong ứng dụng web trình kiểm tra Phân phối ứng dụng Firebase xuất hiện, hãy đăng nhập bằng tài khoản Google của bạn và nhấn vào Chấp nhận lời mời. Giờ đây, bạn có thể xem bản phát hành mà bạn được mời thử nghiệm.

Tải xuống bản phát hành từ thiết bị thử nghiệm

Khi điều hướng đến ứng dụng phòng thí nghiệm mã AppDistribution, bạn có thể thấy rằng bản phát hành đã sẵn sàng để tải xuống.

1. Nhấn vào Tải xuống , sau đó cài đặt và chạy ứng dụng!
2. Khi ứng dụng bắt đầu, nó sẽ yêu cầu bạn bật cảnh báo bản dựng mới. Nhấn vào Bật .

3. Đăng nhập bằng tài khoản người thử nghiệm của bạn..

Bạn được đưa trở lại ứng dụng. Lần sau khi bạn chạy ứng dụng, bạn không cần phải đăng nhập hoặc chấp nhận thông báo

Phân phối bản cập nhật cho người thử nghiệm của bạn

1. Cập nhật versionName của bạn thành "1.1" và versionCode thành 2 trong tệp Gradle mô-đun (cấp ứng dụng) của bạn (thường là app/build.gradle).
2. Xây dựng APK của bạn bằng quy trình thông thường của bạn. Bạn phải ký APK bằng khóa gỡ lỗi hoặc khóa ký ứng dụng của mình.
3. Tải APK mới này lên bảng điều khiển Firebase của bạn, thêm lại email của bạn làm người kiểm tra và nhấp vào Phân phối .

Cảnh báo xây dựng thử nghiệm

1. Đảm bảo rằng bạn đã đóng ứng dụng nếu nó đang mở.
2. Khởi động lại ứng dụng.
3. Khi ứng dụng khởi động lại, bạn sẽ nhận được cảnh báo Có phiên bản mới.

4. Để nhận phiên bản mới nhất, hãy nhấp vào Cập nhật .
5. Nếu được nhắc, hãy chọn tùy chọn cho phép cài đặt từ các nguồn không xác định.
6. Nhấp vào Cài đặt (hoặc Cập nhật ) trên màn hình tiếp theo.

7. Chúc mừng! Bạn đã có thể cập nhật ứng dụng của mình bằng các cảnh báo tích hợp.

7. Tùy chỉnh đăng nhập người kiểm tra

Các phương thức signInTester/signOutTester và isTesterSignedIn giúp bạn linh hoạt hơn trong việc tùy chỉnh trải nghiệm đăng nhập của người thử nghiệm để trải nghiệm này có thể phù hợp hơn với giao diện ứng dụng của bạn.

Ví dụ sau kiểm tra xem người thử nghiệm đã đăng nhập vào tài khoản người thử nghiệm Phân phối ứng dụng Firebase của họ chưa, vì vậy, bạn có thể chọn chỉ hiển thị giao diện người dùng đăng nhập của mình cho những người thử nghiệm chưa đăng nhập. Sau khi người thử nghiệm đăng nhập, bạn có thể gọi checkForUpdate để kiểm tra xem người kiểm tra có quyền truy cập vào bản dựng mới hay không.

Hãy tắt kiểm tra cập nhật tự động trong onResume bằng cách nhận xét lệnh gọi checkForUpdate() .

MainActivity.kt

override fun onResume() {
        super.onResume()
        //checkForupdate()
    }

Thay vào đó, checkForUpdate() đã được thêm vào OnClickListener của updatebutton.

Bây giờ, hãy triển khai phương thức signIn() sẽ đăng nhập người dùng nếu họ đã đăng xuất hoặc đăng xuất người dùng nếu họ đã đăng nhập.

MainActivity.kt

    private fun signIn() {
        if (isTesterSignedIn()) {
            firebaseAppDistribution.signOutTester()
            configureUpdateButton()
            configureSigninButton()
        } else {
            firebaseAppDistribution.signInTester()
        }
    }

Cuối cùng, hãy triển khai phương thức isTesterSignedIn .

MainActivity.kt

    private fun isTesterSignedIn() : Boolean {
        return firebaseAppDistribution.isTesterSignedIn
    }

Xây dựng và thử nghiệm triển khai của bạn

8. Xin chúc mừng!

Bạn đã tích hợp tính năng "hiển thị cảnh báo trong ứng dụng" vào ứng dụng bằng SDK Android phân phối ứng dụng Firebase.

Những gì chúng tôi đã bảo hiểm

• Phân phối ứng dụng Firebase
• Phân phối ứng dụng Firebase Cảnh báo mới SDK Android

Bước tiếp theo

• Sử dụng plugin Fastlane
• Sử dụng các công cụ CLI
• sử dụng lớp

Tìm hiểu thêm

• Firebase.google.com

Có một câu hỏi?

• Stackoverflow 'phân phối ứng dụng firebase '
• Cộng đồng Firebase chùng kênh #app-distribution

Báo cáo vấn đề

• Sự cố Github