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ề việc phân phối và thử nghiệm ứng dụng bằng 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 một email."
Đặ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 phải 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ợ Firebase . Cung cấp Hỗ trợ bằng số dự án Firebase và số nhận dạng ứng dụng của bạn.
Sau đây là 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, tức là 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 được, hãy làm theo các bước sau:
Kiểm tra tệp
Info.plistcủa bạn và xác nhận xemCFBundleDisplayNamecó chứa bất kỳ dấu phân cách<array>nào không.Xóa dấu phân cách
<array>và xây dựng lại ứng dụng của bạn. Việc 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 mọi thay đổi cần thiết để 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ợ 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ó 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ỉ Google Workspace hoặc 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 thử nghiệm 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 đị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 lời mời được gửi đến thì người thử nghiệm có thể không nhìn thấy đúng ứng dụng hoặc bản dựng.
Email mà nhà phát triển gửi lời mời đến và thêm vào bản dựng mới (Email A) có thể khác với email mà người kiểm tra 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 tế là Email B đang có quyền truy cập.
Nếu người thử nghiệm 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. Những lời mời hiện tại 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 thử nghiệm có thể không nhận được thông báo qua email nếu xảy ra một trong những điều 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 tới 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 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, 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à mọi bộ lọc email họ đặt trong dịch vụ email của mình.
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 kiểm tra trước đây đã nhận đượ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
Nếu người thử nghiệm không quan tâm đến việc nhận thông báo qua email và chỉ muốn có thể chấp nhận lời mời ứng dụng, họ có thể xem lời mời ứng dụng đang chờ xử lý trực tiếp trong clip web Phân phối ứng dụng Firebase: appdistribution.firebase.google.com .
Giải pháp 3
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 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.
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 màn hình Cài đặt ứng dụng > Cấu hình & Quản lý thiết bị , chọn tên nhà phát triển của ứng dụng và tin cậy nó.
Lỗi Yêu cầu Chế độ nhà phát triển xuất hiện khi bạn cố gắng khởi chạy một ứng dụng iOS được cung cấp đặc biệt trên iOS 16 trở lên mà không bật Chế độ nhà phát triển trước.
Để bật Chế độ nhà phát triển và khắc phục lỗi này, hãy làm theo các bước sau:
- Trên iPhone của bạn, hãy mở ứng dụng Cài đặt rồi chạm vào Quyền riêng tư & Bảo mật .
- Cuộn xuống Bảo mật và nhấn vào Chế độ nhà phát triển .
- Nhấn vào thanh trượt Chế độ nhà phát triển .
- Nhấn vào Khởi động lại .
- Sau khi thiết bị khởi động lại, hãy mở khóa thiết bị. Bật Chế độ nhà phát triển? hộp thoại xuất hiện.
- Nhấn Bật . Bây giờ bạn có thể khởi chạy ứng dụng của mình và bắt đầu thử nghiệm.
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 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 ứ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ó thể bạn đã đăng nhập vào sai tài khoản Google. 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 lần đầu tiên chấp nhận lời mời thử nghiệm ứng dụng. Hãy thử lại bằng cách đăng nhập bằng tài khoản Google mà trước đây bạn đã sử dụng để chấp nhận lời 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à kiểm tra ứng dụng. Quyền truy cập do quản trị viên miền của tài khoản của bạn trong Google Workspace xác định.
Nếu bạn cho rằng mình cầ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 các tùy chọn 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 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 bằng 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 cách sử dụ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 không nhận được thông báo trong ứng dụng, hãy kiểm tra để đảm bảo ứ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 xem người thử nghiệm có quyền truy cập vào bản phát hành mới hay không:
Nếu một đối tượng phát hành hợp lệ được trả về thì có thể đã xảy ra sự cố trong vòng đời của Bộ điều khiển Chế độ xem khiến hộp thoại cảnh báo được tải trước khi Chế độ xem xuất hiện.
Nếu không có bản phát hành nào được trả về 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 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 người thử nghiệm của bạn được đưa vào 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 đúng cách:
Trên thiết bị thử nghiệm, hãy đăng nhập vào clip 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 tiên khi chấp nhận lời mời dùng thử ứ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 phần Hạn chế chính , hãy đảm bảo rằng API người 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 UserDefaults khi đăng xuất thì có thể bạn đang xóa trạng thái của người thử nghiệm. 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 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 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 dùng thử ứng dụng trước khi ứng dụng hết hạn. Khi lời mời còn 5 ngày kể từ khi 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 trên bản phát hành. Lời mời có thể được gia hạn bằng cách gửi lại thông qua menu thả xuống trên hàng người thử nghiệm.
Xem Đăng ký thiết bị bổ sung .
Bản phát hành ứng dụng sẽ bị xóa khỏi Phân phối ứng dụng nếu xảy ra một trong các điều kiện sau:
- 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 này 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 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 ứng dụng, 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 web của người 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 thì phiên bản cục bộ của ứng dụng sẽ tiếp tục chạy.
Để duy trì bản phát hành ứng 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 bảng điều khiển 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 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 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 cài đặt bản phát hành từ ứng dụng web dành cho 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 bả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 trên trang Phân phối ứng dụng của bảng điều khiển Firebase và trong ứng dụng web 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ý bản phát hành ứng dụng 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ó thắc mắc, hãy liên hệ với Bộ phận hỗ trợ của Firebase .
Cấu hình Firebase là cấu hình 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 (UDID) của thiết bị. 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ơ cung cấ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 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 trên web.
Để được trợ giúp cài đặt hồ sơ 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 web Phân phối ứng dụng Firebase , clip này được tự động thêm vào màn hình chính của thiết bị thử nghiệm khi bạn cài đặt hồ sơ Firebase. Nếu bạn đang thử nghiệm bản 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 đang thử nghiệm bản phân phối Enterprise, 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 phần Kiểm tra ứng dụng , hãy 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 hiển thị để cài đặt hồ sơ 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 liên quan, 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, 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 sẽ không xóa dữ liệu hoặc tài khoản người thử nghiệm của bạn.