마지막으로 Compose BOM과 필요한 Compose 라이브러리 종속 항목의 하위 집합을 다음 블록의 종속 항목에 추가합니다.
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")}
Jetpack Compose 샘플 앱 사용해 보기
Jetpack Compose의 기능을 실험하는 가장 빠른 방법은 GitHub에서 호스팅되는 Jetpack Compose 샘플 앱을 사용해 보는 것입니다. Android 스튜디오에서 샘플 앱 프로젝트를 가져오려면 다음 단계에 따라 진행하세요.
Welcome to Android Studio 창에 있다면 Import an Android code sample을 선택합니다. 이미 Android 스튜디오 프로젝트가 열려 있다면 메뉴 바에서 File > New > Import Sample을 선택합니다.
Browse Samples 마법사 상단 근처의 검색창에 'compose'를 입력합니다.
검색결과에서 Jetpack Compose 샘플 앱 중 하나를 선택하고 Next를 클릭합니다.
Application name 및 Project location을 변경하거나 기본값을 유지합니다.
Finish를 클릭합니다.
Android 스튜디오는 지정된 경로로 샘플 앱을 다운로드하고 프로젝트를 엽니다. 그런 다음 각 예의 MainActivity.kt를 검사하여 IDE 내 미리보기에서 크로스페이드 애니메이션, 맞춤 구성요소, 타이포그래피 사용, 밝은 색상과 어두운 색상 표시와 같은 Jetpack Compose API를 확인할 수 있습니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-08-21(UTC)
[null,null,["최종 업데이트: 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)"]]
