Устранение неполадок 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 с помощью дополнительного адреса электронной почты…

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

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

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

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

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. Нажмите Включить. Теперь вы можете запустить приложение и начать тестирование.

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

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

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

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

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

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

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

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

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

Если вы уже настроили App DistributioniOS 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…

Когда срок действия выпуска достигает 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). Если вы тестируете Ad Hoc-распространение, Firebase отправляет разработчику приложения электронное письмо с UDID тестового устройства и инструкциями о том, как добавить устройство в профиль инициализации приложения, чтобы сборку можно было протестировать на вашем устройстве.

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