Questa guida descrive come distribuire automaticamente le build ai tester utilizzando la funzionalità App Distribution Automated Tester nella console Firebase. La funzione Automated Tester fornisce uno strumento di test del fumo sempre pronto e facile da usare per la tua app.
Prima di iniziare
Se non l'hai già fatto, aggiungi Firebase al tuo progetto Android .
Se non utilizzi altri prodotti Firebase, devi solo creare un progetto e registrare la tua app. Tuttavia, se decidi di utilizzare prodotti aggiuntivi in futuro, assicurati di completare tutti i passaggi in Aggiungere Firebase utilizzando la console Firebase .
Quando sei pronto per distribuire una versione pre-release della tua app ai tester, crea il tuo APK seguendo la normale procedura. Devi firmare l'APK con la chiave di debug o la chiave di firma dell'app.
Distribuisci la tua app su Automated Tester utilizzando la console Firebase
Per distribuire la tua app su Automated Tester, carica il file APK utilizzando la console Firebase:
- Apri la pagina Distribuzione app della console Firebase. Seleziona il tuo progetto Firebase quando richiesto.
- Nella pagina Versioni , seleziona l'app che desideri distribuire dal menu a discesa.
- Trascina il file APK della tua app sulla console per caricarlo.
- Una volta completato il caricamento, seleziona Tester automatizzato nella barra di ricerca Aggiungi tester o gruppi .
- Per personalizzare il tuo test automatizzato, fai clic sull'icona Modifica e seleziona le personalizzazioni nella finestra di dialogo Personalizza il tuo test automatizzato .
- (Facoltativo) Nella finestra di dialogo di configurazione del dispositivo , seleziona il livello API, l'orientamento del dispositivo e le impostazioni locali che soddisfano le specifiche del test.
- (Facoltativo) Fai clic sul menu a discesa Credenziali di accesso per creare un nome utente e una password personalizzati che possono essere utilizzati durante il test se la tua app richiede credenziali di accesso.
- Fare clic su Distribuisci . Puoi anche aggiungere una nota di rilascio facoltativa per la tua app.
Distribuisci la tua app su Automated Tester utilizzando la CLI Firebase
Esegui il comando appdistribution:distribute per caricare la tua app e distribuirla ai tester. Utilizza i seguenti parametri per configurare la tua distribuzione per la funzione Automated Tester:
| appdistribution: opzioni di distribuzione | |
|---|---|
--test-devices o --test-devices-file | I dispositivi di test che desideri distribuire si basano sulla funzionalità Automated Tester. È possibile specificare i dispositivi di test come elenco di dispositivi di test separati da punto e virgola: --test-devices: "model=shiba, version=34, locale=en, orientation=portrait;model=b0q, version=33, locale=en, orientation=portrait"In alternativa, è possibile specificare il percorso di un file di testo contenente un elenco di dispositivi di test separati da punto e virgola: --test-devices-file: "/path/to/test-devices.txt" |
--test-username | Il nome utente per l'accesso automatico da utilizzare durante i test automatizzati . |
--test-password o --test-password-file | La password per l'accesso automatico da utilizzare durante i test automatizzati . Oppure puoi specificare il percorso di un file di testo semplice contenente una password: --test-password-file: "/path/to/test-password.txt" |
--test-username-resource | Nome risorsa per il campo nome utente per l'accesso automatico da utilizzare durante i test automatizzati . |
--test-password-resource | Nome risorsa per il campo password per l'accesso automatico da utilizzare durante i test automatizzati . |
--test-non-blocking | Esegui test automatizzati in modo asincrono. Visita la console Firebase per i risultati dei test automatici. |
Per ulteriori informazioni su come iniziare con la CLI Firebase e sui diversi modi per configurare la distribuzione, consulta Distribuire app Android ai tester utilizzando la CLI Firebase .
Distribuisci la tua app su Automated Tester utilizzando Gradle
Puoi configurare App Distribution aggiungendo almeno una sezione firebaseAppDistribution e utilizzare i seguenti parametri per configurare la distribuzione sulla funzionalità Automated Tester:
| Parametri di build della distribuzione dell'app | |
|---|---|
testDevices o testDevicesFile | I dispositivi di test a cui desideri distribuire le build utilizzando test automatizzati . È possibile specificare i dispositivi di test come elenco di specifiche del dispositivo separate da punto e virgola testDevices="model=shiba, version=34, locale=en, orientation=portrait;model=b0p, version=33, locale=en, orientation=portrait"Oppure puoi specificare il percorso di un file contenente un elenco di specifiche del dispositivo separate da punto e virgola: testDevicesFile="/path/to/testDevices.txt" |
testUsername | Il nome utente per l'accesso automatico da utilizzare durante i test automatizzati . |
testUsernameResource | Nome risorsa per il campo nome utente per l'accesso automatico da utilizzare durante i test automatizzati . |
testPassword o testPasswordFile | La password per l'accesso automatico da utilizzare durante i test automatizzati . Oppure puoi specificare il percorso di un file di testo semplice contenente una password: testPasswordFile="/path/to/testPassword.txt" |
testPasswordResource | Nome risorsa per il campo password per l'accesso automatico da utilizzare durante i test automatizzati . |
testNonBlocking | Esegui test automatizzati in modo asincrono. Visita la console FIrebase per i risultati dei test automatici. |
Per ulteriori informazioni su come iniziare con Gradle e sui diversi modi per configurare la distribuzione, consulta Distribuire app Android ai tester utilizzando Gradle .
Distribuisci la tua app su Automated Tester utilizzando fastlane
In una corsia ./fastlane/Fastfile , aggiungi un blocco firebase_app_distribution . Utilizza i seguenti parametri per configurare la tua distribuzione per la funzione Automated Tester:
| parametri firebase_app_distribution | |
|---|---|
test_devices o test_devices_file | I dispositivi di test che desideri distribuire si basano sulla funzionalità Automated Tester. È possibile specificare i dispositivi di test come elenco di dispositivi di test separati da punto e virgola: test_devices: "model=shiba, version=34, locale=en, orientation=portrait;model=b0q, version=33, locale=en, orientation=portrait"In alternativa, è possibile specificare il percorso di un file di testo contenente un elenco di dispositivi di test separati da punto e virgola: test_devices_file: "/path/to/test-devices.txt" |
test_username | Il nome utente per l'accesso automatico da utilizzare durante i test automatizzati . |
test_password o test_password_file | La password per l'accesso automatico da utilizzare durante i test automatizzati . Oppure puoi specificare il percorso di un file di testo semplice contenente una password: test_password_file: "/path/to/test-password.txt" |
test_username_resource | Nome risorsa per il campo nome utente per l'accesso automatico da utilizzare durante i test automatizzati . |
test_password_resource | Nome risorsa per il campo password per l'accesso automatico da utilizzare durante i test automatizzati . |
test_non_blocking | Esegui test automatizzati in modo asincrono. Visita la console FIrebase per i risultati dei test automatici. |
Per ulteriori informazioni su come iniziare con Fastlane e sui diversi modi per configurare la distribuzione, consulta Distribuire app Android ai tester utilizzando Fastlane .
Stati di scansione di prova automatici
Per aiutarti a interpretare i risultati del test, la scheda Risultati del test automatizzato mostra eventuali problemi del test, screenshot dell'app e un video della scansione del test per ciascun dispositivo. Lo stato del test può essere trovato nella pagina dei risultati del test:
| Stato della scansione | Descrizione |
|---|---|
| In attesa di | Il test automatico è ancora in esecuzione e i risultati saranno disponibili a breve. |
| Passato | Il test automatico ha eseguito correttamente la scansione della tua app e non ha rilevato alcun arresto anomalo. |
| Fallito | Il test automatico non è riuscito perché la tua app si è bloccata durante il test. |
| Inconcludente | Il test automatico non è riuscito a causa di errori infrastrutturali. |