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

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

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

«Нам не удалось найти контактный адрес электронной почты для приложения <app-id> . Чтобы настроить его, посетите раздел «Распространение приложений» в консоли 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 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. Это означает, что у вас есть и приложение Firebase для Android, и приложение Google Play.

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

• Приложение в Google Play настраивается на панели приложений и распространяется на одну из дорожек Google Play (внутреннее тестирование, закрытое тестирование, открытое тестирование или производство).

• Проверка приложения в Google Play завершена, и приложение опубликовано. Ваше приложение опубликовано, если в столбце Статус приложения отображается один из следующих статусов: Внутреннее тестирование (не Черновик внутреннего тестирования), Закрытое тестирование, Открытое тестирование или Производство.

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

У тестировщика нет учетной записи Google

Когда пользователь создает учетную запись Google, он автоматически получает адрес Gmail.

Если у тестировщика нет Google Workspace или адреса Gmail, или если он предпочитает использовать другой адрес электронной почты для входа, попросите тестировщика связать адрес электронной почты, отличный от Gmail, с учетной записью и использовать этот адрес электронной почты для входа.

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

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

Дополнительную информацию см. в разделе Вход в аккаунт Google с другим адресом электронной почты .

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

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

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

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

1. Удалите тестер на вкладке « Тестеры и группы » на странице «Распространение приложений» в консоли Firebase. Существующие приглашения удаляются.

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

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

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

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

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

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

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

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

Решение 1

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

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

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

Решение 2

1. Удалите тестер на вкладке « Тестеры и группы » на странице «Распространение приложений» в консоли Firebase. Это действие удаляет существующие приглашения.

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

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

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

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

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

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

• Android версии 8 или новее : в приложении « Настройки » нажмите « Разрешить из этого источника ».

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

Тестовые APK не устанавливаются

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

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

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

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

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

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

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

3. После удаления настроек попробуйте войти снова.

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

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

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

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

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

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

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

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

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

1. Проверьте наличие сообщений об ошибках, подключив OnFailureListener к задаче, возвращаемой API распространения приложений Firebase.

   Джава

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

   Котлин

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

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

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

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

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

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

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

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

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

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

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

• Убедитесь, что вы включили Firebase App Testers API. Дополнительные сведения см. в разделе Включение API-интерфейса App Distribution Tester .

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

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

Есть ли ограничения на добавление тестировщиков в мое приложение?

Распространение приложений Firebase имеет следующие ограничения для тестировщиков:

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

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

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

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

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

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

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

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

Дополнительные сведения см. в разделе Распространение приложений поддерживает не более 1000 выпусков .

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

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

• Прежде чем срок действия версии приложения истечет или превысит лимит выпуска, загрузите APK или AAB и удалите выпуск с панели управления распространением приложений. Затем повторно загрузите APK или AAB в качестве новой сборки в App Distribution.
• Загрузите выпуск и загрузите его в облачное хранилище для долгосрочного архивирования.

Релизы приложений истекают через 150 дней.

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

По истечении 30 дней с даты истечения срока действия релиза в вашем релизе в приложении Firebase App Tester появится уведомление об истечении срока его действия.

Распространение приложений поддерживает не более 1000 выпусков.

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

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

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

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

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

Как удалить свою учетную запись тестера?

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

1. Посетите https://appdistribution.firebase.google.com и войдите в свою учетную запись Google.

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

   Удалить учетную запись .

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

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

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

«Нам не удалось найти контактный адрес электронной почты для приложения <app-id> . Чтобы настроить его, посетите раздел «Распространение приложений» в консоли 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 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. Это означает, что у вас есть и приложение Firebase для Android, и приложение Google Play.

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

• Приложение в Google Play настраивается на панели приложений и распространяется на одну из дорожек Google Play (внутреннее тестирование, закрытое тестирование, открытое тестирование или производство).

• Проверка приложения в Google Play завершена, и приложение опубликовано. Ваше приложение опубликовано, если в столбце Статус приложения отображается один из следующих статусов: Внутреннее тестирование (не Черновик внутреннего тестирования), Закрытое тестирование, Открытое тестирование или Производство.

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

У тестировщика нет учетной записи Google

Когда пользователь создает учетную запись Google, он автоматически получает адрес Gmail.

Если у тестировщика нет Google Workspace или адреса Gmail, или если он предпочитает использовать другой адрес электронной почты для входа, попросите тестировщика связать адрес электронной почты, отличный от Gmail, с учетной записью и использовать этот адрес электронной почты для входа.

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

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

Дополнительную информацию см. в разделе Вход в аккаунт Google с другим адресом электронной почты .

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

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

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

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

1. Удалите тестер на вкладке « Тестеры и группы » на странице «Распространение приложений» в консоли Firebase. Существующие приглашения удаляются.

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

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

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

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

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

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

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

• The tester was previously invited but did not accept the initial invitation. If the tester is added to subsequent releases, App Distribution won't automatically send release notifications to that tester because the tester didn't accept the initial invitation.

Solution 1

1. Ask the tester to check their spam folder and any email filters they set in their email service.

2. If the tester unsubscribed from the emails, ask the tester to do the following:

   1. Find an email that the tester previously received from the app.
   2. Click Manage email settings at the bottom and click Allow emails to resubscribe.

Solution 2

1. Delete the tester from the Testers & Groups tab in the App Distribution page in the Firebase console. This action removes existing invitations.

2. Re-invite the tester to test your app. The tester should receive an invitation email. Make sure that the tester accepts the invitation with the same email address that the invitation was sent to.

App doesn't indicate that the app is installed

If a tester downloads and installs a release but the app details user interface does not show that the app is installed, this is a known issue. In some cases, the bundle ID in the Firebase app does not match the bundle ID of the APK.

Verify that the bundle ID of the APK matches the bundle ID of the Firebase app you used to upload the distribution.

Android alert that says my device can't install unknown apps

The Android alert appears if your running app or browser hasn't yet been given permission to install apps outside of Google Play. To grant permission:

• Android version 8 or later : In the Settings app, tap Allow from this source .

• Android version 7 or earlier : In the Settings app, tap Security and select Unknown sources . When the prompt appears, tap OK > Trust .

Test APKs fail to install

If a test APK fails to install on a tester's device:

• Verify that the certificate(s) in the new version match those in the version installed on the tester's device. The Android system only allows the app to update if the certificates match. To learn more, see Signing considerations .
• Ensure that the OS version of the tester device is supported by the app (check the minSdkVersion ).

Can't sign in to Android App Tester App

If the App Tester app prevents you from signing in and redirects you back to the signin screen, you may be using a Google Workspace (formerly GSuite) that includes restriction settings.

To remove your restriction settings:

1. In the Apps tab of your Google Workspace, make sure Firebase App Distribution is not set to Access: Blocked .

2. In the Services tab , make sure Cloud Platform is unrestricted.

3. Once the settings are removed, try signing in again.

Error when installing AAB: "Can't install app"

This error can happen when the app being installed conflicts with an app already installed on the device. For example, it could be a different variant of the same app with the same custom permission or ContentProvider name .

You can ask the tester to collect a bug report immediately after experiencing the issue, and inspect the report for more information about the cause. The tester must delete any conflicting apps before the new app can be installed.

403 error: "Contact your admin for access"

When you encounter a 403 error, this means that the account you're using doesn't have permission to install and test apps. Access is determined by the administrator of your account's domain in Google Workspace.

If you believe you should have permission to install and test apps, ask your Google Workspace account admin to change your account settings. Your admin should follow the instructions in Manage access to services that aren't controlled individually .

If you have multiple accounts, try logging in with a different account that is not restricted from installing and testing apps.

Tester isn't receiving in-app alerts

If you have already set up the App Distribution Android SDK in your app and your testers aren't receiving in-app alerts, follow these steps:

1. Check for error messages by attaching an OnFailureListener to the Task returned by the 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. Check that the tester has access to the new release:

   1. Enable debug mode in your app. To learn how, see the Google Analytics documentation .

   2. Run your app in a simulator and search for the string "FirebaseAppDistribution".

      If the logs indicate that no release was found, or that the tester does not have access, your tester may not yet be associated with the new release.

   3. In the App Distribution dashboard of the Firebase console, make sure your tester is included in your build distribution and is in the Accepted state.

      If your tester still isn't receiving alerts, have them follow the tips below to make sure they accepted the invitation to test your app and that they set up their testing device properly:

      1. On the test device, sign into Firebase App Distribution via App Tester or via the tester web app. Remember to select the Google account you first used when you accepted the invitation to test the app.

      2. Check to make sure the new app release is available in App Tester or the tester web app.

Tester prompted to sign in again after closing app

By default, your testers only need to sign in to their Google account once to enable new build updates and to install new builds. If your testers are being prompted to sign in again after closing and re-opening your app, follow these tips to make sure your App Distribution configuration is set up properly:

• Check to make sure you've enabled the Firebase App Testers API. For more information, see Enable the App Distribution Tester API .

• Under Key restrictions , make sure that the Firebase App Testers API is included in the list of allowed APIs.

• If you typically clear SharedPreferences on logout, you may be clearing your tester's state. App Distribution stores a flag that indicates whether your tester has already signed into the app. For more information, see the GitHub repository .

Are there limits for adding testers to my app?

Firebase App Distribution has the following tester limits:

• Add a maximum of 500 testers to a Firebase project

• Add a maximum of 200 testers to an App Distribution group

To add more testers, request a no-cost limit increase .

Do my tester invitations expire?

Testers have 30 days to accept an invitation to test the app before it expires. When an invitation is 5 days from expiring, an expiration notice appears in the Firebase console next to the tester on a release. An invitation can be renewed by resending it via the drop-down menu on the tester row.

How long are app releases available?

App releases are removed from App Distribution if one of the following conditions occurs:

• The app release is older than 150 days.
• You exceed the 1,000 app release limit, and the app release is older than the 1,000 most recent app releases.

For more information, see App Distribution supports a maximum of 1,000 releases .

After the app reaches or exceeds the 150-day expiration limit or the 1,000 release limit, the release is removed from the App Distribution dashboard and the Firebase App Tester app. If your tester has installed the release, the local version of the app continues to run.

To keep the app release available longer, use one of the following recommendations:

• Before the app release expires or exceeds the release limit, download the APK or AAB and delete the release from the App Distribution dashboard. Then, re-upload the APK or AAB as a new build to App Distribution.
• Download the release and upload it to Cloud Storage for long-term archiving.

App releases expire after 150 days

When you upload a release of your app to Firebase, the release appears in the App Distribution dashboard for 150 days, starting from the upload date. After you upload the release, you can distribute it to testers, who install the release from the Firebase App Tester app on their testing device.

When the release is 30 days from the expiration date, an app release expiration notification appears on your release in the Firebase App Tester app.

App Distribution supports a maximum of 1,000 releases

App Distribution allows a maximum of 1,000 releases per app. When your app reaches the 1,000 app release limit, App Distribution automatically deletes the oldest releases above the limit.

If you want to manually manage your app releases, use the App Distribution REST API to list and delete app releases in bulk.

If you have questions, contact Firebase Support .

How can I access test apps I installed on my device?

If you're a tester, we recommend downloading Firebase App Tester , an app that lets you access all your test builds in one place.

How do I delete my tester account?

To delete your App Distribution tester account and its associated data, follow these steps in order:

1. Visit https://appdistribution.firebase.google.com and sign in with your Google account.

2. In the top-right, click settings ( Manage account )

   Delete account .

3. Optional: In your Google account permissions , revoke access from Firebase App Distribution. Note that revoking access without first deleting your App Distribution account does not delete your tester account or data.