Diese Seite enthält Hilfe zur Fehlerbehebung und Antworten auf häufig gestellte Fragen. Fragen zum Verteilen und Testen von Apps mit App Distribution.
Apps bereitstellen
Mit den folgenden Tipps können Sie Probleme beheben, die beim Verteilen von Apps an Ihre Tester auftreten können.
App kann aufgrund einer fehlenden Kontakt-E-Mail-Adresse nicht veröffentlicht werden
Beim Hochladen einer App kann der folgende 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 eine Kontakt-E-Mail-Adresse in der Firebase-Konsole fest, falls verfügbar. Wenn das Problem dauerhaft besteht, wenden Sie sich an den Firebase-Support.
Bei der Bereitstellung Ihrer Anwendung ist ein Fehler aufgetreten (Fehler 400, 409 oder 500).
Wenn bei 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 die App-ID mit.
IPA kann nicht hochgeladen werden
Das folgende Beispiel zeigt 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."
}
Führen Sie die folgenden Schritte aus, um das Problem zu beheben:
Prüfen Sie die Größe der IPA. Die maximale Dateigröße für alle Binärdateien beträgt 2.048 MiB, also etwas mehr als 2 GB.
Wenn die IPA-Größe die maximale Dateigröße nicht überschreitet und reproduzierbar ist, gehen Sie so vor:
Prüfen Sie die Datei
Info.plist
und sehen Sie nach, obCFBundleDisplayName
<array>
-Trennzeichen enthält.Entfernen Sie die
<array>
-Trennzeichen und erstellen Sie die App neu. Der Upload sollte jetzt erfolgreich sein.Sollten weiterhin Probleme auftreten, wenden Sie sich an den Firebase-Support.
Wenn die IPA-Größe die maximal zulässige Dateigröße überschreitet, nehmen Sie die erforderlichen Änderungen die Dateigröße zu verringern.
Wenn das Problem durch Verringern der IPA-Dateigröße nicht behoben wird, wenden Sie sich an den Firebase-Support und erkundigen Sie sich nach der Verwendung von Testflight.
Apps installieren und testen
Mit den folgenden Tipps können Sie Probleme beheben, die Ihre Tester möglicherweise wenn sie Ihre Apps installieren und testen.
Der Tester hat kein Google-Konto
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 stattdessen eine andere E-Mail-Adresse für die Anmeldung verwenden, bitten Sie den Tester, eine Verknüpfung mit dem Konto verknüpfen und sich mit dieser E-Mail-Adresse anmelden.
Bei der Auswahl einer alternativen E-Mail-Adresse müssen die Tester die folgenden Richtlinien einhalten:
- 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 Adresse.
Weitere Informationen finden Sie unter Mit einer anderen E-Mail-Adresse in Ihrem Google-Konto anmelden.
Tester können die richtigen Apps oder Builds nicht sehen
Wenn der Tester die E-Mail-Einladung mit einer anderen E-Mail-Adresse angenommen hat, als an die die Einladung gesendet wurde, kann er möglicherweise nicht die richtigen Apps oder Builds sehen.
Die E-Mail-Adresse, an die der Entwickler Einladungen sendet und die er neuen Builds hinzufügt (E-Mail A), kann von der E-Mail-Adresse abweichen, mit der der Tester die Einladung annimmt (E-Mail B). Dadurch wird hinter den Kulissen ein Link erstellt. Immer E-Mail A neuen Kreationen hinzugefügt wird, ist es tatsächlich E-Mail B, die Zugriff erhält.
Wenn der Tester die E-Mail-Einladung mit einer anderen E-Mail-Adresse angenommen hat, gehen Sie so vor, um das Problem zu beheben:
Löschen Sie den Tester aus dem Abschnitt Alle Tester ansehen der Seite Tester und Tab „Gruppen“ im App Distribution der Firebase-Konsole. Bestehende Einladungen werden entfernt.
Laden Sie den Tester noch einmal zum Testen Ihrer App ein. Er sollte eine Einladungs-E-Mail erhalten.
Achten Sie darauf, dass der Tester die Einladung mit derselben E-Mail-Adresse annimmt.
Tester erhält keine E-Mail-Benachrichtigungen
Tester erhalten möglicherweise keine E-Mail-Benachrichtigungen, wenn einer der folgenden Fälle eintritt:
E-Mail-Benachrichtigungen werden an den Spamordner gesendet.
E-Mail-Filter sind festgelegt.
Die Einladung wurde an ein E-Mail-Konto gesendet, aber der Tester hat sie mit einer mit einem anderen E-Mail-Konto. Der Tester erhält neue E-Mails zu neuen Releases für das E-Mail-Konto, an das die Einladung ursprünglich gesendet wurde.
Der Tester wurde bereits eingeladen, hat die erste Einladung aber nicht angenommen. Wird der Tester zu nachfolgenden Releases hinzugefügt, wird App Distribution nicht automatisch Release-Benachrichtigungen an diesen Tester senden, hat die ursprüngliche Einladung nicht angenommen.
Lösung 1
Bitten Sie den Tester, seinen Spamordner und die darin festgelegten E‐Mail-Filter zu prüfen ihren E-Mail-Dienst nutzen.
Wenn der Tester die E-Mails abgemeldet hat, bitte 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 E-Mails zulassen. ein Abo abzuschließen.
Lösung 2
Wenn der Tester keine E-Mail-Benachrichtigungen erhalten und nur App-Einladungen annehmen möchte, kann er ausstehende App-Einladungen direkt im Firebase App Distribution-Webclip ansehen: appdistribution.firebase.google.com.
Lösung 3
Löschen Sie den Tester aus dem Abschnitt Alle Tester ansehen der Seite Tester und Tab „Gruppen“ im App Distribution in der Firebase-Konsole. Dadurch werden vorhandene Einladungen entfernt.
Laden Sie den Tester noch einmal ein, Ihre App zu testen. Der Tester sollte eine Einladungs-E-Mail. Der Tester muss die Einladung mit dem E-Mail-Adresse, an die die Einladung gesendet wurde.
Fehler „Nicht vertrauenswürdiger Unternehmensentwickler“ beim Ausführen der Test-App
Der Fehler Nicht vertrauenswürdiger Unternehmensentwickler wird angezeigt, wenn Sie dem Entwicklerzertifikat auf dem Testgerät vor dem Öffnen der App kein Vertrauen geschenkt haben. Wählen Sie in der App Einstellungen > Profile und Geräteverwaltung den Namen des Entwicklers der App aus und vertrauen Sie ihm.
Fehlermeldung „Entwicklermodus erforderlich“ beim Ausführen der Test-App
Dieser Fehler wird angezeigt, wenn Sie versuchen, eine ad hoc-provisionierte iOS-App unter iOS 16 oder höher zu starten, ohne zuvor den Entwicklermodus aktiviert zu haben.
Gehen Sie wie folgt vor, um den Entwicklermodus zu aktivieren und diesen Fehler zu beheben:
- Öffnen Sie auf Ihrem iPhone die App Einstellungen und tippen Sie dann auf Datenschutz und Sicherheit.
- Scrollen Sie nach unten zu „Sicherheit“ und tippen Sie auf Entwicklermodus.
- Tippen Sie auf den Schieberegler für Entwicklermodus.
- Tippen Sie auf Neu starten.
- Entsperren Sie das Gerät nach dem Neustart. Die Option Entwicklermodus aktivieren? wird angezeigt.
- Tippen Sie auf Aktivieren. Du kannst deine App jetzt starten und mit dem Testen beginnen.
„Das Gerät ist registriert, Sie können loslegen. Sie werden per E-Mail benachrichtigt, sobald die App zum Testen bereit ist.“
Wenn Sie eine Ad-hoc-Distribution installieren, wird diese Meldung angezeigt, wenn die Der Entwickler hat seine App noch nicht für die Ausführung auf deinem Testgerät konfiguriert. Um die App für dich verfügbar zu machen, muss der Entwickler folgen Sie der Anleitung unter Zusätzliche Geräte registrieren.
Das Google-Konto hat keinen Zugriff auf die Test-App
Wenn Ihr Google-Konto keinen Zugriff auf eine Test-App hat, die Sie zuvor installiert ist oder eine Einladung angenommen hat, Google-Konto anmelden. Die Apps, auf die Sie Zugriff haben, sind mit dem Google-Konto verknüpft, mit dem Sie die Einladung zum Testen der App angenommen haben. Melden Sie sich noch einmal mit dem Google-Konto an, mit dem Sie die Einladung angenommen haben.
403-Fehler: „Wenden Sie sich an Ihren Administrator, um Zugriff zu erhalten“
Wenn ein 403-Fehler auftritt, 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 die Berechtigung zum Installieren und Testen von Apps haben sollten, bitten Sie Ihren Google Workspace-Kontoadministrator, Ihre Kontoeinstellungen zu ändern. Ihr Administrator sollte der Anleitung unter Dienste ohne eigene Einstellung verwalten folgen.
Wenn Sie mehrere Konten haben, melden Sie sich mit einem anderen Konto an, für das die Installation und Prüfung von Apps nicht eingeschränkt ist.
In-App-Benachrichtigungen mit dem App Distribution iOS SDK aktivieren
Mit den folgenden Tipps können Sie Probleme beheben, die beim Aktivieren von Benachrichtigungen zu neuen Builds in Apps mit dem App Distribution iOS SDK auftreten.
Tester erhält keine In-App-Benachrichtigungen
Wenn Sie das App Distribution iOS SDK bereits in Ihrer App eingerichtet haben und Ihre Tester keine In-App-Benachrichtigungen erhalten, prüfen Sie, ob Ihre App neue Releases abruft:
Aktivieren Sie den Fehlerbehebungsmodus 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 dem String „[Firebase/AppDistribution]“.
Prüfen Sie, ob der Tester Zugriff auf den neuen Release hat:
Wenn ein gültiges Release-Objekt zurückgegeben wird, ist wahrscheinlich Problem im View-Controller-Lebenszyklus, wenn das Benachrichtigungsdialogfeld bevor die Ansicht erscheint.
Wenn kein Release zurückgegeben wird, ist Ihr Tester möglicherweise noch nicht mit dem neuen Release verknüpft. Im App Distribution-Dashboard des Firebase-Konsole, vergewissere dich, dass dein Tester in deinem Build enthalten ist und sich im Status Angenommen 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 richtig eingerichtet hat:
Melden Sie sich auf dem Testgerät im Webclip für Firebase App Distribution an. Denken Sie daran, das Google-Konto auszuwählen, das Sie bei der Registrierung hat die Einladung zum Testen der App angenommen.
Achten Sie darauf, dass die neue App-Version im Webclip verfügbar ist.
Tester werden nach dem Schließen der App aufgefordert, sich noch einmal anzumelden
Standardmäßig müssen sich Ihre Tester nur einmal in ihrem Google-Konto anmelden, um Benachrichtigungen zu neuen Builds zu aktivieren und neue Builds zu installieren Wenn Ihre Tester aufgefordert, sich nach dem Schließen und erneuten Öffnen der App wieder anzumelden, führen Sie die folgenden Schritte aus: Tipps für die korrekte Einrichtung der App Distribution-Konfiguration:
Prüfen Sie, ob die Firebase App Testers API aktiviert ist. Weitere Informationen finden Sie unter App Distribution Tester API aktivieren.
Achten Sie darauf, dass die Firebase App Testers API unter Schlüsseleinschränkungen in der Liste der zulässigen APIs enthalten ist.
Wenn Sie die UserDefaults normalerweise beim Abmelden löschen, Status Ihres Testers. App Distribution speichert ein Flag, das angibt, ob sich Ihr Tester bereits in der App angemeldet hat. Weitere Informationen finden Sie im GitHub-Repository.
Häufig gestellte Fragen
Gibt es Einschränkungen für das Hinzufügen von Testern zu meiner App?
Für Firebase App Distribution gelten folgende Limits für Tester:
Einem Firebase-Projekt maximal 500 Tester hinzufügen
Du kannst einer App Distribution-Gruppe maximal 200 Tester hinzufügen
Fordern Sie einen kostenlosen an, um weitere Tester hinzuzufügen Erhöhung des Limits
Verfallen meine Einladungen an Tester?
Tester haben 30 Tage Zeit, eine Einladung zum Testen der App anzunehmen, bevor sie abläuft. Wenn eine Einladung in 5 Tagen abläuft, wird in der Firebase Console neben dem Tester in einer Release-Version eine entsprechende Benachrichtigung angezeigt. Eine Einladung kann verlängert werden, indem Sie sie über das Drop-down-Menü in der Zeile des Testers noch einmal senden.
Wann wird ein neuer Release für iOS-Uploads erstellt?
Siehe Weitere Geräte registrieren.
Wie lange sind App-Releases verfügbar?
App-Releases werden aus App Distribution entfernt, wenn einer der folgenden Punkte zutrifft:
- Der App-Release ist älter als 150 Tage.
- Sie haben das Limit von 1.000 App-Releases überschritten und der App-Release ist älter als die 1.000 aktuellsten App-Releases.
Weitere Informationen finden Sie unter App Distribution unterstützt maximal 1.000 Releases.
Nachdem die App die 150-Tage-Ablauffrist erreicht oder überschreitet oder die 1.000 Apps der App überschritten haben Release-Limit hinzugefügt haben, wird der Release aus dem App Distribution-Dashboard entfernt und App Distribution-Tester-Web-App. Wenn Ihr Tester den Release installiert hat, der App weiterhin ausgeführt wird.
Wenn Sie die App-Version länger verfügbar halten möchten, können Sie eine der folgenden Empfehlungen verwenden:
- Laden Sie die IPA-Datei herunter und löschen Sie die Version aus dem App Distribution-Dashboard, bevor die Version abläuft oder das Versionslimit überschreitet. Gehen Sie dann so vor: Laden Sie das IPA noch einmal als neuen Build in App Distribution hoch.
- Laden Sie die Version herunter und laden Sie sie zur langfristigen Archivierung in Cloud Storage hoch.
App-Releases laufen nach 150 Tagen ab
Wenn Sie einen Release Ihrer App auf Firebase hochladen, wird er ab dem Uploaddatum 150 Tage lang im App Distribution-Dashboard angezeigt. Nach dem Hochladen des Release kann sie an Tester verteilen, die den Release aus dem App Distribution installieren Tester-Web-App auf ihrem Testgerät an.
Wenn 30 Tage nach dem Ablaufdatum der Release liegt, wird ein App-Release Die Ablaufbenachrichtigung wird auf der Seite „App Distribution“ für deinen Release angezeigt der Firebase-Konsole und in der App Distribution-Tester-Web-App.
App Distribution unterstützt maximal 1.000 Releases
Bei App Distribution sind maximal 1.000 Releases pro App erlaubt. Wenn die maximal zulässige Anzahl an Releases für Ihre App erreicht ist, werden bei App Distribution beginnend mit dem ältesten Release automatisch alle Releases gelöscht, die das Limit überschreiten.
Wenn Sie Ihre App-Releases manuell verwalten möchten, können Sie mit der App Distribution REST API App-Releases auflisten und in Bulk löschen.
Wenn Sie Fragen haben, wenden Sie sich bitte an den Firebase-Support.
Was ist das Firebase-Profil?
Das Firebase-Profil ist ein Konfigurationsprofil, mit dem App Distribution Folgendes tun kann:
Testgerät durch Erfassen der eindeutigen Geräte-ID registrieren (UDID). Wenn Sie eine Ad-hoc-Bereitstellung testen, sendet Firebase die App Entwickler eine E-Mail mit der UDID des Testgeräts Anleitung zur Aufnahme des Geräts in die App-Bereitstellung 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 in an einem Ort. Neue Builds, zu deren Test Sie eingeladen werden, werden dem Webclip automatisch hinzugefügt.
Informationen zur Installation von Konfigurationsprofilen auf Ihrem iOS-Gerät finden Sie unter Dokumentation von Apple
Wie kann ich auf Test-Apps zugreifen, die ich auf meinem Gerät installiert habe?
Als Tester können Sie mit dem Firebase App Distribution-Webclip auf alle Ihre Test-Apps zugreifen. Dieser wird automatisch auf dem Startbildschirm Ihres Testgeräts hinzugefügt, wenn Sie das Firebase-Profil installieren. Wenn Sie eine Ad-hoc-Bereitstellung 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 in Google an und nehmen Sie die Einladung an.
Wählen Sie unter Apps testen die App aus, die Sie testen möchten.
Tippe oben rechts auf der Seite der App auf mobile_screen_share.
Folgen Sie der Anleitung, um das Firebase-Profil zu installieren.
Wie lösche ich mein Testkonto?
So löschen Sie Ihr App Distribution-Testerkonto und die zugehörigen Daten:
Rufen Sie https://appdistribution.firebase.google.com auf und melden Sie sich mit Ihrem Google-Konto an.
Klicken Sie rechts oben auf settings (Konto verwalten).
Konto löschen
Optional: Widerrufen Sie in den Google-Kontoberechtigungen den Zugriff für Firebase App Distribution. Wenn Sie den Zugriff widerrufen, ohne zuerst Ihr App Distribution-Konto zu löschen, werden Ihr Testerkonto und Ihre Daten nicht gelöscht.