Questa guida descrive come distribuire gli APK ai tester utilizzando l'interfaccia a riga di comando di Firebase. Lo strumento CLI consente di specificare i tester e le note di rilascio per una build, quindi distribuisce la build di conseguenza.
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 altri prodotti in futuro, assicurati di completare tutti i passaggi nella pagina collegata sopra.
Passaggio 1. Crea la tua app
Quando sei pronto per distribuire una versione pre-release della tua app ai tester, crea il tuo APK utilizzando la normale procedura. Devi firmare l'APK con la chiave di debug o la chiave di firma dell'app.
Passaggio 2. Distribuisci la tua app ai tester
Per distribuire la tua app ai tester, carica il file della tua app utilizzando l'interfaccia a riga di comando di Firebase:
- Installa o aggiorna all'ultima versione dell'interfaccia a riga di comando di Firebase (ti consigliamo di scaricare il file binario autonomo per l'interfaccia a riga di comando specifica per il tuo sistema operativo). Assicurati di accedere e verifica di poter accedere ai tuoi progetti.
- Nella pagina Distribuzione app della console Firebase, seleziona l'app che desideri distribuire, quindi fai clic su Inizia .
Esegui il comando
appdistribution:distribute
per caricare la tua app e distribuirla ai tester. Utilizzare i seguenti parametri per configurare la distribuzione:appdistribution: opzioni di distribuzione --app
Obbligatorio : l'ID app Firebase della tua app. Puoi trovare l'ID app nella console di Firebase, nella pagina Impostazioni generali .
--app 1:1234567890:android:0a1b2c3d4e5f67890
--token
Un token di aggiornamento che viene stampato quando autentichi il tuo ambiente CI con l'interfaccia a riga di comando di Firebase (leggi Utilizzare l'interfaccia a riga di comando con i sistemi CI per ulteriori informazioni).
--token "$FIREBASE_TOKEN"
--release-notes
--release-notes-file
Note di rilascio per questa build.
Puoi specificare direttamente le note di rilascio:
--release-notes "Text of release notes"
Oppure, specifica il percorso di un file di testo semplice:
--release-notes-file "/path/to/release-notes.txt"
--testers
--testers-file
Gli indirizzi email dei tester che desideri invitare.
Puoi specificare i tester come un elenco di indirizzi email separati da virgole:
--testers "ali@example.com, bri@example.com, cal@example.com"
In alternativa, puoi specificare il percorso di un file di testo semplice contenente un elenco di indirizzi email separati da virgole:
--testers-file "/path/to/testers.txt"
--groups
--groups-file
I gruppi di tester che vuoi invitare (fai riferimento a Gestisci tester ). I gruppi vengono specificati utilizzando
alias di gruppo , che puoi cercare nella console di Firebase.È possibile specificare i gruppi come elenco separato da virgole:
--groups "qa-team, trusted-testers"
In alternativa, puoi specificare il percorso di un file di testo semplice contenente un elenco di nomi di gruppi separati da virgole:
--groups-file "/path/to/groups.txt"
--debug
Un flag che puoi includere per stampare l'output dettagliato del log.
Per esempio:
firebase appdistribution:distribute test.apk \ --app 1:1234567890:android:0a1b2c3d4e5f67890 \ --release-notes "Bug fixes and improvements" --testers-file testers.txt
L'interfaccia a riga di comando di Firebase genera i seguenti collegamenti dopo il caricamento della versione. Questi collegamenti ti aiutano a gestire i file binari e assicurano che i tester e altri sviluppatori dispongano della versione corretta:
-
firebase_console_uri
- Un collegamento alla console Firebase che mostra una singola versione. Puoi condividere questo link con altri sviluppatori nella tua organizzazione. -
testing_uri
- Un collegamento alla versione nell'esperienza del tester (app nativa per Android) che consente ai tester di visualizzare le note sulla versione e installare l'app sul proprio dispositivo. Il tester deve accedere alla versione per utilizzare il collegamento. -
binary_download_uri
- Un collegamento firmato che scarica e installa direttamente il file binario dell'app (file APK o AAB). Il collegamento scade dopo un'ora.
Oltre a distribuire le versioni, puoi anche utilizzare
appdistribution:testers:add
eappdistribution:testers:remove
per invitare nuovi tester o rimuovere tester esistenti dal tuo progetto Firebase. Dopo aver aggiunto un tester al tuo progetto Firebase, puoi aggiungerlo alle singole versioni. Dopo aver rimosso un tester, non avrà più accesso alle versioni del tuo progetto. Tieni presente che i tester che sono stati rimossi di recente possono ancora mantenere l'accesso alle tue release per un periodo di tempo.Per esempio:
firebase appdistribution:testers:add anothertester@email.com moretesters@email.com
firebase appdistribution:testers:remove anothertester@email.com moretesters@email.com
Le email dei tester devono essere separate da uno spazio. Puoi anche specificare i tester usando
--file /path/to/testers.txt
.-
Una volta distribuita, la build diventa disponibile nella dashboard di distribuzione app della console Firebase per 150 giorni (cinque mesi). Quando mancano 30 giorni alla scadenza della build, viene visualizzato un avviso di scadenza sia nella console sia nell'elenco delle build del tester sul dispositivo di test.
I tester che non sono stati invitati a testare l'app ricevono inviti e-mail per iniziare e i tester esistenti ricevono notifiche e-mail che una nuova build è pronta per il test (consulta la guida all'impostazione del tester per istruzioni su come installare l'app di test). Puoi monitorare lo stato di ciascun tester, se ha accettato l'invito e se ha scaricato l'app, nella console Firebase.
I tester hanno 30 giorni per accettare un invito a testare l'app prima che scada. Quando mancano 5 giorni alla scadenza di un invito, nella console di Firebase viene visualizzato un avviso di scadenza accanto al tester su una versione. Un invito può essere rinnovato inviandolo nuovamente utilizzando il menu a discesa nella riga del tester.
Prossimi passi
Implementa il feedback in-app per facilitare ai tester l'invio di feedback sulla tua app (compresi gli screenshot).
Scopri come mostrare avvisi in-app ai tuoi tester quando sono disponibili nuove build della tua app per l'installazione.
Scopri le best practice per la distribuzione di app Android ai tester QA utilizzando CI/CD .