Google is committed to advancing racial equity for Black communities. See how.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

Inizia i test con i sistemi CI

Puoi utilizzare Firebase Test Lab durante lo sviluppo della tua app utilizzando qualsiasi sistema di integrazione continua (CI). I sistemi di integrazione continua ti consentono di creare e testare automaticamente la tua app ogni volta che archivia gli aggiornamenti al codice sorgente dell'app.

Utilizzo di Firebase Test Lab con Jenkins CI

Questa sezione descrive come utilizzare Test Lab con Jenkins CI .

Requisiti

Prima di poter utilizzare Firebase Test Lab con Jenkins, è necessario completare i seguenti passaggi:

  1. Configura gcloud. Segui le istruzioni in Utilizzo di Firebase Test Lab dalla riga di comando di gcloud per creare un progetto Firebase e configurare il tuo ambiente Google Cloud SDK locale.
  2. Crea un account di servizio. Gli account di servizio non sono soggetti a controlli antispam o prompt captcha, che altrimenti potrebbero bloccare le build di CI. Crea un account di servizio con un ruolo di Editor nella console di Google Cloud .
  3. Abilita le API richieste. Dopo aver effettuato l'accesso utilizzando l'account di servizio: nella pagina Libreria API di Google Developers Console , abilita l' API di test di Google Cloud e l' API dei risultati di Cloud Tool . Per abilitare queste API, digita questi nomi API nella casella di ricerca nella parte superiore della console, quindi fai clic su Abilita API nella pagina della panoramica per tale API.

Installa e configura Jenkins

È possibile installare e configurare Jenkins CI su Linux o Windows. Alcuni dettagli di questa guida sono specifici per l'installazione e l'esecuzione di Jenkins CI su Linux, compreso l'uso di barre ( / ) nei percorsi dei file.

Per scaricare e installare Jenkins su un computer con Linux o Windows, segui le istruzioni su Installazione di Jenkins . Dopo aver installato Jenkins, segui le istruzioni su Avvio e accesso a Jenkins per completare la configurazione e accedere al dashboard di Jenkins.

Configura le impostazioni di sicurezza globali

Jenkins non ha l'autenticazione dell'utente e il controllo dell'accesso configurati quando viene installato per la prima volta. Prima di utilizzare Jenkins con Firebase Test Lab, configura le impostazioni di sicurezza globali per applicare il controllo degli accessi e autenticare gli utenti.

Per configurare le impostazioni di sicurezza globali

  1. Accedi alla dashboard di Jenkins sul tuo server. A tale scopo, accedere a http: // <servername>: 8080 , dove <servername> è il nome del computer in cui è stato installato Jenkins.
  2. Nella dashboard di Jenkins, fai clic su Gestisci Jenkins , quindi su Configura sicurezza globale .
  3. Nella pagina Configura protezione globale , fare clic su Abilita protezione e quindi fare clic su Salva .

Per ulteriori informazioni sulla configurazione delle impostazioni di sicurezza per Jenkins, vedere Sicurezza rapida e semplice , Configurazione della sicurezza standard e Protezione di Jenkins .

Crea un progetto Jenkins

Successivamente, crea un progetto per eseguire test di integrazione continua della tua app con Firebase Test Lab.

Per creare un progetto Jenkins

  1. Accedi alla dashboard di Jenkins sul tuo server. A tale scopo, accedere a http: // <servername>: 8080 , dove <servername> è il nome del computer in cui è stato installato Jenkins.
  2. Nella dashboard di Jenkins, fai clic su Nuovo elemento .
  3. Digita un nome per il tuo progetto nel campo Nome oggetto :
    • Scegli Progetto Freestyle per creare un progetto che utilizza una singola configurazione di build.
    • Scegli Build multi-configuration project per creare un progetto che viene eseguito su più configurazioni di build differenti. Se prevedi di creare la tua app con una varietà di configurazioni di build (più versioni locali, più livelli di API Android e così via), un progetto multi-configurazione è la scelta migliore.
  4. Fare clic su Salva .

Dopo aver creato il progetto, il browser Web visualizza la pagina principale del progetto.

Aggiungi il controllo di revisione e le fasi di compilazione Gradle

Questa sezione descrive come integrare Jenkins con sistemi di controllo di revisione come GitHub e come aggiungere passaggi di compilazione 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 della tua app, puoi configurare Jenkins per eseguire build automatizzate ed eseguire test ogni volta che vengono archiviati gli aggiornamenti della tua app. Puoi anche configurare Jenkins per eseguire build periodicamente.

Per informazioni sulla configurazione delle build in Jenkins, consulta Configurazione delle build automatiche .

Aggiunta di passaggi di build Gradle per ricostruire i pacchetti APK

Se utilizzi un sistema di controllo di revisione per gestire il codice sorgente per la tua app, devi includere un passaggio di compilazione Gradle per creare nuovi file binari APK ogni volta che Jenkins scarica il codice sorgente dal tuo sistema di controllo di revisione.

  1. Aggiungi una fase di compilazione per eseguire i seguenti comandi nella directory principale dell'applicazione:

    ./gradlew :app:assembleDebug
    ./gradlew :app:assembleDebugAndroidTest
    

  2. Aggiungi una fase di compilazione per utilizzare i pacchetti APK creati da Gradle durante i test con Test Lab. Puoi utilizzare questo percorso come <local_server_path> nell'esempio di script della shell fornito di seguito, dove <AppFolder> è la cartella del progetto Android Studio per la tua app:

    <AppFolder>/app/build/outputs/apk
    

Aggiungi i passaggi di compilazione di Test Lab a Jenkins

Ora sei pronto per aggiungere un passaggio di compilazione a Jenkins per eseguire Test Lab utilizzando la riga di comando di gcloud.

Per aggiungere un passaggio di creazione di gcloud

  1. Dalla pagina principale del tuo progetto, fai clic su Configura .
  2. Nella pagina di configurazione del progetto , scorri verso il basso fino alla sezione Compila e quindi scegli Esegui shell dal menu Aggiungi passaggio di compilazione .

  3. Nella finestra del comando Jenkins Execute shell , inserisci quanto segue, sostituendo <local_server_path> per il percorso dell'app di esempio sul server, <app_apk> per l'APK della tua 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 ha completato il test della tua app, puoi esaminare i risultati del test nella console Firebase o in un bucket di archiviazione Google Cloud nel tuo progetto. Puoi anche aggiungere un comando gsutil al comando della shell mostrato sopra per copiare i dati dei risultati del test sul tuo computer locale. Per saperne di più, consulta Analisi dei risultati di Firebase Test Lab .

Integrazione continua con altri sistemi CI

Per imparare a utilizzare Firebase Test Lab con altri sistemi CI, consulta i loro documenti: