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

App kann aufgrund einer fehlenden E-Mail-Adresse des Kontakts nicht veröffentlicht werden

Beim Hochladen einer App kann dieser Fehler auftreten:

„Wir konnten keine Kontakt-E-Mail-Adresse für die App <app-id> finden. Rufen Sie in der Firebase-Konsole App Distribution auf, 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.

Bei der Bereitstellung Ihrer App 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. Geben Sie dem Support Ihre Firebase-Projektnummer und App-ID an.

Die IPA-Datei kann nicht hochgeladen werden

Hier ist ein Beispiel für eine Browsernetzwerkantwort:

{
"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 Dateigrößenlimits liegt und reproduzierbar ist, führen Sie die folgenden Schritte aus:

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

   2. Entfernen Sie die <array>-Trennzeichen und erstellen Sie die App neu. Der Upload sollte dann funktionieren.

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

3. Wenn die IPA-Datei die Größenbeschränkung überschreitet, müssen Sie die Dateigröße entsprechend verringern.

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, bitten Sie ihn, eine Nicht-Gmail-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 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.
• Verwenden Sie das Passwort des Google-Kontos, wenn Sie sich mit dieser E-Mail-Adresse anmelden.

Weitere Informationen

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 die, 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 auf der Seite App Distribution der Firebase-Konsole auf dem Tab Tester und Gruppen im Bereich Alle Tester ansehen. Vorhandene Einladungen werden entfernt.

2. Laden Sie den Tester noch einmal ein, Ihre App zu testen. Der Tester sollte eine Einladungs-E-Mail erhalten.

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

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 in Spamordner verschoben.

• E-Mail-Filter sind eingerichtet.

• Die Einladung wurde an ein E‑Mail-Konto gesendet, der Tester hat sie aber mit einem anderen E‑Mail-Konto angenommen. Der Tester erhält 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 ursprüngliche 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. Bitten Sie den Tester, in seinem Spamordner und in den von ihm in seinem E‑Mail-Dienst festgelegten E‑Mail-Filtern nachzusehen.

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. Klicken Sie unten auf E-Mail-Einstellungen verwalten und dann auf E-Mails zulassen, um das Abo zu reaktivieren.

Lösung 2

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

Lösung 3

1. Löschen Sie den Tester auf der Seite App Distribution in der Firebase-Konsole auf dem Tab Tester & Gruppen im Bereich Alle Tester ansehen. Durch diese Aktion werden vorhandene Einladungen entfernt.

2. Laden Sie den Tester noch einmal ein, Ihre App zu testen. Der Tester sollte eine Einladungs-E-Mail erhalten. Der Tester muss die Einladung mit derselben E‑Mail-Adresse annehmen, an die die Einladung gesendet wurde.

Fehler „Nicht vertrauenswürdiger Unternehmensentwickler“ beim Ausführen einer Test-App

Der Fehler Nicht vertrauenswürdiger Unternehmensentwickler wird angezeigt, wenn Sie das Entwicklerzertifikat auf dem Testgerät nicht als vertrauenswürdig eingestuft haben, bevor Sie die App geöffnet haben. Wählen Sie in den Einstellungen > Profile und Geräteverwaltung den Entwicklernamen der App aus und stufen Sie ihn als vertrauenswürdig ein.

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

Der Fehler „Developer Mode Required“ (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.

So aktivieren Sie den Entwicklermodus und beheben diesen Fehler:

1. Öffnen Sie auf Ihrem iPhone die Einstellungen und tippen Sie auf Datenschutz & Sicherheit.
2. Scrollen Sie nach unten zu „Sicherheit“ und tippen Sie auf Entwicklermodus.
3. Tippen Sie auf den Schieberegler Entwicklermodus.
4. Tippen Sie auf Neu starten.
5. Entsperren Sie das Gerät, nachdem es neu gestartet wurde. Das Dialogfeld „Entwicklermodus aktivieren?“ wird angezeigt.
6. Tippen Sie auf Aktivieren. Sie können Ihre App jetzt starten und mit dem Testen beginnen.

„Das Gerät ist registriert, Sie können loslegen. Sie erhalten eine E‑Mail, wenn die App getestet werden kann.“

Wenn Sie eine Ad-hoc-Verteilung 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 Ihr Google-Konto keinen Zugriff auf eine Test-App hat, die Sie zuvor installiert oder für die Sie eine Einladung angenommen haben, haben Sie sich wahrscheinlich mit dem falschen Google-Konto angemeldet. Die Apps, auf die Sie Zugriff haben, sind mit dem Google-Konto verknüpft, das Sie verwendet haben, als Sie die Einladung zum Testen der App zum ersten Mal angenommen haben. Melden Sie sich noch einmal mit dem Google-Konto an, das Sie zuvor zum Annehmen der Einladung verwendet haben.

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

Wenn Sie einen 403-Fehler erhalten, bedeutet das, dass das Konto, das Sie verwenden, keine Berechtigung zum Installieren und Testen von Apps 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 Steuerung verwalten folgen.

Wenn Sie mehrere Konten haben, versuchen Sie, sich mit einem anderen Konto anzumelden, mit dem Sie Apps installieren und testen können.

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 Fehlerbehebungsmodus in Ihrer App. Eine Anleitung dazu 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 View Controller-Lebenszyklus vor, bei dem das Benachrichtigungsdialogfeld geladen wird, bevor die Ansicht angezeigt wird.

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

     Wenn Ihr Tester weiterhin 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:

     1. Melden Sie sich auf dem Testgerät im Firebase App Distribution-Webclip an. Wählen Sie das Google-Konto aus, das Sie bei der Annahme der Einladung zum Testen der App verwendet haben.

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

Tester wird 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 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 Distribution Tester API aktivieren.

• Prüfen Sie unter Schlüsseleinschränkungen, ob die Firebase App Testers API in der Liste der zulässigen APIs enthalten ist.

• Wenn Sie beim Abmelden normalerweise UserDefaults löschen, löschen Sie möglicherweise den Status Ihres Testers. In App Distribution wird ein Flag gespeichert, das angibt, ob sich Ihr Tester bereits in der App angemeldet hat. Weitere Informationen finden Sie im GitHub-Repository.

Gibt es Einschränkungen beim Hinzufügen von Testern zu meiner App?

Für Firebase App Distribution gelten die folgenden Einschränkungen für Tester:

• Maximal 500 Tester zu einem Firebase-Projekt hinzufügen

• Einer App Distribution-Gruppe können maximal 200 Tester hinzugefügt werden.

Wenn Sie weitere Tester hinzufügen möchten, fordern Sie eine kostenlose Erhöhung des Limits an.

Verfallen meine Einladungen für Tester?

Tester haben 30 Tage Zeit, eine Einladung zum Testen der App anzunehmen. Danach läuft die Einladung ab. Wenn eine Einladung in fünf Tagen abläuft, wird in der Firebase Console neben dem Tester für eine Version ein Ablaufhinweis angezeigt. Eine Einladung kann erneuert werden, indem sie über das Drop-down-Menü in der Testerzeile noch einmal gesendet wird.

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 eintritt:

• Die App-Version 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.

Sobald die App das Ablaufdatum von 150 Tagen oder das Limit von 1.000 App-Releases erreicht oder überschritten hat, 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 die App-Version länger verfügbar bleibt, können Sie eine der folgenden Empfehlungen umsetzen:

• Laden Sie die IPA-Datei herunter und löschen Sie die Version aus dem App Distribution-Dashboard, bevor die App-Version abläuft oder das Versionslimit überschritten wird. Laden Sie das IPA dann 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 ein Release Ihrer App in Firebase hochladen, wird es 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 ihn über die App Distribution-Web-App für Tester auf ihrem Testgerät installieren.

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

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 automatisch die ältesten Releases gelöscht, 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 in der Masse 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, das App Distribution Folgendes ermöglicht:

• Registrieren Sie das Testgerät, indem Sie die UDID (Unique Device ID) 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 sowie einer Anleitung dazu, 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 Sie eingeladen werden, werden automatisch dem Webclip hinzugefügt.

Hilfe zur Installation von Konfigurationsprofilen auf Ihrem iOS-Gerät finden Sie in der Dokumentation von Apple.

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

Als Tester können Sie über den 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-Verteilung testen, müssen Sie zuerst das Profil installieren, bevor Sie die App testen können.

Wenn Sie eine Unternehmensverteilung testen, können Sie das Profil manuell installieren:

1. 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 auf dem Bildschirm, um das Firebase-Profil zu installieren.

Wie lösche ich mein Testerkonto?

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: Heben Sie in den Berechtigungen für Ihr Google-Konto den Zugriff von Firebase App Distribution auf. Wenn Sie den Zugriff widerrufen, ohne zuerst Ihr App Distribution-Konto zu löschen, werden Ihr Testerkonto oder Ihre Daten nicht gelöscht.