Puoi utilizzare Firebase Test Lab durante lo sviluppo della tua app con qualsiasi di integrazione. I sistemi di integrazione continua ti consentono creare e testare l'app ogni volta che controlli gli aggiornamenti al codice sorgente dell'app.
Utilizzo di Firebase Test Lab con Jenkins CI
Questa sezione descrive come utilizzare Test Lab con CI Jenkins.
Requisiti
Prima di poter utilizzare Firebase Test Lab con Jenkins, devi completare il seguenti passaggi:
Configura gcloud. Segui le istruzioni di Utilizzo di Firebase Test Lab dalla riga di comando gcloud per creare un progetto Firebase e configurare l'SDK Google Cloud locale completamente gestito di Google Cloud.
Crea e autorizza un account di servizio. Gli account di servizio non sono soggetti ai controlli antispam o ai prompt captcha, che potrebbero altrimenti bloccare CI le build. Creare un account di servizio con un ruolo di Editor in Console Google Cloud e poi attivalo (consulta la documentazione di gcloud auth activate-service-account per scoprire come).
Abilita le API richieste. Dopo aver eseguito l'accesso utilizzando l'account di servizio, nella pagina della libreria API di Google Developers Console, abilita l'API Google Cloud Testing e l'API Cloud Tool Results. A abilita queste API, digita i nomi delle API nella casella di ricerca nella parte superiore console, quindi fai clic su Abilita API nella pagina della panoramica per l'API in questione.
Installare e configurare Jenkins
Puoi installare e configurare CI di Jenkins su Linux o Windows. Alcuni dettagli
questa guida è specifica per l'installazione e l'esecuzione di CI Jenkins su Linux, tra cui:
l'utilizzo delle barre (/
) nei percorsi dei file.
Per scaricare e installare Jenkins su un computer con Linux o Windows: le istruzioni sull'installazione Jenkins. Dopo il giorno installare Jenkins, segui le istruzioni Avviare e accedere a Jenkins per completare la configurazione e accedere alla dashboard di Jenkins.
Configura le impostazioni di sicurezza globali
In Jenkins non sono stati configurati l'autenticazione degli utenti e il controllo dell'accesso quando viene installata per la prima volta. Prima di utilizzare Jenkins con Firebase Test Lab, configura impostazioni di sicurezza globali per applicare il controllo dell'accesso e l'autenticazione utenti.
Per configurare le impostazioni di sicurezza globali
- Vai alla dashboard di Jenkins sul server. A questo scopo, vai su http://<servername>:8080, dove <servername> è il nome del computer su cui hai installato Jenkins.
- Nella dashboard di Jenkins, fai clic su Gestisci Jenkins e quindi su Configura la sicurezza globale.
- Nella pagina Configura sicurezza globale, fai clic su Attiva sicurezza. e fai clic su Salva.
Per ulteriori informazioni sulla configurazione delle impostazioni di sicurezza per Jenkins, vedi Sicurezza rapida e semplice, Configurazione di sicurezza standard, e Protezione di Jenkins.
Creare un progetto Jenkins
Poi, crea un progetto per eseguire i test di integrazione continua della tua app con Firebase Test Lab.
Per creare un progetto Jenkins
- Vai alla dashboard di Jenkins sul tuo server. A questo scopo, vai su http://<servername>:8080, dove <servername> è il nome del computer su cui hai installato Jenkins.
- Nella dashboard di Jenkins, fai clic su Nuovo elemento.
- Digita un nome per il progetto nel campo Nome elemento:
- Scegli Progetto Freestyle per creare un progetto che utilizza una singola build configurazione.
- Scegli Crea un progetto con più configurazioni per creare un progetto che viene eseguito su più configurazioni di build diverse. Se prevedi di creare la tua app con una serie di configurazioni di build (più impostazioni internazionali, più livelli API Android e così via), viene creato un progetto con più configurazioni è la scelta migliore.
- Fai clic su Salva.
Una volta creato il progetto, il browser web visualizza la pagina principale progetto.
Aggiungi il controllo delle revisioni e i passaggi di compilazione di Gradle
Questa sezione descrive come integrare Jenkins con i sistemi di controllo delle revisioni ad esempio GitHub, e su come aggiungere passaggi di build Gradle per creare pacchetti APK dal codice sorgente.
Integrazione con GitHub e altri sistemi di controllo delle revisioni
Se utilizzi GitHub o un altro sistema di controllo delle revisioni per gestire il codice sorgente per la tua app, puoi configurare Jenkins per eseguire build automatiche ed eseguire test ogni volta che vengono registrati gli aggiornamenti dell'app. Puoi anche configurare Jenkins in modo che esegua le build periodicamente.
Per scoprire di più sulla configurazione delle build in Jenkins, vedi Configurazione di build automatiche.
Aggiunta dei passaggi di build Gradle per ricreare i pacchetti APK
Se utilizzi un sistema di controllo delle revisioni per gestire il codice sorgente della tua app, devi includere un passaggio di compilazione Gradle per creare nuovi file APK binari ogni volta che Jenkins scarica il codice sorgente dal sistema di controllo delle revisioni.
Aggiungi un passaggio di build per eseguire questi comandi nella directory principale applicazione:
./gradlew :app:assembleDebug ./gradlew :app:assembleDebugAndroidTest
Aggiungi un passaggio di build per utilizzare i pacchetti APK creati da Gradle durante i test con Test Lab. Puoi utilizzare questo percorso come <local_server_path> nell'esempio dello script shell fornito di seguito, dove <AppCartella> è la cartella di progetto Android Studio dell'app:
<AppFolder>/app/build/outputs/apk
Aggiungi Test Lab passaggi di build a Jenkins
Ora puoi aggiungere un passaggio di compilazione a Jenkins per eseguire Test Lab utilizzando la riga di comando gcloud.
Per aggiungere un passaggio di build gcloud
- Nella pagina principale del progetto, fai clic su Configura.
Nella pagina Configurazione progetto, scorri verso il basso fino alla sezione Crea. e scegli Esegui shell dal menu Aggiungi passaggio di build.
Nella finestra Eseguire il comando shell di Jenkins, inserisci quanto segue: sostituendo <local_server_path> con il percorso dell'app di esempio il server, <app_apk> per l'APK dell'app e <app_test_apk> per l'APK di test della tua app:
gcloud firebase test android run --app <local_server_path>/<app_apk>.apk --test <local_server_path>/<app_test_apk>.apk
Analizza i risultati dei test
Dopo che Test Lab avrà completato il test della tua app, potrai esaminarlo
nella console Firebase o in un
Bucket Google Cloud Storage in
del progetto. Puoi anche aggiungere un comando gsutil
al comando shell mostrato sopra per copiare i dati dei risultati del test sul computer locale.
Per saperne di più, vedi
Analisi dei risultati di Firebase Test Lab.
Integrazione continua con altri sistemi CI
Per scoprire come utilizzare Firebase Test Lab con altri sistemi CI, dai un'occhiata documenti:
di Gemini Advanced.