In diesem Leitfaden wird beschrieben, wie Sie Builds mithilfe der Funktion App DistributionAutomatischer Tester in der Firebase-Konsole automatisch an Tester verteilen. Die Funktion „Automatischer Tester“ bietet ein jederzeit einsatzbereites, nutzerfreundliches Tool für Smoke-Tests Ihrer App.
Hinweis
Falls noch nicht geschehen, fügen Sie Ihrem Android-Projekt Firebase hinzu.
Wenn Sie keine anderen Firebase-Produkte verwenden, müssen Sie nur ein Projekt erstellen und Ihre App registrieren. Wenn Sie jedoch in Zukunft zusätzliche Produkte verwenden möchten, müssen Sie alle Schritte unter Firebase über die Firebase Console hinzufügen ausführen.
Wenn Sie bereit sind, eine Vorabversion Ihrer App an Tester zu verteilen, erstellen Sie Ihr APK wie gewohnt. Sie müssen das APK mit Ihrem Debug-Schlüssel oder App-Signaturschlüssel signieren.
App über die Firebase Console an automatisierte Tester verteilen
Wenn Sie Ihre App für automatisierte Tester bereitstellen möchten, laden Sie Ihre APK-Datei über die Firebase-Konsole hoch:
- Öffnen Sie die Seite App Distribution in der Firebase Console. Wählen Sie Ihr Firebase-Projekt aus, wenn Sie dazu aufgefordert werden.
- Wählen Sie auf der Seite Releases im Drop-down-Menü die App aus, die Sie vertreiben möchten.
- Ziehen Sie die APK-Datei Ihrer App per Drag-and-drop in die Console, um sie hochzuladen.
- Wählen Sie nach Abschluss des Uploads in der Suchleiste Tester oder Gruppen hinzufügen die Option Automatischer Tester aus.
- Wenn Sie den automatisierten Test anpassen möchten, klicken Sie auf das Symbol Bearbeiten und wählen Sie die Anpassungen im Dialogfeld Automatisierten Test anpassen aus.
- (Optional) Wähle im Dialogfeld Gerätekonfiguration die API-Ebene, die Geräteausrichtung und die Sprache aus, die deinen Testspezifikationen entsprechen.
- Optional: Klicken Sie auf das Drop-down-Menü Anmeldedaten, um einen benutzerdefinierten Nutzernamen und ein benutzerdefiniertes Passwort zu erstellen, die während des Tests verwendet werden können, wenn für Ihre App Anmeldedaten erforderlich sind.
- Klicken Sie auf Verteilen. Sie können auch eine optionale Versionsnotiz für Ihre App hinzufügen.
App über die Firebase CLI an Automated Tester verteilen
Führen Sie den Befehl appdistribution:distribute aus, um Ihre App hochzuladen und an Tester zu verteilen. Verwenden Sie die folgenden Parameter, um Ihre Bereitstellung für die Funktion „Automatischer Tester“ zu konfigurieren:
| appdistribution:distribute-Optionen | |
|---|---|
--test-devices oder
--test-devices-file
|
Die Testgeräte, auf die Sie Builds über die Funktion „Automatisierte Tester“ verteilen möchten. Sie können die Testgeräte als durch Semikolons getrennte Liste von Testgeräten angeben: --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 Nutzername für die automatische Anmeldung bei automatischen Tests. |
--test-password oder
--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 bei automatisierten Tests. |
--test-password-resource
|
Ressourcenname für das Passwortfeld für die automatische Anmeldung, das bei automatisierten Tests verwendet werden soll. |
--test-non-blocking |
Automatisierte Tests asynchron ausführen. Die Ergebnisse des automatischen Tests finden Sie in der Firebase Console. |
Weitere Informationen zu den ersten Schritten mit der Firebase CLI und den verschiedenen Möglichkeiten zur Konfiguration Ihrer Bereitstellung finden Sie unter Android-Apps mit der Firebase CLI an Tester verteilen.
App mit Gradle an automatisierte Tester verteilen
Sie können App Distribution konfigurieren, indem Sie mindestens einen Abschnitt firebaseAppDistribution hinzufügen. Verwenden Sie die folgenden Parameter, um die Verteilung für die Funktion „Automatischer Tester“ zu konfigurieren:
| App Distribution Build-Parameter | |
|---|---|
testDevices oder
testDevicesFile
|
Die Testgeräte, auf die Sie Builds mithilfe von automatischen Tests verteilen möchten. Sie können die Testgeräte als durch Semikolons getrennte Liste von Gerätespezifikationen angeben. testDevices="model=shiba, version=34, locale=en, orientation=portrait;model=b0q, version=33, locale=en, orientation=portrait"
Alternativ können Sie den Pfad zu einer Datei angeben, die eine durch Semikolons getrennte Liste von Gerätespezifikationen enthält: testDevicesFile="/path/to/testDevices.txt"
|
testUsername
|
Der Nutzername für die automatische Anmeldung bei automatischen Tests. |
testUsernameResource
|
Ressourcenname für das Feld „Nutzername“ für die automatische Anmeldung, der bei automatisierten Tests verwendet wird |
testPassword oder
testPasswordFile
|
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: testPasswordFile="/path/to/testPassword.txt" |
testPasswordResource
|
Ressourcenname für das Passwortfeld für die automatische Anmeldung, das bei automatisierten Tests verwendet werden soll. |
testNonBlocking |
Automatisierte Tests asynchron ausführen. Die automatischen Testergebnisse finden Sie in der Firebase Console. |
Weitere Informationen zu den ersten Schritten mit Gradle und den verschiedenen Möglichkeiten zur Konfiguration Ihrer Distribution finden Sie unter Android-Apps mit Gradle an Tester verteilen.
App mit fastlane an automatisierte Tester verteilen
Fügen Sie einer ./fastlane/Fastfile-Fahrspur einen firebase_app_distribution-Block hinzu. Verwenden Sie die folgenden Parameter, um die Verteilung für die Funktion „Automatischer Tester“ zu konfigurieren:
| Parameter „firebase_app_distribution“ | |
|---|---|
test_devices oder
test_devices_file
|
Die Testgeräte, auf die Sie Builds über die Funktion „Automatisierte Tester“ verteilen möchten. Sie können die Testgeräte als durch Semikolons getrennte Liste angeben: 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 Nutzername für die automatische Anmeldung bei automatischen Tests. |
test_password oder
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 bei automatisierten Tests. |
test_password_resource
|
Ressourcenname für das Passwortfeld für die automatische Anmeldung, das bei automatisierten Tests verwendet werden soll. |
test_non_blocking |
Automatisierte Tests asynchron ausführen. Die automatischen Testergebnisse finden Sie in der Firebase Console. |
Weitere Informationen zum Einstieg in fastlane und zu verschiedenen Möglichkeiten zur Konfiguration Ihrer Bereitstellung finden Sie unter Android-Apps mit fastlane an Tester verteilen.
Status des automatischen Crawlings
Auf dem Tab Automatisierte Testergebnisse werden alle Testprobleme, Screenshots der App und ein Video des Test-Crawlings für jedes Gerät angezeigt. Den Status des Tests finden Sie auf der Seite mit den Testergebnissen:
| Crawling-Status | Beschreibung |
|---|---|
| Ausstehend | Der automatische Test läuft noch. Die Ergebnisse sind bald verfügbar. |
| Bestanden | Beim automatischen Test wurde Ihre App erfolgreich gecrawlt und keine Abstürze festgestellt. |
| Fehlgeschlagen | Der automatische Test ist fehlgeschlagen, weil deine App während des Tests abgestürzt ist. |
| Nicht aussagekräftig | Der automatische Test ist aufgrund von Infrastrukturfehlern fehlgeschlagen. |