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 cấp phép, hãy liên hệ với bộ phận Hỗ trợ của Firebase . Cung cấp cho Hỗ trợ số dự án Firebase và số nhận dạng ứng dụng của bạn.
Sau đây là một ví dụ về phản hồi của mạng trình duyệt:
{
"status": "IN_PROGRESS",
"message": "There was an error processing your
distribution. Ensure you are uploading a valid IPA or APK and try again."
}
Để giải quyết vấn đề này, hãy làm theo các bước sau:
Xác minh kích thước của IPA. 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, hơn 2 GB một chút.
Nếu kích thước IPA nằm trong giới hạn kích thước tệp và có thể tái tạo, hãy làm theo các bước sau:
Kiểm tra tệp
Info.plist
của bạn và xác nhận xemCFBundleDisplayName
có chứa bất kỳ dấu phân cách<array>
nào hay không.Xóa các dấu phân cách
<array>
và xây dựng lại ứng dụng của bạn. Quá trình tải lên sẽ thành công.Nếu bạn vẫn gặp sự cố, hãy liên hệ với Bộ phận hỗ trợ của Firebase .
Nếu kích thước IPA vượt quá giới hạn kích thước tệp, hãy thực hiện bất kỳ thay đổi cần thiết nào để giảm kích thước tệp.
Nếu việc giảm kích thước tệp IPA không giải quyết được sự cố, hãy liên hệ với Bộ phận hỗ trợ của Firebase và hỏi về cách sử dụng Testflight .
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à kiểm tra ứ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 kiểm tra không có Google Workspace hoặc địa chỉ Gmail hoặc nếu họ muốn sử dụng địa chỉ email khác để đăng nhập, hãy yêu cầu người kiểm tra liên kế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 một đị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, người thử nghiệm có thể không thấy 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ực sự thì Email B đang nhận được quyền truy cập.
Nếu người thử nghiệm chấp nhận lời mời qua email có đị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 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ó đã bị xóa.
Mời lại người thử nghiệm để kiểm tra ứng dụng của bạn. Người thử nghiệm sẽ nhận được một 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 một trong những điều sau xảy ra:
Email thông báo được gửi đến thư mục thư rác.
Bộ lọc email đã được thiết lập.
Lời mời đã được gửi đến một tài khoản email, nhưng người thử nghiệm đã chấp nhận bằng một tài khoản email khác. Người thử nghiệm nhận được các email phát hành mới cho tài khoản email mà lời mời đã được gửi ban đầu.
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, 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 thử nghiệm 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 thử nghiệm hủy đăng ký nhận email, hãy yêu cầu người thử nghiệm thực hiện những việc sau:
- Tìm 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 email đăng ký lại.
Giải pháp 2
Xóa người thử nghiệm khỏi 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 để kiểm tra ứng dụng của bạn. Người thử nghiệm sẽ nhận được một 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.
Lỗi Nhà phát triển doanh nghiệp không đáng tin cậy xuất hiện nếu bạn không tin cậy chứng chỉ nhà phát triển trên thiết bị thử nghiệm trước khi mở ứng dụng. Trong ứng dụng Cài đặt > Hồ sơ & màn hình Quản lý thiết bị , hãy chọn tên nhà phát triển của ứng dụng và tin tưởng vào tên đó.
Nếu bạn đang cài đặt bản phân phối Ad Hoc, thông báo này sẽ xuất hiện khi nhà phát triển chưa định cấu hình ứng dụng của họ để chạy trên thiết bị thử nghiệm của bạn. Để cung cấp ứng dụng cho bạn, nhà phát triển phải hoàn thành các hướng dẫn trong Đăng ký thiết bị bổ sung .
Nếu tài khoản Google của bạn không có quyền truy cập vào một ứng dụng thử nghiệm mà bạn đã cài đặt trước đó (hoặc chấp nhận lời mời), có khả năng là bạn đã đăng nhập vào tài khoản Google sai. Các ứng dụng mà bạn có quyền truy cập được liên kết với tài khoản Google mà bạn đã sử dụng khi bạn chấp nhận lời mời thử nghiệm ứng dụng lần đầu tiên. Hãy thử lại bằng cách đăng nhập bằng tài khoản Google mà bạn đã sử dụng trước đây để chấp nhận lời mời.
Khi bạn gặp phải 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 được xác định bởi quản trị viên miền tài khoản của bạn trong Google Workspace.
Nếu bạn cho rằng mình phải 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 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 iOS 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 SDK iOS phân phối ứng dụng.
Nếu bạn đã thiết lập SDK iOS 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 kiểm tra để đảm bảo rằng ứng dụng của bạn đang tìm nạp các bản phát hành mới:
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 "[Firebase / AppDistribution]".
Kiểm tra để đảm bảo rằng người thử nghiệm có quyền truy cập vào bản phát hành mới:
Nếu một đối tượng phát hành hợp lệ được trả lại, có thể có sự cố trong vòng đời của View Controller nơi hộp thoại cảnh báo được tải trước khi View xuất hiện.
Nếu không có bản phát hành nào được trả lại, 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 trang tổng quan 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ó 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 bản cập nhật, 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à họ đã thiết lập thiết bị thử nghiệm của mình đúng cách:
Trên thiết bị thử nghiệm, hãy đăng nhập vào clip trên web Phân phối ứng dụng Firebase. 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 thử nghiệm ứng dụng.
Đảm bảo rằng bản phát hành ứng dụng mới có sẵn trong clip trên web.
Theo mặc định, 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ảnh báo bản dựng mới và cài đặt 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 người 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ế chính , hãy đảm bảo rằng API người kiểm tra ứng dụng Firebase được bao gồm trong danh sách các API được phép.
Nếu bạn thường xóa UserDefaults khi đăng xuất, bạn có thể xóa trạng thái của người thử nghiệm của mình. Phân phối ứng dụng lưu trữ một cờ cho biết liệu 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 đối với người thử nghiệm 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 ứng dụng hết hạn. Khi lời mời còn 5 ngày nữa mới 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 người thử nghiệm về bản phát hành. 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 của 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 150 ngày hết hạn hoặc giới hạn 1.000 ứng dụng phát hành, bản phát hành sẽ bị xóa khỏi trang tổng quan Phân phối ứng dụng và ứng dụng web trình kiểm tra Phân phối ứng dụng. 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 khả dụng 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 IPA và xóa bản phát hành khỏi trang tổng quan Phân phối ứng dụng. Sau đó, tải lại IPA 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 sẽ hết hạn sau 150 ngày
Khi bạn tải 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 trang tổng quan Phân phối ứng dụng trong 150 ngày, bắt đầu 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 web của người thử nghiệm Phân phối ứng dụng 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 trang Phân phối ứng dụng của bảng điều khiển Firebase và trong ứng dụng web của trình kiểm tra Phân phối ứng dụng.
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 1.000 bản phát hành ứ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ý thủ công các bản phát hành ứng dụng của mình, hãy sử dụng API REST phân phối ứng dụng để liệt kê và xóa hàng loạt các bản phát hành ứng dụng.
Nếu bạn có thắc mắc, hãy liên hệ với Bộ phận hỗ trợ của Firebase .
Hồ sơ Firebase là hồ sơ cấu hình cho phép Phân phối ứng dụng:
Đăng ký thiết bị thử nghiệm bằng cách thu thập ID thiết bị duy nhất của thiết bị (UDID). Nếu bạn đang thử nghiệm bản phân phối Ad Hoc, Firebase sẽ gửi cho nhà phát triển ứng dụng một email bao gồm UDID của thiết bị thử nghiệm, cùng với hướng dẫn về cách đưa thiết bị vào hồ sơ cấp phép của ứng dụng để bản dựng có thể được thử nghiệm trên thiết bị của bạn.
Cài đặt clip web Phân phối ứng dụng Firebase vào màn hình chính của thiết bị của bạn. Đoạn clip trên web cho phép bạn cài đặt và truy cập tất cả các ứng dụng thử nghiệm của mình ở một nơi. Các bản dựng mới mà bạn được mời thử nghiệm sẽ tự động được thêm vào clip web.
Để được trợ giúp về cách cài đặt cấu hình trên thiết bị iOS của bạn, hãy tham khảo tài liệu của Apple .
Nếu là người thử nghiệm, bạn có thể truy cập tất cả các ứng dụng thử nghiệm của mình bằng clip trên web Phân phối ứng dụng Firebase, clip này sẽ tự động được thêm vào màn hình chính của thiết bị thử nghiệm khi bạn cài đặt cấu hình Firebase. Nếu bạn đang thử nghiệm phân phối Ad Hoc, trước tiên bạn phải cài đặt cấu hình trước khi có thể thử nghiệm ứng dụng.
Nếu bạn đang thử nghiệm bản phân phối Doanh nghiệp, bạn có thể cài đặt cấu hình theo cách thủ công:
Nếu bạn chưa đăng nhập, hãy đăng nhập vào Google và chấp nhận lời mời.
Trong Kiểm tra ứng dụng , chọn ứng dụng bạn muốn kiểm tra.
Ở trên cùng bên phải của trang ứng dụng, hãy nhấn vào mobile_screen_share .
Làm theo hướng dẫn được hiển thị để cài đặt cấu hình Firebase.
Để 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, 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 đối với tài khoản Google của bạn, hãy 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 trước tiên sẽ không xóa dữ liệu hoặc tài khoản người thử nghiệm của bạn.