Distribuisci le app per Android ai tester utilizzando l'interfaccia a riga di comando di Firebase


Questa guida descrive la modalità di distribuzione degli APK ai tester utilizzando l'interfaccia a riga di comando Firebase. L'interfaccia a riga di comando ti consente di specificare tester note di rilascio di una build, quindi distribuisce la build di conseguenza.

Prima di iniziare

Se non l'hai già fatto, aggiungi Firebase al tuo account Android progetto.

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 è tutto pronto per distribuire una versione pre-release della tua app ai tester, compila l'APK utilizzando la normale procedura. Devi firmare l'APK con il debug chiave o chiave di firma dell'app.

Passaggio 2: Distribuisci la tua app ai tester

Per distribuire l'app ai tester, carica il file dell'app utilizzando la CLI Firebase:

  1. Installa o esegui l'aggiornamento alla versione più recente dell'interfaccia a riga di comando di Firebase (ti consigliamo di scaricare il file binario autonomo per l'interfaccia a riga di comando specifico per il tuo sistema operativo). Assicurati di accedere e verificare di poter accedere al tuo in modo programmatico a gestire i progetti.
  2. Nella pagina App Distribution Nella console Firebase, seleziona l'app che vuoi distribuire, quindi fai clic su Inizia.
  3. Esegui il comando appdistribution:distribute per caricare la tua app e distribuirla ai tester. Utilizza i seguenti parametri per configurare distribuzione:

    opzioni appdistribution:distribution
    --app

    Obbligatorio: l'ID dell'app Firebase dell'app. Puoi trovare l'ID dell'app nella console Firebase, nella pagina Impostazioni generali.

    --app 1:1234567890:android:0a1b2c3d4e5f67890
    --token

    Un token di aggiornamento che viene stampato quando autentichi la tua CI dell'ambiente con l'interfaccia a riga di comando Firebase (leggi Usa l'interfaccia a riga di comando con CI sistemi 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"

    In alternativa, specifica il percorso di un file di testo normale:

    --release-notes-file "/path/to/release-notes.txt"
    --testers
    --testers-file

    Gli indirizzi email dei tester che vuoi invitare.

    Puoi specificare i tester come 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 normale contenente 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 mediante alias di gruppo, che puoi nella console Firebase.

    Puoi specificare i gruppi sotto forma di elenco separato da virgole:

    --groups "qa-team, trusted-testers"

    In alternativa, puoi specificare il percorso di un file di testo normale contenente elenco di nomi di gruppi separati da virgole:

    --groups-file "/path/to/groups.txt"
    --debug

    Un indicatore che puoi includere per stampare l'output del log dettagliato.

    --test-devices
    --test-devices-file

    I seguenti tipi di distribuzione fanno parte della funzionalità beta Tester automatici.

    I dispositivi di test su cui vuoi distribuire le build (fai riferimento a test automatici).

    Puoi specificare i tester come un elenco di indirizzi email separati da virgole indirizzi:

    --test-devices: "model=shiba,version=34,locale=en,orientation=portrait;model=b0q,version=33,locale=en,orientation=portrait"

    In alternativa, puoi specificare il percorso di un file di testo normale contenente elenco separato da punti e virgola dei dispositivi di test:

    --test-devices-file: "/path/to/test-devices.txt"
    --test-username

    Il nome utente per l'accesso automatico da utilizzare durante i test automatici.

    --test-password
    --test-password-file

    La password per l'accesso automatico da utilizzare durante i test automatici.

    In alternativa, puoi specificare il percorso di un file di testo normale contenente una password:

    --test-password-file: "/path/to/test-password.txt"
    --test-username-resource

    Nome della risorsa per il campo del nome utente per l'accesso automatico da utilizzare durante i test automatici.

    --test-password-resource

    Nome della risorsa per il campo password per l'accesso automatico da utilizzare durante i test automatici.

    --test-non-blocking

    Esegui test automatici in modo asincrono. Visita la console Firebase per visualizzare i risultati del test automatico.

    Ad 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 link dopo il caricamento della release. Questi link ti aiutano a gestire i file binari e a garantire che i tester e gli altri sviluppatori abbiano la release corretta:

    • firebase_console_uri: un link alla Console Firebase che mostra una singola release. Puoi condividere questo con altri sviluppatori nella tua organizzazione.
    • testing_uri: un link alla release nel tester esperienza (App nativa Android) che consente ai tester di visualizzare la release e installare l'app sul dispositivo. Il tester deve l'accesso alla release per utilizzare il link.
    • binary_download_uri - Un link firmato che direttamente scarica e installa il file binario dell'app (File APK o AAB) di Google. Il link scade dopo un'ora.

    Gestire tester e gruppi

    Oltre a distribuire le release, puoi anche usare appdistribution:testers:add e appdistribution:testers:remove per invitare nuovi tester o rimuoverla tester esistenti del tuo progetto Firebase.

    Dopo aver aggiunto un tester al tuo progetto Firebase, puoi aggiungerle a singole release. Una volta rimosso, un tester non avrà più accesso alle release del progetto. Tieni presente che i tester rimossi di recente possono: manterranno comunque l'accesso alle tue release per un periodo di tempo.

    Ad 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 utilizzando --file /path/to/testers.txt.

    Se hai un numero elevato di tester, ti consigliamo di utilizzare i gruppi: Puoi utilizzare appdistribution:group:create e appdistribution:group:delete per creare o eliminare gruppi nel tuo progetto Firebase.

    Usa --group-alias per specificare un gruppo per appdistribution:testers:add e appdistribution:testers:remove.

    Ad esempio:

    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

Una volta distribuita, la build diventa disponibile nella dashboardApp Distribution della console Firebase per 150 giorni (cinque mesi). Quando manca 1 mese alla scadenza della build, viene visualizzata una notifica di scadenza sia nella console sia nell'elenco delle build del tester sul suo dispositivo di test.

I tester che non sono stati invitati a testare l'app ricevono inviti via email a iniziare e i tester esistenti ricevono notifiche via email che informano che una nuova build è pronto per il test (leggi guida alla configurazione del tester per istruzioni su come installare il test app). Puoi monitorare lo stato di ogni tester per vedere se ha accettato i invito e se hanno scaricato l'app nella console Firebase.

I tester hanno 30 giorni di tempo per accettare un invito a testare l'app prima che scada. Quando mancano 5 giorni alla scadenza di un invito, viene visualizzata una notifica di scadenza nella Console Firebase accanto al tester in una release. Un invito può essere rinnovato inviandolo di nuovo tramite il menu a discesa nella riga del tester.

Passaggi successivi