Distribuisci app Android ai tester utilizzando la CLI Firebase

Questa guida descrive come distribuire gli Android App Bundle (AAB) ai tester utilizzando la CLI Firebase. Lo strumento CLI ti consente di specificare tester e note di rilascio per una build, quindi distribuisce la build di conseguenza.

App Distribution si integra con il servizio di condivisione app interno di Google Play per elaborare gli AAB caricati e fornire APK ottimizzati per le configurazioni dei dispositivi dei tuoi tester. La distribuzione degli AAB consente di effettuare le seguenti operazioni:

  • Esegui APK ottimizzati (forniti da Google Play) ottimizzati per i dispositivi dei tuoi tester.

  • Scopri ed esegui il debug di problemi specifici del dispositivo.

  • Prova le funzionalità dell'app bundle come Play Feature Delivery e Play Asset Delivery .

  • Riduci la dimensione dei download per i tuoi tester.

Autorizzazioni richieste

Per caricare AAB su App Distribution, devi collegare la tua app Firebase a un'app in Google Play . È necessario disporre del livello di accesso richiesto per eseguire queste azioni.

Se non disponi dell'accesso Firebase necessario, puoi chiedere a un proprietario del progetto Firebase di assegnarti il ​​ruolo applicabile tramite le impostazioni IAM della console Firebase . Se hai domande sull'accesso al tuo progetto Firebase, inclusa la ricerca o l'assegnazione di un proprietario, consulta le domande frequenti su "Autorizzazioni e accesso ai progetti Firebase" .

La tabella seguente si applica al collegamento di un'app Firebase a un'app in Google Play, nonché al caricamento di AAB.

Azione nella console Firebase Autorizzazione IAM richiesta Ruoli IAM che includono le autorizzazioni richieste per impostazione predefinita Ruoli aggiuntivi richiesti
Collega un'app Firebase a un'app in Google Play firebase.playLinks.update Uno dei seguenti ruoli: Accesso a un account sviluppatore Google Play come amministratore
Carica gli AAB nella distribuzione delle app firebaseappdistro.releases.update Uno dei seguenti ruoli: ––

Prima di iniziare

  1. Se non l'hai già fatto, aggiungi Firebase al tuo progetto Android . Al termine di questo flusso di lavoro, avrai un'app Android Firebase nel tuo progetto Firebase.

    Se non utilizzi altri prodotti Firebase, devi solo creare un progetto e registrare la tua app. Se decidi di utilizzare prodotti aggiuntivi, assicurati di completare tutti i passaggi in Aggiungere Firebase al tuo progetto Android .

  2. Per creare un collegamento Firebase a Google Play e caricare AAB, assicurati che la tua app soddisfi i seguenti requisiti:

    • L'app in Google Play e l'app Firebase per Android sono entrambe registrate utilizzando lo stesso nome di pacchetto.

    • L'app in Google Play viene configurata nel dashboard dell'app e distribuita in uno dei percorsi di Google Play (test interno, test chiuso, test aperto o produzione).

    • La revisione dell'app su Google Play è completata e l'app è pubblicata. La tua app viene pubblicata se nella colonna Stato app viene visualizzato uno dei seguenti stati: Test interno (non Test interno bozza), Test chiuso, Test aperto o Produzione.

  3. Collega la tua app Android Firebase al tuo account sviluppatore Google Play:

    1. Nella console Firebase, vai al tuo Impostazioni progetto , quindi selezionare la scheda Integrazioni .

    2. Nella scheda Google Play , fai clic su Collegamento .
      Se disponi già di collegamenti a Google Play, fai clic su Gestisci .

    3. Segui le istruzioni visualizzate sullo schermo per abilitare l'integrazione di App Distribution e seleziona quali app Android Firebase collegare a Google Play.

    Ulteriori informazioni sul collegamento a Google Play .

Passaggio 1. Crea la tua app

Quando sei pronto per distribuire una versione pre-release della tua app ai tester, crea il tuo AAB (consulta la documentazione di Android Studio per istruzioni).

Passaggio 2. Distribuisci la tua app ai tester

Per distribuire la tua app ai tester, carica il file della tua app utilizzando la CLI Firebase:

  1. Installa o aggiorna alla versione più recente della CLI Firebase (ti consigliamo di scaricare il file binario autonomo per la CLI specifica per il tuo sistema operativo). Assicurati di accedere e verificare di poter accedere ai tuoi progetti.
  2. Nella pagina Distribuzione app della console Firebase, seleziona l'app che desideri distribuire, quindi fai clic su Inizia .
  3. 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 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 la CLI Firebase (leggi Utilizzare la CLI con i sistemi CI per ulteriori informazioni).

    --token "$FIREBASE_TOKEN"
    --release-notes
    --release-notes-file

    Note sulla versione per questa build.

    È possibile 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 contenente un elenco di indirizzi email separati da virgole:

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

    I gruppi di tester che desideri invitare (consulta Gestisci tester ). I gruppi vengono specificati utilizzando alias di gruppo , che puoi cercare nella console 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 del log dettagliato.

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

    I seguenti tipi di distribuzione fanno parte della funzionalità beta del tester automatizzato .

    I dispositivi di test a cui desideri distribuire le build (fai riferimento a Test automatizzati ).

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

    --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
    --test-password-file

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

    In alternativa, puoi specificare il percorso di un file di testo 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 esempio:

    firebase appdistribution:distribute test.aab  \
        --app 1:1234567890:android:0a1b2c3d4e5f67890  \
        --release-notes "Bug fixes and improvements" --testers-file testers.txt
    

    La CLI di Firebase restituisce i seguenti collegamenti dopo il caricamento della versione. Questi collegamenti ti aiutano a gestire i file binari e a garantire che i tester e gli altri sviluppatori dispongano della versione corretta:

    • firebase_console_uri - Un collegamento alla console Firebase che mostra una singola versione. Puoi condividere questo collegamento con altri sviluppatori nella tua organizzazione.
    • testing_uri : un collegamento alla versione nell'esperienza del tester (app nativa di 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 poter utilizzare il collegamento.
    • binary_download_uri : un collegamento firmato che scarica e installa direttamente il binario dell'app (file APK o AAB). Il collegamento scade dopo un'ora.

    Gestisci tester e gruppi

    Oltre a distribuire le versioni, puoi anche utilizzare appdistribution:testers:add e appdistribution:testers:remove per invitare nuovi tester o rimuovere tester esistenti dal tuo progetto Firebase.

    Una volta aggiunto un tester al tuo progetto Firebase, puoi aggiungerlo alle singole versioni. Una volta rimosso un tester, non avrà più accesso alle versioni del tuo progetto. Tieni presente che i tester rimossi di recente possono comunque mantenere l'accesso alle tue versioni 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 utilizzando --file /path/to/testers.txt .

    Se hai un numero elevato di tester, dovresti prendere in considerazione l'utilizzo dei gruppi: puoi utilizzare appdistribution:group:create e appdistribution:group:delete per creare o eliminare gruppi nel tuo progetto Firebase.

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

    Per 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 nel dashboard 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 che nell'elenco delle build del tester sul dispositivo di test.

I tester che non sono stati invitati a testare l'app ricevono inviti via email per iniziare, mentre i tester esistenti ricevono notifiche via email che una nuova build è pronta per il test (leggi la guida alla configurazione del tester per istruzioni su come installare l'app di prova). 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 Firebase accanto al tester viene visualizzato un avviso di scadenza su una versione. È possibile rinnovare un invito inviandolo nuovamente utilizzando il menu a discesa nella riga tester.

Prossimi passi