Distribuire app per iOS ai tester utilizzando l'interfaccia a riga di comando di Firebase

Puoi distribuire le build ai tester utilizzando la CLI Firebase. Lo strumento CLI ti consente di specificare i tester e le note di rilascio per una build e di distribuire la build di conseguenza.

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

  1. Installa o esegui l'aggiornamento all'ultima versione della Firebase CLI (ti consigliamo di scaricare il file binario autonomo per la CLI specifica per il tuo sistema operativo). Assicurati di aver eseguito l'accesso e di poter accedere ai tuoi progetti.

  2. Esegui il comando appdistribution:distribute per caricare l'app e distribuirla ai tester. Utilizza i seguenti parametri per configurare la distribuzione:

    Opzioni di appdistribution:distribute
    --app

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

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

    Un token di aggiornamento stampato quando autentichi l'ambiente CI con l'interfaccia a riga di comando Firebase (per saperne di più, consulta Utilizzare l'interfaccia a riga di comando con i sistemi CI ). 

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

    Note di rilascio per questa build.

    Puoi specificare le note di rilascio direttamente:

    --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 un elenco di indirizzi email separato 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 separato da virgole di indirizzi email:

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

    I gruppi di tester che vuoi invitare (consulta Gestire i tester). I gruppi vengono specificati utilizzando gli alias di gruppo, che puoi cercare nella Firebase console.

    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 l'output dei log dettagliati.
    --test-devices
    --test-devices-file

    I dispositivi di test su cui vuoi eseguire i test dell'agente App Testing.

    Puoi specificare i dispositivi di test come un elenco di specifiche dei dispositivi separati da punti e virgola:

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

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

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

    Il nome utente per l'accesso automatico da utilizzare durante i test dell'agente App Testing.
    --test-password
    --test-password-file

    La password per l'accesso automatico da utilizzare durante i test dell'agente App Testing.

    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 dell'agente App Testing.
    --test-password-resource

    Nome della risorsa per il campo della password per l'accesso automatico da utilizzare durante i test dell'agente App Testing.
    --test-non-blocking

    Se impostato durante l'esecuzione dei test dell'agente App Testing, il comando avvierà i test e poi verrà restituito immediatamente anziché attendere il completamento. Per visualizzare i risultati dei test, visita la Console Firebase. Se questo flag non è impostato, il comando verrà bloccato fino al completamento dei test e verrà chiuso con un codice di errore se uno dei test non riesce.

    Ad esempio:

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

    L'interfaccia a riga di comando di Firebase restituisce 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 Firebase console che mostra una singola release. Puoi condividere questo link con altri sviluppatori della tua organizzazione.
    • testing_uri - Un link alla release nell'esperienza del tester (clip web iOS) che consente ai tester di visualizzare le note di rilascio e installare l'app sul proprio dispositivo. Per utilizzare il link, il tester deve avere accesso alla release.
    • binary_download_uri - Un link firmato che scarica e installa direttamente il file binario dell'app (file IPA). Il link scade dopo un'ora.

    Gestire tester e gruppi

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

    Una volta aggiunto un tester al tuo progetto Firebase, puoi aggiungerlo alle singole release. Una volta rimosso un tester, non avrà più accesso alle release del tuo progetto. Tieni presente che i tester rimossi di recente possono comunque mantenere 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

    Gli indirizzi email dei tester devono essere separati 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.

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

    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, questa diventa disponibile nella App Distribution dashboard della Firebase console per 150 giorni (cinque mesi). Quando mancano 30 giorni alla scadenza della build, nella console e nell'elenco delle build del tester sul dispositivo di test viene visualizzato un avviso di scadenza.

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 indicano che una nuova build è pronta per il test. Per scoprire come installare l'app di test, consulta la sezione Configurare l'ambiente come tester. Puoi monitorare lo stato di ogni tester (se ha accettato l' invito e se ha scaricato l'app) nella Firebase console.

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, nella Firebase console viene visualizzato un avviso di scadenza accanto al tester in una release. Un invito può essere rinnovato inviandolo di nuovo utilizzando il menu a discesa nella riga del tester.

Passaggi successivi