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

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

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

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

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

При инициализации приложения произошла ошибка (400, 409 или 500).

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

Не удалось загрузить APK-файл

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

2. Если размер APK-файла не превышает допустимый и проблема воспроизводится, обратитесь в службу поддержки Firebase.

Не удалось загрузить APK-файл с помощью Fastlane. APK-файл не подписан.

Убедитесь, что APK подписан с помощью следующих схем:

apksigner verify --verbose ~/app-distro/app-distro-apps/[path_name]/app/ build/outputs/apk/debug/app-debug.apk

Ошибки при входе через социальные сети или сторонние API

Когда вы загружаете AAB в App Distribution, Google Play автоматически подписывает сгенерированный APK с помощью тестового сертификата ключа подписи приложения. Если вы хотите продолжить использовать сторонние сервисы, то при появлении запроса зарегистрируйте приложение у поставщиков API. После подписания тестовый сертификат приложения можно будет посмотреть в консоли Firebase.

Появятся ли загруженные мной наборы AAB в Google Play?

Сборки AAB, загруженные в App Distribution, не появляются в вашем аккаунте разработчика Google Play (в том числе в App Bundle Explorer и разделе "Внутренний доступ к приложениям").

Что произойдет, если отменить связь Firebase с Google Play?

Если отменить связь приложения Firebase для Android с Google Play, произойдет следующее:

• Вы не сможете загружать новые наборы App Bundle в App Distribution и экспортировать их в Google Play через интеграцию App Distribution с Google Play.

• Существующие сборки по-прежнему будут доступны на панели управления Firebase App Distribution и тестировщикам.

• Все данные, которые ранее передавались между Firebase и Google Play, останутся доступными в обоих сервисах.

Можно ли повторно связать приложение с Google Play?

Чтобы распространять наборы Android App Bundle (AAB) через App Distribution и автоматически связывать загруженные наборы с проектом Firebase и аккаунтом разработчика Google Play, убедитесь, что выполняются следующие требования:

• У вас есть один из следующих уровней доступа к аккаунту разработчика Google Play: владелец или администратор.

• В проекте Firebase у вас есть одна из следующих ролей: Владелец или Администратор Firebase.

• Приложение должно быть добавлено в проект Firebase и в аккаунт разработчика Google Play. Это значит, что у вас должно быть приложение для Android и в Firebase, и в Google Play.

• Приложение в Google Play и приложение для Android в Firebase регистрируются с использованием одного и того же названия пакета.

• Приложение в Google Play должно быть настроено на панели управления и выпущено в виде версии для внутреннего, закрытого или открытого тестирования либо рабочей версии.

• Приложение должно пройти проверку в Google Play и быть опубликовано, то есть в столбце Статус приложения должен отображаться статус "Внутреннее тестирование" (не "Проект"), "Закрытое тестирование", "Открытое тестирование" или "Рабочая версия".

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

У тестировщика нет аккаунта 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

Если тестировщик не хочет получать уведомления по электронной почте, но хочет иметь возможность принимать приглашения, он может просматривать ожидающие приглашения непосредственно в приложении App Tester (инструкции по скачиванию).

Решение 3

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

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

Приложение не указывает, что оно установлено

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

Убедитесь, что идентификатор пакета APK-файла совпадает с идентификатором пакета приложения Firebase, которое вы использовали для загрузки дистрибутива.

Оповещение Android о том, что на устройстве нельзя устанавливать неизвестные приложения

Оповещение Android появляется, если у запущенного приложения или браузера нет разрешения на установку приложений из источников, отличных от Google Play. Чтобы предоставить разрешение:

• Android 8 или более поздней версии. В приложении Настройки нажмите Разрешить установку из этого источника.

• Android 7 или более ранней версии. В приложении Настройки нажмите Безопасность и выберите Неизвестные источники. Когда появится запрос, нажмите ОК > Доверять.

Не удается установить тестовые APK-файлы

Если тестовый APK-файл не устанавливается на устройство тестировщика:

• Убедитесь, что сертификаты в новой версии совпадают с сертификатами в версии, установленной на устройстве тестировщика. Система Android разрешает обновление приложения, только если сертификаты совпадают. Чтобы узнать больше, изучите Рекомендации по подписанию.
• Убедитесь, что версия ОС на устройстве тестировщика поддерживается приложением (проверьте minSdkVersion).

Не удается войти в приложение Android App Tester

Если приложение App Tester не позволяет вам войти в аккаунт и перенаправляет вас обратно на экран входа, возможно, вы используете аккаунт Google Workspace (ранее G Suite) с настройками ограничений.

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

1. На вкладке Приложения в Google Workspace убедитесь, что для приложения Firebase App Distribution не задано значение Доступ: заблокировано.

2. На вкладке Сервисы убедитесь, что для Cloud Platform не заданы ограничения.

3. После этого попробуйте войти снова.

Ошибка при установке AAB: "Не удалось установить приложение"

Эта ошибка может возникнуть, если устанавливаемое приложение конфликтует с приложением, которое уже установлено на устройстве. Например, это может быть другой вариант того же приложения с тем же специальным разрешением или названием ContentProvider.

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

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

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

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

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

Тестирование на новом устройстве Android

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

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

1. На устройстве Android перейдите на страницу appdistribution.firebase.google.com.

2. Войдите в существующий аккаунт тестировщика и нажмите кнопку Download App Tester (Скачать App Tester) внизу экрана, чтобы установить приложение Android App Tester.

Тестировщик не может начать отправку отзыва в приложении

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

1. Включите подробное ведение журнала для App Distribution Android SDK в приложении:

   adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
   

2. Проверьте сообщения об ошибках в журналах приложения, отфильтровав их по FirebaseAppDistribution.

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

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

   2. На панели управления App Distribution в консоли Firebase найдите выпуск, который установлен на устройстве тестировщика. Убедитесь, что тестировщик указан на вкладке Тестировщики на карточке выпуска и имеет статус "Принято".

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

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

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

   3. Попробуйте отправить отзыв, убедившись, что вы вошли в тот же аккаунт Google.

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

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

Не получаю отзывы, отправленные в приложении

1. Если при отправке отзыва вы видите сообщение "Отзыв не был отправлен из-за режима разработчика", отключите режим разработчика на устройстве, выполнив следующую команду:

   adb shell setprop debug.firebase.appdistro.devmode false
   

2. Проверьте файл google-services.json, чтобы убедиться, что вы отправляете отзыв для нужного проекта и приложения.

3. Включите подробное ведение журнала для App Distribution Android SDK в приложении:

   adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
   

4. Проверьте сообщения об ошибках в журналах приложения, отфильтровав их по FirebaseAppDistribution.

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

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

1. Чтобы проверить наличие сообщений об ошибках, прикрепите OnFailureListener к задаче, возвращенной Firebase App Distribution API.

   Java

     firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener ( e -> {
                     if (e instanceof FirebaseAppDistributionException) {
                        // Log exception here
                     }});
   

   Kotlin

     firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener { e ->
                     if (e is FirebaseAppDistributionException) {
                        // Log exception here
                     }
     }
   

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

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

   2. Запустите приложение в симуляторе и найдите строку FirebaseAppDistribution.

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

   3. На панели управления App Distribution в консоли Firebase убедитесь, что тестировщик включен в распространение сборки и находится в статусе Принято.

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

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

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

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

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

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

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

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

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

Чтобы получить доступ к предварительной версии агента тестирования приложений, вы можете включить эту функцию и начать использовать ее через баннер на странице "Выпуски" в консоли Firebase.

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

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

Если я включу эту функцию, она станет доступна всей команде или только мне?

Это позволит включить функцию для всего проекта.

Я включил функцию, но она не появилась

Обновите окно браузера. Если после обновления браузера функция по-прежнему не отображается, обратитесь в службу поддержки Firebase с сообщением "Запрос доступа к агенту тестирования приложений App Distribution".

Что такое предварительные тестовые сценарии и как они работают?

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

Обратите внимание, что отчет о тестировании, который используется в качестве предварительного условия для другого отчета о тестировании, нельзя удалить, пока он не будет удален в качестве предварительного условия из другого отчета о тестировании. Чтобы удалить предварительные условия из отчета о тестировании, выберите Нет в раскрывающемся меню в диалоговом окне редактирования отчета.

Поддерживает ли агент тестирования приложений приложения Flutter?

Да, агент тестирования приложений поддерживает приложения Android, созданные с помощью Flutter.

Есть ли ограничения на количество случайных проверок с помощью агента тестирования приложений?

Для случайного сканирования агент тестирования приложений использует инфраструктуру Firebase Test Lab. Ограничения и цены такие же. Квоты на тестирование измеряются количеством тестов, выполняемых в день. Подробнее о квотах и оплате тестирования рассказывается в статье Уровни использования, квоты и цены для Test Lab.

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

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

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

Если вы используете сегмент Google Cloud Storage (GCS) по умолчанию, у вас должна быть роль редактора в проекте Firebase.

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

• Администратор качества Firebase
• Администратор Firebase Test Lab
• Пользователь объектов в хранилище

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

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

Тесты с ИИ-подсказками длятся 5 минут, а тесты со случайным сканированием – 10 минут.

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

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

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

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

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

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

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

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

Выпуски приложений удаляются из App Distribution, если выполняется одно из следующих условий:

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

Подробнее о том, почему в App Distribution поддерживается не более 1000 выпусков…

По истечении 150 дней или после 1000 выпусков приложение удаляется из панели управления App Distribution и приложения Firebase App Tester. Если тестировщик установил выпуск, локальная версия приложения продолжит работать.

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

• Прежде чем срок действия выпуска истечет или будет превышено ограничение на количество выпусков, скачайте APK-файл или набор App Bundle и удалите выпуск на панели управления App Distribution. Затем повторно загрузите APK-файл или набор Android App Bundle в качестве новой сборки в App Distribution.
• Скачайте выпуск и загрузите его в Cloud Storage для долгосрочного хранения.

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

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

За 30 дней до окончания срока действия в приложении Firebase App Tester появится уведомление.

В App Distribution поддерживается не более 1000 выпусков.

В App Distribution можно создать не более 1000 выпусков для одного приложения. Если вы достигнете этого лимита, App Distribution автоматически удалит самые старые выпуски.

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

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

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

Если вы тестировщик, рекомендуем скачать Firebase App Tester – приложение, в котором собраны все тестовые сборки.

Как удалить аккаунт тестировщика?

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

1. Перейдите на страницу https://appdistribution.firebase.google.com и войдите в аккаунт Google.

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

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

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