Diese Seite bietet Hilfe bei der Fehlerbehebung und Antworten auf häufig gestellte Fragen zum Verteilen und Testen von Apps mit App Distribution.
Apps verteilen
Verwenden Sie die folgenden Tipps, um Probleme zu beheben, die beim Verteilen von Apps an Ihre Tester auftreten können.
Beim Hochladen einer App tritt möglicherweise dieser Fehler auf:
„Wir konnten keine Kontakt-E-Mail-Adresse für die App <app-id>
finden. Rufen Sie die App-Verteilung in der Firebase-Konsole auf, um eine einzurichten.“
Legen Sie eine Kontakt-E-Mail in der Firebase-Konsole fest, falls 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 . Bieten Sie Support mit Ihrer Firebase-Projektnummer und App-ID an.
Das Folgende ist ein Beispiel für eine Browser-Netzwerkantwort:
{
"status": "IN_PROGRESS",
"message": "There was an error processing your
distribution. Ensure you are uploading a valid IPA or APK and try again."
}
Gehen Sie folgendermaßen vor, um dieses Problem zu beheben:
Überprüfen Sie die Größe des IPA. Die maximale Dateigröße für alle Binärdateien beträgt 2048 MiB, was etwas mehr als 2 GB entspricht.
Wenn die IPA-Größe innerhalb der Dateigrößenbeschränkung liegt und reproduzierbar ist, gehen Sie folgendermaßen vor:
Überprüfen Sie Ihre
Info.plist
Datei und bestätigen Sie, obCFBundleDisplayName
irgendwelche<array>
-Trennzeichen enthält.Entfernen Sie die Trennzeichen
<array>
und erstellen Sie Ihre App neu. Der Upload sollte erfolgreich sein.Wenn weiterhin Probleme auftreten, wenden Sie sich an den Firebase-Support .
Wenn die IPA-Größe die Dateigrößenbeschränkung überschreitet, nehmen Sie alle erforderlichen Änderungen vor, um die Dateigröße zu verringern.
Wenn die Verringerung der IPA-Dateigröße das Problem nicht löst, wenden Sie sich an den Firebase-Support und fragen Sie nach der Verwendung von Testflight .
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 Benutzer 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 sich mit dieser E-Mail-Adresse anzumelden.
Bei der Auswahl einer alternativen E-Mail-Adresse muss der Tester diese 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, das Passwort Ihres Google-Kontos 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 die Einladung gesendet wurde, kann der Tester möglicherweise nicht die richtigen Apps oder Builds sehen.
Die E-Mail, an die der Entwickler Einladungen sendet und neue Builds hinzufügt (E-Mail A), kann sich von der E-Mail unterscheiden, die der Tester verwendet, um die Einladung anzunehmen (E-Mail B). Dadurch entsteht eine Verbindung hinter den 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 gesetzt.
Die Einladung wurde an ein E-Mail-Konto gesendet, aber der Tester nahm sie 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 die E-Mails abbestellt hat, bitten Sie ihn, Folgendes zu tun:
- Suchen Sie eine E-Mail, die der Tester zuvor von der App erhalten hat.
- Klicken Sie unten auf E-Mail-Einstellungen verwalten und dann auf Neuanmeldung von E-Mails zulassen.
Lösung 2
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.
Der Fehler Untrusted Enterprise Developer wird angezeigt, wenn Sie dem Entwicklerzertifikat auf dem Testgerät vor dem Öffnen der App nicht vertraut haben. Wählen Sie in der App „Einstellungen“ > „Profile & Geräteverwaltung“ den Entwicklernamen der App aus und vertrauen Sie ihm.
Der Fehler „Entwicklermodus erforderlich“ wird angezeigt, wenn Sie versuchen, eine ad hoc bereitgestellte iOS-App unter iOS 16 oder höher zu starten, ohne zuerst den Entwicklermodus zu aktivieren.
Führen Sie die folgenden Schritte aus, um den Entwicklermodus zu aktivieren und diesen Fehler zu beheben:
- Öffnen Sie auf Ihrem iPhone die App „Einstellungen“ und tippen Sie dann auf „Datenschutz & Sicherheit“ .
- Scrollen Sie nach unten zu Sicherheit und tippen Sie auf Entwicklermodus .
- Tippen Sie auf den Entwicklermodus- Schieberegler.
- Tippen Sie auf Neustart .
- Entsperren Sie das Gerät nach dem Neustart. Der Entwicklermodus aktivieren? Dialogfeld erscheint.
- Tippen Sie auf Einschalten . Sie können Ihre App jetzt starten und mit dem Testen beginnen.
Wenn Sie eine Ad-hoc-Distribution installieren, wird diese Meldung angezeigt, wenn der Entwickler seine App noch nicht für die Ausführung auf Ihrem Testgerät konfiguriert hat. Um Ihnen die App zur Verfügung zu stellen, muss der Entwickler die Anweisungen unter Zusätzliche Geräte registrieren ausführen.
Wenn Ihr Google-Konto keinen Zugriff auf eine Test-App hat, die Sie zuvor installiert haben (oder für die Sie eine Einladung angenommen haben), haben Sie sich wahrscheinlich beim falschen Google-Konto angemeldet. Die Apps, auf die Sie Zugriff haben, sind mit dem Google-Konto verknüpft, das Sie verwendet haben, als Sie zum ersten Mal die Einladung zum Testen der App angenommen haben. Versuchen Sie es erneut, indem Sie sich mit dem Google-Konto anmelden, mit dem Sie die Einladung zuvor angenommen haben.
Wenn Sie auf einen 403-Fehler stoßen, bedeutet dies, dass das von Ihnen verwendete Konto nicht berechtigt ist, Apps zu installieren und zu testen. Der Zugriff wird vom Administrator der Domain Ihres Kontos in Google Workspace festgelegt.
Wenn Sie der Meinung sind, dass Sie berechtigt sein sollten, Apps zu installieren und zu testen, bitten Sie Ihren Google Workspace-Kontoadministrator, Ihre Kontoeinstellungen zu ändern. Ihr Administrator sollte die Anweisungen unter Verwalten des Zugriffs auf Dienste befolgen, die nicht einzeln gesteuert werden .
Wenn Sie mehrere Konten haben, versuchen Sie, sich mit einem anderen Konto anzumelden, das nicht für das Installieren und Testen von Apps eingeschränkt ist.
Aktivieren von In-App-Benachrichtigungen mit dem App Distribution iOS SDK
Verwenden Sie die folgenden Tipps, um Probleme zu beheben, bei denen Benachrichtigungen für neue Builds in der App mithilfe des App Distribution iOS SDK aktiviert werden.
Wenn Sie das App Distribution iOS SDK bereits in Ihrer App eingerichtet haben und Ihre Tester keine In-App-Benachrichtigungen erhalten, überprüfen Sie, ob Ihre App neue Releases abruft:
Aktivieren Sie den Debug-Modus in Ihrer App. Informationen dazu finden Sie in der Google Analytics-Dokumentation .
Führen Sie Ihre App in einem Simulator aus und suchen Sie nach der Zeichenfolge „[Firebase/AppDistribution]“.
Überprüfen Sie, ob der Tester Zugriff auf die neue Version hat:
Wenn ein gültiges Release-Objekt zurückgegeben wird, liegt wahrscheinlich ein Problem im Lebenszyklus des Ansichtscontrollers vor, bei dem das Warnungsdialogfeld geladen wird, bevor die Ansicht angezeigt wird.
Wenn keine Version zurückgegeben wird, ist Ihr Tester möglicherweise noch nicht mit der neuen Version verknüpft. Stellen Sie im App-Verteilungs-Dashboard der Firebase-Konsole sicher, dass Ihr Tester in Ihrer Build-Verteilung enthalten ist und sich im Zustand „Akzeptiert“ befindet.
Wenn Ihr Tester immer noch keine Updates 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 beim Firebase App Distribution-Webclip an. Denken Sie daran, das Google-Konto auszuwählen, das Sie zuerst verwendet haben, als Sie die Einladung zum Testen der App angenommen haben.
Stellen Sie sicher, dass die neue App-Version im Webclip verfügbar ist.
Standardmäßig müssen sich Ihre Tester nur einmal bei ihrem Google-Konto anmelden, um neue Build-Benachrichtigungen zu aktivieren und neue Builds zu installieren. Wenn Ihre Tester aufgefordert werden, sich nach dem Schließen und erneuten Öffnen Ihrer App 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 Schlüsseleinschränkungen sicher, dass die Firebase App Testers API in der Liste der zulässigen APIs enthalten ist.
Wenn Sie UserDefaults normalerweise beim Abmelden löschen, löschen Sie möglicherweise den Status Ihres Testers. App Distribution speichert ein Flag, das angibt, ob sich Ihr Tester bereits bei der App angemeldet hat. Weitere Informationen finden Sie im GitHub-Repository .
Häufig gestellte Fragen
Firebase App Distribution hat die folgenden Testerlimits:
Fügen Sie einem Firebase-Projekt maximal 500 Tester hinzu
Fügen Sie einer App Distribution-Gruppe maximal 200 Tester hinzu
Um weitere Tester hinzuzufügen, fordern Sie eine kostenlose Erhöhung des Limits an .
Tester haben 30 Tage Zeit, um eine Einladung zum Testen der App anzunehmen, bevor sie abläuft. Wenn eine Einladung in 5 Tagen abläuft, wird in der Firebase-Konsole neben dem Tester für eine Version ein Ablaufhinweis angezeigt. Eine Einladung kann erneuert werden, indem Sie sie über das Dropdown-Menü in der Tester-Zeile erneut senden.
Siehe Zusätzliche Geräte registrieren .
App-Versionen werden aus der App-Verteilung entfernt, wenn eine der folgenden Bedingungen eintritt:
- Das App-Release ist älter als 150 Tage.
- Sie überschreiten das Limit von 1.000 App-Releases und das 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 App-Releases erreicht oder überschritten hat, wird das Release aus dem App Distribution-Dashboard und der App Distribution Tester-Web-App entfernt. Wenn Ihr Tester die Version installiert hat, wird die lokale Version der App weiterhin ausgeführt.
Verwenden Sie eine der folgenden Empfehlungen, um die App-Version länger verfügbar zu halten:
- Bevor die App-Version abläuft oder die Veröffentlichungsgrenze überschreitet, laden Sie das IPA herunter und löschen Sie die Version aus dem App-Verteilungs-Dashboard. Laden Sie dann das IPA erneut als neuen Build in App Distribution hoch.
- Laden Sie die Version herunter und laden Sie sie zur Langzeitarchivierung in Cloud Storage 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 von der App Distribution Tester-Web-App auf ihrem Testgerät installieren.
Wenn die Veröffentlichung 30 Tage nach dem Ablaufdatum liegt, wird in Ihrer Veröffentlichung auf der Seite „App-Verteilung“ der Firebase-Konsole und in der Web-App „App Distribution Tester“ eine Benachrichtigung über den Ablauf der App-Version angezeigt.
App Distribution unterstützt maximal 1.000 Releases
Die App-Verteilung erlaubt maximal 1.000 Releases 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 .
Wenden Sie sich bei Fragen an den Firebase-Support .
Das Firebase-Profil ist ein Konfigurationsprofil, das App Distribution Folgendes ermöglicht:
Registrieren Sie das Testgerät, indem Sie die eindeutige Geräte-ID (UDID) des Geräts erfassen. Wenn Sie eine Ad-hoc-Distribution testen, sendet Firebase dem App-Entwickler eine E-Mail mit der UDID des Testgeräts und einer Anleitung, wie das Gerät in das Bereitstellungsprofil der App aufgenommen wird, damit der Build auf Ihrem Gerät getestet werden kann.
Installieren Sie einen Firebase App Distribution-Webclip auf dem Startbildschirm Ihres Geräts. Mit dem Webclip können Sie alle Ihre Test-Apps an einem Ort installieren und darauf zugreifen. Neue Builds, die Sie zum Testen einladen, werden automatisch zum Webclip hinzugefügt.
Hilfe zur Installation von Konfigurationsprofilen auf Ihrem iOS-Gerät finden Sie in der Apple-Dokumentation .
Wenn Sie ein Tester sind, können Sie mit dem Firebase App Distribution-Webclip auf alle Ihre Test-Apps zugreifen, der automatisch zum Startbildschirm Ihres Testgeräts hinzugefügt wird, wenn Sie das Firebase-Profil installieren. Wenn Sie eine Ad-hoc-Verteilung testen, müssen Sie zuerst das Profil installieren , bevor Sie die App testen können.
Wenn Sie eine Enterprise-Distribution testen, können Sie das Profil manuell installieren:
Falls noch nicht geschehen, melden Sie sich bei Google an und nehmen Sie die Einladung an.
Wählen Sie unter Apps testen die App aus, die Sie testen möchten.
Tippen Sie oben rechts auf der Seite der App auf mobile_screen_share .
Befolgen Sie die angezeigten Anweisungen, um das Firebase-Profil zu installieren.
Gehen Sie folgendermaßen vor, um Ihr App Distribution-Testerkonto und die zugehörigen Daten zu löschen:
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 Ihren Google-Kontoberechtigungen den Zugriff von Firebase App Distribution. Beachten Sie, dass das Widerrufen des Zugriffs ohne vorheriges Löschen Ihres App Distribution-Kontos Ihr Tester-Konto oder Ihre Daten nicht löscht.