Best practice per la distribuzione di app Apple ai tester QA utilizzando CI/CD e Fastlane

Questo documento illustra le best practice per l'utilizzo di Firebase App Distribution e fastlane per rendere i flussi di lavoro di test pre-release della piattaforma Apple sostenibili e ripetibili in un ambiente CI/CD. Sebbene questo documento si concentri su Fastlane, descrive anche le soluzioni disponibili tramite la console Firebase, l'interfaccia a riga di comando Firebase e l'API App Distribution Firebase pubblica per offrirti maggiore flessibilità. Descrivi inoltre i limiti di rilascio e di tester per consentirti di pianificare in anticipo un'esperienza ottimale.

Se utilizzi anche Android, consulta Best practice per la distribuzione di app per Android ai tester QA che utilizzano CI/CD.

Prima di iniziare

Prima di implementare le best practice riportate in questo documento, assicurati di attivare App Distribution nella console Firebase per ogni app. Se non hai attivato App Distribution, verrà visualizzato un errore 404.

Per attivare App Distribution:

  1. Apri la pagina App Distribution nella console Firebase.

  2. Seleziona la tua app per iOS.

  3. Fai clic su Inizia.

Automatizzare il flusso di lavoro di test di pre-release utilizzando CI/CD

Se vuoi automatizzare la creazione e il rilascio di app per i tester e utilizzi CI/CD, ti consigliamo di utilizzare fastlane. Un'altra opzione è utilizzare l'interfaccia a riga di comando Firebase, che ti consente di accedere a un'ampia gamma di prodotti Firebase.

Usa corsia preferenziale

Integra App Distribution nella tua pipeline CI/CD utilizzando Fastlane, uno strumento open source che automatizza la creazione e il rilascio di app per iOS e Android. Creando e distribuendo automaticamente le tue release più recenti ai tester, ti assicuri che i tester dispongano sempre della versione di test più aggiornata della tua app.

Per scoprire come integrare App Distribution con fastlane, consulta Distribuire app per iOS ai tester utilizzando fastlane. Consulta anche un codelab che illustra il processo di integrazione delle corsie Fast.

Utilizza l'interfaccia a riga di comando Firebase

Utilizza gli strumenti dell'interfaccia a riga di comando Firebase forniti da App Distribution per distribuire le build ai tester in modo programmatico. Puoi specificare i tester e le note di rilascio per una build.

Distribuisci la tua ultima build per iOS test.ipa specificando l'ID app Firebase dell'app e, facoltativamente, aggiungendo una nota di rilascio e un file contenente le email dei tester:

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

Per scoprire di più sull'utilizzo dell'interfaccia a riga di comando Firebase per automatizzare le build, consulta Distribuire app per iOS ai tester utilizzando l'interfaccia a riga di comando Firebase.

Utilizzare le credenziali del servizio per l'autenticazione

Usa il plug-in Fastlane App Distribution o l'interfaccia a riga di comando Firebase con gli account di servizio, che sfruttano le credenziali predefinite dell'applicazione e ti aiutano a gestire la tua CI. Un account di servizio è un tipo di Account Google che rappresenta le applicazioni anziché gli utenti. Il tuo sistema CI può utilizzare gli account di servizio per eseguire i carichi di lavoro App Distribution. Per scoprire di più, consulta Autenticarsi con un account di servizio.

Se utilizzi la federazione delle identità per i carichi di lavoro, puoi generare e utilizzare un file di configurazione delle credenziali invece di una chiave dell'account di servizio.

Tieni presente i limiti di uscita

App Distribution supporta un massimo di 1000 release per app. Ciò significa che, se superi il limite di release, App Distribution elimina automaticamente le release meno recenti che superano il limite. Per informazioni su come gestire i limiti di release, consulta Per quanto tempo sono disponibili le release dell'app?

Aggiungere lo stesso gruppo di tester a più release

Se vuoi aggiungere un numero elevato di tester alle tue release, utilizza la funzionalità di gestione collettiva dei tester di App Distribution.

Ti consigliamo di utilizzare i gruppi per aggiungere gli stessi tester a più release. Un gruppo funge da elenco di controllo dell'accesso. Quando rimuovi un tester da un gruppo, quest'ultimo perde l'accesso a tutte le release distribuite al gruppo. Per scoprire di più, vedi Aggiungere e rimuovere tester da un gruppo.

Se hai molti tester da gestire, puoi aggiungere ed eliminare in blocco i tester utilizzando la console Firebase. Per automatizzare l'aggiunta e la rimozione dei tester, utilizza l'interfaccia a riga di comando di Firebase, la Fastlane o l'API pubblica di Firebase App Distribution.

Tieni presente i limiti dei tester

App Distribution limita il numero di tester che puoi aggiungere a un progetto Firebase o a un gruppo App Distribution. Se superi questi limiti, non potrai distribuire la tua app ad altri tester. Per scoprire di più sui limiti per i tester, consulta Esistono limiti per l'aggiunta di tester alla mia app?

Gestisci e aggiungi automaticamente nuovi dispositivi tester iOS

Per aiutarti a registrare altri dispositivi tester iOS, App Distribution ti aiuta a gestire i tuoi dispositivi tester iOS nell'Apple Developer Portal informandoti sui nuovi dispositivi tester iOS via email o file CSV. Per scoprire di più, consulta Importare i tester da file CSV. Puoi anche esportare nuovi dispositivi tramite Fastlane in modo programmatico.

Per scoprire come configurare un'azione fastlane che estrae automaticamente gli UDID, li aggiunge alla console per sviluppatori Apple, ricostruisce l'app e la distribuisce, consulta Distribuire più velocemente le build pre-release per iOS con App Distribution e fastlane.

Consentire ai potenziali tester di registrarsi autonomamente per i test

Per semplificare la distribuzione della tua app a più tester, ti consigliamo di utilizzare i link di invito. Un link di invito è un URL univoco che consente ai tester di inserire i propri indirizzi email per registrarsi e testare un'app. Consentire agli utenti di aggiungersi al tuo elenco di tester di app è un modo semplice per aumentare la tua base di test interni.

I casi d'uso dei link di invito includono i programmi dogfood aziendali, le organizzazioni con grandi team di QA e i gruppi di sviluppatori che vogliono che i singoli clienti possano controllare l'accesso dei tester.

Ti consigliamo di creare un link di invito per un gruppo. Qualsiasi tester che si registra usando il link di invito viene aggiunto automaticamente alle release successive.

Per scoprire di più, consulta Creare link di invito e Aggiungere e rimuovere tester da un gruppo.

Assicurati che i tester stiano testando la versione che ti interessa

Quando viene caricata una nuova versione, i tester ricevono una notifica via email. A integrare questa notifica, puoi usare le seguenti funzionalità, link di release e avvisi in-app, per assicurarti che i tester stiano testando la versione specifica dell'app che ti interessa:

  • Link di rilascio: utilizza questa funzionalità quando vuoi condividere una versione specifica con i tester. Per scoprire come utilizzare i link di rilascio, consulta Distribuire app per iOS ai tester utilizzando la console Firebase. Questi link sono disponibili anche con i nostri strumenti a riga di comando (CLI) Firebase e fastlane per l'utilizzo con gli strumenti di automazione della compilazione.

  • Avvisi in-app: utilizza questi avvisi quando vuoi assicurarti che i tester stiano testando la versione più recente della tua app. Integrando l'SDK App Distribution iOS di Firebase, puoi mostrare avvisi direttamente all'interno dell'app ai tester quando sono disponibili nuove build dell'app. Per scoprire come aggiungere avvisi in-app, consulta Avvisare i tester delle nuove build.

Rimuovere automaticamente l'accesso dei tester che lasciano l'azienda

Una volta che il flusso di test interno CI/CD è attivo e funzionante, devi assicurarti che le persone che lasciano l'azienda non abbiano più accesso alle tue build interne. Per aiutarti a gestire l'accesso dei tester alle build, App Distribution offre le seguenti opzioni: