Sie können Builds mithilfe der Firebase-CLI an Tester verteilen. Mit dem CLI-Tool können Sie Tester und Versionshinweise für einen Build angeben und den Build entsprechend verteilen.
Um Ihre App an Tester zu verteilen, laden Sie die IPA-Datei mit der Firebase-Befehlszeilenschnittstelle hoch:
- Installieren oder aktualisieren Sie auf die neueste Version der Firebase CLI (wir empfehlen, die eigenständige Binärdatei für die für Ihr Betriebssystem spezifische CLI herunterzuladen). Stellen Sie sicher, dass Sie sich anmelden und testen, ob Sie auf Ihre Projekte zugreifen können.
- Wählen Sie auf der Seite App-Verteilung der Firebase-Konsole die App aus, die Sie verteilen möchten, und klicken Sie dann auf Erste Schritte .
Führen Sie den Befehl
appdistribution:distribute
, um Ihre App hochzuladen und an Tester zu verteilen. Verwenden Sie die folgenden Parameter, um die Verteilung zu konfigurieren:appdistribution:Verteilungsoptionen --app
Erforderlich : Die Firebase-App-ID Ihrer App. Sie finden die App-ID in der Firebase-Konsole auf der Seite „Allgemeine Einstellungen“ .
--app 1:1234567890:ios:0a1b2c3d4e5f67890
--token
Ein Aktualisierungstoken, das gedruckt wird, wenn Sie Ihre CI-Umgebung mit der Firebase-CLI authentifizieren (weitere Informationen finden Sie unter Verwenden der CLI mit CI-Systemen ).
--token "$FIREBASE_TOKEN"
--release-notes
--release-notes-file
Versionshinweise für diesen Build.
Sie können die Versionshinweise entweder direkt angeben:
--release-notes "Text of release notes"
Oder geben Sie den Pfad zu einer Nur-Text-Datei an:
--release-notes-file "/path/to/release-notes.txt"
--testers
--testers-file
Die E-Mail-Adressen der Tester, die Sie einladen möchten.
Sie können die Tester als kommagetrennte Liste von E-Mail-Adressen angeben:
--testers "ali@example.com, bri@example.com, cal@example.com"
Oder Sie können den Pfad zu einer einfachen Textdatei angeben, die eine durch Kommas getrennte Liste von E-Mail-Adressen enthält:
--testers-file "/path/to/testers.txt"
--groups
--groups-file
Die Testergruppen, die Sie einladen möchten (siehe Tester verwalten ). Gruppen werden mit angegeben
Gruppenaliase , die Sie in der Firebase-Konsole nachschlagen können.Sie können die Gruppen als kommagetrennte Liste angeben:
--groups "qa-team, trusted-testers"
Oder Sie können den Pfad zu einer einfachen Textdatei angeben, die eine durch Kommas getrennte Liste von Gruppennamen enthält:
--groups-file "/path/to/groups.txt"
--debug
Ein Flag, das Sie einfügen können, um eine ausführliche Protokollausgabe zu drucken.
Zum Beispiel:
firebase appdistribution:distribute test.ipa \ --app 1:1234567890:ios:0a1b2c3d4e5f67890 \ --release-notes "Bug fixes and improvements" --testers-file testers.txt
Die Firebase-CLI gibt nach dem Release-Upload die folgenden Links aus. Diese Links helfen Ihnen bei der Verwaltung von Binärdateien und stellen sicher, dass Tester und andere Entwickler die richtige Version haben:
-
firebase_console_uri
– Ein Link zur Firebase-Konsole, der eine einzelne Version anzeigt. Sie können diesen Link mit anderen Entwicklern in Ihrer Organisation teilen. -
testing_uri
– Ein Link zur Version im Tester-Erlebnis (iOS-Webclip), mit dem Tester Versionshinweise anzeigen und die App auf ihrem Gerät installieren können. Der Tester benötigt Zugriff auf die Freigabe, um den Link verwenden zu können. -
binary_download_uri
– Ein signierter Link, der die App-Binärdatei (IPA-Datei) direkt herunterlädt und installiert. Der Link läuft nach einer Stunde ab.
Neben der Verteilung von Releases können Sie auch
appdistribution:testers:add
undappdistribution:testers:remove
verwenden, um neue Tester einzuladen oder vorhandene Tester aus Ihrem Firebase-Projekt zu entfernen. Sobald ein Tester zu Ihrem Firebase-Projekt hinzugefügt wurde, können Sie ihn einzelnen Releases hinzufügen. Sobald Sie einen Tester entfernen, hat er keinen Zugriff mehr auf Releases in Ihrem Projekt. Beachten Sie, dass kürzlich entfernte Tester noch für ein gewisses Zeitfenster Zugriff auf Ihre Veröffentlichungen behalten können.Zum Beispiel:
firebase appdistribution:testers:add anothertester@email.com moretesters@email.com
firebase appdistribution:testers:remove anothertester@email.com moretesters@email.com
Tester-E-Mails müssen durch ein Leerzeichen getrennt werden. Sie können Tester auch mit
--file /path/to/testers.txt
angeben.-
Nachdem Sie Ihren Build verteilt haben, ist er 150 Tage (fünf Monate) lang im App-Verteilungs-Dashboard der Firebase-Konsole verfügbar. Wenn der Build in 30 Tagen abläuft, wird sowohl in der Konsole als auch in der Liste der Builds Ihres Testers auf seinem Testgerät ein Ablaufhinweis angezeigt.
Tester, die nicht zum Testen der App eingeladen wurden, erhalten E-Mail-Einladungen, um loszulegen, und bestehende Tester erhalten E-Mail-Benachrichtigungen, dass ein neuer Build zum Testen bereit ist. Informationen zum Installieren der Test-App finden Sie unter Als Tester einrichten . Sie können den Status jedes Testers – ob er die Einladung angenommen und die App heruntergeladen hat – in der Firebase-Konsole überwachen.
Tester haben 30 Tage Zeit, um eine Einladung zum Testen der App anzunehmen, bevor sie abläuft. Wenn eine Einladung in 5 Tagen abläuft, wird in der Firebase-Konsole neben dem Tester für eine Version ein Ablaufhinweis angezeigt. Eine Einladung kann erneuert werden, indem Sie sie über das Dropdown-Menü in der Tester-Zeile erneut senden.
Nächste Schritte
Informationen zum manuellen oder programmgesteuerten Registrieren weiterer Geräte finden Sie unter Weitere iOS-Geräte registrieren .
Lernen Sie Best Practices für die Verteilung von Apple-Apps an QA-Tester mit CI/CD und Fastlane kennen.