На этой странице представлена помощь по устранению неполадок и ответы на часто задаваемые вопросы о распространении и тестировании приложений с помощью App Distribution.
Распространение приложений
Используйте следующие советы для устранения проблем, которые могут возникнуть при распространении приложений среди тестировщиков.
При загрузке приложения вы можете столкнуться с этой ошибкой:
«Нам не удалось найти контактный адрес электронной почты для приложения <app-id>
. Чтобы настроить его, посетите раздел «Распространение приложений» в консоли 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). Это создает связь за кулисами. Всякий раз, когда электронная почта А добавляется к новым сборкам, на самом деле электронная почта Б получает доступ.
Если тестер принял приглашение по электронной почте с другим адресом электронной почты, выполните следующие действия, чтобы решить проблему:
Удалите тестера из раздела «Просмотреть всех тестировщиков» на вкладке «Тестеры и группы» на странице «Распространение приложений» в консоли Firebase. Существующие приглашения удаляются.
Повторно пригласите тестировщика для тестирования вашего приложения. Тестировщик должен получить приглашение по электронной почте.
Убедитесь, что тестер принимает приглашение с тем же адресом электронной почты.
Тестировщики могут не получать уведомления по электронной почте в следующих случаях:
Уведомления по электронной почте отправляются в папки со спамом.
Установлены фильтры электронной почты.
Приглашение было отправлено на одну учетную запись электронной почты, но тестер принял ее с другой учетной записи электронной почты. Тестировщик получает новые сообщения электронной почты о выпуске для учетной записи электронной почты, на которую изначально было отправлено приглашение.
Тестировщик был ранее приглашен, но не принял первоначальное приглашение. Если тестировщик будет добавлен в последующие выпуски, App Distribution не будет автоматически отправлять уведомления о выпуске этому тестировщику, поскольку тестер не принял первоначальное приглашение.
Решение 1
Попросите тестировщика проверить свою папку со спамом и все фильтры электронной почты, которые они установили в своей службе электронной почты.
Если тестер отписался от электронных писем, попросите его сделать следующее:
- Найдите электронное письмо, которое тестировщик ранее получил от приложения.
- Нажмите «Управление настройками электронной почты» внизу и нажмите «Разрешить повторную подписку на электронные письма ».
Решение 2
Удалите тестера из раздела «Просмотреть всех тестировщиков» на вкладке «Тестеры и группы» на странице «Распространение приложений» в консоли 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.
Если вы уже настроили iOS SDK для распространения приложений в своем приложении, а ваши тестировщики не получают оповещения в приложении, убедитесь, что ваше приложение загружает новые выпуски:
Включите режим отладки в своем приложении. Чтобы узнать, как это сделать, см. документацию Google Analytics .
Запустите приложение в симуляторе и найдите строку «[Firebase/AppDistribution]».
Убедитесь, что тестер имеет доступ к новому релизу:
Если возвращается действительный объект выпуска, вероятно, существует проблема в жизненном цикле контроллера представления, из-за которой диалоговое окно предупреждения загружается до появления представления.
Если выпуск не возвращается, возможно, ваш тестер еще не связан с новым выпуском. На панели управления App Distribution консоли Firebase убедитесь, что ваш тестер включен в дистрибутив сборки и находится в состоянии Accepted .
Если ваш тестер по-прежнему не получает обновления, попросите его следовать приведенным ниже советам, чтобы убедиться, что он принял приглашение протестировать ваше приложение и правильно настроил свое тестовое устройство:
На тестовом устройстве войдите в веб-клип Firebase App Distribution. Не забудьте выбрать учетную запись Google, которую вы впервые использовали, когда приняли приглашение протестировать приложение.
Убедитесь, что новая версия приложения доступна в веб-клипе.
По умолчанию вашим тестировщикам нужно войти в свою учетную запись Google только один раз, чтобы включить оповещения о новых сборках и установить новые сборки. Если вашим тестировщикам предлагается снова войти в систему после закрытия и повторного открытия вашего приложения, следуйте этим советам, чтобы убедиться, что ваша конфигурация распространения приложений настроена правильно:
Убедитесь, что вы включили Firebase App Testers API. Дополнительные сведения см. в разделе Включение API-интерфейса App Distribution Tester .
В разделе Основные ограничения убедитесь, что API Firebase App Testers включен в список разрешенных API.
Если вы обычно очищаете UserDefaults при выходе из системы, возможно, вы очищаете состояние своего тестера. Приложение App Distribution хранит флаг, указывающий, вошел ли ваш тестер в приложение. Дополнительные сведения см. в репозитории GitHub .
Часто задаваемые вопросы
Распространение приложений Firebase имеет следующие ограничения для тестировщиков:
Добавьте не более 500 тестировщиков в проект Firebase.
Добавьте не более 200 тестировщиков в группу распространения приложений.
Чтобы добавить больше тестировщиков, запросите бесплатное увеличение лимита .
У тестировщиков есть 30 дней, чтобы принять приглашение протестировать приложение до истечения срока его действия. Когда срок действия приглашения истекает через 5 дней, уведомление об истечении срока действия появляется в консоли Firebase рядом с тестировщиком в выпуске. Приглашение можно продлить, повторно отправив его через раскрывающееся меню в строке тестера.
См. Регистрация дополнительных устройств .
Выпуски приложений удаляются из службы распространения приложений, если выполняется одно из следующих условий:
- Релиз приложения старше 150 дней.
- Вы превысили ограничение в 1000 выпусков приложений, и выпуск приложения старше, чем 1000 самых последних выпусков приложений.
Дополнительные сведения см. в разделе Распространение приложений поддерживает не более 1000 выпусков .
После того, как приложение достигнет или превысит 150-дневный срок действия или ограничение в 1000 выпусков приложений, выпуск будет удален из панели мониторинга распространения приложений и веб-приложения тестера распространения приложений. Если ваш тестер установил выпуск, локальная версия приложения продолжает работать.
Чтобы версия приложения оставалась доступной дольше, воспользуйтесь одной из следующих рекомендаций:
- Прежде чем срок действия выпуска приложения истечет или превысит лимит выпусков, загрузите IPA и удалите выпуск с панели управления распространением приложений. Затем повторно загрузите IPA в качестве новой сборки в App Distribution.
- Загрузите выпуск и загрузите его в облачное хранилище для долгосрочного архивирования.
Релизы приложений истекают через 150 дней.
Когда вы загружаете выпуск своего приложения в Firebase, он отображается на панели управления распространением приложений в течение 150 дней, начиная с даты загрузки. После того как вы загрузите выпуск, вы можете распространить его среди тестировщиков, которые установят выпуск из веб-приложения для тестирования распространения приложений на своем тестовом устройстве.
По истечении 30 дней с даты истечения срока действия выпуска в вашем выпуске на странице распространения приложений консоли Firebase и в веб-приложении тестера распространения приложений появится уведомление об истечении срока действия выпуска приложения.
Распространение приложений поддерживает не более 1000 выпусков.
Распространение приложений позволяет выпускать не более 1000 выпусков для каждого приложения. Когда ваше приложение достигает предела в 1000 выпусков приложений, служба распространения приложений автоматически удаляет самые старые выпуски сверх этого ограничения.
Если вы хотите вручную управлять выпусками приложений, используйте REST API распространения приложений, чтобы составить список и массово удалить выпуски приложений.
Если у вас есть вопросы, обратитесь в службу поддержки Firebase .
Профиль Firebase — это профиль конфигурации, который позволяет распределению приложений:
Зарегистрируйте тестовое устройство, собрав уникальный идентификатор устройства (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. Обратите внимание, что отзыв доступа без предварительного удаления вашей учетной записи распространения приложений не приводит к удалению вашей учетной записи тестировщика или данных.