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

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

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

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

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

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

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

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

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

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

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

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

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

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

Решение 1

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

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

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

Решение 2

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

Решение 3

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

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

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

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

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

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

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

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

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

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

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

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

Не удается войти в приложение Android 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. Войдите в имеющийся аккаунт тестировщика и нажмите кнопку Скачать приложение для тестирования внизу экрана, чтобы установить приложение Android App Tester.

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

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

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".

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

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

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…

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

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

• До того как срок действия выпуска приложения истечет или будет превышен лимит на количество выпусков, скачайте APK-файл или набор Android 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 не приводит к удалению аккаунта тестировщика или данных.