In diesem Leitfaden wird beschrieben, wie APKs an Tester verteilt werden. mit der Firebase-Befehlszeile. Mit dem Befehlszeilentool können Sie Tester und Release-Notes für einen Build angeben und den Build dann entsprechend verteilen.
Hinweis
Fügen Sie Ihrem Android-Gerät Firebase hinzu, falls noch nicht geschehen. Projekt.
Wenn Sie keine anderen Firebase-Produkte verwenden, müssen Sie nur Projekt erstellen und Ihre App registrieren. Sollten Sie sich jedoch für die Verwendung zusätzlicher zu erhalten, sollten Sie alle Schritte auf der Seite wie oben verlinkt.
Schritt 1: App erstellen
Wenn Sie eine Vorabveröffentlichung Ihrer App für Tester veröffentlichen möchten, Erstellen Sie Ihr APK wie gewohnt. Sie müssen das APK mit Ihrem Debug-Schlüssel oder App-Signaturschlüssel signieren.
Schritt 2: App an Tester verteilen
Wenn Sie Ihre App an Tester verteilen möchten, laden Sie die Datei Ihrer App mit der Firebase-CLI hoch:
- Installieren Sie die neueste Version der Firebase CLI oder aktualisieren Sie sie auf die neueste Version. Wir empfehlen, das eigenständige Binärprogramm für die für Ihr Betriebssystem spezifische CLI herunterzuladen. Melden Sie sich an und testen Sie, ob Sie auf Ihr Projekten.
- Wählen Sie auf der Seite App Distribution der Firebase-Konsole die App aus, die Sie vertreiben möchten, und klicken Sie dann auf Jetzt starten.
-
Führen Sie den Befehl
appdistribution:distribute
aus, um Ihre App hochzuladen und an Tester zu verteilen. Verwenden Sie die folgenden Parameter, um die Verteilung zu konfigurieren:Optionen für appdistribution:distribution --app
Erforderlich: Die Firebase-App-ID Ihrer App. Sie finden die App-ID in der Firebase Console auf der Seite Allgemeine Einstellungen.
--app 1:1234567890:android:0a1b2c3d4e5f67890
--token
Ein Aktualisierungstoken, das ausgegeben wird, wenn Sie Ihre CI-Umgebung mit der Firebase CLI authentifizieren. Weitere Informationen finden Sie unter CLI mit CI-Systemen verwenden.
--token "$FIREBASE_TOKEN"
--release-notes
--release-notes-file
Versionshinweise für diesen Build.
Sie können die Versionshinweise 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 durch Kommas getrennte Liste von E-Mail-Adressen angeben:
--testers "ali@example.com, bri@example.com, cal@example.com"
Sie können auch den Pfad zu einer Nur-Text-Datei 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 mithilfe von
Gruppenaliassen angegeben, die Sie in der Firebase-Konsole nach.Sie können die Gruppen als durch Kommas getrennte Liste angeben:
--groups "qa-team, trusted-testers"
Alternativ können Sie den Pfad zu einer Nur-Text-Datei angeben, die ein kommagetrennte Liste von Gruppennamen:
--groups-file "/path/to/groups.txt"
--debug
Ein Flag, das Sie verwenden können, um eine ausführliche Logausgabe auszugeben.
--test-devices
--test-devices-file
Die folgenden Verteilungstypen sind Teil der Betafunktion für automatisierte Tester.
Die Testgeräte, auf die Sie Builds verteilen möchten (siehe Automatisierte Tests).
Du kannst die Tester als eine durch Kommas getrennte Liste von E-Mail-Adressen angeben Adressen:
--test-devices: "model=shiba,version=34,locale=en,orientation=portrait;model=b0q,version=33,locale=en,orientation=portrait"
Alternativ können Sie den Pfad zu einer Nur-Text-Datei angeben, die eine durch Semikolons getrennte Liste von Testgeräten enthält:
--test-devices-file: "/path/to/test-devices.txt"
--test-username
Der Benutzername für die automatische Anmeldung bei automatischen Tests.
--test-password
--test-password-file
Das Passwort für die automatische Anmeldung bei automatisierten Tests.
Sie können auch den Pfad zu einer Nur-Text-Datei mit einem Passwort angeben:
--test-password-file: "/path/to/test-password.txt"
--test-username-resource
Ressourcenname für das Feld „Nutzername“ für die automatische Anmeldung, der bei automatisierten Tests verwendet wird
--test-password-resource
Ressourcenname für das Passwortfeld für die automatische Anmeldung, der bei automatisierten Tests verwendet wird
--test-non-blocking
Führen Sie automatisierte Tests asynchron aus. Die Ergebnisse des automatischen Tests finden Sie in der Firebase Console.
Beispiel:
firebase appdistribution:distribute test.apk \ --app 1:1234567890:android:0a1b2c3d4e5f67890 \ --release-notes "Bug fixes and improvements" --testers-file testers.txt
Die Firebase CLI gibt nach dem Upload des Release die folgenden Links aus. Mit diesen Links können Sie Binärprogramme verwalten und dafür sorgen, dass Tester und andere Entwickelnden die richtige Version haben:
firebase_console_uri
: Ein Link zur Firebase-Konsole, in der ein einzelner Release angezeigt wird. Sie können diesen Link mit anderen Entwicklern in Ihrer Organisation teilen.testing_uri
– ein Link zum Release im Tester Erfahrung (native Android-App) mit der Tester den Release Notizen machen und die App auf ihrem Gerät installieren. Der Tester benötigt um den Link zu nutzen.binary_download_uri
: ein signierter Link, der direkt das App-Binärprogramm herunterlädt und installiert (APK- oder AAB-Datei) . Der Link läuft nach einer Stunde ab.
Tester und Gruppen verwalten
Neben der Veröffentlichung von Releases
appdistribution:testers:add
undappdistribution:testers:remove
, um neue Tester einzuladen oder zu entfernen vorhandenen Testern aus Ihrem Firebase-Projekt.Nach dem Hinzufügen eines Testers Ihrem Firebase-Projekt hinzugefügt haben, können Sie sie einzelnen Releases hinzufügen. Wenn Sie einen Tester entfernen, hat er keinen Zugriff mehr auf Releases in Ihrem Projekt. Hinweis: Tester, die vor Kurzem entfernt wurden, können haben noch für einen bestimmten Zeitraum Zugriff auf Ihre Releases.
Beispiel:
firebase appdistribution:testers:add anothertester@email.com moretesters@email.com
firebase appdistribution:testers:remove anothertester@email.com moretesters@email.com
E-Mail-Adressen der Tester müssen durch ein Leerzeichen getrennt sein. Sie können Tester auch mit
--file /path/to/testers.txt
angeben.Wenn Sie viele Tester haben, sollten Sie Gruppen verwenden: Sie können
appdistribution:group:create
undappdistribution:group:delete
, um Gruppen in Firebase zu erstellen oder zu löschen Projekt arbeiten.Verwenden Sie
--group-alias
, um eine Gruppe für die Befehleappdistribution:testers:add
undappdistribution:testers:remove
anzugeben.Beispiel:
firebase appdistribution:group:create "QA team" qa-team
firebase appdistribution:testers:add --group-alias=qa-team anothertester@email.com moretesters@email.com
firebase appdistribution:testers:remove --group-alias=qa-team anothertester@email.com moretesters@email.com
firebase appdistribution:group:delete qa-team
Sobald Sie Ihren Build verteilt haben, ist er im App Distribution-Dashboard der Firebase-Konsole für 150 Tage (fünf Monate). Wenn der Build innerhalb von 30 Tagen abläuft, erscheint in beiden die Konsole und die Liste der Builds auf dem Testgerät.
Tester, die nicht zum Testen der App eingeladen wurden, erhalten eine E-Mail-Einladung zum Einstieg. Bestehende Tester werden per E-Mail benachrichtigt, dass ein neuer Build zum Testen bereit ist. Eine Anleitung zum Installieren der Test-App finden Sie im Leitfaden zur Einrichtung von Testern. In der Firebase-Konsole können Sie den Status der einzelnen Tester prüfen, also ob sie die Einladung angenommen und die App heruntergeladen haben.
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-Konsole 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.
Nächste Schritte
In-App-Feedback implementieren damit Tester ganz einfach Feedback zu Ihrer App geben können, z. B. Screenshots).
Best Practices für die Verteilung von Android-Apps an QA-Tester mithilfe von CI/CD