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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. Включите режим отладки в своем приложении. Чтобы узнать, как это сделать, см. документацию Google Analytics .

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

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

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

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

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

     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 действуют следующие ограничения на количество тестировщиков:

• В проект Firebase можно добавить максимум 500 тестировщиков.

• В группу App Distribution можно добавить максимум 200 тестировщиков.

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

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

У тестировщиков есть 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 автоматически удалит самые старые релизы, превышающие этот лимит.

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

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

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

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

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

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

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

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

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

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

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 не приводит к удалению вашей учетной записи тестировщика или ваших данных.