Устранение неполадок с распространением приложений & Часто задаваемые вопросы

Невозможно распространить приложение из-за отсутствия контактного адреса электронной почты.

При загрузке приложения вы можете столкнуться со следующей ошибкой:

«Мы не смогли найти контактный адрес электронной почты для приложения <app-id> . Чтобы настроить его, перейдите в раздел App Distribution в консоли Firebase ».

Укажите контактный адрес электронной почты в консоли Firebase , если он доступен. Если проблема не устранена, обратитесь в службу поддержки Firebase .

Произошла ошибка при подготовке вашего приложения (ошибки 400, 409 или 500)

Если во время подготовки вы постоянно сталкиваетесь с ошибками 400, 409 или 500, обратитесь в службу поддержки Firebase . Сообщите службе поддержки номер вашего проекта Firebase и идентификатор приложения.

Не удалось загрузить IPA

Ниже приведен пример сетевого ответа браузера:

{
"status": "IN_PROGRESS",
  "message": "There was an error processing your
distribution. Ensure you are uploading a valid IPA or APK and try again."
}

Чтобы решить эту проблему, выполните следующие действия:

1. Проверьте размер IPA-файла. Максимальный размер файла для всех исполняемых файлов составляет 2048 МБ, что чуть больше 2 ГБ.

2. Если размер IPA находится в пределах ограничения на размер файла и воспроизводится, выполните следующие действия:

   1. Проверьте файл Info.plist и убедитесь, что CFBundleDisplayName содержит какие-либо разделители <array> .

   2. Удалите разделители <array> и пересоберите приложение. Загрузка должна пройти успешно.

   3. Если у вас все еще возникают проблемы, обратитесь в службу поддержки Firebase .

3. Если размер IPA превышает ограничение на размер файла, внесите необходимые изменения, чтобы уменьшить размер файла.

4. Если уменьшение размера файла IPA не решило проблему, обратитесь в службу поддержки Firebase и спросите об использовании Testflight .

У тестировщика нет аккаунта Google

Когда пользователь создает учетную запись Google, он автоматически получает адрес Gmail.

Если у тестировщика нет адреса Google Workspace или Gmail или он предпочитает использовать другой адрес электронной почты для входа, попросите тестировщика привязать к учетной записи адрес электронной почты, отличный от Gmail, и использовать этот адрес электронной почты для входа.

При выборе альтернативного адреса электронной почты тестировщик должен следовать следующим рекомендациям:

• Не используйте адрес Gmail.
• Не используйте адрес электронной почты, который уже связан с другой учетной записью Google.
• Не забудьте использовать пароль своей учетной записи Google при входе в систему с этим адресом электронной почты.

Дополнительную информацию см. в статье Вход в учетную запись Google с другим адресом электронной почты .

Тестировщик не видит нужные приложения или сборки

Если тестировщик принял приглашение по электронной почте с адреса электронной почты, отличного от того, на который было отправлено приглашение, он может не увидеть нужные приложения или сборки.

Адрес электронной почты, на который разработчик отправляет приглашения и добавляет в новые сборки (адрес электронной почты A), может отличаться от адреса электронной почты, который тестировщик использует для принятия приглашения (адрес электронной почты B). Это создаёт скрытую связь. Всякий раз, когда адрес электронной почты A добавляется в новые сборки, доступ фактически получает адрес электронной почты B.

Если тестировщик принял приглашение по электронной почте с другим адресом электронной почты, выполните следующие действия для решения проблемы:

1. Удалите тестировщика из раздела «Просмотреть всех тестировщиков» на вкладке «Тестировщики и группы» на странице App Distribution консоли Firebase . Существующие приглашения будут удалены.

2. Пригласите тестировщика повторно протестировать ваше приложение. Тестировщик должен получить электронное письмо с приглашением.

3. Убедитесь, что тестировщик принимает приглашение с тем же адресом электронной почты.

Тестировщик не получает уведомления по электронной почте

Тестировщики могут не получать уведомления по электронной почте в следующих случаях:

• Уведомления по электронной почте отправляются в папку «Спам».

• Фильтры электронной почты установлены.

• Приглашение было отправлено на один адрес электронной почты, но тестировщик принял его с другого. Тестировщик получает письма с информацией о новых выпусках на тот адрес электронной почты, на который изначально было отправлено приглашение.

• Тестировщик был ранее приглашён, но не принял первоначальное приглашение. Если тестировщик будет добавлен в последующие выпуски, App Distribution не будет автоматически отправлять ему уведомления о выпуске, поскольку он не принял первоначальное приглашение.

Решение 1

1. Попросите тестировщика проверить папку со спамом и любые фильтры электронной почты, установленные в его почтовом сервисе.

2. Если тестировщик отписался от рассылки, попросите его сделать следующее:

   1. Найдите электронное письмо, которое тестировщик ранее получил от приложения.
   2. Нажмите «Управление настройками электронной почты» внизу и нажмите «Разрешить повторную подписку на электронные письма» .

Решение 2

Если тестировщику не нужно получать уведомления по электронной почте, а просто нужно иметь возможность принимать приглашения в приложения, он может просмотреть ожидающие приглашения в приложениях непосредственно в веб-клипе Firebase App Distribution : appdistribution.firebase.google.com .

Решение 3

1. Удалите тестировщика из раздела «Просмотреть всех тестировщиков» на вкладке «Тестировщики и группы» на странице App Distribution в консоли Firebase . Это действие удалит существующие приглашения.

2. Пригласите тестировщика повторно протестировать ваше приложение. Тестировщик должен получить электронное письмо с приглашением. Убедитесь, что тестировщик принял приглашение, указав тот же адрес электронной почты, на который оно было отправлено.

Ошибка «Ненадежный корпоративный разработчик» при попытке запустить тестовое приложение

Ошибка «Untrusted Enterprise Developer» появляется, если вы не доверяли сертификату разработчика на тестовом устройстве перед открытием приложения. В приложении « Настройки » > «Профили и управление устройствами» выберите имя разработчика приложения и укажите, что оно ему доверяет.

Ошибка «Требуется режим разработчика» при попытке запустить тестовое приложение

Ошибка «Требуется режим разработчика» появляется при попытке запустить специально подготовленное приложение iOS на iOS 16 или более поздней версии без предварительного включения режима разработчика.

Чтобы включить режим разработчика и устранить эту ошибку, выполните следующие действия:

1. На iPhone откройте приложение «Настройки», а затем нажмите «Конфиденциальность и безопасность» .
2. Прокрутите вниз до раздела «Безопасность» и нажмите «Режим разработчика» .
3. Коснитесь ползунка «Режим разработчика» .
4. Нажмите «Перезагрузить» .
5. После перезагрузки разблокируйте устройство. Появится диалоговое окно «Включить режим разработчика?».
6. Нажмите « Включить» . Теперь вы можете запустить приложение и начать тестирование.

«Устройство зарегистрировано, всё готово! Вы получите электронное письмо, когда приложение будет готово к тестированию».

Если вы устанавливаете дистрибутив Ad Hoc, это сообщение появляется, когда разработчик ещё не настроил своё приложение для работы на вашем тестовом устройстве. Чтобы предоставить вам доступ к приложению, разработчик должен выполнить инструкции, описанные в разделе Регистрация дополнительных устройств .

Учетная запись Google не имеет доступа к тестовому приложению.

Если у вашей учётной записи Google нет доступа к тестовому приложению, которое вы ранее установили (или приняли приглашение), вероятно, вы вошли в неправильный аккаунт Google. Приложения, к которым у вас есть доступ, связаны с учётной записью Google, которую вы использовали при первом принятии приглашения для тестирования. Попробуйте ещё раз, войдя в учётную запись Google, которую вы использовали для принятия приглашения.

Ошибка 403: «Обратитесь к администратору для получения доступа»

Ошибка 403 означает, что у вашей учётной записи нет разрешения на установку и тестирование приложений. Доступ определяется администратором домена вашей учётной записи в Google Workspace.

Если вы считаете, что вам необходимо разрешение на установку и тестирование приложений, попросите администратора вашего аккаунта Google Workspace изменить настройки. Администратор должен следовать инструкциям в разделе «Управление доступом к службам, которые не контролируются по отдельности» .

Если у вас несколько учетных записей, попробуйте войти в систему с другой учетной записью, на которую не наложены ограничения по установке и тестированию приложений.

Тестировщик не получает оповещения в приложении

Если вы уже настроили App Distribution iOS SDK в своем приложении и ваши тестировщики не получают оповещения в приложении, проверьте, загружает ли ваше приложение новые версии:

1. Включите режим отладки в своём приложении. Подробнее см. в документации Google Analytics .

2. Запустите приложение в симуляторе и найдите строку «[Firebase/AppDistribution]».

3. Проверьте, есть ли у тестировщика доступ к новой версии:

   • Если возвращается допустимый объект выпуска, то, скорее всего, возникла проблема в жизненном цикле View Controller, из-за которой диалоговое окно оповещения загружается до появления View.

   • Если релиз не возвращается, возможно, ваш тестер ещё не связан с новым релизом. В панели App Distribution консоли Firebase убедитесь, что ваш тестер включён в дистрибутив сборки и находится в состоянии Accepted .

     Если ваш тестировщик по-прежнему не получает обновления, попросите его следовать приведенным ниже советам, чтобы убедиться, что он принял приглашение протестировать ваше приложение и правильно настроил свое тестовое устройство:

     1. На тестовом устройстве войдите в веб-клип Firebase App Distribution. Не забудьте выбрать учётную запись Google, которую вы использовали при принятии приглашения на тестирование приложения.

     2. Убедитесь, что новая версия приложения доступна в веб-клипе.

Тестировщику предлагается снова войти в систему после закрытия приложения.

По умолчанию вашим тестировщикам достаточно войти в свой аккаунт 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 рядом с именем тестировщика в релизе появляется уведомление об истечении срока действия. Приглашение можно продлить, отправив его повторно через раскрывающееся меню в строке тестировщика.

Когда создается новый релиз для загрузок на iOS?

См. Регистрация дополнительных устройств .

Как долго доступны версии приложений?

Релизы приложений удаляются из 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 на свои тестовые устройства.

Когда до истечения срока действия релиза остается 30 дней, на странице App Distribution консоли Firebase и в веб-приложении тестировщика App Distribution в вашем релизе появляется уведомление об истечении срока действия релиза приложения.

App Distribution поддерживает максимум 1000 выпусков.

App Distribution допускает максимум 1000 релизов на приложение. Когда ваше приложение достигает лимита в 1000 релизов, App Distribution автоматически удаляет самые старые релизы, превышающие этот лимит.

Если вы хотите вручную управлять выпусками приложений, используйте API REST App Distribution для массового перечисления и удаления выпусков приложений.

Если у вас есть вопросы, обратитесь в службу поддержки Firebase .

Что такое профиль Firebase?

Профиль Firebase — это профиль конфигурации, который позволяет App Distribution :

• Зарегистрируйте тестовое устройство, получив его уникальный идентификатор (UDID). При тестировании дистрибутива Ad Hoc Firebase отправляет разработчику приложения электронное письмо с UDID тестового устройства и инструкциями по добавлению устройства в профиль подготовки приложения, чтобы сборку можно было протестировать на вашем устройстве.

• Установите веб-клип Firebase App Distribution на главный экран вашего устройства. Он позволяет устанавливать и получать доступ ко всем вашим тестовым приложениям в одном месте. Новые сборки, которые вы приглашены для тестирования, автоматически добавляются в веб-клип.

Информацию об установке профилей конфигурации на устройство iOS см. в документации Apple .

Как получить доступ к тестовым приложениям, установленным на моем устройстве?

Если вы тестировщик, вы можете получить доступ ко всем своим тестовым приложениям с помощью веб-клипа Firebase App Distribution , который автоматически добавляется на главный экран вашего тестового устройства при установке профиля Firebase. Если вы тестируете дистрибутив Ad Hoc, вам необходимо сначала установить профиль, прежде чем вы сможете протестировать приложение.

Если вы тестируете дистрибутив Enterprise, вы можете вручную установить профиль:

1. Если вы еще этого не сделали, войдите в Google и примите приглашение.

2. В разделе Тестовые приложения выберите приложение, которое вы хотите протестировать.

3. В правом верхнем углу страницы приложения нажмите mobile_screen_share .

4. Следуйте отображаемым инструкциям по установке профиля Firebase.

Как удалить мою учетную запись тестировщика?

Чтобы удалить учетную запись тестировщика App Distribution и связанные с ней данные, выполните следующие действия в указанном порядке:

1. Посетите https://appdistribution.firebase.google.com и войдите в свою учетную запись Google.

2. В правом верхнем углу нажмите settings ( Управление учетной записью ).

   Удалить аккаунт .

3. Необязательно: в настройках разрешений вашего аккаунта Google отзовите доступ к Firebase App Distribution . Обратите внимание, что отзыв доступа без предварительного удаления аккаунта App Distribution не приводит к удалению вашего аккаунта тестировщика или данных.