На этой странице вы найдете помощь в устранении неполадок и ответы на часто задаваемые вопросы о распространении и тестировании приложений с помощью App Distribution .
Распространение приложений
Воспользуйтесь следующими советами для устранения неполадок, с которыми вы можете столкнуться при распространении приложений среди тестировщиков.
При загрузке приложения вы можете столкнуться со следующей ошибкой:
«Мы не смогли найти контактный адрес электронной почты для приложения <app-id> . Пожалуйста, посетите App Distribution в консоли Firebase , чтобы настроить его».
Установите контактный адрес электронной почты в консоли Firebase , если он доступен. Если проблема не устранена, обратитесь в службу поддержки Firebase .
Если во время подготовки вы постоянно сталкиваетесь с ошибками 400, 409 или 500, обратитесь в службу поддержки Firebase . Предоставьте службе поддержки номер вашего проекта Firebase и идентификатор приложения.
Ниже приведен пример сетевого ответа браузера:
{
"status": "IN_PROGRESS",
"message": "There was an error processing your
distribution. Ensure you are uploading a valid IPA or APK and try again."
}
Чтобы решить эту проблему, выполните следующие действия:
Проверьте размер IPA. Максимальный размер файла для всех двоичных файлов составляет 2048 МБ, что немного больше 2 ГБ.
Если размер IPA находится в пределах ограничения на размер файла и воспроизводится, выполните следующие действия:
Проверьте файл
Info.plistи убедитесь, чтоCFBundleDisplayNameсодержит какие-либо разделители<array>.Удалите разделители
<array>и перестройте приложение. Загрузка должна пройти успешно.Если у вас по-прежнему возникают проблемы, обратитесь в службу поддержки Firebase .
Если размер IPA превышает ограничение на размер файла, внесите необходимые изменения, чтобы уменьшить размер файла.
Если уменьшение размера файла IPA не решило проблему, обратитесь в службу поддержки Firebase и спросите об использовании Testflight .
Установка и тестирование приложений
Воспользуйтесь следующими советами для устранения неполадок, с которыми могут столкнуться ваши тестировщики при установке и тестировании ваших приложений.
Когда пользователь создает учетную запись Google, он автоматически получает адрес Gmail.
Если у тестировщика нет адреса Google Workspace или Gmail или он предпочитает использовать другой адрес электронной почты для входа, попросите тестировщика привязать к учетной записи адрес электронной почты, отличный от Gmail, и использовать этот адрес электронной почты для входа.
При выборе альтернативного адреса электронной почты тестировщик должен следовать следующим рекомендациям:
- Не используйте адрес Gmail.
- Не используйте адрес электронной почты, который уже привязан к другой учетной записи Google.
- Не забудьте использовать пароль своей учетной записи Google при входе с помощью этого адреса электронной почты.
Дополнительную информацию см. в разделе Вход в учетную запись Google с другим адресом электронной почты .
Если тестировщик принял приглашение по электронной почте с адреса электронной почты, отличного от того, на который было отправлено приглашение, он может не увидеть нужные приложения или сборки.
Адрес электронной почты, на который разработчик отправляет приглашения и добавляет в новые сборки (адрес электронной почты A), может отличаться от адреса электронной почты, который тестировщик использует для принятия приглашения (адрес электронной почты B). Это создает ссылку за кулисами. Всякий раз, когда адрес электронной почты A добавляется в новые сборки, на самом деле доступ получает адрес электронной почты B.
Если тестировщик принял приглашение по электронной почте с другим адресом электронной почты, выполните следующие действия для решения проблемы:
Удалите тестировщика из раздела View all testers вкладки Testers & Groups на странице App Distribution консоли Firebase . Существующие приглашения удаляются.
Повторно пригласите тестировщика для тестирования вашего приложения. Тестировщик должен получить электронное письмо с приглашением.
Убедитесь, что тестировщик принимает приглашение с тем же адресом электронной почты.
Тестировщики могут не получать уведомления по электронной почте в следующих случаях:
Уведомления по электронной почте отправляются в папку «Спам».
Фильтры электронной почты установлены.
Приглашение было отправлено на один адрес электронной почты, но тестер принял его с другого адреса электронной почты. Тестер получает новые письма о релизе для адреса электронной почты, на который изначально было отправлено приглашение.
Тестировщик был ранее приглашен, но не принял первоначальное приглашение. Если тестировщик добавляется в последующие выпуски, App Distribution не будет автоматически отправлять уведомления о выпуске этому тестировщику, поскольку тестировщик не принял первоначальное приглашение.
Решение 1
Попросите тестировщика проверить папку со спамом и все фильтры электронной почты, установленные в его почтовом сервисе.
Если тестировщик отписался от рассылки, попросите его сделать следующее:
- Найдите электронное письмо, которое тестировщик ранее получил от приложения.
- Нажмите «Управление настройками электронной почты» внизу и нажмите «Разрешить повторную подписку по электронной почте» .
Решение 2
Если тестировщику не нужны уведомления по электронной почте, а просто нужна возможность принимать приглашения в приложения, он может просмотреть ожидающие приглашения в приложения непосредственно в веб-клипе Firebase App Distribution : appdistribution.firebase.google.com .
Решение 3
Удалите тестировщика из раздела View all testers вкладки Testers & Groups на странице App Distribution в консоли Firebase . Это действие удаляет существующие приглашения.
Повторно пригласите тестировщика для тестирования вашего приложения. Тестировщик должен получить электронное письмо с приглашением. Убедитесь, что тестировщик принимает приглашение с тем же адресом электронной почты, на который оно было отправлено.
Ошибка Untrusted Enterprise Developer появляется, если вы не доверяли сертификату разработчика на тестовом устройстве перед открытием приложения. В приложении « Настройки » > «Профили и управление устройствами » выберите имя разработчика приложения и доверяйте ему.
Ошибка «Требуется режим разработчика» появляется при попытке запустить специально подготовленное приложение iOS на iOS 16 или более поздней версии без предварительного включения режима разработчика.
Чтобы включить режим разработчика и устранить эту ошибку, выполните следующие действия:
- На iPhone откройте приложение «Настройки», а затем нажмите «Конфиденциальность и безопасность» .
- Прокрутите страницу вниз до пункта «Безопасность» и нажмите «Режим разработчика» .
- Коснитесь ползунка «Режим разработчика» .
- Нажмите «Перезагрузить» .
- После перезагрузки устройства разблокируйте его. Появится диалоговое окно «Включить режим разработчика?».
- Нажмите « Включить» . Теперь вы можете запустить свое приложение и начать тестирование.
Если вы устанавливаете дистрибутив Ad Hoc, это сообщение появляется, когда разработчик еще не настроил свое приложение для запуска на вашем тестовом устройстве. Чтобы сделать приложение доступным для вас, разработчик должен выполнить инструкции в разделе Регистрация дополнительных устройств .
Если у вашего аккаунта Google нет доступа к тестовому приложению, которое вы ранее установили (или приняли приглашение), скорее всего, вы вошли в неправильный аккаунт Google. Приложения, к которым у вас есть доступ, связаны с аккаунтом Google, который вы использовали, когда впервые приняли приглашение для тестирования приложения. Попробуйте еще раз, войдя в аккаунт Google, который вы использовали ранее для принятия приглашения.
Когда вы сталкиваетесь с ошибкой 403, это означает, что у используемой вами учетной записи нет разрешения на установку и тестирование приложений. Доступ определяется администратором домена вашей учетной записи в Google Workspace.
Если вы считаете, что у вас должно быть разрешение на установку и тестирование приложений, попросите администратора вашего аккаунта Google Workspace изменить настройки вашего аккаунта. Ваш администратор должен следовать инструкциям в разделе Управление доступом к службам, которые не контролируются индивидуально .
Если у вас несколько учетных записей, попробуйте войти в систему с помощью другой учетной записи, на которую не распространяются ограничения по установке и тестированию приложений.
Включение оповещений в приложении с помощью App Distribution iOS SDK
Воспользуйтесь следующими советами для устранения неполадок, связанных с включением оповещений о новых сборках в приложении с помощью App Distribution iOS SDK.
Если вы уже настроили App Distribution iOS SDK в своем приложении и ваши тестировщики не получают оповещения в приложении, проверьте, загружает ли ваше приложение новые выпуски:
Включите режим отладки в вашем приложении. Чтобы узнать, как это сделать, см. документацию Google Analytics .
Запустите приложение в симуляторе и найдите строку «[Firebase/AppDistribution]».
Проверьте, есть ли у тестировщика доступ к новой версии:
Если возвращается допустимый объект выпуска, вероятно, в жизненном цикле View Controller возникла проблема, из-за которой диалоговое окно оповещения загружается до появления View.
Если релиз не возвращается, ваш тестер, возможно, еще не связан с новым релизом. В панели App Distribution консоли Firebase убедитесь, что ваш тестер включен в дистрибутив сборки и находится в состоянии Accepted .
Если ваш тестировщик по-прежнему не получает обновления, попросите его следовать приведенным ниже советам, чтобы убедиться, что он принял приглашение протестировать ваше приложение и правильно настроил свое тестовое устройство:
На тестовом устройстве войдите в веб-клип Firebase App Distribution. Не забудьте выбрать учетную запись Google, которую вы использовали в первый раз, когда принимали приглашение на тестирование приложения.
Убедитесь, что новая версия приложения доступна в веб-клипе.
По умолчанию вашим тестировщикам нужно войти в свою учетную запись Google только один раз, чтобы включить оповещения о новых сборках и установить новые сборки. Если вашим тестировщикам предлагается снова войти в систему после закрытия и повторного открытия вашего приложения, следуйте этим советам, чтобы убедиться, что ваша конфигурация App Distribution настроена правильно:
Проверьте, что вы включили API Firebase App Testers. Для получения дополнительной информации см. Включить API App Distribution Tester .
В разделе «Ограничения ключа» убедитесь, что API Firebase App Testers включен в список разрешенных API.
Если вы обычно очищаете UserDefaults при выходе из системы, вы можете очищать состояние тестировщика. App Distribution сохраняет флаг, который указывает, вошел ли ваш тестировщик в приложение. Для получения дополнительной информации см. репозиторий GitHub .
Часто задаваемые вопросы
Firebase App Distribution имеет следующие ограничения для тестировщиков:
Добавьте максимум 500 тестировщиков в проект Firebase.
Добавьте максимум 200 тестировщиков в группу App Distribution
Чтобы добавить больше тестировщиков, запросите бесплатное увеличение лимита .
У тестировщиков есть 30 дней, чтобы принять приглашение на тестирование приложения, прежде чем срок его действия истечет. Когда до истечения срока действия приглашения остается 5 дней, в консоли Firebase рядом с тестировщиком в релизе появляется уведомление об истечении срока действия. Приглашение можно продлить, повторно отправив его через раскрывающееся меню в строке тестировщика.
См. Регистрация дополнительных устройств .
Релизы приложений удаляются из App Distribution при возникновении одного из следующих условий:
- Выпуск приложения старше 150 дней.
- Вы превысили лимит в 1000 выпусков приложений, и выпуск приложения старше 1000 последних выпусков приложений.
Для получения дополнительной информации см. App Distribution поддерживает максимум 1000 выпусков .
После того, как приложение достигает или превышает 150-дневный лимит истечения срока действия или лимит релизов в 1000 приложений, релиз удаляется из панели App Distribution и веб-приложения тестировщика App Distribution . Если ваш тестер установил релиз, локальная версия приложения продолжает работать.
Чтобы сохранить доступность версии приложения как можно дольше, воспользуйтесь одной из следующих рекомендаций:
- До того, как срок действия релиза приложения истечет или превысит лимит релизов, загрузите IPA и удалите релиз из панели App Distribution . Затем повторно загрузите IPA как новую сборку в App Distribution .
- Загрузите релиз и загрузите его в Cloud Storage для долгосрочного архивирования.
Срок действия приложений истекает через 150 дней.
Когда вы загружаете релиз своего приложения в Firebase, релиз отображается на панели App Distribution в течение 150 дней, начиная с даты загрузки. После загрузки релиза вы можете распространить его среди тестировщиков, которые устанавливают релиз из веб-приложения App Distribution tester на свое тестовое устройство.
Когда с даты истечения срока действия релиза остается 30 дней, на странице App Distribution консоли Firebase и в веб-приложении App Distribution tester для вашего релиза появляется уведомление об истечении срока действия релиза.
App Distribution поддерживает максимум 1000 релизов.
App Distribution допускает максимум 1000 релизов на приложение. Когда ваше приложение достигает лимита в 1000 релизов, App Distribution автоматически удаляет самые старые релизы сверх лимита.
Если вы хотите вручную управлять выпусками приложений, используйте API REST App Distribution для массового составления списка и удаления выпусков приложений.
Если у вас возникнут вопросы, обратитесь в службу поддержки Firebase .
Профиль Firebase — это профиль конфигурации, который позволяет App Distribution :
Зарегистрируйте тестовое устройство, собрав уникальный идентификатор устройства (UDID). Если вы тестируете распространение Ad Hoc, Firebase отправляет разработчику приложения электронное письмо, включающее UDID тестового устройства, а также инструкции о том, как включить устройство в профиль подготовки приложения, чтобы сборку можно было протестировать на вашем устройстве.
Установите веб-клип Firebase App Distribution на домашний экран вашего устройства. Веб-клип позволяет вам устанавливать и получать доступ ко всем вашим тестовым приложениям в одном месте. Новые сборки, которые вы приглашены для тестирования, автоматически добавляются в веб-клип.
Информацию об установке профилей конфигурации на устройстве iOS см. в документации Apple .
Если вы тестировщик, вы можете получить доступ ко всем своим тестовым приложениям с помощью веб-клипа Firebase App Distribution , который автоматически добавляется на домашний экран вашего тестового устройства при установке профиля Firebase. Если вы тестируете дистрибутив Ad Hoc, вам необходимо сначала установить профиль, прежде чем вы сможете протестировать приложение.
Если вы тестируете дистрибутив Enterprise, вы можете вручную установить профиль:
Если вы еще этого не сделали, войдите в систему Google и примите приглашение.
В разделе Тестовые приложения выберите приложение, которое вы хотите протестировать.
В правом верхнем углу страницы приложения нажмите mobile_screen_share .
Следуйте отображаемым инструкциям по установке профиля Firebase.
Чтобы удалить учетную запись тестировщика App Distribution и связанные с ней данные, выполните следующие действия в указанном порядке:
Посетите https://appdistribution.firebase.google.com и войдите в свою учетную запись Google.
В правом верхнем углу нажмите ( Управление учетной записью ).
Удалить аккаунт .
Необязательно: В разрешениях вашего аккаунта Google отмените доступ из Firebase App Distribution . Обратите внимание, что отмена доступа без предварительного удаления вашего аккаунта App Distribution не удаляет ваш аккаунт тестировщика или данные.