Guida rapida

Per un'esperienza ottimale di sviluppo con Compose, scarica e installa Android Studio. Include molte funzionalità dell'editor intelligente, come nuovi modelli di progetto e la possibilità di visualizzare immediatamente l'anteprima dell'interfaccia utente e delle animazioni di Compose.

Scaricare Android Studio

Segui queste istruzioni per creare un nuovo progetto di app Compose, configurare Compose per un progetto di app esistente o importare un'app di esempio scritta in Compose.

Crea una nuova app con supporto per Compose

Se vuoi avviare un nuovo progetto che includa il supporto di Compose per impostazione predefinita, Android Studio include vari modelli di progetto per aiutarti a iniziare. Per creare un nuovo progetto con Compose configurato correttamente, procedi nel seguente modo:

  1. Se ti trovi nella finestra Benvenuto in Android Studio, fai clic su Avvia un nuovo progetto Android Studio. Se hai già aperto un progetto Android Studio, seleziona File > Nuovo > Nuovo progetto dalla barra dei menu.
  2. Nella finestra Seleziona un modello di progetto, seleziona Attività vuota e fai clic su Avanti.
  3. Nella finestra Configura il progetto:
    1. Imposta Nome, Nome pacchetto e Posizione di salvataggio come di consueto. Tieni presente che, nel menu a discesa Lingua, Kotlin è l'unica opzione disponibile perché Jetpack Compose funziona solo con le classi scritte in Kotlin.
    2. Nel menu a discesa Livello API minimo, seleziona il livello API 21 o superiore.
  4. Fai clic su Fine.

Ora puoi iniziare a sviluppare un'app utilizzando Jetpack Compose. Per iniziare e scoprire cosa puoi fare con il toolkit, prova il tutorial su Jetpack Compose.

Configurare Compose per un'app esistente

Per prima cosa, configura il compilatore Compose utilizzando il plug-in Gradle del compilatore Compose.

Quindi, aggiungi la seguente definizione al file build.gradle della tua app:

Groovy

android {
    buildFeatures {
        compose true
    }
}

Kotlin

android {
    buildFeatures {
        compose = true
    }
}

L'impostazione del flag compose su true all'interno del blocco BuildFeatures di Android attiva la funzionalità di Compose in Android Studio.

Infine, aggiungi la distinta base di Compose e il sottoinsieme delle dipendenze della libreria Compose necessarie alle tue dipendenze dal seguente blocco:

Groovy

dependencies {

    def composeBom = platform('androidx.compose:compose-bom:2025.05.00')
    implementation composeBom
    androidTestImplementation composeBom

    // Choose one of the following:
    // Material Design 3
    implementation 'androidx.compose.material3:material3'
    // or Material Design 2
    implementation 'androidx.compose.material:material'
    // or skip Material Design and build directly on top of foundational components
    implementation 'androidx.compose.foundation:foundation'
    // or only import the main APIs for the underlying toolkit systems,
    // such as input and measurement/layout
    implementation 'androidx.compose.ui:ui'

    // Android Studio Preview support
    implementation 'androidx.compose.ui:ui-tooling-preview'
    debugImplementation 'androidx.compose.ui:ui-tooling'

    // UI Tests
    androidTestImplementation 'androidx.compose.ui:ui-test-junit4'
    debugImplementation 'androidx.compose.ui:ui-test-manifest'

    // Optional - Included automatically by material, only add when you need
    // the icons but not the material library (e.g. when using Material3 or a
    // custom design system based on Foundation)
    implementation 'androidx.compose.material:material-icons-core'
    // Optional - Add full set of material icons
    implementation 'androidx.compose.material:material-icons-extended'
    // Optional - Add window size utils
    implementation 'androidx.compose.material3.adaptive:adaptive'

    // Optional - Integration with activities
    implementation 'androidx.activity:activity-compose:1.10.1'
    // Optional - Integration with ViewModels
    implementation 'androidx.lifecycle:lifecycle-viewmodel-compose:2.8.5'
    // Optional - Integration with LiveData
    implementation 'androidx.compose.runtime:runtime-livedata'
    // Optional - Integration with RxJava
    implementation 'androidx.compose.runtime:runtime-rxjava2'

}

Kotlin

dependencies {

    val composeBom = platform("androidx.compose:compose-bom:2025.05.00")
    implementation(composeBom)
    androidTestImplementation(composeBom)

    // Choose one of the following:
    // Material Design 3
    implementation("androidx.compose.material3:material3")
    // or Material Design 2
    implementation("androidx.compose.material:material")
    // or skip Material Design and build directly on top of foundational components
    implementation("androidx.compose.foundation:foundation")
    // or only import the main APIs for the underlying toolkit systems,
    // such as input and measurement/layout
    implementation("androidx.compose.ui:ui")

    // Android Studio Preview support
    implementation("androidx.compose.ui:ui-tooling-preview")
    debugImplementation("androidx.compose.ui:ui-tooling")

    // UI Tests
    androidTestImplementation("androidx.compose.ui:ui-test-junit4")
    debugImplementation("androidx.compose.ui:ui-test-manifest")

    // Optional - Included automatically by material, only add when you need
    // the icons but not the material library (e.g. when using Material3 or a
    // custom design system based on Foundation)
    implementation("androidx.compose.material:material-icons-core")
    // Optional - Add full set of material icons
    implementation("androidx.compose.material:material-icons-extended")
    // Optional - Add window size utils
    implementation("androidx.compose.material3.adaptive:adaptive")

    // Optional - Integration with activities
    implementation("androidx.activity:activity-compose:1.10.1")
    // Optional - Integration with ViewModels
    implementation("androidx.lifecycle:lifecycle-viewmodel-compose:2.8.5")
    // Optional - Integration with LiveData
    implementation("androidx.compose.runtime:runtime-livedata")
    // Optional - Integration with RxJava
    implementation("androidx.compose.runtime:runtime-rxjava2")

}

Provare le app di esempio di Jetpack Compose

Il modo più veloce per sperimentare le funzionalità di Jetpack Compose è provare le app di esempio di Jetpack Compose ospitate su GitHub. Per importare un progetto di app di esempio da Android Studio, procedi nel seguente modo:

  1. Se ti trovi nella finestra Benvenuto in Android Studio, seleziona Importa un esempio di codice Android. Se hai già aperto un progetto Android Studio, seleziona File > Nuovo > Importa esempio dalla barra dei menu.
  2. Nella barra di ricerca nella parte superiore della procedura guidata Sfoglia esempi, digita "compose".
  3. Seleziona una delle app di esempio Jetpack Compose dai risultati di ricerca e fai clic su Avanti.
  4. Modifica Nome applicazione e Posizione progetto o mantieni i valori predefiniti.
  5. Fai clic su Fine.

Android Studio scarica l'app di esempio nel percorso specificato e apre il progetto. Puoi quindi esaminare MainActivity.kt in ciascuno degli esempi per vedere API Jetpack Compose come animazione crossfade, componenti personalizzati, utilizzo della tipografia e visualizzazione di colori chiari e scuri nell'anteprima nell'IDE.

Per utilizzare Jetpack Compose per Wear OS, vedi Configurare Jetpack Compose su Wear OS.