Trang này cung cấp trợ giúp khắc phục sự cố và câu trả lời cho các câu hỏi thường gặp về phân phối và thử nghiệm ứng dụng với Phân phối ứng dụng.
Phân phối ứng dụng
Sử dụng các mẹo sau để khắc phục sự cố mà bạn có thể gặp phải khi phân phối ứng dụng cho người thử nghiệm của mình.
Khi tải lên một ứng dụng, bạn có thể gặp phải lỗi này:
"Chúng tôi không thể tìm thấy email liên hệ cho ứng dụng <app-id>
. Vui lòng truy cập Phân phối ứng dụng trong bảng điều khiển Firebase để thiết lập."
Đặt Email liên hệ trong bảng điều khiển Firebase, nếu có. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với Bộ phận hỗ trợ của Firebase .
Nếu bạn liên tục gặp lỗi 400, 409 hoặc 500 trong quá trình cung cấp, hãy liên hệ với Bộ phận hỗ trợ của Firebase . Cung cấp Hỗ trợ với số dự án Firebase và số nhận dạng ứng dụng của bạn.
Xác minh kích thước của APK. Giới hạn kích thước tệp tối đa cho tất cả các tệp nhị phân là 2048 MiB, tức là hơn 2 GB một chút.
Nếu kích thước APK nằm trong giới hạn kích thước tệp và có thể tái tạo, hãy liên hệ với Bộ phận hỗ trợ của Firebase .
Xác minh rằng APK đã được ký bằng cách sau:
apksigner verify --verbose ~/app-distro/app-distro-apps/[path_name]/app/ build/outputs/apk/debug/app-debug.apk
Phân phối Gói ứng dụng Android (AAB)
Khi bạn tải AAB lên Phân phối ứng dụng, Google Play sẽ tự động cấp lại APK đã tạo bằng chứng chỉ khóa ký ứng dụng thử nghiệm. Khi được nhắc, bạn phải đăng ký ứng dụng của mình với nhà cung cấp API nếu muốn tiếp tục sử dụng dịch vụ bên thứ ba của họ. Sau khi được ký, bạn có thể xem chứng chỉ kiểm tra ứng dụng của mình trong bảng điều khiển Firebase.
Các bản dựng AAB mà bạn tải lên Phân phối ứng dụng không xuất hiện trong tài khoản nhà phát triển Google Play của bạn (điều này bao gồm App Bundle Explorer và chia sẻ ứng dụng nội bộ).
Nếu Ứng dụng Android Firebase bị hủy liên kết khỏi Google Play, điều sau đây sẽ xảy ra:
Bạn sẽ không thể tải các gói ứng dụng mới lên Phân phối ứng dụng và xuất chúng sang Google Play thông qua tích hợp Phân phối ứng dụng với Google Play.
Các bản dựng hiện tại sẽ tiếp tục có sẵn trong bảng điều khiển Phân phối ứng dụng Firebase và cho những người thử nghiệm của bạn.
Mọi dữ liệu đã xuất trước đó giữa Firebase và Google Play sẽ vẫn có thể truy cập được trong cả hai sản phẩm.
Để phân phối Android App Bundle (AAB) thông qua Phân phối ứng dụng và tự động liên kết các AAB đã tải lên với cả dự án Firebase và tài khoản nhà phát triển trên Google Play của bạn, hãy đảm bảo bạn đáp ứng các yêu cầu sau:
Tài khoản nhà phát triển trên Google Play của bạn có một trong các cấp truy cập sau: Chủ sở hữu hoặc Quản trị viên.
Đối với dự án Firebase của bạn, bạn có một trong các vai trò sau: Chủ sở hữu hoặc Quản trị viên Firebase .
Ứng dụng của bạn đã được đăng ký với Firebase và tài khoản nhà phát triển Google Play của bạn. Điều này có nghĩa là bạn có cả ứng dụng Firebase Android và ứng dụng Google Play.
Ứng dụng trong Google Play và ứng dụng Firebase Android đều được đăng ký bằng cùng một tên gói.
Ứng dụng trong Google Play được thiết lập trên trang tổng quan của ứng dụng và đượ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 khép 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.
Nếu trước đây bạn đã tải lên một ứng dụng không đáp ứng các tiêu chí được liệt kê ở trên để liên kết, nhưng bây giờ lại đáp ứng được, bạn có thể thử liên kết lại Ứng dụng Android Firebase của mình với Google Play .
Cài đặt và thử nghiệm ứng dụng
Sử dụng các mẹo sau để khắc phục sự cố mà người thử nghiệm của bạn có thể gặp phải khi họ cài đặt và thử nghiệm ứng dụng của bạn.
Khi người dùng tạo tài khoản Google, họ sẽ tự động nhận được địa chỉ Gmail.
Nếu người thử nghiệm không có địa chỉ Gmail hoặc Google Workspace hoặc nếu họ muốn sử dụng một địa chỉ email khác để đăng nhập, hãy yêu cầu người thử nghiệm liên kết một địa chỉ email không phải Gmail với tài khoản và sử dụng email đó để đăng nhập.
Khi chọn một email thay thế, người kiểm tra phải tuân theo các nguyên tắc sau:
- Không sử dụng địa chỉ Gmail.
- Không sử dụng địa chỉ email đã được liên kết với tài khoản Google khác.
- Hãy nhớ sử dụng mật khẩu Tài khoản Google của bạn khi đăng nhập bằng địa chỉ email này.
Để biết thêm thông tin, hãy xem Đăng nhập vào Tài khoản Google của bạn bằng địa chỉ email khác .
Nếu người thử nghiệm chấp nhận lời mời qua email có địa chỉ email khác với địa chỉ email được gửi đến, thì người thử nghiệm có thể không thấy được các ứng dụng hoặc bản dựng phù hợp.
Email mà nhà phát triển gửi lời mời và thêm vào các bản dựng mới (Email A) có thể khác với email mà người thử nghiệm sử dụng để chấp nhận lời mời (Email B). Điều này tạo ra một liên kết đằng sau hậu trường. Bất cứ khi nào Email A được thêm vào các bản dựng mới, thì đó thực sự là Email B đang có quyền truy cập.
Nếu người kiểm tra chấp nhận lời mời qua email bằng một địa chỉ email khác, hãy làm theo các bước sau để giải quyết vấn đề:
Xóa người thử nghiệm khỏi phần Xem tất cả người thử nghiệm của tab Người thử nghiệm & Nhóm trong trang Phân phối ứng dụng của bảng điều khiển Firebase. Các lời mời hiện có sẽ bị xóa.
Mời lại người thử nghiệm để thử nghiệm ứng dụng của bạn. Người thử nghiệm sẽ nhận được email mời.
Đảm bảo rằng người thử nghiệm chấp nhận lời mời có cùng địa chỉ email.
Người kiểm tra có thể không nhận được thông báo qua email nếu xảy ra một trong các trường hợp sau:
Thông báo email được gửi đến thư mục thư rác.
Bộ lọc email được đặt.
Lời mời đã được gửi đến một tài khoản email, nhưng người kiểm tra đã chấp nhận bằng một tài khoản email khác. Người kiểm tra nhận được email phát hành mới cho tài khoản email mà lời mời ban đầu được gửi đến.
Người thử nghiệm đã được mời trước đó nhưng không chấp nhận lời mời ban đầu. Nếu người thử nghiệm được thêm vào các bản phát hành tiếp theo, thì Phân phối ứng dụng sẽ không tự động gửi thông báo phát hành cho người thử nghiệm đó vì người thử nghiệm không chấp nhận lời mời ban đầu.
Giải pháp 1
Yêu cầu người kiểm tra kiểm tra thư mục thư rác và bất kỳ bộ lọc email nào họ đặt trong dịch vụ email của họ.
Nếu người kiểm tra hủy đăng ký nhận email, hãy yêu cầu người kiểm tra làm như sau:
- Tìm một email mà người thử nghiệm đã nhận được trước đó từ ứng dụng.
- Nhấp vào Quản lý cài đặt email ở dưới cùng và nhấp vào Cho phép đăng ký lại email .
Giải pháp 2
Xóa người thử nghiệm khỏi phần Xem tất cả người thử nghiệm của tab Người thử nghiệm & Nhóm trong trang Phân phối ứng dụng trong bảng điều khiển Firebase. Hành động này sẽ xóa các lời mời hiện có.
Mời lại người thử nghiệm để thử nghiệm ứng dụng của bạn. Người thử nghiệm sẽ nhận được email mời. Đảm bảo rằng người thử nghiệm chấp nhận lời mời có cùng địa chỉ email mà lời mời đã được gửi đến.
Nếu người thử nghiệm tải xuống và cài đặt một bản phát hành nhưng giao diện người dùng chi tiết ứng dụng không cho thấy rằng ứng dụng đã được cài đặt, thì đây là sự cố đã biết. Trong một số trường hợp, ID gói trong ứng dụng Firebase không khớp với ID gói của APK.
Xác minh rằng ID gói của APK khớp với ID gói của ứng dụng Firebase mà bạn đã sử dụng để tải bản phân phối lên.
Cảnh báo Android xuất hiện nếu ứng dụng hoặc trình duyệt đang chạy của bạn chưa được cấp quyền cài đặt ứng dụng bên ngoài Google Play. Để cấp quyền:
Android phiên bản 8 trở lên : Trong ứng dụng Cài đặt , nhấn Cho phép từ nguồn này .
Android phiên bản 7 trở về trước : Trong ứng dụng Cài đặt , chạm vào Bảo mật và chọn Nguồn không xác định . Khi lời nhắc xuất hiện, nhấn OK > Tin cậy .
Nếu APK thử nghiệm không cài đặt được trên thiết bị của người thử nghiệm:
- Xác minh rằng (các) chứng chỉ trong phiên bản mới khớp với chứng chỉ trong phiên bản được cài đặt trên thiết bị của người thử nghiệm. Hệ thống Android chỉ cho phép ứng dụng cập nhật nếu các chứng chỉ phù hợp. Để tìm hiểu thêm, hãy xem Cân nhắc ký kết .
- Đảm bảo rằng phiên bản hệ điều hành của thiết bị thử nghiệm được ứng dụng hỗ trợ (kiểm tra
minSdkVersion
).
Nếu ứng dụng Trình kiểm tra ứng dụng ngăn bạn đăng nhập và chuyển hướng bạn quay lại màn hình đăng nhập, thì có thể bạn đang sử dụng Google Workspace (trước đây là GSuite) bao gồm các tùy chọn cài đặt hạn chế.
Để xóa cài đặt hạn chế của bạn:
Trong tab Ứng dụng của Google Workspace, hãy đảm bảo bạn không đặt Phân phối ứng dụng Firebase thành Quyền truy cập: Bị chặn .
Trong tab Dịch vụ , đảm bảo Nền tảng đám mây không bị hạn chế.
Sau khi xóa cài đặt, hãy thử đăng nhập lại.
Lỗi này có thể xảy ra khi ứng dụng đang được cài đặt xung đột với ứng dụng đã được cài đặt trên thiết bị. Ví dụ: đó có thể là một biến thể khác của cùng một ứng dụng có cùng quyền tùy chỉnh hoặc tên ContentProvider .
Bạn có thể yêu cầu người kiểm tra thu thập báo cáo lỗi ngay sau khi gặp sự cố và kiểm tra báo cáo để biết thêm thông tin về nguyên nhân. Người thử nghiệm phải xóa mọi ứng dụng xung đột trước khi có thể cài đặt ứng dụng mới.
Khi bạn gặp lỗi 403, điều này có nghĩa là tài khoản bạn đang sử dụng không có quyền cài đặt và thử nghiệm ứng dụng. Quyền truy cập do quản trị viên của miền tài khoản của bạn trong Google Workspace xác định.
Nếu bạn cho rằng mình nên có quyền cài đặt và thử nghiệm ứng dụng, hãy yêu cầu quản trị viên tài khoản Google Workspace thay đổi chế độ cài đặt tài khoản của bạn. Quản trị viên của bạn nên làm theo hướng dẫn trong Quản lý quyền truy cập vào các dịch vụ không được kiểm soát riêng lẻ .
Nếu bạn có nhiều tài khoản, hãy thử đăng nhập bằng một tài khoản khác không bị hạn chế cài đặt và thử nghiệm ứng dụng.
Bật cảnh báo trong ứng dụng với SDK Android phân phối ứng dụng
Sử dụng các mẹo sau để khắc phục sự cố liên quan đến việc bật cảnh báo bản dựng mới trong ứng dụng bằng cách sử dụng SDK Android phân phối ứng dụng.
Nếu bạn đã thiết lập SDK Android phân phối ứng dụng trong ứng dụng của mình và người thử nghiệm của bạn không nhận được cảnh báo trong ứng dụng, hãy làm theo các bước sau:
Kiểm tra thông báo lỗi bằng cách đính kèm
OnFailureListener
vào Tác vụ do API phân phối ứng dụng Firebase trả về.Java
firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener ( e -> { if (e instanceof FirebaseAppDistributionException) { // Log exception here }});
Kotlin
firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener { e -> if (e is FirebaseAppDistributionException) { // Log exception here } }
Kiểm tra xem người kiểm tra có quyền truy cập vào bản phát hành mới không:
Bật chế độ gỡ lỗi trong ứng dụng của bạn. Để tìm hiểu cách thực hiện, hãy xem tài liệu Google Analytics .
Chạy ứng dụng của bạn trong trình mô phỏng và tìm kiếm chuỗi "FirebaseAppDistribution".
Nếu nhật ký cho thấy không tìm thấy bản phát hành nào hoặc người thử nghiệm không có quyền truy cập, thì người thử nghiệm của bạn có thể chưa được liên kết với bản phát hành mới.
Trong bảng điều khiển Phân phối ứng dụng của bảng điều khiển Firebase, hãy đảm bảo rằng người thử nghiệm của bạn được bao gồm trong bản phân phối bản dựng của bạn và ở trạng thái Được chấp nhận .
Nếu người thử nghiệm của bạn vẫn không nhận được thông báo, hãy yêu cầu họ làm theo các mẹo bên dưới để đảm bảo rằng họ đã chấp nhận lời mời thử nghiệm ứng dụng của bạn và rằng họ đã thiết lập đúng thiết bị thử nghiệm của mình:
Trên thiết bị thử nghiệm, hãy đăng nhập vào Phân phối ứng dụng Firebase thông qua Trình kiểm tra ứng dụng hoặc qua ứng dụng web của trình kiểm tra. Hãy nhớ chọn tài khoản Google mà bạn sử dụng lần đầu khi chấp nhận lời mời dùng thử ứng dụng.
Kiểm tra để đảm bảo bản phát hành ứng dụng mới có sẵn trong Trình kiểm tra ứng dụng hoặc ứng dụng web dành cho người kiểm tra.
Theo mặc định, những người thử nghiệm của bạn chỉ cần đăng nhập vào tài khoản Google của họ một lần để bật các bản cập nhật bản dựng mới và cài đặt các bản dựng mới. Nếu người thử nghiệm của bạn được nhắc đăng nhập lại sau khi đóng và mở lại ứng dụng của bạn, hãy làm theo các mẹo sau để đảm bảo cấu hình Phân phối ứng dụng của bạn được thiết lập đúng cách:
Kiểm tra để đảm bảo bạn đã bật API Trình kiểm tra ứng dụng Firebase. Để biết thêm thông tin, hãy xem Bật API Trình kiểm tra phân phối ứng dụng .
Trong Các hạn chế về khóa , hãy đảm bảo rằng API của Trình kiểm tra ứng dụng Firebase được đưa vào danh sách các API được phép.
Nếu bạn thường xóa SharedPreferences khi đăng xuất, thì có thể bạn đang xóa trạng thái của người kiểm tra. Phân phối ứng dụng lưu trữ một cờ cho biết người thử nghiệm của bạn đã đăng nhập vào ứng dụng hay chưa. Để biết thêm thông tin, hãy xem kho lưu trữ GitHub .
Các câu hỏi thường gặp
Phân phối ứng dụng Firebase có các giới hạn dành cho người kiểm tra sau:
Thêm tối đa 500 người thử nghiệm vào dự án Firebase
Thêm tối đa 200 người thử nghiệm vào nhóm Phân phối ứng dụng
Để thêm nhiều người thử nghiệm hơn, hãy yêu cầu tăng giới hạn miễn phí .
Người thử nghiệm có 30 ngày để chấp nhận lời mời thử nghiệm ứng dụng trước khi hết hạn. Khi lời mời còn 5 ngày kể từ ngày hết hạn, thông báo hết hạn sẽ xuất hiện trong bảng điều khiển Firebase bên cạnh trình thử nghiệm trên bản phát hành. Bạn có thể gia hạn lời mời bằng cách gửi lại lời mời qua menu thả xuống trên hàng người thử nghiệm.
Bản phát hành ứng dụng bị xóa khỏi Phân phối ứng dụng nếu một trong các điều kiện sau xảy ra:
- Bản phát hành ứng dụng đã cũ hơn 150 ngày.
- Bạn vượt quá giới hạn 1.000 bản phát hành ứng dụng và bản phát hành ứng dụng cũ hơn 1.000 bản phát hành ứng dụng gần đây nhất.
Để biết thêm thông tin, hãy xem Phân phối ứng dụng hỗ trợ tối đa 1.000 bản phát hành .
Sau khi ứng dụng đạt đến hoặc vượt quá giới hạn hết hạn 150 ngày hoặc giới hạn 1.000 bản phát hành, bản phát hành sẽ bị xóa khỏi bảng điều khiển Phân phối ứng dụng và ứng dụng Trình kiểm tra ứng dụng Firebase. Nếu người thử nghiệm của bạn đã cài đặt bản phát hành, phiên bản cục bộ của ứng dụng sẽ tiếp tục chạy.
Để giữ cho bản phát hành ứng dụng tồn tại lâu hơn, hãy sử dụng một trong các đề xuất sau:
- Trước khi bản phát hành ứng dụng hết hạn hoặc vượt quá giới hạn phát hành, hãy tải xuống APK hoặc AAB và xóa bản phát hành khỏi bảng điều khiển Phân phối ứng dụng. Sau đó, tải lại APK hoặc AAB dưới dạng bản dựng mới lên Phân phối ứng dụng.
- Tải xuống bản phát hành và tải nó lên Cloud Storage để lưu trữ lâu dài.
Bản phát hành ứng dụng hết hạn sau 150 ngày
Khi bạn tải một bản phát hành ứng dụng của mình lên Firebase, bản phát hành đó sẽ xuất hiện trong bảng điều khiển Phân phối ứng dụng trong 150 ngày, kể từ ngày tải lên. Sau khi tải bản phát hành lên, bạn có thể phân phối bản phát hành đó cho những người thử nghiệm, những người này sẽ cài đặt bản phát hành từ ứng dụng Trình kiểm tra ứng dụng Firebase trên thiết bị thử nghiệm của họ.
Khi bản phát hành còn 30 ngày kể từ ngày hết hạn, thông báo hết hạn phát hành ứng dụng sẽ xuất hiện trên bản phát hành của bạn trong ứng dụng Firebase App Tester.
Phân phối ứng dụng hỗ trợ tối đa 1.000 bản phát hành
Phân phối ứng dụng cho phép tối đa 1.000 bản phát hành cho mỗi ứng dụng. Khi ứng dụng của bạn đạt đến giới hạn phát hành 1.000 ứng dụng, Phân phối ứng dụng sẽ tự động xóa các bản phát hành cũ nhất vượt quá giới hạn.
Nếu bạn muốn quản lý các bản phát hành ứng dụng của mình theo cách thủ công, hãy sử dụng API REST phân phối ứng dụng để liệt kê và xóa hàng loạt bản phát hành ứng dụng.
Nếu bạn có câu hỏi, hãy liên hệ với bộ phận Hỗ trợ của Firebase .
Nếu bạn là người thử nghiệm, chúng tôi khuyên bạn nên tải xuống Trình kiểm tra ứng dụng Firebase , một ứng dụng cho phép bạn truy cập tất cả các bản dựng thử nghiệm của mình ở một nơi.
Để xóa tài khoản người thử nghiệm Phân phối ứng dụng của bạn và dữ liệu được liên kết với tài khoản đó, hãy làm theo các bước sau theo thứ tự:
Truy cập https://appdistribution.firebase.google.com và đăng nhập bằng tài khoản Google của bạn.
Ở trên cùng bên phải, nhấp vào
( Quản lý tài khoản )Xóa tài khoản .
Tùy chọn: Trong quyền tài khoản Google của bạn , thu hồi quyền truy cập từ Phân phối ứng dụng Firebase. Lưu ý rằng việc thu hồi quyền truy cập mà không xóa tài khoản Phân phối ứng dụng của bạn trước sẽ không xóa dữ liệu hoặc tài khoản người thử nghiệm của bạn.