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

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

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

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

• Любые данные, ранее экспортированные между 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). Это создает скрытую связь. Всякий раз, когда адрес электронной почты A добавляется в новые сборки, на самом деле доступ к нему получает адрес электронной почты B.

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

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

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

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

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

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

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

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

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

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

Решение 1

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

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

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

Решение 2

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

Решение 3

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

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

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

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

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

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

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

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

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

Тестовые 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

Если вы впервые тестируете, см. раздел «Настройка в качестве тестировщика» .

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

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

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

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

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

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

   adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
   

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

3. Подтвердите, что тестер имеет доступ к установленной версии:

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

   2. На панели распространения приложений консоли Firebase найдите точный выпуск, который работает на устройстве тестировщика, и убедитесь, что тестер указан на вкладке «Тестеры» на карточке выпуска и находится в состоянии «Принято».

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

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

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

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

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

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

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

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

   adb shell setprop debug.firebase.appdistro.devmode false
   

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

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

   adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
   

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

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

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

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. На панели распространения приложений консоли Firebase убедитесь, что ваш тестер включен в дистрибутив сборки и находится в состоянии «Принято» .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Распространение приложений допускает максимум 1000 выпусков для каждого приложения. Когда ваше приложение достигает лимита в 1000 выпусков, App Distribution автоматически удаляет самые старые выпуски, превышающие этот лимит.

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

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

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

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

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

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

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

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

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

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