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

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. Khái quát chung

c7a9160ef7b184c7.png22e0b52f771c060d.png

Chào mừng bạn đến với Tích hợp SDK phân phối ứng dụng Firebase trong bảng mã ứng dụng Android của bạn. Trong bảng mã 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ó các bản dựng mới để tải xuống. Bạn sẽ học cách sử dụng cả cấu hình cơ bản và cấu hình tùy chỉnh để giúp 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 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.

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

  • Cách sử dụng Phân phối ứng dụng để phân phối ứng dụng trước khi phát hành 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ó một 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 3.4+.
  • Mã mẫu.
  • Thiết bị thử nghiệm chạy Android 2.3+ và các dịch vụ Google Play 9.8 trở lên hoặc Trình mô phỏng với các dịch vụ Google Play 9.8 trở lên.
  • Nếu sử dụng thiết bị, cáp kết nối.

Bạn sẽ sử dụng hướng dẫn này như thế nào?

Chỉ đọc qua nó Đọc nó và hoàn thành các bài tập

Bạn đánh giá trải nghiệm của mình với việc xây dựng ứng dụng Android như thế nào?

Người mới Trung gian Thành thạo

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 ( android_studio_folder.png ) từ 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 , sau đó đặt tên cho dự án của bạn là "Firebase Codelab".

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

  1. 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 để tải 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 Gradle" và mở tệp Gradle mô-đun (cấp ứng dụng) của bạn (thường là app/build.gradle ).
  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 Gradle filesselecting File> Sync Project with Gradle Files từ thanh công cụ 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ó cá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 rằng bạn đã bật API người 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ừ menu 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 được tạo 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) của mình.

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 cảnh báo kích hoạt được tạo sẵn cho những người thử nghiệm 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 kiểm tra 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 thực hiện chuỗi 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 sẽ hiển thị hộp thoại được tạo sẵn nhắc người thử nghiệm đăng nhập vào Phân phối ứng dụng bằng tài khoản Google của họ.

Bật cảnh báo là quy trình một lần trên thiết bị thử nghiệm, kéo dài qua 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.

  1. Kiểm tra các bản dựng mới có sẵn để người thử nghiệm cài đặt.
  2. Hiển thị cảnh báo được tạo sẵn nhắc người thử nghiệm tải xuống bản phát hành mới nhất.
  3. Kiểm tra loại bản dựng mới trước khi tiếp tục cập nhật:
  4. 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.
  5. Nếu bản dựng mới là APK, 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 về 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 xây dựng ứng dụng và kiểm tra việc triển khai 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 của bạn bằng quy trình bình thường. 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 lên tệp APK 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, chọn ứng dụng bạn muốn phân phối từ menu thả xuống.

623460c3c8a82ce6.png

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

bf503b25066ff4a4.png

  1. Kéo tệp APK của ứng dụng của bạn vào bảng điều khiển để tải tệp đó lên.
  2. 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 .

3343048f0930e84b.png

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

2be58fe195928bf9.png

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.

9935a41810344c61.png

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, mở email được gửi từ Phân phối ứng dụng Firebase và nhấn 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. Bây giờ bạn có thể thấy bản phát hành mà bạn được mời thử nghiệm.

c18cb684f8e82ad6.png

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 mã hóa AppDistribution, bạn có thể thấy rằng bản phát hành đã sẵn sàng để tải xuống.

5414d9a536f25ece.png

  1. Nhấn vào Tải xuống , sau đó cài đặt và chạy ứng dụng!
  2. Khi ứng dụng khởi động, 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 .

b059e09acaa4779f.png

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

22e0b52f771c060d.png

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

c9f33df16a2680d.png

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. Tạo APK của bạn bằng quy trình bình 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 lên APK mới này trong bảng điều khiển Firebase của bạn, thêm lại email của bạn làm người thử nghiệm và nhấp vào Phân phối .

2dfa702edfdce6b8.png

Kiểm tra cảnh báo bản dựng

  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.

987e3d0ba4e56f84.png

  1. Để nhận phiên bản mới nhất, hãy nhấp vào Cập nhật .
  2. 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.
  3. Nhấp vào Cài đặt (hoặc Cập nhật ) trên màn hình tiếp theo.

a7c7cd15d60bc764.png

  1. Xin 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 được tích hợp sẵn.

7. Tùy chỉnh đăng nhập của người thử nghiệm

Các phương thức signInTester / signOutTesterisTesterSignedIn cung cấp cho bạn sự linh hoạt hơn khi tùy chỉnh trải nghiệm đăng nhập của người thử nghiệm, vì vậy nó 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ọ hay 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 thử nghiệm có quyền truy cập vào bản dựng mới hay không.

Hãy tắt tính năng kiểm tra cập nhật tự động trong onResume bằng cách bình luận trong 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 () của chúng tôi, phương thức này sẽ đăng nhập vào 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à kiểm tra việc triển khai của bạn

8. Xin chúc mừng!

Bạn đã xây dựng tính năng "hiển thị cảnh báo trong ứng dụng" vào một ứng dụng bằng cách sử dụng SDK Android phân phối ứng dụng Firebase.

Những gì chúng tôi đã đề cập

  • 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

Tìm hiểu thêm

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

Báo cáo sự cố