Join us in person and online for Firebase Summit on October 18, 2022. Learn how Firebase can help you accelerate app development, release your app with confidence, and scale with ease. Register now

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

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Questa guida descrive come distribuire Android App Bundle (AAB) ai tester che utilizzano l'interfaccia a riga di comando di 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 delle app interno di Google Play per elaborare gli AAB caricati e pubblicare APK ottimizzati per le configurazioni dei dispositivi dei tester. La distribuzione di AAB consente di eseguire le seguenti operazioni:

  • Esegui APK ottimizzati (serviti 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 l'erogazione delle funzionalità di gioco e l'erogazione delle risorse di gioco .

  • Riduci la dimensione dei download per i tuoi tester.

Permessi richiesti

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 al proprietario di un 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 obbligatori
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 AAB su App Distribution firebaseappdistro.releases.update Uno dei seguenti ruoli: ––

Prima di iniziare

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

    Se non utilizzi nessun altro prodotto Firebase, devi solo creare un progetto e registrare la tua app. Se decidi di utilizzare prodotti aggiuntivi, assicurati di completare tutti i passaggi in Aggiungi 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 del pacchetto.

    • L'app in Google Play viene configurata nella dashboard dell'app e viene distribuita a una delle tracce di Google Play (test interni, test chiusi, test aperti o produzione).

    • La revisione dell'app in Google Play è completa e l'app viene pubblicata. La tua app viene pubblicata se la colonna Stato app mostra uno dei seguenti stati: Test interni (non bozza test interni), Test chiusi, Test aperti o Produzione.

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

    1. Nella console Firebase, vai alle tue progetto , quindi seleziona la scheda Integrazioni .

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

    3. Segui le istruzioni sullo schermo per abilitare l'integrazione della distribuzione delle app e seleziona le app Android Firebase da collegare a Google Play.

    Ulteriori informazioni sul collegamento a Google Play .

Passaggio 1. Crea la tua app

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

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:

  1. Installa o aggiorna all'ultima versione della CLI Firebase (ti consigliamo di scaricare il binario autonomo per la CLI specifica per il tuo sistema operativo). Assicurati di accedere e verifica 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

    Richiesto : 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 si autentica l'ambiente CI con l'interfaccia a riga di comando di Firebase (leggi Usa l'interfaccia a riga di comando con i sistemi CI per ulteriori informazioni).

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

    Note sulla versione 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 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 un elenco di indirizzi e-mail 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 un elenco di indirizzi e-mail separati da virgole:

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

    I gruppi di tester che desideri invitare (consulta Gestione tester ). I gruppi vengono specificati utilizzando alias di gruppo , che puoi cercare nella console Firebase.

    Puoi specificare i gruppi come un elenco separato da virgole:

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

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

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

    Un flag che puoi includere per stampare un output dettagliato del registro.

    Per esempio:

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

    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 che un tester è stato aggiunto al tuo progetto Firebase, puoi aggiungerlo a singole versioni. Dopo aver rimosso un tester, non avranno 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 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 del 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 la build è trascorsi 30 giorni dalla scadenza, viene visualizzato un avviso di scadenza sia nella console che nell'elenco di 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 (leggi la guida alla configurazione del tester per istruzioni su come installare l'app di test). Puoi monitorare lo stato di ogni tester, se ha accettato l'invito e se ha scaricato l'app, nella console di Firebase.

I tester hanno 30 giorni di tempo per accettare un invito a testare l'app prima che scada. Quando un invito è trascorsi 5 giorni dalla scadenza, viene visualizzato un avviso di scadenza nella console Firebase accanto al tester su una versione. Un invito può essere rinnovato inviandolo nuovamente utilizzando il menu a discesa nella riga del tester.