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

iOS+ Android

Auf dieser Seite finden Sie Hilfe zur Fehlerbehebung und Antworten auf häufig gestellte 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. Rufen Sie App Distribution in der Firebase-Konsole auf, um eine einzurichten.“

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

Bei der Bereitstellung Ihrer Anwendung ist ein Fehler aufgetreten (Fehler 400, 409 oder 500).

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 die App-ID mit.

IPA konnte nicht hochgeladen werden

Im Folgenden finden Sie 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, was etwas mehr als 2 GB entspricht.

2. Wenn die IPA-Größe die Dateigrößenbeschränkung nicht überschreitet und reproduzierbar ist, gehen Sie so vor:

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

      Hinweis: Die App-Bereitstellung akzeptiert keine CFBundleDisplayName-Werte, die Arrays sind.

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

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

3. Wenn die IPA-Datei die maximale Dateigröße überschreitet, nehmen Sie die erforderlichen Änderungen vor, um die Dateigröße zu verringern.

4. 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 bei der Installation und dem Testen Ihrer Apps auftreten können.

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 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 damit anzumelden.

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.
• Verwenden Sie das Passwort Ihres Google-Kontos, wenn Sie sich mit dieser E-Mail-Adresse anmelden.

Weitere Informationen finden Sie im Hilfeartikel Mit einer anderen E‑Mail-Adresse im 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 die Einladung gesendet wurde, kann er möglicherweise nicht die richtigen Anwendungen 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 ein Link hinter die Kulissen 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 in der Firebase-Konsole auf der Seite App Distribution auf dem Tab Tester &Gruppen aus dem Bereich Alle Tester ansehen. Vorhandene Einladungen werden entfernt.

2. Laden Sie den Tester noch einmal zum Testen Ihrer App ein. Er sollte eine Einladungs-E-Mail erhalten.

3. Achten Sie darauf, dass der Tester die Einladung mit derselben E-Mail-Adresse annimmt.

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

• E-Mail-Filter sind festgelegt.

• 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 mit neuen Releases für das E-Mail-Konto, an das die Einladung ursprünglich gesendet wurde.

• Der Tester wurde zuvor eingeladen, hat die ursprüngliche Einladung aber nicht angenommen. Wird der Tester zu nachfolgenden Releases hinzugefügt, sendet App Distribution nicht automatisch Releasebenachrichtigungen an diesen Tester, da er die ursprüngliche Einladung nicht angenommen hat.

Lösung 1

1. Bitten Sie den Tester, seinen Spamordner und die E-Mail-Filter zu prüfen, die er im E-Mail-Dienst festgelegt hat.

2. Wenn der Tester die E-Mails abgemeldet 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 sich wieder anzumelden.

Lösung 2

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

Hinweis :Damit du ausstehende App-Einladungen sehen kannst, muss die E-Mail-Adresse des Google-Kontos, mit dem sich der Tester im Webclip anmeldet, mit der E-Mail-Adresse des Empfängers der Einladung vom Entwickler übereinstimmen.

Lösung 3

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

2. Laden Sie den Tester noch einmal zum Testen Ihrer App ein. Er 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 Enterprise-Entwickler“ 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 nicht vertraut haben. Wählen Sie in der App Einstellungen > Profile und Geräteverwaltung den Namen des Entwicklers der App aus und vertrauen Sie ihm.

Fehler „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.

So aktivieren Sie den Entwicklermodus und beheben diesen Fehler:

1. Öffnen Sie auf Ihrem iPhone die Einstellungen und tippen Sie auf Datenschutz und 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 nach dem Neustart. Das Dialogfeld „Entwicklermodus aktivieren?“ wird angezeigt.
6. Tippen Sie auf Aktivieren. Sie können jetzt Ihre App 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 der Entwickler die App für Sie verfügbar machen kann, muss er der Anleitung unter Zusätzliche Geräte registrieren folgen.

Hinweis :Wenn der Entwickler bereits einen Build mit derselben Build-Nummer und -Version verteilt hat, erhalten nur Nutzer neu registrierter Geräte E-Mail-Benachrichtigungen.

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 oder für die Sie eine Einladung angenommen haben, sind Sie wahrscheinlich in dem falschen Google-Konto angemeldet. 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.

Hinweise:

• Das Google-Konto, mit dem Sie die Einladung angenommen haben, muss nicht dasselbe sein wie das Google-Konto, an das die Einladung ursprünglich gesendet wurde.
• Ein Google-Konto kann mit einer beliebigen E-Mail-Adresse verknüpft werden, nicht nur mit Adressen mit Gmail- oder G Suite-Domains. Weitere Informationen zum Anmelden mit einer anderen E-Mail-Adresse

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

Wenn ein 403-Fehler auftritt, bedeutet das, dass das 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 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, 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:

1. Aktivieren Sie den Fehlerbehebungsmodus in Ihrer App. Weitere Informationen 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 Lebenszyklus des View-Controllers vor. Dort wird das Benachrichtigungsdialogfeld geladen, bevor die Ansicht angezeigt wird.

     Hinweis: Das App Distribution iOS SDK zeigt standardmäßig kein Warndialogfeld an. Sie müssen angeben, wie und wo das Dialogfeld in Ihrer App angezeigt wird. Weitere Informationen finden Sie unter Grundlegende Konfiguration von Benachrichtigungen.

   • 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-Distribution enthalten ist und sich im Status 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 hat und sein Testgerät ordnungsgemäß eingerichtet hat:

     1. 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 zum ersten Mal verwendet haben, als Sie die Einladung zum Testen der App angenommen haben.

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

• Achten Sie unter Schlüsseleinschränkungen darauf, dass die Firebase App Testers API in der Liste der zulässigen APIs enthalten ist.

• Wenn Sie die UserDefaults normalerweise beim Abmelden löschen, löschen Sie möglicherweise auch den Status des 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 die folgenden Einschränkungen für Tester:

• Einem Firebase-Projekt maximal 500 Tester hinzufügen

• Du kannst einer App Distribution-Gruppe maximal 200 Tester hinzufügen

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

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 Version eine entsprechende Benachrichtigung angezeigt. Eine Einladung kann verlängert werden, indem Sie sie über das Drop-down-Menü in der Testerzeile noch einmal senden.

Wann wird eine neue Version 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:

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

Wenn die App das Ablaufdatum von 150 Tagen erreicht oder überschreitet oder die maximale Anzahl von 1.000 App-Releases erreicht ist, 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 die App-Version länger verfügbar halten möchten, können Sie eine der folgenden Empfehlungen verwenden:

• Laden Sie das IPA herunter und löschen Sie den Release aus dem App Distribution-Dashboard, bevor der App-Release abläuft oder das Release-Limit überschreitet. Laden Sie das IPA dann noch einmal als neuen Build auf 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 in Firebase hochladen, wird er ab dem Uploaddatum 150 Tage lang im App Distribution-Dashboard angezeigt. Nachdem Sie die Version hochgeladen haben, können Sie sie an Tester verteilen, die sie über die App DistributionTester-Webanwendung auf ihrem Testgerät installieren.

Wenn der Release in 30 Tagen abläuft, wird auf der Seite App Distribution der Firebase Console 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 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 die App Distribution REST API verwenden, um mehrere App-Releases im Bulk aufzulisten und zu 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:

• Registrieren Sie das Testgerät, indem Sie die eindeutige Geräte-ID (UDID) des Geräts erfassen. Wenn Sie eine Ad-hoc-Bereitstellung testen, sendet Firebase dem App-Entwickler eine E-Mail mit der UDID des Testgeräts sowie 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 Sie eingeladen werden, werden dem Webclip automatisch hinzugefügt.

Informationen zum Installieren 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 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:

1. Melden Sie sich ggf. in 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 .

4. Folgen Sie der Anleitung, 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  (Konto verwalten).

   Konto löschen

3. Optional: Widerrufen Sie in den Google-Kontoberechtigungen den Zugriff für Firebase App Distribution. Wenn Sie den Zugriff widerrufen, ohne zuvor Ihr App Distribution-Konto zu löschen, werden Ihr Testerkonto oder Ihre Daten nicht gelöscht.