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 câu hỏi về việc phân phối và kiểm thử ứng dụng bằng tính năng Phân phối ứng dụng.
Phân phối ứng dụng
Hãy áp dụng các mẹo sau đây để khắc phục sự cố mà bạn có thể gặp phải khi phân phối ứng dụng đến người kiểm thử.
Không thể phân phối ứng dụng do thiếu email liên hệ
Khi tải ứng dụng lên, bạn có thể gặp lỗi sau:
"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
Tính năng Phân phối ứng dụng trong bảng điều khiển của Firebase để thiết lập một tính năng."
Thiết lập một Email liên hệ trong bảng điều khiển của Firebase (nếu có). Nếu vấn đề vẫn còn, hãy liên hệ với Nhóm hỗ trợ của Firebase.
Đã xảy ra lỗi khi cấp phép ứng dụng của bạn (lỗi 400, 409 hoặc 500)
Nếu bạn liên tục gặp phải lỗi 400, 409 hoặc 500 trong khi cung cấp, liên hệ với Nhóm hỗ trợ của Firebase. Cung cấp Hỗ trợ với số dự án Firebase và mã nhận dạng ứng dụng của bạn.
Không thể tải IPA lê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."
}
Để khắc phục 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, hãy làm theo các bước sau:
Kiểm tra tệp
Info.plistvà xác nhận xemCFBundleDisplayNamecó phải là chứa bất kỳ dấu phân cách<array>nào.Xoá các dấu phân cách
<array>và xây dựng lại ứng dụng. Tệp tải lên nên thành công.Nếu bạn vẫn gặp sự cố, hãy liên hệ với Nhóm 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 đối với hãy 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 vấn đề, hãy liên hệ với Nhóm hỗ trợ của Firebase và hỏi về cách sử dụng Chuyến bay thử nghiệm.
Cài đặt và kiểm thử ứng dụng
Hãy áp dụng các mẹo sau để khắc phục những vấn đề mà người kiểm thử có thể gặp phải gặp phải khi cài đặt và kiểm thử ứng dụng của bạn.
Người kiểm thử chưa có Tài khoản Google
Khi người dùng tạo Tài khoản Google, họ sẽ tự động nhận được một địa chỉ Gmail.
Nếu người kiểm thử không có địa chỉ Google Workspace hay địa chỉ Gmail hoặc nếu họ thay vì 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ỉ không phải Gmail địa chỉ email vào tài khoản và sử dụng email đó để đăng nhập.
Khi chọn một email thay thế, người kiểm thử phải tuân theo các nguyên tắc sau:
- Đừng sử dụng địa chỉ Gmail.
- Không sử dụng địa chỉ email đã được liên kết với một Tài khoản Google khác.
- Nhớ sử dụng mật khẩu Tài khoản Google của bạn khi đăng nhập bằng email này của bạn.
Để biết thêm thông tin, hãy xem bài viết Đăng nhập vào Tài khoản Google bằng địa chỉ email khác.
Người kiểm thử không thấy đúng ứng dụng hoặc bản dựng
Nếu người kiểm thử chấp nhận lời mời qua email bằng một địa chỉ email khác với lời mời được gửi tới, người kiểm thử có thể không thấy ứng dụng phù hợp 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 thử dùng để chấp nhận lời mời (Email B). Thao tác này sẽ tạo một đường liên kết trong nền. Bất cứ khi nào gửi email cho A được thêm vào bản dựng mới thì email B đang nhận quyền truy cập.
Nếu người kiểm thử 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 đề:
Xoá người kiểm thử khỏi phần Xem tất cả người kiểm thử của phần Nhân viên kiểm thử và Thẻ Groups trong tính năng Phân phối ứng dụng của bảng điều khiển của Firebase. Những lời mời hiện có sẽ bị xoá.
Mời lại người kiểm thử ứng dụng của bạn. Người kiểm thử sẽ nhận được một email gửi lời mời.
Đảm bảo rằng người kiểm thử chấp nhận lời mời bằng cùng một địa chỉ email.
Người kiểm thử không nhận được thông báo qua email
Có thể người thử nghiệm sẽ không nhận được thông báo qua email nếu một trong những trường hợp sau xảy ra:
Thông báo qua email được gửi đến thư mục thư rác.
Đã đặt bộ lọc email.
Lời mời được gửi đến một tài khoản email, nhưng người kiểm thử đã chấp nhận bằng tài khoản email khác nhau. Người kiểm thử nhận được email phát hành mới cho tài khoản email nhận lời mời ban đầu.
Người kiểm thử này từng được mời nhưng không chấp nhận lời mời ban đầu. Nếu người kiểm thử được thêm vào các bản phát hành tiếp theo, thì tính năng Phân phối ứng dụng sẽ không sẽ tự động gửi thông báo phát hành cho người kiểm thử đó vì người kiểm thử đã không chấp nhận lời mời ban đầu.
Giải pháp 1
Đề nghị người kiểm thử kiểm tra thư mục thư rác và mọi bộ lọc email họ đã thiết lập dịch vụ email của họ.
Nếu người kiểm thử huỷ đăng ký nhận email, hãy đề nghị họ làm lại sau:
- Tìm email mà người kiểm thử đã nhận được trước đây từ ứng dụng.
- Nhấp vào Quản lý chế độ cài đặt email ở dưới cùng rồi nhấp vào Cho phép email để đăng ký lại.
Giải pháp 2
Nếu người kiểm thử không quan tâm đến việc nhận thông báo qua email mà chỉ muốn nhận thông báo có thể chấp nhận lời mời sử dụng ứng dụng, họ có thể xem các lời mời sử dụng ứng dụng đang chờ xử lý ngay trong đoạn video trên web Phân phối ứng dụng Firebase: appdistribution.firebase.google.com.
Giải pháp 3
Xoá người kiểm thử khỏi phần Xem tất cả người kiểm thử của phần Nhân viên kiểm thử và Thẻ Groups trong tính năng Phân phối ứng dụng trong bảng điều khiển của Firebase. Thao tác này sẽ xoá các lời mời hiện có.
Mời lại người kiểm thử ứng dụng của bạn. Người kiểm thử sẽ nhận được một email gửi lời mời. Hãy đảm bảo người kiểm thử chấp nhận lời mời bằng cùng địa chỉ email đã nhận được thư mời.
"Nhà phát triển doanh nghiệp không đáng tin cậy" lỗi khi cố gắng chạy ứng dụng thử nghiệm
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ị kiểm thử trước khi mở ứng dụng. Trong ứng dụng Cài đặt > Hồ sơ và 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 tên đó.
"Cần có Chế độ nhà phát triển" lỗi khi cố gắng chạy ứng dụng thử nghiệm
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 quảng cáo ứng dụng iOS được cung cấp bởi Học trên iOS 16 trở lên mà không cần bật trước cho Nhà phát triển Chế độ.
Để 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, hãy mở ứng dụng Cài đặt rồi nhấn vào Quyền riêng tư và Bảo mật.
- Cuộn xuống phần Bảo mật rồi 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ở khoá thiết bị. Bật Chế độ nhà phát triển? xuất hiện.
- Nhấn vào Bật. Bây giờ, bạn có thể chạy ứng dụng và bắt đầu thử nghiệm.
"Đã đăng ký thiết bị và bạn đã hoàn tất! Bạn sẽ nhận được email khi ứng dụng sẵn sàng thử nghiệm"
Nếu bạn đang cài đặt phân phối Học tập, 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. Để 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 phần Đăng ký thiết bị bổ sung.
Tài khoản Google không có quyền truy cập vào ứng dụng thử nghiệm
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 từng truy cập đã cài đặt (hoặc đã chấp nhận lời mời), thì có thể bạn đã ký vào tài khoản Google không chính xác. 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 chấp nhận lần đầu lời mời thử nghiệm ứng dụng. 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.
Lỗi 403: "Hãy liên hệ với quản trị viên để có quyền truy cập"
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 là do quản trị viên miền của tài khoản trong Google Workspace xác định.
Nếu bạn cho rằng mình lẽ ra 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 chế độ cài đặt tài khoản. Quản trị viên của bạn cần làm theo hướng dẫn trong bài viết Quản lý quyền truy cập vào các dịch vụ không được kiểm soát riêng.
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 bằng SDK iOS Phân phối ứng dụng
Hãy áp dụng các mẹo sau đây để khắc phục sự cố liên quan đến bật cảnh báo về 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.
Người kiểm thử không nhận được cảnh báo trong ứng dụng
Nếu bạn đã thiết lập SDK iOS Phân phối ứng dụng trong ứng dụng và người kiểm thử không nhận được cảnh báo trong ứng dụng, hãy kiểm tra để đảm bảo ứng dụng của bạn tìm nạp 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 về Google Analytics.
Chạy ứng dụng của bạn trong trình mô phỏng rồi tìm chuỗi "[Firebase/AppDistribution]".
Kiểm tra để đảm bảo người kiểm thử 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ả về, thì có khả năng vấn đề trong vòng đời của Trình điều khiển khung hiển thị khi hộp thoại cảnh báo là đượ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ề, người kiểm thử 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 của Firebase, hãy nhớ thêm người kiểm thử vào bản dựng của bạn và đang ở trạng thái Đã chấp nhận.
Nếu người kiểm thử vẫn không nhận được thông tin cập nhật, hãy yêu cầu họ làm theo dưới đây để đảm bảo họ đã chấp nhận lời mời thử nghiệm và 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 trang web Phân phối ứng dụng Firebase đoạn video. 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 xuất hiện trong đoạn video trên web.
Người kiểm thử được nhắc đăng nhập lại sau khi đóng ứng dụng
Theo mặc định, người thử nghiệm 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 về bản dựng mới và cài đặt bản dựng mới. Nếu người kiểm thử là được nhắc đăng nhập lại sau khi đóng và mở lại ứng dụng, hãy làm theo các bước sau để đảm bảo cấu hình Phân phối ứng dụng được thiết lập đúng cách:
Kiểm tra để đảm bảo rằng bạn đã bật API Người kiểm tra ứng dụng Firebase. Để biết thêm hãy xem bài viết Bật API Người kiểm tra phân phối ứng dụng.
Trong mục 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ó trong danh sách API được phép.
Nếu thường xoá UserDefaults khi đăng xuất, thì có thể bạn đang xoá trạng thái của người kiểm thử. Tính năng Phân phối ứng dụng lưu trữ một cờ cho biết liệu người kiểm thử của bạn đã đăng nhập vào ứng dụng. Để biết thêm thông tin, hãy xem Kho lưu trữ GitHub.
Câu hỏi thường gặp
Có giới hạn nào đối với việc thêm người kiểm thử vào ứng dụng của tôi không?
Tính năng Phân phối ứng dụng Firebase có các giới hạn sau đây về số người kiểm thử:
Thêm tối đa 500 người thử nghiệm vào một dự án Firebase
Thêm tối đa 200 người kiểm thử vào một nhóm Phân phối ứng dụng
Để thêm nhiều người kiểm thử hơn, hãy yêu cầu gói không tốn phí tăng hạn mức.
Lời mời người kiểm thử của tôi có hết hạn không?
Người kiểm thử có 30 ngày để chấp nhận lời mời kiểm thử ứng dụng trước khi ứng dụng hết hạn. Khi lời mời hết hạn 5 ngày, thông báo hết hạn sẽ xuất hiện trong bảng điều khiển của Firebase bên cạnh người kiểm thử trên một bản phát hành. Có thể gia hạn lời mời bằng cách gửi lại thông qua trình đơn thả xuống trên hàng người kiểm thử.
Khi nào một bản phát hành mới được tạo cho nội dung tải lên iOS?
Hãy xem phần Đăng ký thiết bị bổ sung.
Bản phát hành ứng dụng có sẵn trong bao lâu?
Bản phát hành ứng dụng sẽ bị xoá khỏi tính năng Phân phối ứng dụng nếu một trong những điều sau điều kiện xảy ra:
- Bản phát hành ứng dụng này đã quá 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â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 1.000 ứng dụng giới hạn phát hành, bản phát hành sẽ bị xoá khỏi trang tổng quan 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 kiểm thử đã cài đặt bản phát hành, thì phiên bản phiên bản của ứng dụng 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 áp dụng một trong những đề 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 bản phát hành, hãy tải IPA và xoá bản phát hành khỏi Trang tổng quan về Phân phối ứng dụng. Sau đó: hãy tải IPA lên lại dưới dạng bản dựng mới cho tính năng Phân phối ứng dụng.
- Tải bản phát hành xuống và tải 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 một bản phát hành ứng dụng lên Firebase, bản phát hành đó sẽ xuất hiện trong Trang tổng quan về 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 đến người kiểm thử, những người cài đặt bản phát hành từ Phân phối ứng dụng trên thiết bị kiểm thử của họ.
Khi bản phát hành được 30 ngày kể từ ngày hết hạn, một bản phát hành ứng dụng thông báo hết hạn 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 của Firebase và trong ứng dụng web của trình kiểm tra Phân phối ứng dụng.
Tính nă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 trên 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, Tính năng Phân phối ứng dụng sẽ tự động xoá ứng dụng 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 theo cách thủ công, hãy dùng API REST Phân phối ứng dụng để liệt kê và xoá phát hành ứng dụng hàng loạt.
Nếu bạn có thắc mắc, hãy liên hệ với Nhóm hỗ trợ của Firebase.
Hồ sơ Firebase là gì?
Hồ sơ Firebase là một hồ sơ cấu hình cho phép tính năng Phân phối ứng dụng:
Đăng ký thiết bị thử nghiệm bằng cách thu thập mã thiết bị duy nhất của thiết bị đó (UDID). Nếu bạn đang thử nghiệm phân phối Ad Hoc, Firebase sẽ gửi ứng dụng email chứa UDID của thiết bị thử nghiệm cho nhà phát triển, cùng với hướng dẫn về cách đưa thiết bị vào cấp phép của ứng dụng để có thể kiểm thử bản dựng trên thiết bị của bạn.
Cài đặt đoạn video trên web của tính năng Phân phối ứng dụng Firebase vào trang chủ của thiết bị màn hình. Web clip này cho phép bạn cài đặt và truy cập vào tất cả ứng dụng thử nghiệm trong cùng một nơi. Các bản dựng mới mà bạn được mời thử nghiệm tự động được thêm vào đoạn video trên web.
Để được trợ giúp về cách cài đặt hồ sơ cấu hình trên thiết bị iOS, hãy tham khảo Tài liệu của Apple.
Làm cách nào để truy cập vào các ứng dụng thử nghiệm tôi đã cài đặt trên thiết bị của mình?
Nếu là người kiểm thử, bạn có thể truy cập vào tất cả các ứng dụng kiểm thử của mình bằng Đoạn video trên web Phân phối ứng dụng Firebase, được tự động thêm vào thử nghiệm của bạn màn hình chính của thiết bị khi bạn cài đặt hồ sơ Firebase. Nếu bạn đang thử nghiệm một Khi phân phối Học tập, trước tiên, cài đặt hồ sơ trước khi có thể kiểm thử ứng dụng.
Nếu bạn đang thử nghiệm một Trong phân phối dành cho doanh nghiệp, bạn có thể cài đặt hồ sơ theo cách thủ công:
Đăng nhập vào Google và chấp nhận lời mời.
Trong phần Test apps (Kiểm thử ứng dụng), hãy chọn ứng dụng bạn muốn kiểm thử.
Ở trên cùng bên phải trang của ứng dụng, hãy nhấn vào mobile_screen_share.
Làm theo hướng dẫn trên màn hình để cài đặt hồ sơ Firebase.
Làm cách nào để xoá tài khoản người kiểm thử?
Cách xoá tài khoản người kiểm thử tính năng Phân phối ứng dụng và dữ liệu 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 vào 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, hãy nhấp vào settings (Quản lý tài khoản)
Xoá tài khoản.
Không bắt buộc: Trong phần Quyền đối với Tài khoản Google, thu hồi quyền truy cập từ Phân phối ứng dụng Firebase. Xin lưu ý rằng việc thu hồi quyền truy cập mà không trước tiên, việc xoá tài khoản Phân phối ứng dụng sẽ không xoá người kiểm thử của bạn tài khoản hoặc dữ liệu của bạn.