Utilizzare una distinta materiali

La distinta componenti (BOM) di Compose ti consente di gestire tutte le versioni della libreria Compose specificando solo la versione della BOM. La BOM stessa contiene link alle versioni stabili delle diverse librerie Compose, in modo che funzionino bene insieme. Quando utilizzi il BOM nella tua app, non devi aggiungere alcuna versione alle dipendenze della libreria Compose. Quando aggiorni la versione del BOM, tutte le librerie in uso vengono aggiornate automaticamente alle nuove versioni.

Kotlin

dependencies {
    // Specify the Compose BOM with a version definition
    val composeBom = platform("androidx.compose:compose-bom:2024.10.01")
    implementation(composeBom)
    testImplementation(composeBom)
    androidTestImplementation(composeBom)

    // Specify Compose library dependencies without a version definition
    implementation("androidx.compose.foundation:foundation")
    // ..
    testImplementation("androidx.compose.ui:ui-test-junit4")
    // ..
    androidTestImplementation("androidx.compose.ui:ui-test")
}

Groovy

dependencies {
    // Specify the Compose BOM with a version definition
    Dependency composeBom = platform('androidx.compose:compose-bom:2024.10.01')
    implementation composeBom
    testImplementation composeBom
    androidTestImplementation composeBom

    // Specify Compose library dependencies without a version definition
    implementation 'androidx.compose.foundation:foundation'
    // ..
    testImplementation 'androidx.compose.ui:ui-test-junit4'
    // ..
    androidTestImplementation 'androidx.compose.ui:ui-test'
}

Per scoprire quali versioni delle librerie Compose sono mappate a una versione BOM specifica, consulta la mappatura della versione BOM alla versione della libreria.

Perché la libreria del compilatore Compose non è inclusa nel BOM?

L'estensione del compilatore Kotlin di Compose (androidx.compose.compiler) non è collegata alle versioni della libreria Compose. È invece collegato alle versioni del plug-in del compilatore Kotlin e viene rilasciato con una cadenza separata dal resto di Compose.

A partire da Kotlin 2.0, il compilatore di app Compose viene gestito insieme al compilatore Kotlin e utilizza la stessa versione del compilatore Kotlin. Per i dettagli di configurazione, consulta Plugin Gradle del compilatore Compose.

Prima di Kotlin 2.0, devi assicurarti di utilizzare una versione compatibile con la tua versione di Kotlin. Puoi trovare la versione di Kotlin associata a ogni versione del plug-in nella mappa di compatibilità di Compose con Kotlin e scoprire come configurarla in Compilatore Compose.

Come faccio a utilizzare una versione della libreria diversa da quella indicata nel BOM?

Nella sezione build.gradle dependencies, mantieni l'importazione della piattaforma BOM. Nell'importazione della dipendenza della libreria, specifica la versione che ha la precedenza. Ad esempio, ecco come dichiarare le dipendenze se vuoi utilizzare una versione più recente della libreria di animazione, indipendentemente dalla versione designata nel BOM:

Kotlin

dependencies {
    // Specify the Compose BOM with a version definition
    val composeBom = platform("androidx.compose:compose-bom:2024.10.01")
    implementation(composeBom)

    // Override the BOM version when needed
    implementation("androidx.compose.animation:animation:1.8.0-alpha05")

    // ..
}

Groovy

dependencies {
    // Specify the Compose BOM with a version definition
    Dependency composeBom = platform("androidx.compose:compose-bom:2024.10.01")
    implementation composeBom

    // Override the BOM version when needed
    implementation 'androidx.compose.animation:animation:1.8.0-alpha05'

    // ..
}

Nota: l'override del BOM per utilizzare una versione alpha di una libreria Compose aggiornerà la compilazione in modo da utilizzare le dipendenze richieste di quella libreria alpha (che a sua volta potrebbe essere alpha).

Il BOM aggiunge automaticamente tutte le librerie Compose alla mia app?

No. Per aggiungere e utilizzare effettivamente le librerie Compose nella tua app, devi dichiarare ogni libreria come riga di dipendenza separata nel file Gradle del modulo (a livello di app) (di solito app/build.gradle).

L'utilizzo della distinta base garantisce che le versioni di eventuali librerie Compose nella tua app siano compatibili, ma la distinta base non aggiunge effettivamente queste librerie Compose alla tua app.

Perché il BOM è il modo consigliato per gestire le versioni delle librerie Compose?

In futuro, le librerie Compose verranno versionate in modo indipendente, il che significa che i numeri di versione inizieranno a essere incrementati in base al loro ritmo. Le release stabili più recenti di ogni libreria vengono testate insieme. Tuttavia, trovare le versioni stabili più recenti di ogni libreria può essere difficile e il BOM ti aiuta a utilizzare automaticamente queste versioni più recenti.

Sono obbligato a utilizzare la BOM?

No. Puoi comunque scegliere di aggiungere manualmente ogni versione della dipendenza. Tuttavia, ti consigliamo di utilizzare il BOM perché ti consentirà di utilizzare più facilmente tutte le versioni stabili più recenti contemporaneamente.

La BOM funziona con i cataloghi delle versioni?

Sì. Puoi includere la BOM stessa nel catalogo delle versioni e omettere le altre versioni della libreria Compose:

[libraries]
androidx-compose-bom = { group = "androidx.compose", name = "compose-bom", version.ref = "androidxComposeBom" }
androidx-compose-foundation = { group = "androidx.compose.foundation", name = "foundation" }

Non dimenticare di importare la BOM in build.gradle del modulo:

Kotlin

dependencies {
    val composeBom = platform(libs.androidx.compose.bom)
    implementation(composeBom)
    androidTestImplementation(composeBom)

    // import Compose dependencies as usual
}

Groovy

dependencies {
    Dependency composeBom = platform(libs.androidx.compose.bom)
    implementation composeBom
    androidTestImplementation(composeBom)

    // import Compose dependencies as usual
}

Cosa succede se voglio provare le release alpha o beta delle librerie Compose?

Esistono tre BOM di Compose disponibili. Ogni BOM è uno snapshot in un determinato momento delle versioni più recenti delle librerie Compose.

• Stabile: contiene le versioni stabili più recenti di ogni libreria
• Beta: contiene le ultime versioni beta, release candidate (RC) o stabili di ogni libreria
• Alpha: contiene le versioni alpha, beta, RC o stabili più recenti di ogni libreria

Le versioni Alpha e Beta della BOM vengono specificate aggiungendo -alpha e -beta al nome dell'elemento della BOM. La versione stabile non ha suffisso.

Nota: le BOM alpha e beta vengono fornite per i test delle funzionalità imminenti e delle correzioni dei bug. Non sono destinati all'uso in produzione. Queste BOM non contengono solo versioni alpha e beta. Se la versione stabile più recente di una libreria è superiore alle ultime versioni alpha, beta o RC, questa versione stabile verrà visualizzata nei BOM alpha e beta. Se la versione più recente è beta o RC, verrà visualizzata nelle BOM alpha e beta.

Kotlin

dependencies {
    // Specify the Compose BOM with a version definition
    val composeBom = platform("androidx.compose:compose-bom-alpha:2024.10.01")
    //            or platform("androidx.compose:compose-bom-beta:2024.10.01")
    implementation(composeBom)
    // ..
}

Groovy

dependencies {
    // Specify the Compose BOM with a version definition
    Dependency composeBom = platform('androidx.compose:compose-bom-alpha:2024.10.01')
    //                   or platform('androidx.compose:compose-bom-beta:2024.10.01')
    implementation composeBom
    // ..
}

Come faccio a segnalare un problema o a fornire un feedback sulla BOM?

Puoi segnalare i problemi nel nostro Issue Tracker.