Interdipendenze tra strumenti e librerie

Le dipendenze di build sono componenti esterni necessari per creare correttamente il progetto. Una build può dipendere da librerie, plug-in, sottoprogetti, l'SDK Android, strumenti come i compilatori Kotlin e Java, ambienti di sviluppo come Android Studio e Gradle stesso.

Ogni dipendenza può a sua volta richiedere altre dipendenze. Queste sono chiamate dipendenze transitive e possono aumentare rapidamente le dipendenze complessive utilizzate dalla tua applicazione. Quando vuoi eseguire l'upgrade di una dipendenza, che si tratti di una libreria, di uno strumento o dell'SDK Android, l'upgrade può essere applicato a cascata, eseguendo l'upgrade di molte altre dipendenze.

Spesso, questo non causerà problemi, poiché molte librerie seguono uno schema noto come controllo delle versioni semantico. Queste librerie limitano i tipi di modifiche che apportano per garantire la compatibilità con le versioni precedenti.

Il controllo delle versioni semantico segue un formato major.minor.patch. Ad esempio, nel numero di versione 4.8.3, 4 è la versione major, 8 è la versione minor e 3 è il numero patch. Quando la parte major cambia, la libreria potrebbe presentare modifiche che provocano un errore nell'API o nel comportamento. Ciò può influire sul comportamento della build o dell'applicazione.

Quando cambiano le parti minor (nuove funzionalità) o patch (correzioni di bug), gli sviluppatori della libreria ti comunicano che la libreria è ancora compatibile e non dovrebbe influire sulla tua applicazione.

Relazioni nella build

Le build Android contengono relazioni tra:

  • Codice sorgente: il codice e le risorse su cui hai il controllo
  • Dipendenze libreria: librerie o moduli esterni che il progetto e i sottoprogetti includono durante la creazione
  • Strumenti: compilatori, plug-in e SDK che traducono il codice sorgente in un'applicazione o una libreria
Dipendenze build e relative relazioni
Figura 1. Stringi legami

Codice sorgente

Il codice sorgente è il codice Kotlin o Java che scrivi nella tua applicazione o libreria. Per maggiori dettagli sull'utilizzo di C++, consulta Android NDK.

Il codice sorgente dipende dalle librerie (incluse le librerie di runtime Kotlin e Java) e dall'SDK Android e richiede il compilatore Kotlin o Java corrispondente.

Alcuni codici sorgente includono annotazioni che richiedono un'elaborazione aggiuntiva. Ad esempio, se scrivi codice Jetpack Compose, aggiungi annotazioni come @Composable che devono essere elaborate dal plug-in del compilatore Kotlin di Compose. Altre annotazioni possono essere elaborate da un processore di simboli Kotlin (KSP) o da strumenti di elaborazione delle annotazioni separati.

Dipendenze libreria

Le librerie contengono bytecode inserito nell'applicazione. Potrebbe trattarsi di un file JAR Java, di una libreria Android (AAR) o di un sottoprogetto nella build. Molte librerie seguono il controllo delle versioni semantico, che può aiutarti a capire quando rimangono compatibili (o meno) dopo l'upgrade.

Le librerie hanno spesso dipendenze transitive da altre librerie. In questo modo, si riduce ciò che devi gestire esplicitamente: specifichi le dipendenze dirette e Gradle le inserisce insieme a quelle transitive. L'upgrade delle dipendenze dirette potrebbe comportare anche l'upgrade delle relative dipendenze transitive.

A volte una libreria potrebbe richiedere versioni minime dell'SDK Android in fase di runtime (minSdk) o in fase di tempo di compilazione (compileSdk). Ciò è necessario quando una libreria utilizza funzioni incluse nell'SDK Android o nelle API JDK fornite. Il valore minSdk effettivo della tua applicazione è il valore minSdk più alto richiesto dalla tua applicazione e da tutte le sue dipendenze di libreria dirette e transitive.

L'utilizzo di alcune librerie potrebbe richiedere l'uso di un plug-in Gradle specifico. Questi plug-in di supporto spesso installano processori di simboli Kotlin o altri processori di annotazioni che generano codice o modificano la compilazione dell'origine per supportare l'utilizzo delle funzionalità della libreria. Ad esempio, Jetpack Room include annotazioni e un KSP che le trasforma in codice generato per recuperare e modificare i dati in un database. Jetpack Compose richiede il plug-in del compilatore Compose per modificare le funzioni annotate in modo da gestire come e quando vengono eseguite nuovamente.

Strumenti

Gradle

Gradle è lo strumento di build che legge i file di build e genera l'applicazione o la libreria, oltre a esporre un'API per i plug-in per estenderne le funzionalità. Gradle esegue più processi su una o più macchine virtuali Java e i suoi plug-in Java chiamano gli strumenti Java all'interno del JDK.

Plug-in Gradle

I plug-in Gradle estendono Gradle definendo nuove attività e configurazioni. L'applicazione di un plug-in alla build abilita funzionalità di build specifiche, configurate come dati negli script di build. Per le build Android, il plug-in Gradle più importante è il plug-in Android per Gradle (AGP).

Compilatori

Il compilatore Kotlin o Java trasforma il codice sorgente in bytecode eseguibile. Il compilatore Kotlin espone un'API del plug-in che consente di eseguire l'analisi esterna e la generazione del codice direttamente all'interno del compilatore, accedendo alla struttura del codice analizzato.

Plugin del compilatore

I plug-in del compilatore eseguono l'analisi e la generazione del codice all'interno del compilatore Kotlin mentre quest'ultimo analizza il codice e vengono installati quando applichi i relativi plug-in Gradle alla build.

SDK Android

L'SDK Android contiene la piattaforma Android e le API Java per una versione specifica di Android, nonché i relativi strumenti. Questi strumenti ti aiutano a gestire l'SDK, creare le tue applicazioni e comunicare con i dispositivi Android ed emularli.

Ogni versione dell'SDK Android fornisce API Java specifiche a cui il tuo codice sorgente può accedere e il supporto del desugaring per utilizzare queste API nelle versioni precedenti di Android.

JDK

Java Development Kit, contenente librerie ed eseguibili Java per compilare il codice sorgente Java ed eseguire applicazioni Java. In una build Android sono presenti diversi JDK. Per maggiori dettagli, consulta Versioni Java nelle build Android.

Ambiti Gradle

Gradle raggruppa le dipendenze della libreria in ambiti diversi (chiamati configurazioni nell'API Gradle), consentendoti di specificare diversi insiemi di dipendenze della libreria da utilizzare in diverse parti della build. Ad esempio, probabilmente non vuoi includere librerie di test come JUnit nell'applicazione o nella libreria pubblicata, ma ne hai bisogno durante la creazione e l'esecuzione degli unit test. Puoi anche utilizzare gli ambiti per aggiungere processori di simboli o annotazioni per analizzare il codice.

Ad esempio, AGP definisce gli ambiti implementation e api, il tuo modo di specificare se una dipendenza deve essere esposta agli utenti del tuo sottoprogetto. Consulta Configura le dipendenze per le descrizioni di questi e altri ambiti utilizzati in una build Android.

Aggiungi le dipendenze della libreria nel blocco dependencies dei file di build, come stringhe group:artifact:version:

Kotlin

// In a module-level build script
// explicit dependency strings ("group:artifact:version")
dependencies {
    implementation("com.example:library1:1.2.3")
    api("com.example:library2:1.1.1")
}

Alla moda

// In a module-level build script
// explicit dependency strings ("group:artifact:version")
dependencies {
    implementation 'com.example:library1:1.2.3'
    api 'com.example:library2:1.1.1'
}

o in un catalogo delle versioni:

# Version catalog - gradle/libs.versions.toml
[versions]
exampleLib = "1.2.3"
examplePlugin = "2.3.4"

[libraries]
example-library = { group = "com.example", name = "library", version.ref = "exampleLib" }

[plugins]
example-plugin = { id = "com.example.plugin", version.ref = "examplePlugin" }

e specifica le variabili generate nei file di build:

Kotlin

// In a module-level build script
// Using a version catalog
plugins {
    alias(libs.plugins.example.plugin)
}

dependencies {
    implementation(libs.example.library)
}

Alla moda

// In a module-level build script
// Using a version catalog
plugins {
    alias(libs.plugins.example.plugin)
}

dependencies {
    implementation libs.example.library
}