Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Pour une expérience de développement optimale avec Compose, téléchargez et installez Android Studio. Celui-ci inclut de nombreuses fonctionnalités d'éditeur intelligentes, telles que de nouveaux modèles de projet et la possibilité de prévisualiser immédiatement votre UI et vos animations Compose.
Suivez ces instructions pour créer un projet d'application Compose, configurer Compose pour un projet d'application existant ou importer une application exemple écrite dans Compose.
Créer une application compatible avec Compose
Android Studio inclut divers modèles de projet pour vous aider à démarrer un nouveau projet compatible par défaut avec Compose. Voici comment créer un projet dans lequel Compose est configuré correctement :
Si vous vous trouvez dans la fenêtre Welcome to Android Studio (Bienvenue dans Android Studio), cliquez sur Start a new Android Studio project (Démarrer un nouveau projet Android Studio). Si vous avez déjà ouvert un projet Android Studio, sélectionnez File > New > New Project (Fichier > Nouveau > Nouveau projet) dans la barre de menu.
Dans la fenêtre Select a Project Template (Sélectionner un modèle de projet), sélectionnez Empty Activity (Activité vide) et cliquez sur Next (Suivant).
Dans la fenêtre Configure your project (Configurer votre projet), procédez comme suit :
Définissez les paramètres Name, Package name (Nom, Nom du package) et Save location (Enregistrer l'emplacement) comme vous le faites d'habitude. Notez que, dans le menu déroulant Language (Langage), Kotlin est la seule option disponible, car Jetpack Compose ne fonctionne qu'avec les classes écrites en Kotlin.
Dans le menu déroulant Minimum API level (Niveau d'API minimal), sélectionnez le niveau d'API 21 ou supérieur.
Cliquez sur Finish (Terminer).
Vous êtes maintenant prêt à développer une application avec Jetpack Compose. Pour vous lancer et découvrir ce que vous pouvez faire avec le kit d'outils, suivez le tutoriel Jetpack Compose.
Enfin, ajoutez la nomenclature Compose et le sous-ensemble des dépendances des bibliothèques Compose nécessaires à vos dépendances à partir du bloc suivant :
Groovy
dependencies{defcomposeBom=platform('androidx.compose:compose-bom:2025.08.00')implementationcomposeBomandroidTestImplementationcomposeBom// Choose one of the following:// Material Design 3implementation'androidx.compose.material3:material3'// or Material Design 2implementation'androidx.compose.material:material'// or skip Material Design and build directly on top of foundational componentsimplementation'androidx.compose.foundation:foundation'// or only import the main APIs for the underlying toolkit systems,// such as input and measurement/layoutimplementation'androidx.compose.ui:ui'// Android Studio Preview supportimplementation'androidx.compose.ui:ui-tooling-preview'debugImplementation'androidx.compose.ui:ui-tooling'// UI TestsandroidTestImplementation'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 iconsimplementation'androidx.compose.material:material-icons-extended'// Optional - Add window size utilsimplementation'androidx.compose.material3.adaptive:adaptive'// Optional - Integration with activitiesimplementation'androidx.activity:activity-compose:1.10.1'// Optional - Integration with ViewModelsimplementation'androidx.lifecycle:lifecycle-viewmodel-compose:2.8.5'// Optional - Integration with LiveDataimplementation'androidx.compose.runtime:runtime-livedata'// Optional - Integration with RxJavaimplementation'androidx.compose.runtime:runtime-rxjava2'}
Kotlin
dependencies{valcomposeBom=platform("androidx.compose:compose-bom:2025.08.00")implementation(composeBom)androidTestImplementation(composeBom)// Choose one of the following:// Material Design 3implementation("androidx.compose.material3:material3")// or Material Design 2implementation("androidx.compose.material:material")// or skip Material Design and build directly on top of foundational componentsimplementation("androidx.compose.foundation:foundation")// or only import the main APIs for the underlying toolkit systems,// such as input and measurement/layoutimplementation("androidx.compose.ui:ui")// Android Studio Preview supportimplementation("androidx.compose.ui:ui-tooling-preview")debugImplementation("androidx.compose.ui:ui-tooling")// UI TestsandroidTestImplementation("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 iconsimplementation("androidx.compose.material:material-icons-extended")// Optional - Add window size utilsimplementation("androidx.compose.material3.adaptive:adaptive")// Optional - Integration with activitiesimplementation("androidx.activity:activity-compose:1.10.1")// Optional - Integration with ViewModelsimplementation("androidx.lifecycle:lifecycle-viewmodel-compose:2.8.5")// Optional - Integration with LiveDataimplementation("androidx.compose.runtime:runtime-livedata")// Optional - Integration with RxJavaimplementation("androidx.compose.runtime:runtime-rxjava2")}
Essayer des applications exemples Jetpack Compose
Le moyen le plus rapide de tester les fonctionnalités de Jetpack Compose est d'essayer les applications exemples Jetpack Compose hébergées sur GitHub. Pour importer un projet d'application exemple à partir d'Android Studio, procédez comme suit :
Si vous vous trouvez dans la fenêtre Welcome to Android Studio (Bienvenue dans Android Studio), sélectionnez Import an Android code sample (Importer un exemple de code Android). Si vous avez déjà ouvert un projet Android Studio, sélectionnez File > New > Import Sample (Fichier > Nouveau > Importer un exemple) dans la barre de menu.
Dans la barre de recherche en haut de l'assistant Browse Samples (Parcourir des exemples), saisissez "compose".
Sélectionnez l'une des applications exemples Jetpack Compose dans les résultats de recherche, puis cliquez sur Next (Suivant).
Modifiez les champs Application name (Nom de l'application) et Project location (Emplacement du projet) ou conservez les valeurs par défaut.
Cliquez sur Finish (Terminer).
Android Studio télécharge l'application exemple dans le chemin d'accès que vous avez spécifié et ouvre le projet. Vous pouvez ensuite inspecter MainActivity.kt dans chacun des exemples pour voir les API Jetpack Compose, telles que l'animation de fondu enchaîné, les composants personnalisés, la typographie, et l'affichage des couleurs claires et sombres dans l'aperçu intégré à l'IDE.
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/21 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/21 (UTC)."],[],[],null,["# Quick start\n\nFor the best experience developing with Compose, download and install [Android\nStudio](/studio). It includes many [smart editor features](/develop/ui/compose/tooling), such as new project\ntemplates and the ability to immediately preview your Compose UI and animations.\n\n[Get Android Studio](/studio)\n\nFollow these instructions to create a new Compose app project, set up\nCompose for an existing app project, or import a sample app written in Compose.\n\nCreate a new app with support for Compose\n-----------------------------------------\n\nIf you want to start a new project that includes support for Compose by default,\nAndroid Studio includes various project templates to help you get started. To\ncreate a new project that has Compose setup correctly, proceed as follows:\n\n1. If you're in the **Welcome to Android Studio** window, click **Start a new\n Android Studio project** . If you already have an Android Studio project open , select **File \\\u003e New \\\u003e New Project** from the menu bar.\n2. In the **Select a Project Template** window, select **Empty\n Activity** and click **Next**.\n3. In the **Configure your project** window, do the following:\n 1. Set the **Name, Package name** , and **Save location** as you normally would. Note that, in the **Language** dropdown menu, **Kotlin** is the only available option because Jetpack Compose works only with classes written in Kotlin.\n 2. In the **Minimum API level dropdown** menu, select API level 21 or higher.\n4. Click **Finish**.\n\nNow you're ready to start developing an app using Jetpack Compose. To help you\nget started and learn about what you can do with the toolkit, try the [Jetpack\nCompose tutorial](/develop/ui/compose/tutorial).\n\nSet up Compose for an existing app\n----------------------------------\n\nFirst, configure the Compose compiler using the [Compose\nCompiler Gradle plugin](/develop/ui/compose/compiler).\n\nThen, add the following definition to your app's `build.gradle` file: \n\n### Groovy\n\n android {\n buildFeatures {\n compose true\n }\n }\n\n### Kotlin\n\n android {\n buildFeatures {\n compose = true\n }\n }\n\nSetting the `compose` flag to `true` inside the Android [`BuildFeatures`](/reference/tools/gradle-api/7.0/com/android/build/api/dsl/BuildFeatures)\nblock enables [Compose functionality](/develop/ui/compose/tooling) in Android Studio.\n\nFinally, add the Compose BOM and the subset of Compose library dependencies\nyou need to your dependencies from the following block: \n\n### Groovy\n\n dependencies {\n\n def composeBom = platform('androidx.compose:compose-bom:2025.08.00')\n implementation composeBom\n androidTestImplementation composeBom\n\n // Choose one of the following:\n // Material Design 3\n implementation 'androidx.compose.material3:material3'\n // or Material Design 2\n implementation 'androidx.compose.material:material'\n // or skip Material Design and build directly on top of foundational components\n implementation 'androidx.compose.foundation:foundation'\n // or only import the main APIs for the underlying toolkit systems,\n // such as input and measurement/layout\n implementation 'androidx.compose.ui:ui'\n\n // Android Studio Preview support\n implementation 'androidx.compose.ui:ui-tooling-preview'\n debugImplementation 'androidx.compose.ui:ui-tooling'\n\n // UI Tests\n androidTestImplementation 'androidx.compose.ui:ui-test-junit4'\n debugImplementation 'androidx.compose.ui:ui-test-manifest'\n\n // Optional - Included automatically by material, only add when you need\n // the icons but not the material library (e.g. when using Material3 or a\n // custom design system based on Foundation)\n implementation 'androidx.compose.material:material-icons-core'\n // Optional - Add full set of material icons\n implementation 'androidx.compose.material:material-icons-extended'\n // Optional - Add window size utils\n implementation 'androidx.compose.material3.adaptive:adaptive'\n\n // Optional - Integration with activities\n implementation 'androidx.activity:activity-compose:1.10.1'\n // Optional - Integration with ViewModels\n implementation 'androidx.lifecycle:lifecycle-viewmodel-compose:2.8.5'\n // Optional - Integration with LiveData\n implementation 'androidx.compose.runtime:runtime-livedata'\n // Optional - Integration with RxJava\n implementation 'androidx.compose.runtime:runtime-rxjava2'\n\n }\n\n### Kotlin\n\n dependencies {\n\n val composeBom = platform(\"androidx.compose:compose-bom:2025.08.00\")\n implementation(composeBom)\n androidTestImplementation(composeBom)\n\n // Choose one of the following:\n // Material Design 3\n implementation(\"androidx.compose.material3:material3\")\n // or Material Design 2\n implementation(\"androidx.compose.material:material\")\n // or skip Material Design and build directly on top of foundational components\n implementation(\"androidx.compose.foundation:foundation\")\n // or only import the main APIs for the underlying toolkit systems,\n // such as input and measurement/layout\n implementation(\"androidx.compose.ui:ui\")\n\n // Android Studio Preview support\n implementation(\"androidx.compose.ui:ui-tooling-preview\")\n debugImplementation(\"androidx.compose.ui:ui-tooling\")\n\n // UI Tests\n androidTestImplementation(\"androidx.compose.ui:ui-test-junit4\")\n debugImplementation(\"androidx.compose.ui:ui-test-manifest\")\n\n // Optional - Included automatically by material, only add when you need\n // the icons but not the material library (e.g. when using Material3 or a\n // custom design system based on Foundation)\n implementation(\"androidx.compose.material:material-icons-core\")\n // Optional - Add full set of material icons\n implementation(\"androidx.compose.material:material-icons-extended\")\n // Optional - Add window size utils\n implementation(\"androidx.compose.material3.adaptive:adaptive\")\n\n // Optional - Integration with activities\n implementation(\"androidx.activity:activity-compose:1.10.1\")\n // Optional - Integration with ViewModels\n implementation(\"androidx.lifecycle:lifecycle-viewmodel-compose:2.8.5\")\n // Optional - Integration with LiveData\n implementation(\"androidx.compose.runtime:runtime-livedata\")\n // Optional - Integration with RxJava\n implementation(\"androidx.compose.runtime:runtime-rxjava2\")\n\n }\n\n| **Note:** Jetpack Compose is shipped using a Bill of Materials (BOM), to keep the versions of all library groups in sync. Read more about it in the [Bill of\n| Materials page](/develop/ui/compose/bom/bom).\n\nTry Jetpack Compose sample apps\n-------------------------------\n\nThe fastest way to experiment with the capabilities of Jetpack Compose is by\ntrying [Jetpack Compose sample apps](https://github.com/android/compose-samples) hosted on GitHub. To import\na sample app project from Android Studio, proceed as follows:\n\n1. If you're in the **Welcome to Android Studio** window, select **Import an\n Android code sample** . If you already have an Android Studio project open, select **File \\\u003e New \\\u003e Import Sample** from the menu bar.\n2. In the search bar near the top of the **Browse Samples** wizard, type \"compose\".\n3. Select one of the Jetpack Compose sample apps from the search results and click **Next**.\n4. Either change the **Application name** and **Project location** or keep the default values.\n5. Click **Finish**.\n\nAndroid Studio downloads the sample app to the path you specified and opens the\nproject. You can then inspect `MainActivity.kt` in each of the examples to see\nJetpack Compose APIs such as crossfade animation, custom components, using\ntypography, and displaying light and dark colors in the in-IDE preview.\n\nTo use Jetpack Compose for Wear OS, see [Set up Jetpack Compose on Wear OS](/training/wearables/compose-setup).\n\nRecommended for you\n-------------------\n\n- Note: link text is displayed when JavaScript is off\n- [Navigating with Compose](/develop/ui/compose/navigation)\n- [Testing your Compose layout](/develop/ui/compose/testing)\n- [React to focus](/develop/ui/compose/touch-input/focus/react-to-focus)"]]
