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

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

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

«Нам не удалось найти контактный адрес электронной почты для приложения <app-id> . Посетите раздел «Распространение приложений» в консоли 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. Удалите тестер из раздела «Просмотр всех тестеров» на вкладке «Тестеры и группы» на странице «Распространение приложений» консоли Firebase. Существующие приглашения удаляются.

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

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

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

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

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

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

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

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

Решение 1

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

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

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

Решение 2

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

Решение 3

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

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

Ошибка «Untrusted Enterprise Developer» при попытке запустить тестовое приложение

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

3. Убедитесь, что у тестировщика есть доступ к новому релизу:

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

   • Если выпуск не возвращен, возможно, ваш тестер еще не связан с новым выпуском. На панели распространения приложений консоли Firebase убедитесь, что ваш тестер включен в дистрибутив сборки и находится в состоянии «Принято» .

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

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

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

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

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

• Убедитесь, что вы включили API-интерфейс Firebase App Testers. Дополнительные сведения см. в разделе Включение API App Distribution Tester .

• В разделе «Ограничения ключей» убедитесь, что API Firebase App Testers включен в список разрешенных API.

• Если вы обычно очищаете UserDefaults при выходе из системы, возможно, вы очищаете состояние тестера. Распространение приложений хранит флаг, указывающий, вошел ли ваш тестер уже в приложение. Дополнительную информацию смотрите в репозитории GitHub .

Существуют ли ограничения на добавление тестировщиков в мое приложение?

Firebase App Distribution имеет следующие ограничения для тестировщиков:

• Добавьте в проект Firebase не более 500 тестировщиков.

• Добавьте не более 200 тестировщиков в группу распространения приложений.

Чтобы добавить больше тестировщиков, запросите бесплатное увеличение лимита .

Срок действия моих приглашений тестировщика истекает?

У тестировщиков есть 30 дней, чтобы принять приглашение протестировать приложение до истечения срока его действия. Когда до истечения срока действия приглашения остается 5 дней, в консоли Firebase рядом с тестером в выпуске появляется уведомление об истечении срока действия. Приглашение можно продлить, отправив его повторно через раскрывающееся меню в строке тестера.

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

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

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

Релизы приложений удаляются из распространения приложений при возникновении одного из следующих условий:

• Релиз приложения старше 150 дней.
• Вы превысили лимит в 1000 выпусков приложений, а выпуск приложения старше 1000 последних выпусков приложений.

Дополнительные сведения см. в разделе Распространение приложений поддерживает максимум 1000 выпусков .

После того, как приложение достигнет или превысит 150-дневный предел срока действия или предел в 1000 выпусков приложений, выпуск удаляется с панели мониторинга распространения приложений и веб-приложения тестера распространения приложений. Если ваш тестер установил выпуск, локальная версия приложения продолжит работать.

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

• Прежде чем срок действия выпуска приложения истечет или превысит лимит выпуска, загрузите IPA и удалите выпуск с панели распространения приложений. Затем повторно загрузите IPA как новую сборку в App Distribution.
• Загрузите релиз и загрузите его в Cloud Storage для долгосрочного архивирования.

Срок действия версий приложения истекает через 150 дней.

Когда вы загружаете версию своего приложения в Firebase, она отображается на панели распространения приложений в течение 150 дней, начиная с даты загрузки. После загрузки выпуска вы можете распространить его среди тестировщиков, которые установят выпуск из веб-приложения для тестировщиков App Distribution на свое тестовое устройство.

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

Распространение приложений поддерживает максимум 1000 выпусков.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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