Fehlerbehebung und Fehlerbehebung bei der App-Verteilung FAQ

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

Beim Hochladen einer App kann dieser 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 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 (400, 409 oder 500 Fehler).

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

Das IPA kann nicht hochgeladen werden

Das Folgende 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."
}

Um dieses Problem zu beheben, führen Sie die folgenden Schritte aus:

1. Überprüfen Sie die Größe des IPA. Die maximale Dateigröße für alle Binärdateien beträgt 2048 MiB, was etwas mehr als 2 GB entspricht.

2. Wenn die IPA-Größe innerhalb der Dateigrößenbeschränkung liegt und reproduzierbar ist, führen Sie die folgenden Schritte aus:

   1. Überprüfen Sie Ihre Info.plist Datei und bestätigen Sie, ob CFBundleDisplayName irgendwelche <array> -Trennzeichen enthält.

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

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

3. Wenn die IPA-Größe über der Dateigrößenbeschränkung liegt, nehmen Sie alle 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 fragen Sie nach der Verwendung von Testflight .

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, bitten Sie den Tester, eine Nicht-Gmail-E-Mail-Adresse mit dem Konto zu verknüpfen und diese E-Mail-Adresse für die Anmeldung zu verwenden.

Bei der Auswahl einer alternativen E-Mail-Adresse muss der Tester die folgenden Richtlinien befolgen:

• Verwenden Sie keine Gmail-Adresse.
• Verwenden Sie keine E-Mail-Adresse, die bereits mit einem anderen Google-Konto verknüpft ist.
• Denken Sie daran, Ihr Google-Konto-Passwort zu verwenden, wenn Sie sich mit dieser E-Mail-Adresse anmelden.

Weitere Informationen finden Sie unter „Mit einer anderen E-Mail-Adresse bei Ihrem Google-Konto anmelden“ .

Der 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 es sein, dass der Tester nicht die richtigen Apps oder Builds sieht.

Die E-Mail-Adresse, an die der Entwickler Einladungen sendet und zu neuen Builds hinzufügt (E-Mail A), kann sich von der E-Mail-Adresse unterscheiden, mit der der Tester die Einladung annimmt (E-Mail B). Dadurch entsteht eine Verbindung hinter die Kulissen. Immer wenn E-Mail A zu neuen Builds hinzugefügt wird, erhält tatsächlich E-Mail B Zugriff.

Wenn der Tester die E-Mail-Einladung mit einer anderen E-Mail-Adresse angenommen hat, befolgen Sie diese Schritte, um das Problem zu beheben:

1. Löschen Sie den Tester aus dem Abschnitt „Alle Tester anzeigen“ der Registerkarte „Tester und Gruppen“ auf der Seite „App-Verteilung“ der Firebase-Konsole. Vorhandene Einladungen werden entfernt.

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

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

Der 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 Spam-Ordner gesendet.

• E-Mail-Filter sind eingestellt.

• Die Einladung wurde an ein E-Mail-Konto gesendet, der Tester nahm sie jedoch mit einem anderen E-Mail-Konto an. Der Tester erhält neue Release-E-Mails für das E-Mail-Konto, an das die Einladung ursprünglich gesendet wurde.

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

Lösung 1

1. Bitten Sie den Tester, seinen Spam-Ordner und alle E-Mail-Filter zu überprüfen, die er in seinem E-Mail-Dienst eingerichtet hat.

2. Wenn der Tester sich von den E-Mails abgemeldet hat, bitten Sie 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 Erneutes Abonnieren von E-Mails zulassen.

Lösung 2

Wenn dem Tester der Erhalt von E-Mail-Benachrichtigungen egal ist und er lediglich App-Einladungen annehmen möchte, kann er ausstehende App-Einladungen direkt im Firebase App Distribution-Webclip anzeigen: appdistribution.firebase.google.com .

Lösung 3

1. Löschen Sie den Tester aus dem Abschnitt „Alle Tester anzeigen“ der Registerkarte „Tester und Gruppen“ auf der Seite „App-Verteilung“ in der Firebase-Konsole. Diese Aktion entfernt vorhandene Einladungen.

2. Laden Sie den Tester erneut ein, Ihre App zu testen. Der Tester sollte eine Einladungs-E-Mail erhalten. Stellen Sie sicher, dass der Tester die Einladung mit derselben E-Mail-Adresse annimmt, an die die Einladung gesendet wurde.

Fehler „Nicht vertrauenswürdiger Unternehmensentwickler“ beim Versuch, die Test-App auszuführen

Der Fehler „Untrusted Enterprise Developer“ wird angezeigt, wenn Sie dem Entwicklerzertifikat auf dem Testgerät vor dem Öffnen der App nicht vertraut haben. Wählen Sie im Bildschirm „Einstellungen “ > „Profile und Geräteverwaltung“ den Entwicklernamen der App aus und vertrauen Sie ihm.

Fehler „Entwicklermodus erforderlich“ beim Versuch, die Test-App auszuführen

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

Führen Sie die folgenden Schritte aus, um den Entwicklermodus zu aktivieren und diesen Fehler zu beheben:

1. Öffnen Sie auf Ihrem iPhone die App „Einstellungen“ und tippen Sie anschließend 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 des Geräts. Der Entwicklermodus aktivieren? Dialog erscheint.
6. Tippen Sie auf Einschalten . Sie können jetzt Ihre App starten und mit dem Testen beginnen.

„Gerät registriert, fertig! Sie erhalten eine E-Mail, wenn 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. Um Ihnen die App zur Verfügung zu stellen, muss der Entwickler die Anweisungen unter Zusätzliche Geräte registrieren ausführen.

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 haben (oder für die Sie eine Einladung angenommen haben), haben Sie sich wahrscheinlich beim 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. Versuchen Sie es erneut, indem Sie sich mit dem Google-Konto anmelden, mit dem Sie zuvor 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 über die Berechtigung zum Installieren und Testen von Apps verfügt. Der Zugriff wird vom Administrator der Domain Ihres Kontos in Google Workspace bestimmt.

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 den Anweisungen unter „Zugriff auf Dienste verwalten, die nicht einzeln kontrolliert werden“ folgen.

Wenn Sie mehrere Konten haben, versuchen Sie, sich mit einem anderen Konto anzumelden, das nicht auf die Installation und das Testen von Apps beschränkt ist.

Der 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, überprüfen Sie, ob Ihre App neue Versionen abruft:

1. Aktivieren Sie den Debug-Modus 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 der Zeichenfolge „[Firebase/AppDistribution]“.

3. Überprüfen Sie, ob der Tester Zugriff auf die neue Version hat:

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

   • Wenn kein Release zurückgegeben wird, ist Ihr Tester möglicherweise noch nicht mit dem neuen Release verknüpft. Stellen Sie im App Distribution-Dashboard der Firebase-Konsole sicher, dass Ihr Tester in Ihrer 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 ordnungsgemäß eingerichtet hat:

     1. Melden Sie sich auf dem Testgerät beim Firebase App Distribution-Webclip 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. Stellen Sie sicher, dass die neue App-Version im Webclip verfügbar ist.

Der Tester wird nach dem Schließen der App aufgefordert, sich erneut anzumelden

Standardmäßig müssen sich Ihre Tester nur einmal bei ihrem Google-Konto anmelden, um neue Build-Benachrichtigungen zu aktivieren und neue Builds zu installieren. Wenn Ihre Tester nach dem Schließen und erneuten Öffnen Ihrer App aufgefordert werden, sich erneut anzumelden, befolgen Sie diese Tipps, um sicherzustellen, dass Ihre App Distribution-Konfiguration ordnungsgemäß eingerichtet ist:

• Stellen Sie sicher, dass Sie die Firebase App Testers API aktiviert haben. Weitere Informationen finden Sie unter Aktivieren der App Distribution Tester-API .

• Stellen Sie unter Wichtige Einschränkungen sicher, dass die Firebase App Testers API 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 eine Markierung, die angibt, ob sich Ihr Tester bereits bei der App angemeldet hat. Weitere Informationen finden Sie im GitHub-Repository .

Gibt es Beschränkungen für das Hinzufügen von Testern zu meiner App?

Für Firebase App Distribution gelten die folgenden Testergrenzen:

• Fügen Sie einem Firebase-Projekt maximal 500 Tester hinzu

• Fügen Sie einer App-Verteilungsgruppe maximal 200 Tester hinzu

Um weitere Tester hinzuzufügen, fordern Sie eine kostenlose Erhöhung des Limits an.

Laufen meine Testereinladungen ab?

Tester haben 30 Tage Zeit, eine Einladung zum Testen der App anzunehmen, bevor diese abläuft. Wenn eine Einladung in fünf Tagen abläuft, wird in der Firebase-Konsole neben dem Tester einer Veröffentlichung eine Ablaufbenachrichtigung angezeigt. Eine Einladung kann erneuert werden, indem Sie sie über das Dropdown-Menü in der Testerzeile erneut senden.

Wann wird eine neue Version für iOS-Uploads erstellt?

Siehe 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 die App-Release ist älter als die 1.000 neuesten App-Releases.

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

Nachdem die App das 150-Tage-Ablauflimit oder das 1.000-App-Release-Limit erreicht oder überschreitet, wird das Release aus dem App Distribution-Dashboard und der App Distribution-Tester-Web-App entfernt. Wenn Ihr Tester das Release installiert hat, läuft die lokale Version der App weiterhin.

Um die App-Version länger verfügbar zu halten, verwenden Sie eine der folgenden Empfehlungen:

• Bevor die App-Version abläuft oder das Release-Limit überschreitet, laden Sie das IPA herunter und löschen Sie die Version aus dem App Distribution-Dashboard. Laden Sie dann das IPA erneut als neuen Build in App Distribution hoch.
• Laden Sie die Version herunter und laden Sie sie zur Langzeitarchivierung in den Cloud-Speicher hoch.

App-Releases laufen nach 150 Tagen ab

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

Wenn die Veröffentlichung 30 Tage nach dem Ablaufdatum liegt, wird auf Ihrer Veröffentlichung auf der Seite „App Distribution“ der Firebase-Konsole und in der App Distribution-Tester-Web-App eine Benachrichtigung über den Ablauf der App-Version angezeigt.

App Distribution unterstützt maximal 1.000 Releases

Die App-Verteilung erlaubt maximal 1.000 Veröffentlichungen pro App. Wenn Ihre App das Limit von 1.000 App-Releases erreicht, löscht App Distribution automatisch die ältesten Releases über dem Limit.

Wenn Sie Ihre App-Releases manuell verwalten möchten, verwenden Sie die App Distribution REST API, um App-Releases in großen Mengen 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 der App-Verteilung Folgendes ermöglicht:

• 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 sowie Anweisungen zum Einschließen des Geräts in das Bereitstellungsprofil der App, 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, die Sie testen möchten, werden automatisch zum 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?

Wenn Sie Tester sind, können Sie mit dem Firebase App Distribution-Webclip auf alle Ihre Test-Apps zugreifen. Dieser wird automatisch zum Startbildschirm Ihres Testgeräts hinzugefügt, wenn Sie das Firebase-Profil installieren. Wenn Sie eine Ad-hoc-Verteilung testen, müssen Sie zunächst 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 bei Google an und nehmen Sie die Einladung an, falls Sie dies noch nicht getan haben.

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

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

4. Befolgen Sie die angezeigten Anweisungen, um das Firebase-Profil zu installieren.

Wie lösche ich mein Testerkonto?

Um Ihr App Distribution-Testerkonto und die zugehörigen Daten zu löschen, führen Sie die folgenden Schritte aus:

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

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

   Konto löschen .

3. Optional: Widerrufen Sie in den Berechtigungen Ihres Google-Kontos den Zugriff von Firebase App Distribution. Beachten Sie, dass das Widerrufen des Zugriffs ohne vorheriges Löschen Ihres App Distribution-Kontos nicht zur Löschung Ihres Testerkontos oder Ihrer Testerdaten führt.