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.
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, 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 sản xuất, 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 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 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ợ của Firebase và hỏi về việc 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à 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
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, thì họ có thể xem trực tiếp lời mời ứng dụng đang chờ xử lý trong đoạn 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 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.
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 tưởng 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 > Cấu 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 đó.
Lỗi Chế độ nhà phát triển bắt buộc xuất hiện khi bạn cố gắng khởi chạy ứ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 Chế độ nhà phát triển .
- Nhấn vào thanh trượt Chế độ nhà phát triển .
- Nhấn 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 vào 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), thì có thể bạn đã đăng nhập vào tài khoản Google không đúng. 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à 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 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à những 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 xem người kiểm tra có quyền truy cập vào bản phát hành mới 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 Trình điều khiển Chế độ xem nơi 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ả 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 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 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à 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 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 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 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 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 UserDefaults 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.
Xem Đăng ký thiết bị bổ sung .
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 ứ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 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 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 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 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 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 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 thử nghiệm 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 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 .
Hồ sơ Firebase là một hồ sơ cấu hình cho phép Phân phối ứng dụng:
Đăng ký thiết bị kiểm tra 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 để có thể thử nghiệm bản dựng 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ị. Đ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 web.
Để được trợ giúp về cài đặt cấu hình 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 vào 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 , đượ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 cấu hình Firebase. Nếu đ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 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 Ứng dụng thử nghiệm , hãy chọn ứng dụng bạn muốn thử nghiệm.
Ở 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 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.