Best Practices für die Verteilung von Apple-Apps an QA-Tester mit CI/CD und Fastlane

In diesem Dokument werden Best Practices für die Verwendung von Firebase App Distribution und fastlane vorgestellt, um Ihre Workflows für Vorabveröffentlichungstests auf Apple-Plattformen in einer CI/CD-Umgebung nachhaltig und wiederholbar zu machen. In diesem Dokument geht es zwar hauptsächlich um fastlane, wir beschreiben aber auch Lösungen, die über die Firebase Console, die Firebase-Befehlszeile und die öffentliche Firebase App Distribution API verfügbar sind, um Ihnen mehr Flexibilität zu bieten. Außerdem beschreiben wir die Limits für Releases und Tester, damit Sie im Voraus planen können.

Wenn Sie auch Android verwenden, lesen Sie den Hilfeartikel Best Practices für die Bereitstellung von Android-Apps für QA-Tester mit CI/CD.

Hinweis

Bevor Sie die Best Practices in diesem Dokument implementieren, müssen Sie App Distribution in der Firebase-Konsole für jede App aktivieren. Wenn Sie App Distribution nicht aktiviert haben, erhalten Sie einen 404-Fehler.

So aktivieren Sie App Distribution:

  1. Öffnen Sie in der Firebase Console die Seite App Distribution.

  2. Wählen Sie Ihre iOS-App aus.

  3. Klicken Sie auf Jetzt starten.

Workflow für Tests vor der Veröffentlichung mit CI/CD automatisieren

Wenn Sie das Erstellen und Veröffentlichen von Apps für Ihre Tester automatisieren möchten und CI/CD verwenden, empfehlen wir die Verwendung von fastlane. Eine weitere Möglichkeit ist die Verwendung der Firebase-Befehlszeile, mit der Sie auf eine Vielzahl von Firebase-Produkten zugreifen können.

Fastlane verwenden

Integrieren Sie App Distribution in Ihre CI/CD-Pipeline mit fastlane, einem Open-Source-Tool, das die Erstellung und Veröffentlichung von iOS- und Android-Apps automatisiert. Wenn Sie Ihre neuesten Releases automatisch erstellen und an Tester verteilen, haben diese immer die aktuellste Testversion Ihrer App.

Informationen zum Einbinden von App Distribution in fastlane finden Sie unter iOS-Apps mit fastlane an Tester verteilen. In diesem Codelab wird die Einbindung von fastlane Schritt für Schritt erklärt.

Firebase CLI verwenden

Verwenden Sie die Firebase-Befehlszeilentools, die App Distribution bereitstellt, um Builds programmatisch an Tester zu verteilen. Sie können Tester und Versionshinweise für einen Build angeben.

Verteilen Sie Ihren neuesten iOS-Build test.ipa, indem Sie die Firebase-App-ID der App angeben und optional eine Versionsinformation und eine Datei mit den E-Mail-Adressen der Tester hinzufügen:

firebase appdistribution:distribute test.ipa  \
    --app 1:1234567890:ios:0a1b2c3d4e5f67890  \
    --release-notes "Bug fixes and improvements" --testers-file testers.txt

Weitere Informationen zur Verwendung der Firebase-Befehlszeile zum Automatisieren Ihrer Builds finden Sie unter iOS-Apps mit der Firebase-Befehlszeile an Tester verteilen.

Dienst-Anmeldedaten zur Authentifizierung verwenden

Verwenden Sie das fastlane-Plug-in von App Distribution oder die Firebase-Befehlszeile mit Dienstkonten, die Standardanmeldedaten für Anwendungen nutzen und Ihnen bei der Verwaltung Ihrer CI helfen. Ein Dienstkonto ist ein Google-Konto, das Anwendungen und keine Nutzer repräsentiert. Ihr CI-System kann Dienstkonten verwenden, um Ihre App Distribution-Arbeitslasten auszuführen. Weitere Informationen finden Sie unter Mit einem Dienstkonto authentifizieren.

Wenn Sie die Workload Identity-Föderation verwenden, können Sie anstelle eines Dienstkontoschlüssels eine Konfigurationsdatei für Anmeldedaten generieren und verwenden.

Release-Limits beachten

App Distribution unterstützt maximal 1.000 Releases pro App. Wenn Sie das Release-Limit überschreiten,löscht App Distribution automatisch die ältesten Releases, die das Limit überschreiten. Informationen zum Verwalten von Release-Limits finden Sie unter Wie lange sind App-Releases verfügbar?.

Dieselben Tester zu mehreren Releases hinzufügen

Wenn Sie Ihren Releases eine große Anzahl von Testerinnen und Testern hinzufügen möchten, verwenden Sie die Funktion zur Bulk-Verwaltung von Testerinnen und Testern in App Distribution.

Wir empfehlen, Gruppen zu verwenden, um dieselben Tester mehreren Releases hinzuzufügen. Eine Gruppe fungiert als Zugriffssteuerungsliste. Wenn Sie einen Tester aus einer Gruppe entfernen, verliert er den Zugriff auf alle Releases, die an diese Gruppe verteilt wurden. Weitere Informationen finden Sie unter Tester zu einer Gruppe hinzufügen und daraus entfernen.

Wenn Sie viele Tester verwalten müssen, können Sie mit der Firebase Console Tester im Bulk hinzufügen und löschen. Wenn Sie das Hinzufügen und Entfernen von Testern automatisieren möchten, verwenden Sie die Firebase-Befehlszeile, fastlane oder die öffentliche Firebase App Distribution API.

Testerlimits beachten

App Distribution begrenzt die Anzahl der Tester, die Sie einem Firebase-Projekt oder einer App Distribution-Gruppe hinzufügen können. Wenn Sie diese Limits überschreiten, können Sie Ihre App nicht mehr an zusätzliche Tester verteilen. Weitere Informationen zu Testerlimits finden Sie unter Gibt es Limits für das Hinzufügen von Testern zu meiner App?

Neue iOS-Testgeräte verwalten und automatisch hinzufügen

Damit Sie zusätzliche iOS-Testgeräte registrieren können, hilft Ihnen App Distribution bei der Verwaltung Ihrer iOS-Testgeräte im Apple Entwicklerportal, indem Sie per E-Mail oder CSV-Datei über neue iOS-Testgeräte informiert werden. Weitere Informationen finden Sie unter Tester aus CSV-Dateien importieren. Sie können neue Geräte auch programmatisch mit fastlane exportieren.

Informationen zum Einrichten einer fastlane-Aktion, die automatisch UDIDs abruft, sie der Apple-Entwicklerkonsole hinzufügt, die App neu erstellt und sie dann verteilt, finden Sie unter Vorabveröffentlichungen von iOS-Builds schneller mit App Distribution und fastlane verteilen.

Potenziellen Testern die Möglichkeit geben, sich selbst für Tests zu registrieren

Damit Sie Ihre App leichter an mehr Tester verteilen können, empfehlen wir die Verwendung von Einladungslinks. Ein Einladungslink ist eine eindeutige URL, über die Tester ihre E‑Mail-Adresse eingeben können, um sich für den Test einer App zu registrieren. Wenn du Nutzern die Möglichkeit gibst, sich selbst in deine Liste der App-Tester einzutragen, kannst du die Anzahl der internen Tester ganz einfach erhöhen.

Zu den Anwendungsfällen für Einladungslinks gehören Dogfood-Programme von Unternehmen, Organisationen mit großen QA-Teams und Entwicklergruppen, die einzelnen Kunden die Möglichkeit geben möchten, den Testerzugriff zu steuern.

Wir empfehlen, einen Einladungslink für eine Gruppe zu erstellen. Alle Tester, die sich über den Einladungslink registrieren, werden automatisch zu nachfolgenden Releases hinzugefügt.

Weitere Informationen finden Sie unter Einladungslinks erstellen und Tester zu einer Gruppe hinzufügen und daraus entfernen.

Achten Sie darauf, dass die Tester die Version testen, die Sie interessiert.

Wenn eine neue Version hochgeladen wird, werden Ihre Tester per E-Mail benachrichtigt. Zusätzlich zu dieser Benachrichtigung können Sie die folgenden Funktionen verwenden, um sicherzustellen, dass Ihre Tester die gewünschte App-Version testen:

  • Releaselinks:Verwenden Sie diese Funktion, wenn Sie eine bestimmte Version mit Testern teilen möchten. Informationen zur Verwendung von Release-Links finden Sie unter iOS-Apps mit der Firebase-Konsole an Tester verteilen. Diese Links sind auch mit unseren Firebase- und fastlane-Befehlszeilentools (CLI) für die Verwendung mit Ihren Build-Automatisierungstools verfügbar.

  • In-App-Benachrichtigungen:Verwenden Sie diese Benachrichtigungen, wenn Sie sicherstellen möchten, dass Ihre Tester die neueste Version Ihrer App testen. Durch die Einbindung des Firebase App Distribution iOS SDK können Sie Ihren Testern direkt in der App Benachrichtigungen anzeigen, wenn neue Builds Ihrer App verfügbar sind. Informationen zum Hinzufügen von In-App-Benachrichtigungen finden Sie unter Tester über neue Builds benachrichtigen.

Zugriff für Tester, die das Unternehmen verlassen, automatisch entfernen

Sobald Ihr interner CI/CD-Testablauf eingerichtet ist, müssen Sie dafür sorgen, dass Personen, die das Unternehmen verlassen, keinen Zugriff mehr auf Ihre internen Builds haben. App Distribution bietet die folgenden Optionen, um den Zugriff von Testern auf Builds zu verwalten: