Configura la build

Il sistema di compilazione Android compila le risorse e il codice sorgente dell'app e li pacchettizza in APK o Android App Bundle che puoi testare, implementare, firmare e distribuire.

In Panoramica della build Gradle e Struttura della build Android, abbiamo discusso i concetti di build e la struttura di un'app per Android. Ora è il momento di configurare la build.

Glossario delle build Android

Gradle e il plug-in Android per Gradle ti aiutano a configurare i seguenti aspetti della build:

Tipi di build

I tipi di build definiscono determinate proprietà utilizzate da Gradle durante la creazione e il packaging dell'app. I tipi di build vengono in genere configurati per le diverse fasi del ciclo di vita dello sviluppo.

Ad esempio, il tipo di build di debug attiva le opzioni di debug e firma l'app con la chiave di debug, mentre il tipo di build di release può ridurre, offuscare e firmare l'app con una chiave di release per la distribuzione.

Devi definire almeno un tipo di build per creare la tua app. Android Studio crea i tipi di build di debug e release per impostazione predefinita. Per iniziare a personalizzare le impostazioni di pacchettizzazione per la tua app, scopri come configurare i tipi di build.

Varianti di prodotto
Le varianti del prodotto rappresentano diverse versioni della tua app che puoi rilasciare agli utenti, ad esempio le versioni senza costi e a pagamento. Puoi personalizzare le varianti di prodotto per utilizzare codice e risorse diversi durante la condivisione e il riutilizzo delle parti comuni a tutte le versioni della tua app. Le varianti di prodotto sono facoltative e devi crearle manualmente. Per iniziare a creare diverse versioni della tua app, scopri come configurare le varianti del prodotto.
Varianti di build
Una variante di build è un prodotto incrociato di tipo di build e variante di prodotto ed è la configurazione che Gradle utilizza per creare la tua app. Utilizzando le varianti di build, puoi creare la versione di debug delle tue varianti di prodotto durante lo sviluppo e le versioni di rilascio firmate delle tue varianti di prodotto per la distribuzione. Sebbene non configuri direttamente le varianti di build, configuri i tipi di build e le varianti di prodotto che le compongono. La creazione di tipi di build o varianti di prodotto aggiuntivi crea anche varianti di build aggiuntive. Per scoprire come creare e gestire le varianti di build, leggi la panoramica Configurare le varianti di build.
Voci del manifest
Puoi specificare i valori per alcune proprietà del file manifest nella configurazione della variante di build. Questi valori di build sostituiscono i valori esistenti nel file manifest. Questo è utile se vuoi generare più varianti della tua app con un nome dell'applicazione, una versione minima dell'SDK o una versione dell'SDK di destinazione diversi. Quando sono presenti più manifest, lo strumento di unione dei manifest unisce le impostazioni dei manifest.
Dipendenze
Il sistema di build gestisce le dipendenze del progetto dal file system locale e dai repository remoti. Ciò significa che non devi cercare, scaricare e copiare manualmente i pacchetti binari delle dipendenze nella directory del progetto. Per saperne di più, consulta Aggiungere dipendenze di build.
Firma
Il sistema di build ti consente di specificare le impostazioni di firma nella configurazione della build e può firmare automaticamente la tua app durante la procedura di build. Il sistema di compilazione firma la versione di debug con una chiave e un certificato predefiniti utilizzando credenziali note per evitare una richiesta di password al momento della compilazione. Il sistema di build non firma la versione di rilascio a meno che tu non definisca esplicitamente una configurazione di firma per questa build. Se non hai una chiave di release, puoi generarne una come descritto in Firma l'app. Le build di release firmate sono necessarie per distribuire le app tramite la maggior parte degli store.
Riduzione del codice e delle risorse
Il sistema di compilazione ti consente di specificare un file di regole ProGuard diverso per ogni variante di build. Quando crei l'app, il sistema di compilazione applica il set di regole appropriato per ridurre le dimensioni del codice e delle risorse utilizzando gli strumenti di riduzione integrati, come R8. La riduzione del codice e delle risorse può contribuire a ridurre le dimensioni dell'APK o dell'AAB.
Supporto di più APK
Il sistema di build ti consente di creare automaticamente APK diversi che contengono solo il codice e le risorse necessari per una densità dello schermo o un'interfaccia binaria dell'applicazione (ABI) specifica. Per maggiori informazioni, vedi Creare più APK. Tuttavia, il rilascio di un singolo AAB è l'approccio consigliato, in quanto offre la suddivisione per lingua oltre a densità dello schermo e ABI, evitando la necessità di caricare più artefatti su Google Play. Tutte le nuove app inviate dopo agosto 2021 devono utilizzare gli AAB.

Versioni di Java nelle build Android

Indipendentemente dal fatto che il codice sorgente sia scritto in Java, Kotlin o entrambi, ci sono diversi punti in cui devi scegliere una versione JDK o del linguaggio Java per la tua build. Per maggiori dettagli, consulta la sezione Versioni di Java nelle build di Android.

File di configurazione di compilazione

La creazione di configurazioni di compilazione personalizzate richiede modifiche a uno o più file di configurazione di compilazione. Questi file di testo normale utilizzano un linguaggio specifico del dominio (DSL) per descrivere e manipolare la logica di compilazione utilizzando Kotlin Script, una variante del linguaggio Kotlin. Puoi anche utilizzare Groovy, un linguaggio dinamico per la Java Virtual Machine (JVM), per configurare le build.

Non è necessario conoscere Kotlin Script o Groovy per iniziare a configurare la build, perché il plug-in Android Gradle introduce la maggior parte degli elementi DSL necessari. Per saperne di più sul DSL del plug-in Android per Gradle, consulta la documentazione di riferimento del DSL. Lo script Kotlin si basa anche sulla DSL Kotlin di Gradle sottostante.

Quando avvii un nuovo progetto, Android Studio crea automaticamente alcuni di questi file e li compila in base a valori predefiniti ragionevoli. Per una panoramica dei file creati, vedi Struttura della build Android.

Il file Gradle Wrapper

Il wrapper Gradle (gradlew) è una piccola applicazione inclusa nel codice sorgente che scarica e avvia Gradle. In questo modo, l'esecuzione della build è più coerente. Gli sviluppatori scaricano il codice sorgente dell'applicazione ed eseguono gradlew. Viene scaricata la distribuzione Gradle richiesta e viene avviato Gradle per creare l'applicazione.

Il file gradle/wrapper/gradle-wrapper.properties contiene una proprietà, distributionUrl, che descrive la versione di Gradle utilizzata per eseguire la build.

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-8.0-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

Il file di impostazioni di Gradle

Il file settings.gradle.kts (per Kotlin DSL) o settings.gradle (per Groovy DSL) si trova nella directory root del progetto. Questo file di impostazioni definisce le impostazioni del repository a livello di progetto e indica a Gradle quali moduli deve includere durante la creazione dell'app. I progetti multimodulo devono specificare ogni modulo da includere nella build finale.

Per la maggior parte dei progetti, il file ha il seguente aspetto per impostazione predefinita:

Kotlin

pluginManagement {

    /**
      * The pluginManagement.repositories block configures the
      * repositories Gradle uses to search or download the Gradle plugins and
      * their transitive dependencies. Gradle pre-configures support for remote
      * repositories such as JCenter, Maven Central, and Ivy. You can also use
      * local repositories or define your own remote repositories. Here we
      * define the Gradle Plugin Portal, Google's Maven repository,
      * and the Maven Central Repository as the repositories Gradle should use to look for its
      * dependencies.
      */

    repositories {
        gradlePluginPortal()
        google()
        mavenCentral()
    }
}
dependencyResolutionManagement {

    /**
      * The dependencyResolutionManagement.repositories
      * block is where you configure the repositories and dependencies used by
      * all modules in your project, such as libraries that you are using to
      * create your application. However, you should configure module-specific
      * dependencies in each module-level build.gradle file. For new projects,
      * Android Studio includes Google's Maven repository and the Maven Central
      * Repository by default, but it does not configure any dependencies (unless
      * you select a template that requires some).
      */

  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
      google()
      mavenCentral()
  }
}
rootProject.name = "My Application"
include(":app")

Groovy

pluginManagement {

    /**
      * The pluginManagement.repositories block configures the
      * repositories Gradle uses to search or download the Gradle plugins and
      * their transitive dependencies. Gradle pre-configures support for remote
      * repositories such as JCenter, Maven Central, and Ivy. You can also use
      * local repositories or define your own remote repositories. Here we
      * define the Gradle Plugin Portal, Google's Maven repository,
      * and the Maven Central Repository as the repositories Gradle should use to look for its
      * dependencies.
      */

    repositories {
        gradlePluginPortal()
        google()
        mavenCentral()
    }
}
dependencyResolutionManagement {

    /**
      * The dependencyResolutionManagement.repositories
      * block is where you configure the repositories and dependencies used by
      * all modules in your project, such as libraries that you are using to
      * create your application. However, you should configure module-specific
      * dependencies in each module-level build.gradle file. For new projects,
      * Android Studio includes Google's Maven repository and the Maven Central
      * Repository by default, but it does not configure any dependencies (unless
      * you select a template that requires some).
      */

    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}
rootProject.name = "My Application"
include ':app'

Il file di build di primo livello

Il file build.gradle.kts di primo livello (per Kotlin DSL) o il file build.gradle (per Groovy DSL) si trova nella directory principale del progetto. In genere definisce le versioni comuni dei plug-in utilizzati dai moduli del progetto.

Il seguente esempio di codice descrive le impostazioni predefinite e gli elementi DSL nello script di build di primo livello dopo la creazione di un nuovo progetto:

Kotlin

plugins {

    /**
     * Use `apply false` in the top-level build.gradle file to add a Gradle
     * plugin as a build dependency but not apply it to the current (root)
     * project. Don't use `apply false` in sub-projects. For more information,
     * see Applying external plugins with same version to subprojects.
     */

    id("com.android.application") version "8.11.0" apply false
    id("com.android.library") version "8.11.0" apply false
    id("org.jetbrains.kotlin.android") version "2.1.20" apply false
}

Groovy

plugins {

    /**
     * Use `apply false` in the top-level build.gradle file to add a Gradle
     * plugin as a build dependency but not apply it to the current (root)
     * project. Don't use `apply false` in sub-projects. For more information,
     * see Applying external plugins with same version to subprojects.
     */

    id 'com.android.application' version '8.11.0' apply false
    id 'com.android.library' version '8.11.0' apply false
    id 'org.jetbrains.kotlin.android' version '2.1.20' apply false
}