Diese Seite bietet Hilfe zur Fehlerbehebung und Antworten auf häufig gestellte Fragen zum Verteilen und Testen von Apps mit App Distribution.
Verteilen von Apps
Verwenden Sie die folgenden Tipps, um Probleme zu beheben, die beim Verteilen von Apps an Ihre Tester auftreten können.
Beim Hochladen einer App kann dieser Fehler auftreten:
„Wir konnten keine Kontakt-E-Mail-Adresse für die App <app-id>
finden. Bitte besuchen Sie App Distribution in der Firebase-Konsole, um eine einzurichten.“
Legen Sie in der Firebase-Konsole eine Kontakt-E-Mail-Adresse fest, sofern verfügbar. Wenn das Problem weiterhin besteht, wenden Sie sich an den Firebase-Support .
Wenn während der Bereitstellung wiederholt die Fehler 400, 409 oder 500 auftreten, wenden Sie sich an den Firebase-Support . Teilen Sie dem Support Ihre Firebase-Projektnummer und App-ID mit.
Überprüfen Sie die Größe der APK. Die maximale Dateigröße für alle Binärdateien beträgt 2048 MiB, was etwas mehr als 2 GB entspricht.
Wenn die APK-Größe innerhalb der Dateigrößenbeschränkung liegt und reproduzierbar ist, wenden Sie sich an den Firebase-Support .
Stellen Sie sicher, dass das APK wie folgt signiert ist:
apksigner verify --verbose ~/app-distro/app-distro-apps/[path_name]/app/ build/outputs/apk/debug/app-debug.apk
Verteilen von Android App Bundles (AABs)
Wenn Sie ein AAB in App Distribution hochladen, signiert Google Play das generierte APK automatisch mithilfe eines Test-App-Signaturschlüsselzertifikats. Wenn Sie dazu aufgefordert werden, müssen Sie Ihre App bei API-Anbietern registrieren, wenn Sie deren Drittanbieterdienste weiterhin nutzen möchten. Nach der Signierung kann das Testzertifikat Ihrer App in der Firebase-Konsole angezeigt werden.
AAB-Builds, die Sie in die App-Verteilung hochladen, werden nicht in Ihrem Google Play-Entwicklerkonto angezeigt (dazu gehören auch der App Bundle Explorer und die interne App-Freigabe).
Wenn die Verknüpfung einer Firebase-Android-App mit Google Play aufgehoben wird, passiert Folgendes:
Sie können keine neuen App-Bundles in App Distribution hochladen und über die App Distribution-Integration mit Google Play nach Google Play exportieren.
Vorhandene Builds stehen weiterhin im Firebase App Distribution-Dashboard und für Ihre Tester zur Verfügung.
Alle zuvor zwischen Firebase und Google Play exportierten Daten bleiben in beiden Produkten zugänglich.
Um ein Android App Bundle (AAB) über App Distribution zu verteilen und hochgeladene AABs automatisch sowohl mit Ihrem Firebase-Projekt als auch mit Ihrem Google Play-Entwicklerkonto zu verknüpfen, stellen Sie sicher, dass Sie die folgenden Anforderungen erfüllen:
Ihr Google Play-Entwicklerkonto verfügt über eine der folgenden Zugriffsebenen : Besitzer oder Administrator.
Für Ihr Firebase-Projekt haben Sie eine der folgenden Rollen: Eigentümer oder Firebase-Administrator .
Ihre App ist bei Firebase und Ihrem Google Play-Entwicklerkonto registriert. Das bedeutet, dass Sie sowohl über eine Firebase-Android-App als auch über eine Google Play-App verfügen.
Die App in Google Play und die Firebase-Android-App sind beide mit demselben Paketnamen registriert.
Die App in Google Play wird im App-Dashboard eingerichtet und an einen der Google Play-Tracks verteilt (interner Test, geschlossener Test, offener Test oder Produktion).
Die Prüfung der App bei Google Play ist abgeschlossen und die App veröffentlicht. Ihre App wird veröffentlicht, wenn in der Spalte „App-Status“ einer der folgenden Status angezeigt wird: Interner Test (kein interner Testentwurf), geschlossener Test, offener Test oder Produktion.
Wenn Sie eine App hochgeladen haben, die zuvor die oben aufgeführten Kriterien für die Verknüpfung nicht erfüllte, dies aber jetzt tut, können Sie erneut versuchen , Ihre Firebase-Android-App mit Google Play zu verknüpfen .
Apps installieren und testen
Verwenden Sie die folgenden Tipps, um Probleme zu beheben, auf die Ihre Tester beim Installieren und Testen Ihrer Apps stoßen könnten.
Wenn ein Nutzer ein Google-Konto erstellt, erhält er automatisch eine Gmail-Adresse.
Wenn ein Tester keine Google Workspace- oder Gmail-Adresse hat oder sich lieber mit einer anderen E-Mail-Adresse anmelden möchte, bitten Sie den Tester, eine Nicht-Gmail-E-Mail-Adresse mit dem Konto zu verknüpfen und diese E-Mail-Adresse für die Anmeldung zu verwenden.
Bei der Auswahl einer alternativen E-Mail-Adresse muss der Tester die folgenden Richtlinien befolgen:
- Verwenden Sie keine Gmail-Adresse.
- Verwenden Sie keine E-Mail-Adresse, die bereits mit einem anderen Google-Konto verknüpft ist.
- Denken Sie daran, Ihr Google-Konto-Passwort zu verwenden, wenn Sie sich mit dieser E-Mail-Adresse anmelden.
Weitere Informationen finden Sie unter „Mit einer anderen E-Mail-Adresse bei Ihrem Google-Konto anmelden“ .
Wenn der Tester die E-Mail-Einladung mit einer anderen E-Mail-Adresse angenommen hat als der, an die die Einladung gesendet wurde, kann es sein, dass der Tester nicht die richtigen Apps oder Builds sieht.
Die E-Mail-Adresse, an die der Entwickler Einladungen sendet und zu neuen Builds hinzufügt (E-Mail A), kann sich von der E-Mail-Adresse unterscheiden, mit der der Tester die Einladung annimmt (E-Mail B). Dadurch entsteht eine Verbindung hinter die Kulissen. Immer wenn E-Mail A zu neuen Builds hinzugefügt wird, erhält tatsächlich E-Mail B Zugriff.
Wenn der Tester die E-Mail-Einladung mit einer anderen E-Mail-Adresse angenommen hat, befolgen Sie diese Schritte, um das Problem zu beheben:
Löschen Sie den Tester aus dem Abschnitt „Alle Tester anzeigen“ der Registerkarte „Tester und Gruppen“ auf der Seite „App-Verteilung“ der Firebase-Konsole. Vorhandene Einladungen werden entfernt.
Laden Sie den Tester erneut ein, Ihre App zu testen. Der Tester sollte eine Einladungs-E-Mail erhalten.
Stellen Sie sicher, dass der Tester die Einladung mit derselben E-Mail-Adresse annimmt.
Tester erhalten möglicherweise keine E-Mail-Benachrichtigungen, wenn einer der folgenden Fälle eintritt:
E-Mail-Benachrichtigungen werden an Spam-Ordner gesendet.
E-Mail-Filter sind eingestellt.
Die Einladung wurde an ein E-Mail-Konto gesendet, der Tester nahm sie jedoch mit einem anderen E-Mail-Konto an. Der Tester erhält neue Release-E-Mails für das E-Mail-Konto, an das die Einladung ursprünglich gesendet wurde.
Der Tester wurde zuvor eingeladen, hat die ursprüngliche Einladung jedoch nicht angenommen. Wenn der Tester zu nachfolgenden Releases hinzugefügt wird, sendet App Distribution nicht automatisch Release-Benachrichtigungen an diesen Tester, da der Tester die ursprüngliche Einladung nicht angenommen hat.
Lösung 1
Bitten Sie den Tester, seinen Spam-Ordner und alle E-Mail-Filter zu überprüfen, die er in seinem E-Mail-Dienst eingerichtet hat.
Wenn der Tester sich von den E-Mails abgemeldet hat, bitten Sie ihn, Folgendes zu tun:
- Suchen Sie nach einer E-Mail, die der Tester zuvor von der App erhalten hat.
- Klicken Sie unten auf E-Mail-Einstellungen verwalten und dann auf Erneutes Abonnieren von E-Mails zulassen.
Lösung 2
Wenn der Tester keine E-Mail-Benachrichtigungen wünscht, aber App-Einladungen annehmen möchte, kann er ausstehende App-Einladungen direkt in der App Tester-App einsehen ( Download-Anleitung ).
Lösung 3
Löschen Sie den Tester aus dem Abschnitt „Alle Tester anzeigen“ der Registerkarte „Tester und Gruppen“ auf der Seite „App-Verteilung“ in der Firebase-Konsole. Diese Aktion entfernt vorhandene Einladungen.
Laden Sie den Tester erneut ein, Ihre App zu testen. Der Tester sollte eine Einladungs-E-Mail erhalten. Stellen Sie sicher, dass der Tester die Einladung mit derselben E-Mail-Adresse annimmt, an die die Einladung gesendet wurde.
Wenn ein Tester eine Version herunterlädt und installiert, auf der Benutzeroberfläche der App-Details jedoch nicht angezeigt wird, dass die App installiert ist, handelt es sich um ein bekanntes Problem. In manchen Fällen stimmt die Bundle-ID in der Firebase-App nicht mit der Bundle-ID des APK überein.
Stellen Sie sicher, dass die Bundle-ID des APK mit der Bundle-ID der Firebase-App übereinstimmt, die Sie zum Hochladen der Verteilung verwendet haben.
Die Android-Warnung wird angezeigt, wenn Ihrer laufenden App oder Ihrem Browser noch keine Berechtigung zum Installieren von Apps außerhalb von Google Play erteilt wurde. So erteilen Sie die Erlaubnis:
Android-Version 8 oder höher : Tippen Sie in der App „Einstellungen“ auf „Aus dieser Quelle zulassen“ .
Android-Version 7 oder früher : Tippen Sie in der App „Einstellungen“ auf „Sicherheit“ und wählen Sie „Unbekannte Quellen“ aus. Wenn die Eingabeaufforderung angezeigt wird, tippen Sie auf OK > Vertrauen .
Wenn die Installation einer Test-APK auf dem Gerät eines Testers fehlschlägt:
- Stellen Sie sicher, dass die Zertifikate in der neuen Version mit denen in der auf dem Gerät des Testers installierten Version übereinstimmen. Das Android-System erlaubt die Aktualisierung der App nur, wenn die Zertifikate übereinstimmen. Weitere Informationen finden Sie unter Überlegungen zum Signieren .
- Stellen Sie sicher, dass die Betriebssystemversion des Testergeräts von der App unterstützt wird (überprüfen Sie
minSdkVersion
).
Wenn die App Tester-App Sie an der Anmeldung hindert und Sie zurück zum Anmeldebildschirm weiterleitet, verwenden Sie möglicherweise Google Workspace (ehemals GSuite), das Einschränkungseinstellungen enthält.
So entfernen Sie Ihre Einschränkungseinstellungen:
Stellen Sie auf der Registerkarte „Apps“ Ihres Google Workspace sicher, dass die Firebase-App-Verteilung nicht auf „Zugriff: Blockiert“ eingestellt ist.
Stellen Sie auf der Registerkarte „Dienste“ sicher, dass die Cloud-Plattform nicht eingeschränkt ist.
Versuchen Sie nach dem Entfernen der Einstellungen erneut, sich anzumelden.
Dieser Fehler kann auftreten, wenn die installierte App mit einer bereits auf dem Gerät installierten App in Konflikt steht. Beispielsweise könnte es sich um eine andere Variante derselben App mit derselben benutzerdefinierten Berechtigung oder demselben ContentProvider-Namen handeln.
Sie können den Tester bitten, unmittelbar nach Auftreten des Problems einen Fehlerbericht zu sammeln und den Bericht auf weitere Informationen zur Ursache zu untersuchen. Der Tester muss alle in Konflikt stehenden Apps löschen, bevor die neue App installiert werden kann.
Wenn ein 403-Fehler auftritt, bedeutet dies, dass das von Ihnen verwendete Konto nicht über die Berechtigung zum Installieren und Testen von Apps verfügt. Der Zugriff wird vom Administrator der Domain Ihres Kontos in Google Workspace bestimmt.
Wenn Sie der Meinung sind, dass Sie die Berechtigung zum Installieren und Testen von Apps haben sollten, bitten Sie den Administrator Ihres Google Workspace-Kontos, Ihre Kontoeinstellungen zu ändern. Ihr Administrator sollte den Anweisungen unter „Zugriff auf Dienste verwalten, die nicht einzeln kontrolliert werden“ folgen.
Wenn Sie mehrere Konten haben, versuchen Sie, sich mit einem anderen Konto anzumelden, das nicht auf die Installation und das Testen von Apps beschränkt ist.
Wenn Sie zum ersten Mal testen, lesen Sie den Abschnitt „Als Tester einrichten“ .
Wenn Sie ein bestehender App Distribution-Tester sind und ein neues Android-Gerät zum Testen erhalten, führen Sie die folgenden Schritte aus, anstatt den gesamten neuen Testerablauf erneut zu durchlaufen:
Navigieren Sie auf Ihrem Android-Gerät zu appdistribution.firebase.google.com .
Melden Sie sich mit Ihrem bestehenden Testerkonto an und klicken Sie unten auf dem Bildschirm auf die Schaltfläche „App Tester herunterladen“ , um die Android App Tester-App zu installieren.
Aktivieren von Testerfunktionen mit dem App Distribution Android SDK
Verwenden Sie die folgenden Tipps, um Probleme zu beheben, die das Aktivieren von In-App-Benachrichtigungen zu neuen Builds oder das Senden von In-App-Feedback mit dem App Distribution Android SDK betreffen.
Wenn Sie das App Distribution Android SDK bereits in Ihrer App eingerichtet haben, um In-App-Feedback zu unterstützen, und Ihre Tester kein Feedback abgeben können, führen Sie die folgenden Schritte aus:
Aktivieren Sie die ausführliche Protokollierung für das App Distribution Android SDK in Ihrer App:
adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
Suchen Sie in Ihren App-Protokollen nach Fehlermeldungen, indem Sie nach „FirebaseAppDistribution“ filtern.
Bestätigen Sie, dass der Tester Zugriff auf die installierte Version hat:
Wenn in den Protokollen angegeben wird, dass „der Tester keinen Zugriff auf diese Ressource hat“, wurde Ihr Tester möglicherweise nicht zur App eingeladen oder hat möglicherweise keinen Zugriff auf die Version.
Suchen Sie im App Distribution-Dashboard der Firebase-Konsole nach der genauen Version, die auf dem Gerät des Testers ausgeführt wird, und stellen Sie sicher, dass der Tester auf der Registerkarte „Tester“ auf der Versionskarte aufgeführt ist und sich im Status „Akzeptiert“ befindet.
Wenn Sie immer noch kein Feedback erhalten, gehen Sie folgendermaßen vor:
Melden Sie sich auf dem Testgerät mit App Tester oder der Tester-Web-App bei Firebase App Distribution an. Wählen Sie unbedingt das Google-Konto aus, das Sie zum ersten Mal verwendet haben, als Sie die Einladung zum Testen der App angenommen haben.
Installieren Sie die App erneut mit App Tester oder der Test-Web-App, um sicherzustellen, dass der Tester Zugriff auf die Version hat.
Versuchen Sie, Feedback zu übermitteln. Melden Sie sich dabei erneut mit demselben Google-Konto an.
Stellen Sie sicher, dass Sie die Firebase App Testers API aktiviert haben. Weitere Informationen finden Sie unter Aktivieren der App Distribution Tester-API .
Stellen Sie unter Wichtige Einschränkungen sicher, dass die Firebase App Testers API in der Liste der zulässigen APIs enthalten ist.
Wenn beim Senden von Feedback die Meldung „Hätte Feedback gesendet, aber aufgrund des Entwicklungsmodus nicht“ angezeigt wird, deaktivieren Sie den Entwicklermodus auf dem Gerät, indem Sie diesen Befehl ausführen:
adb shell setprop debug.firebase.appdistro.devmode false
Überprüfen Sie Ihre
google-services.json
Datei, um sicherzustellen, dass Sie Feedback für das richtige Projekt und die richtige App senden.Aktivieren Sie die ausführliche Protokollierung für das App Distribution Android SDK in Ihrer App:
adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
Suchen Sie in Ihren App-Protokollen nach Fehlermeldungen, indem Sie nach „FirebaseAppDistribution“ filtern.
Wenn Sie das App Distribution Android SDK bereits in Ihrer App eingerichtet haben und Ihre Tester keine In-App-Benachrichtigungen erhalten, gehen Sie folgendermaßen vor:
Suchen Sie nach Fehlermeldungen, indem Sie einen
OnFailureListener
an die von der Firebase App Distribution API zurückgegebene Aufgabe anhängen.Java
firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener ( e -> { if (e instanceof FirebaseAppDistributionException) { // Log exception here }});
Kotlin
firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener { e -> if (e is FirebaseAppDistributionException) { // Log exception here } }
Überprüfen Sie, ob der Tester Zugriff auf die neue Version hat:
Aktivieren Sie den Debug-Modus in Ihrer App. Weitere Informationen dazu finden Sie in der Google Analytics-Dokumentation .
Führen Sie Ihre App in einem Simulator aus und suchen Sie nach der Zeichenfolge „FirebaseAppDistribution“.
Wenn aus den Protokollen hervorgeht, dass keine Version gefunden wurde oder der Tester keinen Zugriff hat, ist Ihr Tester möglicherweise noch nicht mit der neuen Version verknüpft.
Stellen Sie im App Distribution-Dashboard der Firebase-Konsole sicher, dass Ihr Tester in Ihrer Build-Distribution enthalten ist und sich im Status „Akzeptiert“ befindet.
Wenn Ihr Tester immer noch keine Benachrichtigungen erhält, bitten Sie ihn, die folgenden Tipps zu befolgen, um sicherzustellen, dass er die Einladung zum Testen Ihrer App angenommen und sein Testgerät ordnungsgemäß eingerichtet hat:
Melden Sie sich auf dem Testgerät über App Tester oder über die Tester-Web-App bei Firebase App Distribution an. Denken Sie daran, das Google-Konto auszuwählen, das Sie zum ersten Mal verwendet haben, als Sie die Einladung zum Testen der App angenommen haben.
Stellen Sie sicher, dass die neue App-Version in App Tester oder der Tester-Web-App verfügbar ist.
Standardmäßig müssen sich Ihre Tester nur einmal bei ihrem Google-Konto anmelden, um Testfunktionen zu aktivieren. Wenn Ihre Tester nach dem Schließen und erneuten Öffnen Ihrer App aufgefordert werden, sich erneut anzumelden, befolgen Sie diese Tipps, um sicherzustellen, dass Ihre App Distribution-Konfiguration ordnungsgemäß eingerichtet ist:
Stellen Sie sicher, dass Sie die Firebase App Testers API aktiviert haben. Weitere Informationen finden Sie unter Aktivieren der App Distribution Tester-API .
Stellen Sie unter Wichtige Einschränkungen sicher, dass die Firebase App Testers API in der Liste der zulässigen APIs enthalten ist.
Wenn Sie SharedPreferences normalerweise beim Abmelden löschen, löschen Sie möglicherweise den Status Ihres Testers. App Distribution speichert eine Markierung, die angibt, ob sich Ihr Tester bereits bei der App angemeldet hat. Weitere Informationen finden Sie im GitHub-Repository .
Häufig gestellte Fragen
Für Firebase App Distribution gelten die folgenden Testergrenzen:
Fügen Sie einem Firebase-Projekt maximal 500 Tester hinzu
Fügen Sie einer App-Verteilungsgruppe maximal 200 Tester hinzu
Um weitere Tester hinzuzufügen, fordern Sie eine kostenlose Erhöhung des Limits an.
Tester haben 30 Tage Zeit, eine Einladung zum Testen der App anzunehmen, bevor diese abläuft. Wenn eine Einladung in fünf Tagen abläuft, wird in der Firebase-Konsole neben dem Tester einer Veröffentlichung eine Ablaufbenachrichtigung angezeigt. Eine Einladung kann erneuert werden, indem Sie sie über das Dropdown-Menü in der Testerzeile erneut senden.
App-Releases werden aus App Distribution entfernt, wenn eine der folgenden Bedingungen eintritt:
- Die App-Version ist älter als 150 Tage.
- Sie überschreiten das Limit von 1.000 App-Releases und die App-Release ist älter als die 1.000 neuesten App-Releases.
Weitere Informationen finden Sie unter App Distribution unterstützt maximal 1.000 Releases .
Nachdem die App das Ablauflimit von 150 Tagen oder das Limit von 1.000 Veröffentlichungen erreicht oder überschreitet, wird die Veröffentlichung aus dem App Distribution-Dashboard und der Firebase App Tester-App entfernt. Wenn Ihr Tester das Release installiert hat, läuft die lokale Version der App weiterhin.
Um die App-Version länger verfügbar zu halten, verwenden Sie eine der folgenden Empfehlungen:
- Bevor die App-Version abläuft oder das Release-Limit überschreitet, laden Sie das APK oder AAB herunter und löschen Sie die Version aus dem App Distribution-Dashboard. Laden Sie dann das APK oder AAB erneut als neuen Build in App Distribution hoch.
- Laden Sie die Version herunter und laden Sie sie zur Langzeitarchivierung in den Cloud-Speicher hoch.
App-Releases laufen nach 150 Tagen ab
Wenn Sie eine Version Ihrer App auf Firebase hochladen, wird die Version ab dem Upload-Datum 150 Tage lang im App-Verteilungs-Dashboard angezeigt. Nachdem Sie die Version hochgeladen haben, können Sie sie an Tester verteilen, die die Version über die Firebase App Tester-App auf ihrem Testgerät installieren.
Wenn die Veröffentlichung 30 Tage vor dem Ablaufdatum liegt, wird auf Ihrer Veröffentlichung in der Firebase App Tester-App eine Benachrichtigung über den Ablauf der App-Version angezeigt.
App Distribution unterstützt maximal 1.000 Releases
Die App-Verteilung erlaubt maximal 1.000 Veröffentlichungen pro App. Wenn Ihre App das Limit von 1.000 App-Releases erreicht, löscht App Distribution automatisch die ältesten Releases über dem Limit.
Wenn Sie Ihre App-Releases manuell verwalten möchten, verwenden Sie die App Distribution REST API, um App-Releases in großen Mengen aufzulisten und zu löschen .
Wenn Sie Fragen haben, wenden Sie sich an den Firebase-Support .
Wenn Sie Tester sind, empfehlen wir den Download von Firebase App Tester , einer App, mit der Sie an einem Ort auf alle Ihre Test-Builds zugreifen können.
Firebase App Distribution nutzt die Firebase Test Lab-Infrastruktur und die Kontingentgrenzen und Preise sind gleich. Die Testquoten werden anhand der Anzahl der pro Tag durchgeführten Tests gemessen. Weitere Informationen zu Testkontingenten und der Abrechnung finden Sie unter Nutzungsniveaus, Kontingente und Preise für Test Lab .
Wenn Sie das Kontingent überschreiten, erhalten Sie Fehlermeldungen, dass das Kontingent überschritten wurde. Das Zurücksetzen von Kontingenten dauert etwa 24 Stunden. Daher sollten Sie Wiederholungsversuche vermeiden, bis das Kontingent freigegeben ist. Wenn Sie jedoch Fehler im Zusammenhang mit der automatisierten Tester-Infrastruktur erhalten, ist es wahrscheinlicher, dass Anrufe erfolgreich sind, wenn Sie es sofort erneut versuchen.
Sie benötigen Editorzugriff auf das Firebase-Projekt, um Tests mit der Funktion „Automatisierte Tester“ ausführen zu können.
Um Ihr App Distribution-Testerkonto und die zugehörigen Daten zu löschen, führen Sie die folgenden Schritte aus:
Besuchen Sie https://appdistribution.firebase.google.com und melden Sie sich mit Ihrem Google-Konto an.
Klicken Sie oben rechts auf
( Konto verwalten ).Konto löschen .
Optional: Widerrufen Sie in den Berechtigungen Ihres Google-Kontos den Zugriff von Firebase App Distribution. Beachten Sie, dass das Widerrufen des Zugriffs ohne vorheriges Löschen Ihres App Distribution-Kontos nicht zur Löschung Ihres Testerkontos oder Ihrer Testerdaten führt.