Устранение неполадок App Distribution и часто задаваемые вопросы

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

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

"Нам не удалось найти контактный адрес электронной почты для приложения <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.

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

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

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

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

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

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

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

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

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

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

Решение 1

1. Попросите тестировщика проверить папку "Спам" и фильтры, настроенные в почтовом сервисе.

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

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

Решение 2

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

Решение 3

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

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

Если у вас несколько аккаунтов, попробуйте войти в тот, в котором нет ограничений на установку и тестирование приложений.

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

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

1. Включите в приложении режим отладки. Инструкции вы найдете в документации Google Аналитики.

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

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

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

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

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

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

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

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

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

• Убедитесь, что вы включили Firebase App Testers API. Подробнее о том, как включить App Distribution Tester API…

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

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

Есть ли ограничения на количество тестировщиков?

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

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

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

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

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

Принять приглашение можно в течение 30 дней. За пять дней до истечения срока действия приглашения в консоли 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 выпусков для одного приложения. Если вы достигнете этого лимита, App Distribution автоматически удалит самые старые выпуски.

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

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

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

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

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

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

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

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

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

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

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