Khắc phục sự cố Phân phối ứng dụng & Câu hỏi thường gặp

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 phải lỗi sau:

"Chúng tôi không tìm thấy địa chỉ email liên hệ cho ứng dụng <app-id>. Vui lòng truy cập vào App Distribution 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 vấn đề vẫn tiếp diễn, hãy liên hệ với Nhóm hỗ trợ 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 lỗi 400, 409 hoặc 500 trong quá trình cấp phép, hãy liên hệ với Nhóm hỗ trợ Firebase. Cung cấp cho Nhóm hỗ trợ số dự án Firebase và giá trị nhận dạng ứng dụng của bạn.

Không thể tải tệp IPA lên

Sau đây là ví dụ về phản hồi mạng của 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:

1. 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ả tệp nhị phân là 2048 MiB, tức là hơn 2 GB một chút.

2. 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 hiện, hãy làm theo các bước sau:

   1. Kiểm tra tệp Info.plist và xác nhận xem CFBundleDisplayName có chứa dấu phân tách <array> nào không.

   2. Xoá dấu phân cách <array> rồi tạo lại ứng dụng. Quá trình tải lên sẽ thành công.

   3. Nếu bạn vẫn gặp vấn đề, hãy liên hệ với Nhóm hỗ trợ Firebase.

3. Nếu kích thước tệp 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.

4. 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ợ Firebase và hỏi về cách sử dụng Testflight.

Người kiểm thử không có Tài khoản Google

Khi tạo Tài khoản Google, người dùng 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 hoặc Gmail, 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 kiểm thử 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 địa chỉ email thay thế, người kiểm tra phải tuân thủ các nguyên tắc sau:

• Đừng sử dụng địa chỉ Gmail.
• Đừng sử dụng địa chỉ email đã được liên kết với một 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 bài viết Đăng nhập vào Tài khoản Google bằng một địa chỉ email khác.

Người thử nghiệm 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 địa chỉ email nhận lời mời, thì người kiểm thử có thể không thấy đượ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 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 ngầm. Bất cứ khi nào Email A được thêm vào bản dựng mới, thì Email B mới là email được cấp 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 đề:

1. Xoá người kiểm thử khỏi phần Xem tất cả người kiểm thử của thẻ Người kiểm thử và nhóm trên trang App Distribution của Firebase Console. Các lời mời hiện có sẽ bị xoá.

2. Mời lại người kiểm thử để 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.

3. Đảm bảo rằng người kiểm thử chấp nhận lời mời bằng chính địa chỉ email đó.

Người kiểm thử không nhận được thông báo qua email

Người kiểm thử có thể không nhận được thông báo qua email nếu xảy ra một trong những trường hợp sau:

• 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 một tài khoản email khác. Người kiểm thử sẽ nhận được email về bản phát hành mới cho tài khoản email mà lời mời được gửi đến ban đầu.

• Người kiểm thử đã được mời trước đó 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ì App Distribution sẽ không tự động gửi thông báo về bản phát hành cho người kiểm thử đó vì người kiểm thử chưa chấp nhận lời mời ban đầu.

Giải pháp 1

1. Yêu cầu người kiểm thử kiểm tra thư mục thư rác và mọi bộ lọc email mà họ đặt trong dịch vụ email của họ.

2. Nếu người kiểm thử đã huỷ đăng ký nhận email, hãy yêu cầu người kiểm thử làm như sau:

   1. Tìm một email mà người kiểm thử đã nhận được từ ứng dụng.
   2. 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 và chỉ muốn có thể chấp nhận lời mời tham gia ứng dụng, thì họ có thể xem lời mời tham gia ứng dụng đang chờ xử lý trực tiếp trong đoạn trích web Firebase App Distribution: appdistribution.firebase.google.com.

Giải pháp 3

1. Xoá người thử nghiệm khỏi mục Xem tất cả người thử nghiệm của thẻ Người thử nghiệm và nhóm trên trang App Distribution trong Firebase Console. Thao tác này sẽ xoá các lời mời hiện có.

2. Mời lại người kiểm thử để 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 chính địa chỉ email mà bạn đã gửi lời mời đến.

Lỗi "Untrusted Enterprise Developer" (Nhà phát triển doanh nghiệp không đáng tin cậy) khi cố gắng chạy ứng dụng thử nghiệm

Lỗi Untrusted Enterprise Developer (Nhà phát triển doanh nghiệp không đáng tin cậy) sẽ 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 ứng dụng Settings (Cài đặt) > màn hình Profiles & Device Management (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 đó.

Lỗi "Yêu cầu Chế độ nhà phát triển" 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 chạy một ứng dụng iOS được cấp phé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à giải quyết lỗi này, hãy làm theo các bước sau:

1. Trên iPhone, hãy mở ứng dụng Cài đặt rồi nhấn vào Privacy & Security (Quyền riêng tư và bảo mật).
2. Di chuyển xuống phần Bảo mật rồi nhấn vào Chế độ nhà phát triển.
3. Nhấn vào thanh trượt Chế độ nhà phát triển.
4. Nhấn vào Khởi động lại.
5. Sau khi thiết bị khởi động lại, hãy mở khoá thiết bị. Hộp thoại Turn on Developer Mode? (Bật Chế độ nhà phát triển?) sẽ xuất hiện.
6. Nhấn vào Bật. Giờ thì bạn có thể chạy ứng dụng và bắt đầu kiểm thử.

"Đã đăng ký thiết bị, 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 mộ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 để 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 tất hướng dẫn trong phần Đăng ký thêm thiết bị.

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 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), thì có thể bạn đã đăng nhập vào nhầm 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 đã dùng khi 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 đã dùng trước đó để chấp nhận lời mời.

Lỗi 403: "Hãy liên hệ với quản trị viên để được cấp 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à thử nghiệm ứ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 quyết định.

Nếu bạn cho rằng mình 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 bài viết Quản lý quyền truy cập vào các dịch vụ không có chế độ 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.

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 App Distribution cho iOS 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 đang tìm nạp các bản phát hành mới:

1. 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.

2. Chạy ứng dụng của bạn trong trình mô phỏng và tìm chuỗi "[Firebase/AppDistribution]".

3. Kiểm tra để đảm bảo 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ả về, thì có thể đã xảy ra sự cố trong vòng đời của Trình điều khiển khung hiển thị, trong đó hộp thoại cảnh báo được tải trước khi Khung hiển thị xuất hiện.

   • Nếu không có bản phát hành nào được trả về, thì có thể người kiểm thử của bạn chưa được liên kết với bản phát hành mới. Trong trang tổng quan App Distribution của bảng điều khiển Firebase, hãy đảm bảo rằng người kiểm thử của bạn có trong bản phân phối bản dựng và đang ở trạng thái Accepted (Đã chấp nhận).

     Nếu người thử nghiệm vẫn không nhận được bản cập nhật, hãy yêu cầu họ sử dụng các mẹo sau để đảm bảo họ đã chấp nhận lời mời thử nghiệm ứng dụng của bạn và thiết lập thiết bị thử nghiệm đúng cách:

     1. Trên thiết bị thử nghiệm, hãy đăng nhập vào web clip của Firebase App Distribution. Nhớ chọn Tài khoản Google mà bạn đã dùng lần đầu khi chấp nhận lời mời thử nghiệm ứng dụng.

     2. Đảm bảo rằng bản phát hành ứng dụng mới có trong đoạn video trên web.

Người thử nghiệm đượ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 một lần để bật thông 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ử đượ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 mẹo sau để đảm bảo cấu hình App Distribution của bạn được thiết lập đúng cách:

• Kiểm tra để đảm bảo bạn đã bật API Firebase App Testers. Để biết thêm thông tin, hãy xem bài viết Bật App Distribution Tester API.

• Trong mục Key restrictions (Hạn chế khoá), hãy đảm bảo rằng Firebase App Testers API có trong danh sách các API được phép.

• Nếu thường xoá UserDefaults khi đăng xuất, bạn có thể đang xoá trạng thái của người kiểm thử. App Distribution lưu trữ một cờ cho biết liệu người kiểm thử đã đă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ó giới hạn nào về việc thêm người thử nghiệm vào ứng dụng của tôi không?

Firebase App Distribution có các giới hạn sau đây về số lượng 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 thử nghiệm vào một nhóm App Distribution

Để thêm người thử nghiệm, hãy yêu cầu tăng hạn mức mà không mất phí.

Lời mời người kiểm thử 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 lời mời hết hạn. Khi lời mời còn 5 ngày nữa là hết hạn, 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ử trong một 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 thông qua trình đơn thả xuống trên hàng của người kiểm thử.

Khi nào bản phát hành mới được tạo cho nội dung tải lên trên iOS?

Xem phần Đăng ký thêm thiết bị.

Các bản phát hành ứng dụng được cung cấp trong bao lâu?

Bản phát hành ứng dụng sẽ bị xoá khỏi App Distribution 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 phát hành hơn 150 ngày trước.
• 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 bài viết App Distribution 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ị xoá khỏi trang tổng quan App Distribution và ứng dụng web dành cho người kiểm thử App Distribution. Nếu người kiểm thử đã 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.

Để bản phát hành ứng dụng được cung cấp lâu hơn, hãy áp 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 tệp IPA xuống và xoá bản phát hành khỏi trang tổng quan của App Distribution. Sau đó, hãy tải tệp IPA lên lại dưới dạng một bản dựng mới cho App Distribution.
• Tải bản phát hành xuống rồi 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 của ứng dụng lên Firebase, bản phát hành đó sẽ xuất hiện trong trang tổng quan App Distribution 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 người kiểm thử. Người kiểm thử sẽ cài đặt bản phát hành từ App Distribution ứng dụng web dành cho người kiểm thử trên thiết bị kiểm thử của họ.

Khi bản phát hành còn 30 ngày nữa là đến ngày hết hạn, thông báo hết hạn của 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 trong trang App Distribution của bảng điều khiển Firebase và trong ứng dụng web dành cho người kiểm thử App Distribution.

App Distribution hỗ trợ tối đa 1.000 bản phát hành

App Distribution 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, App Distribution sẽ tự động xoá 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 theo cách thủ công, hãy sử dụng App Distribution REST API để liệt kê và xoá 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 Nhóm hỗ trợ Firebase.

Hồ sơ Firebase là gì?

Hồ sơ Firebase là một hồ sơ cấu hình cho phép App Distribution:

• Đăng ký thiết bị thử nghiệm bằng cách thu thập mã thiết bị duy nhất (UDID) của thiết bị. Nếu bạn đang thử nghiệm một bản phân phối Ad Hoc, Firebase sẽ gửi cho nhà phát triển ứng dụng một email có chứa 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 đoạn video trên web Firebase App Distribution vào màn hình chính của thiết bị. Đoạn video trên web cho phép bạn cài đặt và truy cập vào tất cả ứng dụng thử nghiệm ở 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 đ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 mà tôi đã cài đặt trên thiết bị?

Nếu là người kiểm thử, bạn có thể truy cập vào tất cả ứng dụng kiểm thử bằng đoạn mã web Firebase App Distribution. Đoạn mã này sẽ tự động được thêm vào màn hình chính của thiết bị kiểm thử khi bạn cài đặt hồ sơ Firebase. Nếu đang thử nghiệm một bản phân phối Ad Hoc, trước tiên, bạn phải cài đặt hồ sơ thì mới có thể thử nghiệm ứng dụng.

Nếu đang thử nghiệm một bản phân phối Enterprise, bạn có thể cài đặt hồ sơ theo cách thủ công:

1. Đăng nhập vào Google và chấp nhận lời mời nếu bạn chưa làm việc này.

2. Trong phần Ứng dụng thử nghiệm, hãy chọn ứng dụng bạn muốn thử nghiệm.

3. Ở trên cùng bên phải trang của ứng dụng, hãy nhấn vào biểu tượng mobile_screen_share.

4. 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ử?

Để xoá tài khoản người kiểm thử App Distribution và dữ liệu liên quan, hãy làm theo các bước sau:

1. Truy cập vào https://appdistribution.firebase.google.com rồi đăng nhập bằng Tài khoản Google của bạn.

2. Ở trên cùng bên phải, hãy nhấp vào biểu tượng settings (Quản lý tài khoản)

   Xoá tài khoản.

3. Không bắt buộc: Trong phần Quyền đối với Tài khoản Google, hãy thu hồi quyền truy cập của Firebase App Distribution. Xin lưu ý rằng việc thu hồi quyền truy cập mà không xoá tài khoản App Distribution trước sẽ không xoá tài khoản hoặc dữ liệu của người kiểm thử.