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 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. 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, also etwas mehr als 2 GB.

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 sehen Sie nach, 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 maximal zulässige 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 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 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 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. 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 im Bereich Alle Tester ansehen des Tabs Tester und Gruppen. 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

Tester erhalten möglicherweise keine E-Mail-Benachrichtigungen, wenn einer der folgenden Fälle eintritt:

• E-Mail-Benachrichtigungen werden in den Spamordner gesendet.

• E-Mail-Filter sind festgelegt.

• Die Einladung wurde an eine E-Mail-Adresse gesendet, der Tester hat sie aber mit einem anderen E-Mail-Konto angenommen. 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. Wenn der Tester zu nachfolgenden Releases hinzugefügt wird, sendet App Distribution diesem Tester keine automatischen Release-Benachrichtigungen, da er die ursprüngliche Einladung nicht angenommen hat.

Lösung 1

1. Bitten Sie 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 abgemeldet 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 zu abonnieren.

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.

Hinweis :Damit ausstehende App-Einladungen angezeigt werden, 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 des Entwicklers ü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 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.

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-Bereitstellung 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 bereitgestellt hat, erhalten nur Nutzer von neu registrierten Geräten 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.

Beachten Sie Folgendes:

• 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 jeder 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 Debug-Modus in Ihrer App. Eine entsprechende Anleitung 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.

     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 und sein Testgerät richtig eingerichtet hat:

     1. Melden Sie sich auf dem Testgerät im Webclip für Firebase App Distribution an. Wählen Sie das Google-Konto aus, 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 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, 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

• 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 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 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 die IPA-Datei herunter und löschen Sie die Version aus dem App Distribution-Dashboard, bevor die Version abläuft oder das Versionslimit überschreitet. Laden Sie das IPA dann noch einmal als neuen Build unter 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. 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 mit der App Distribution REST API App-Releases auflisten und in Bulk 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-Bereitstellung 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 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 zuerst Ihr App Distribution-Konto zu löschen, werden Ihr Testerkonto und Ihre Daten nicht gelöscht.