Puoi distribuire le build ai tester utilizzando l'interfaccia a riga di comando Firebase. Lo strumento dell'interfaccia a riga di comando consente di specificare tester e note di rilascio per una build e distribuisce la build di conseguenza.
Per distribuire la tua app ai tester, carica il file IPA utilizzando l'interfaccia a riga di comando di Firebase:
- Installa o esegui l'aggiornamento alla versione più recente dell'interfaccia a riga di comando di Firebase (ti consigliamo di scaricare il programma binario autonomo per l'interfaccia a riga di comando specifico per il tuo sistema operativo). Assicurati di accedere e verificare di poter accedere ai tuoi progetti.
- Nella pagina App Distribution della console Firebase, seleziona l'app che vuoi distribuire, quindi fai clic su Inizia.
-
Esegui il comando
appdistribution:distribute
per caricare l'app e distribuirla ai tester. Utilizza i seguenti parametri per configurare la distribuzione:opzioni appdistribution:distribute --app
Obbligatorio: l'ID dell'app Firebase dell'app. Puoi trovare l'ID app nella console Firebase, nella pagina Impostazioni generali.
--app 1:1234567890:ios:0a1b2c3d4e5f67890
--token
Un token di aggiornamento che viene stampato quando autentichi il tuo ambiente CI con l'interfaccia a riga di comando Firebase. Per saperne di più, leggi Utilizzare l'interfaccia a riga di comando con sistemi CI .
--token "$FIREBASE_TOKEN"
--release-notes
--release-notes-file
Note di rilascio di 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 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 normale 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 (consulta Gestire i tester). I gruppi vengono specificati utilizzando gli
alias di gruppo , che puoi cercare nella console Firebase.Puoi specificare i gruppi come 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 del log dettagliato.
--test-devices
--test-devices-file
I seguenti tipi di distribuzione fanno parte della funzionalità beta del tester automatico.
I dispositivi di test a cui vuoi distribuire le build (consulta Test automatici).
Puoi specificare i tester come 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, puoi specificare il percorso di un file di testo normale contenente un elenco di dispositivi di test separati da due punti:
--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.ipa \ --app 1:1234567890:ios: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 link con altri sviluppatori nella tua organizzazione.testing_uri
: un link alla release nell'esperienza del tester (clip web su iOS) che consente ai tester di visualizzare le note di rilascio e di installare l'app sul proprio dispositivo. Il tester deve avere accesso alla release per utilizzare il link.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 utilizzare
appdistribution:testers:add
eappdistribution:testers:remove
anche per invitare nuovi tester o rimuovere i tester esistenti dal tuo progetto Firebase.Dopo aver aggiunto un tester al progetto Firebase, puoi aggiungerlo a singole release. Una volta rimosso, un tester non avrà più accesso alle release nel tuo progetto. Tieni presente che i tester rimossi di recente possono comunque mantenere l'accesso alle tue release per un determinato 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
eappdistribution:group:delete
per creare o eliminare gruppi nel tuo progetto Firebase.Utilizza
--group-alias
per specificare un gruppo per i comandiappdistribution:testers:add
eappdistribution: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 dashboard App Distribution della console Firebase per 150 giorni (cinque mesi). Trascorsi 30 giorni dalla scadenza della build, nella console e nell'elenco di build del tester sul dispositivo di test viene visualizzata una notifica di scadenza.
I tester che non sono stati invitati a testare l'app ricevono inviti via email per iniziare e i tester esistenti ricevono notifiche via email che li informano che una nuova build è pronta per il test. Per scoprire come installare l'app di test, consulta Configurare un tester. Nella console Firebase puoi monitorare lo stato di ogni tester, per sapere se ha accettato l'invito e se ha scaricato l'app.
I tester hanno 30 giorni di tempo per accettare un invito a testare l'app prima che scada. Quando manca 1 settimana alla scadenza di un invito, nella console Firebase viene visualizzata una notifica di scadenza accanto al tester di una release. Un invito può essere rinnovato inviandolo di nuovo tramite il menu a discesa nella riga del tester.
Passaggi successivi
Per registrare più dispositivi manualmente o in modo programmatico, consulta l'articolo Registrare altri dispositivi iOS.
Scopri le best practice per distribuire le app Apple ai tester del QA utilizzando CI/CD e fastlane.