Fehlerbehebung bei der App-Bereitstellung & Häufig gestellte Fragen

App kann aufgrund einer fehlenden Kontakt-E-Mail-Adresse nicht bereitgestellt werden

Beim Hochladen einer App kann der folgende Fehler auftreten:

„Für die App <app-id> wurde keine Kontakt-E‑Mail-Adresse gefunden. Rufen Sie App Distribution in der Firebase-Konsole auf, um einen einzurichten.“

Legen Sie in der Firebase-Konsole eine Kontakt-E-Mail-Adresse fest, falls verfügbar. Sollte das Problem weiterhin auftreten, wenden Sie sich an den Firebase-Support.

Beim Bereitstellen Ihrer App ist ein Fehler aufgetreten (Fehler 400, 409 oder 500).

Wenn die Fehler 400, 409 oder 500 während der Bereitstellung wiederholt auftreten, wenden Sie sich an den Firebase-Support. Geben Sie dem Support Ihre Firebase-Projektnummer und App-ID an.

IPA kann nicht hochgeladen werden

Hier 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."
}

Führen Sie die folgenden Schritte aus, um das Problem zu beheben:

1. 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.

2. Wenn die IPA-Größe innerhalb des Limits für die Dateigröße liegt und reproduzierbar ist, gehen Sie so vor:

   1. Prüfen Sie die Datei Info.plist und ob CFBundleDisplayName <array>-Trennzeichen enthält.

   2. Entfernen Sie die <array>-Trennzeichen und erstellen Sie Ihre App neu. Der Upload sollte erfolgreich sein.

   3. Sollten weiterhin Probleme auftreten, wenden Sie sich an den Firebase-Support.

3. Wenn die IPA-Größe die Dateigrößenbeschränkung überschreitet, nehmen Sie die erforderlichen Änderungen vor, um die Dateigröße zu reduzieren.

4. Wenn das Problem durch Verringern der IPA-Dateigröße nicht behoben wird, wenden Sie sich an den Firebase-Support und fragen Sie nach der Verwendung von Testflight.

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 sich lieber mit einer anderen E‑Mail-Adresse anmelden möchte, bitte ihn, eine E‑Mail-Adresse, die keine Gmail-Adresse ist, 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 die folgenden Richtlinien beachten:

• Verwenden Sie keine Gmail-Adresse.
• Verwenden Sie keine E‑Mail-Adresse, die bereits mit einem anderen Google-Konto verknüpft ist.
• Sie müssen das Google-Kontopasswort verwenden, wenn Sie sich mit dieser E‑Mail-Adresse anmelden.

Weitere Informationen finden Sie unter Mit einer anderen E‑Mail-Adresse im Google-Konto anmelden.

Tester kann die richtigen Apps oder Builds nicht sehen

Wenn der Tester die E‑Mail-Einladung mit einer anderen E‑Mail-Adresse angenommen hat als der, 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-Adresse A), kann sich von der E‑Mail-Adresse unterscheiden, die der Tester zum Annehmen der Einladung verwendet (E‑Mail-Adresse B). Dadurch wird im Hintergrund ein Link erstellt. Wenn E‑Mail-Adresse A neuen Builds hinzugefügt wird, erhält tatsächlich E‑Mail-Adresse B Zugriff.

Wenn der Tester die E-Mail-Einladung mit einer anderen E-Mail-Adresse angenommen hat, gehen Sie so vor, um das Problem zu beheben:

1. Löschen Sie den Tester im Abschnitt Alle Tester ansehen des Tabs Tester und Gruppen auf der Seite App Distribution der Firebase-Konsole. Vorhandene Einladungen werden entfernt.

2. Lade den Tester noch einmal ein, deine App zu testen. Der Tester sollte eine E‑Mail-Einladung erhalten.

3. Der Tester muss die Einladung mit derselben E‑Mail-Adresse annehmen.

Tester erhält keine E‑Mail-Benachrichtigungen

In den folgenden Fällen erhalten Tester möglicherweise keine E‑Mail-Benachrichtigungen:

• E‑Mail-Benachrichtigungen werden in den Spamordner verschoben.

• E‑Mail-Filter sind festgelegt.

• Die Einladung wurde an ein E‑Mail-Konto gesendet, aber der Tester hat sie mit einem anderen E‑Mail-Konto angenommen. Der Tester erhält E‑Mails zu neuen Releases an das E‑Mail-Konto, an das die Einladung ursprünglich gesendet wurde.

• Der Tester wurde bereits eingeladen, hat die Einladung aber nicht angenommen. Wenn der Tester zu nachfolgenden Releases hinzugefügt wird, sendet App Distribution nicht automatisch Release-Benachrichtigungen an diesen Tester, da er die ursprüngliche Einladung nicht angenommen hat.

Lösung 1

1. Bitte den Tester, seinen Spamordner und alle E-Mail-Filter zu prüfen, die er in seinem E-Mail-Dienst eingerichtet hat.

2. Wenn der Tester die E-Mails abbestellt hat, bitte ihn, Folgendes zu tun:

   1. Suchen Sie nach einer E‑Mail, die der Tester zuvor von der App erhalten hat.
   2. Klicke unten auf E‑Mail-Einstellungen verwalten und dann auf E‑Mails zulassen, um dich wieder anzumelden.

Lösung 2

Wenn der Tester keine E-Mail-Benachrichtigungen erhalten möchte und nur App-Einladungen annehmen möchte, kann er ausstehende App-Einladungen direkt im Firebase App Distribution-Webclip aufrufen: appdistribution.firebase.google.com.

Lösung 3

1. Löschen Sie den Tester im Abschnitt Alle Tester ansehen des Tabs Tester und Gruppen auf der Seite App Distribution in der Firebase-Konsole. Durch diese Aktion werden vorhandene Einladungen entfernt.

2. Lade den Tester noch einmal ein, deine App zu testen. Der Tester sollte eine E‑Mail-Einladung erhalten. Der Tester muss die Einladung mit der E‑Mail-Adresse annehmen, an die die Einladung gesendet wurde.

Fehler „Nicht vertrauenswürdiger Entwickler“ beim Ausführen der Test-App

Der Fehler Nicht vertrauenswürdiger Unternehmensentwickler wird angezeigt, wenn Sie dem Entwicklerzertifikat auf dem Testgerät nicht vertraut haben, bevor Sie die App geöffnet haben. Wählen Sie in der App Einstellungen auf dem Bildschirm Profile und Geräteverwaltung den Entwicklernamen der App aus und vertrauen Sie ihm.

Fehler „Entwicklermodus erforderlich“ beim Ausführen der Test-App

Der Fehler „Entwicklermodus erforderlich“ wird angezeigt, wenn Sie versuchen, eine ad-hoc-bereitgestellte iOS-App unter iOS 16 oder höher zu starten, ohne zuvor den Entwicklermodus zu aktivieren.

So aktivieren Sie den Entwicklermodus und beheben diesen Fehler:

1. Öffnen Sie auf Ihrem iPhone die Einstellungen und tippen Sie auf Datenschutz & Sicherheit.
2. Scrolle nach unten zu „Sicherheit“ und tippe auf Entwicklermodus.
3. Tippe auf den Schieberegler Entwicklermodus.
4. Tippe auf Neu starten.
5. Entsperre das Gerät nach dem Neustart. Das Dialogfeld „Entwicklermodus aktivieren?“ wird angezeigt.
6. Tippe auf Aktivieren. Sie können Ihre 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 der Entwickler seine App noch nicht für die Ausführung auf Ihrem Testgerät konfiguriert hat. Damit die App für Sie verfügbar ist, muss der Entwickler die Anleitung unter Zusätzliche Geräte registrieren befolgen.

Google-Konto hat keinen Zugriff auf die Test-App

Wenn Sie mit Ihrem Google-Konto keinen Zugriff auf eine Test-App haben, die Sie zuvor installiert haben (oder für die Sie eine Einladung angenommen haben), sind Sie wahrscheinlich im falschen Google-Konto angemeldet. Die Apps, auf die du Zugriff hast, sind mit dem Google-Konto verknüpft, das du verwendet hast, als du die Einladung zum Testen der App zum ersten Mal angenommen hast. Melde dich mit dem Google-Konto an, mit dem du die Einladung zuvor angenommen hast, und versuche es noch einmal.

403-Fehler: „Wenden Sie sich an Ihren Administrator, um Zugriff zu erhalten“

Wenn Sie einen 403-Fehler erhalten, bedeutet das, dass das von Ihnen verwendete Konto keine Berechtigung zum Installieren und Testen von Anwendungen hat. 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 den Administrator Ihres Google Workspace-Kontos, Ihre Kontoeinstellungen zu ändern. Ihr Administrator sollte der Anleitung unter Dienste ohne eigene Einstellung verwalten folgen.

Wenn du mehrere Konten hast, versuche, dich mit einem anderen Konto anzumelden, das nicht von der Installation und dem Testen von Apps ausgeschlossen ist.

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:

1. Aktivieren Sie den Debug-Modus in Ihrer App. Weitere Informationen finden Sie in der Google Analytics-Dokumentation.

2. Führen Sie Ihre App in einem Simulator aus und suchen Sie nach dem String „[Firebase/AppDistribution]“.

3. Prüfen Sie, ob der Tester Zugriff auf den neuen Release hat:

   • Wenn ein gültiges Release-Objekt zurückgegeben wird, liegt wahrscheinlich ein Problem im Lebenszyklus des View Controllers vor, bei dem das Benachrichtigungsdialogfeld geladen wird, bevor die Ansicht angezeigt wird.

   • Wenn kein Release zurückgegeben wird, ist der Tester möglicherweise noch nicht mit dem neuen Release verknüpft. Prüfen Sie im App Distribution-Dashboard der Firebase-Konsole, ob der Tester in der Build-Verteilung enthalten ist und den Status Akzeptiert hat.

     Wenn dein Tester immer noch keine Updates erhält, bitte ihn, die folgenden Tipps zu beachten, um sicherzustellen, dass er die Einladung zum Testen deiner App angenommen und sein Testgerät richtig eingerichtet hat:

     1. Melden Sie sich auf dem Testgerät im Webclip für die Firebase App-Bereitstellung an. Wählen Sie das Google-Konto aus, das Sie verwendet haben, als Sie die Einladung zum Testen der App angenommen haben.

     2. Prüfen Sie, ob der neue App-Release im Webclip verfügbar ist.

Tester wird nach dem Schließen der App aufgefordert, sich noch einmal anzumelden

Standardmäßig müssen sich deine Tester nur einmal in ihrem Google-Konto anmelden, um Benachrichtigungen zu neuen Builds zu aktivieren und neue Builds zu installieren. Wenn Ihre Tester nach dem Schließen und erneuten Öffnen Ihrer App aufgefordert werden, sich noch einmal anzumelden, folgen Sie diesen Tipps, um sicherzustellen, dass Ihre App Distribution-Konfiguration richtig eingerichtet ist:

• Prüfen Sie, ob Sie die Firebase App Testers API aktiviert haben. Weitere Informationen finden Sie unter App-Bereitstellung 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 UserDefaults normalerweise beim Abmelden löschen, löschen Sie möglicherweise den Status Ihres Testers. App Distribution speichert ein Flag, das angibt, ob sich der Tester bereits in der App angemeldet hat. Weitere Informationen finden Sie im GitHub-Repository.

Gibt es Limits für das Hinzufügen von Testern zu meiner App?

Für Firebase App Distribution gelten die folgenden Testerlimits:

• Einem Firebase-Projekt maximal 500 Tester hinzufügen

• Sie können einer App Distribution-Gruppe maximal 200 Tester hinzufügen.

Wenn Sie weitere Tester hinzufügen möchten, können Sie eine kostenlose Limiterhöhung beantragen.

Laufen meine Einladungen für Tester ab?

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 für einen Release ein Ablaufhinweis angezeigt. Eine Einladung kann erneuert 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?

Weitere Informationen finden Sie unter Zusätzliche Geräte registrieren.

Wie lange sind App-Releases verfügbar?

App-Releases werden aus App Distribution entfernt, wenn eine der folgenden Bedingungen erfüllt ist:

• Der App-Release ist älter als 150 Tage.
• Sie überschreiten das Limit von 1.000 App-Releases und der App-Release ist älter als die 1.000 neuesten App-Releases.

Weitere Informationen finden Sie unter App Distribution unterstützt maximal 1.000 Releases.

Wenn die App das Ablaufdatum von 150 Tagen oder das Limit von 1.000 App-Releases erreicht oder überschreitet, wird der Release aus dem App Distribution-Dashboard und der App Distribution-Tester-Web-App entfernt. Wenn Ihr Tester den Release installiert hat, wird die lokale Version der App weiterhin ausgeführt.

Wenn Sie möchten, dass der App-Release länger verfügbar ist, können Sie eine der folgenden Empfehlungen befolgen:

• Bevor der App-Release abläuft oder das Release-Limit überschreitet, lade die IPA herunter und lösche den Release aus dem App Distribution-Dashboard. Laden Sie das IPA dann als neuen Build in App Distribution hoch.
• Laden Sie den Release herunter und laden Sie ihn zur langfristigen Archivierung in Cloud Storage hoch.

App-Releases laufen nach 150 Tagen ab

Wenn Sie einen Release Ihrer App in Firebase hochladen, wird er ab dem Upload-Datum 150 Tage lang im App Distribution-Dashboard angezeigt. Nachdem Sie den Release hochgeladen haben, können Sie ihn an Tester verteilen, die den Release über die App Distribution-Tester-Web-App auf ihrem Testgerät installieren.

Wenn der Release 30 Tage vor dem Ablaufdatum steht, wird auf der Seite App Distribution der Firebase-Konsole und in der App Distribution-Tester-Web-App eine Benachrichtigung zum Ablauf des App-Release angezeigt.

App Distribution unterstützt maximal 1.000 Releases

App Distribution 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, die das Limit überschreiten.

Wenn Sie Ihre App-Releases manuell verwalten möchten, können Sie die App Distribution REST API verwenden, um App-Releases im Bulk aufzulisten und zu löschen.

Wenn Sie Fragen haben, wenden Sie sich an den Firebase-Support.

Was ist das Firebase-Profil?

Das Firebase-Profil ist ein Konfigurationsprofil, mit dem App Distribution Folgendes tun kann:

• Registrieren Sie das Testgerät, indem Sie die eindeutige Geräte-ID (UDID) des Geräts erfassen. Wenn Sie eine Ad-hoc-Verteilung 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 werden kann, 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, zu deren Test du eingeladen wirst, werden dem Webclip automatisch hinzugefügt.

Informationen zum Installieren von Konfigurationsprofilen auf Ihrem iOS-Gerät finden Sie in der Apple-Dokumentation.

Wie kann ich auf Test-Apps zugreifen, die ich auf meinem Gerät installiert habe?

Wenn Sie ein Tester sind, können Sie über den Firebase App Distribution-Webclip auf alle Ihre Test-Apps zugreifen. Dieser wird automatisch dem Startbildschirm Ihres Testgeräts hinzugefügt, 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:

1. Wenn Sie noch nicht angemeldet sind, melden Sie sich bei Google an und nehmen Sie die Einladung an.

2. Wählen Sie unter Apps testen die App aus, die Sie testen möchten.

3. Tippen Sie rechts oben auf der Seite der App auf mobile_screen_share.

4. 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:

1. Rufen Sie https://appdistribution.firebase.google.com auf und melden Sie sich mit Ihrem Google-Konto an.

2. Klicken Sie rechts oben auf settings (Konto verwalten).

   Konto löschen.

3. Optional: Entziehen Sie Firebase App Distribution in Ihren Google-Kontoberechtigungen den Zugriff. Wenn du den Zugriff widerrufst, ohne vorher dein App Distribution-Konto zu löschen, werden dein Testerkonto und deine Daten nicht gelöscht.