Compose 컴파일러

API 참조
androidx.compose
(모든 Compose 패키지는 API 참조 문서 참고)

Kotlin 컴파일러 플러그인으로 최적화를 사용 설정하고 @Composable 함수를 변환합니다.

최근 업데이트	공개 버전	출시 후보	베타 버전	알파 버전
2022년 6월 1일	1.1.1	-	1.2.0-beta03	-

구조

Compose는 androidx 내의 Maven 그룹 ID 7개의 조합입니다. 각 그룹에는 타겟팅된 일부 기능이 포함되고 각 기능에는 자체 출시 노트 조합이 있습니다.

다음 표에서는 그룹에 관한 설명과 각 출시 노트 조합의 링크를 제시합니다.

그룹	설명
compose.animation	Jetpack Compose 애플리케이션에서 애니메이션을 빌드하여 사용자 환경에 풍부함을 더합니다.
compose.compiler	Kotlin 컴파일러 플러그인으로 최적화를 사용 설정하고 @Composable 함수를 변환합니다.
compose.foundation	즉시 사용 가능한 기본 구성요소를 사용해 Jetpack Compose 애플리케이션을 작성하고 토대를 확장해 나만의 디자인 시스템을 구축하세요.
compose.material	즉시 사용 가능한 Material Design 구성요소로 Jetpack Compose UI를 빌드합니다. 이는 Compose를 고급 수준에서 사용하는 첫 단계이며, www.material.io에 설명된 것과 동일한 구성요소를 제공합니다.
compose.material3	차세대 Material Design인 Material Design 3 구성요소로 Jetpack Compose UI를 빌드합니다. Material 3은 업데이트된 테마 설정 및 구성요소, Material You 맞춤설정 기능(동적 색상 등)을 포함하며 새로운 Android 12의 시각적 스타일 및 시스템 UI와 일관되도록 설계되었습니다.
compose.runtime	Compose의 프로그래밍 모델과 상태 관리를 위한 기본 구성요소 및 타겟팅용 Compose 컴파일러 플러그인 핵심 런타임입니다.
compose.ui	레이아웃, 그리기, 입력 등 기기와 상호작용할 때 필요한 Compose UI의 기본적인 구성요소입니다.

종속 항목 선언

Compose의 종속 항목을 추가하려면 프로젝트에 Google Maven 저장소를 추가해야 합니다. 자세한 내용을 알아보려면 Google Maven 저장소를 읽어보세요.

다음과 같이 앱 또는 모듈의 build.gradle 파일에 필요한 아티팩트의 종속 항목을 추가합니다.

Groovy

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.2.0-rc01"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.2.0-rc01"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

종속 항목에 관한 자세한 내용은 빌드 종속 항목 추가를 참고하세요.

의견

제출하신 의견은 Jetpack을 개선하는 데 도움이 됩니다. 새로운 문제를 발견하거나 라이브러리 개선을 위한 아이디어가 있다면 Google에 알려 주세요. 새 문제를 제출하기 전에 이 라이브러리의 기존 문제를 살펴보시기 바랍니다. 별표 버튼을 클릭하여 기존 문제에 투표할 수 있습니다.

새로운 문제 제출하기

자세한 내용은 Issue Tracker 문서를 참고하세요.

버전 1.2

버전 1.2.0-beta03

2022년 6월 1일

androidx.compose.compiler:compiler:1.2.0-beta03이 출시되었습니다. 버전 1.2.0-beta03에 포함된 커밋을 확인하세요.

버전 1.2.0-beta02

2022년 5월 18일

androidx.compose.compiler:compiler:1.2.0-beta02가 출시되었습니다. 버전 1.2.0-beta02에 포함된 커밋을 확인하세요.

버전 1.2.0-beta01

2022년 5월 11일

androidx.compose.compiler:compiler:1.2.0-beta01이 출시되었습니다. 버전 1.2.0-beta01에 포함된 커밋을 확인하세요.

이 출시는 1.2의 첫 번째 베타 출시입니다. 마지막 알파 이후 변경사항이 없습니다.

새로운 기능

Kotlin 1.6.21 지원을 추가했습니다.

버전 1.2.0-alpha08

2022년 4월 20일

androidx.compose.compiler:compiler:1.2.0-alpha08이 출시되었습니다. 버전 1.2.0-alpha08에 포함된 커밋을 확인하세요.

버전 1.2.0-alpha07

2022년 4월 6일

androidx.compose.compiler:compiler:1.2.0-alpha07이 출시되었습니다. 버전 1.2.0-alpha07에 포함된 커밋을 확인하세요.

버전 1.2.0-alpha06

2022년 3월 23일

androidx.compose.compiler:compiler:1.2.0-alpha06이 출시되었습니다. 버전 1.2.0-alpha06에 포함된 커밋을 확인하세요.

버전 1.2.0-alpha05

2022년 3월 9일

androidx.compose.compiler:compiler:1.2.0-alpha05가 출시되었습니다. 버전 1.2.0-alpha05에 포함된 커밋을 확인하세요.

버전 1.2.0-alpha04

2022년 2월 23일

androidx.compose.compiler:compiler:1.2.0-alpha04가 출시되었습니다. 버전 1.2.0-alpha04에 포함된 커밋을 확인하세요.

버전 1.2.0-alpha03

2022년 2월 9일

androidx.compose.compiler:compiler:1.2.0-alpha03이 출시되었습니다. 버전 1.2.0-alpha03에 포함된 커밋을 확인하세요.

버전 1.2.0-alpha02

2022년 1월 26일

androidx.compose.compiler:compiler:1.2.0-alpha02가 출시되었습니다. 버전 1.2.0-alpha02에 포함된 커밋을 확인하세요.

버전 1.2.0-alpha01

2022년 1월 12일

androidx.compose.compiler:compiler:1.2.0-alpha01이 출시되었습니다. 버전 1.2.0-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

Kotlin 1.6.10 지원이 추가되었습니다.

버전 1.1

버전 1.1.1

2022년 2월 23일

androidx.compose.compiler:compiler:1.1.1이 출시되었습니다. 버전 1.1.1에 포함된 커밋을 확인하세요.

버그 수정

androidx.compose.ui.platform.RenderNodeLayer.updateDisplayList에서 발생하는 NullPointerException을 수정합니다. (aosp/1947059, b/206677462)
Android에서 클립보드를 읽는 동안 클립보드 콘텐츠로 인해 발생하는 비정상 종료 문제를 해결했습니다. (I06020, b/197769306)
LazyVerticalGrid의 RTL을 수정했습니다. (aosp/1931080, b/207510535)

버전 1.1.0

2022년 2월 9일

androidx.compose.compiler:compiler:1.1.0이 출시되었습니다. 버전 1.1.0에 포함된 커밋을 확인하세요.

1.0.0 이후 중요 변경사항

Android 12 오버스크롤 효과의 공개 버전 지원
터치 영역 크기 조정 개선
Compose 1.0의 경우 머티리얼 구성요소는 머티리얼 접근성 가이드라인 터치 영역 크기에 맞게 레이아웃 공간을 확장합니다. 예를 들어 버튼의 크기를 더 작게 설정하더라도 버튼 터치 영역은 최소 48x48dp로 확장됩니다. 이렇게 하면 Compose Material이 머티리얼 디자인 구성요소의 동작과 동일하게 정렬되어 뷰와 Compose를 함께 사용할 때 일관되게 동작합니다. 또한 Compose Material 구성요소를 사용하여 UI를 만들 때 이러한 변경을 통해 터치 영역 접근성에 관한 최소 요구사항이 충족됩니다.
Navigation Rail의 공개 버전 지원
다수의 이전 실험용 API의 공개 버전 전환
최신 버전의 Kotlin 지원

버전 1.1.0-rc03

2022년 1월 26일

androidx.compose.compiler:compiler:1.1.0-rc03이 출시되었습니다. 버전 1.1.0-rc03에 포함된 커밋을 확인하세요.

버그 수정

Compose Material 1.1.0-rc03을 지원하도록 업데이트했습니다.

버전 1.1.0-rc02

2021년 12월 16일

androidx.compose.compiler:compiler:1.1.0-rc02가 출시되었습니다. 버전 1.1.0-rc02에 포함된 커밋을 확인하세요.

종속 항목 업데이트

Compose Compiler 1.1.0-rc02가 Kotlin 1.6.10과 호환됩니다.

버전 1.1.0-rc01

2021년 12월 15일

androidx.compose.compiler:compiler:1.1.0-rc01이 출시되었습니다. 버전 1.1.0-rc01에 포함된 커밋을 확인하세요.

종속 항목 변경사항

Compose Compiler 1.1.0-rc01이 Kotlin 1.6.0과 호환됩니다.
buildId 8003490인 androidx.dev SNAPSHOT을 통해 호환되는 1.6.10 빌드를 사용할 수 있습니다. 다음 종속 항목 스니펫은 Compose 컴파일러의 SNAPSHOT을 구성합니다.

프로젝트의 루트 build.gradle 파일에 다음 스니펫을 추가합니다.
```
buildscript {
    repositories {
        google()
        jcenter()
        maven { url 'https://androidx.dev/snapshots/builds/8003490/artifacts/repository' }
    }
}
```
Compose를 사용하는 앱 또는 모듈의 build.gradle 파일에 다음 스니펫을 추가합니다.
```
android {
    composeOptions {
        kotlinCompilerExtensionVersion = "1.2.0-SNAPSHOT"
    }
}
```

버전 1.1.0-beta04

2021년 12월 1일

androidx.compose.compiler:compiler:1.1.0-beta04가 출시되었습니다. 버전 1.1.0-beta04에 포함된 커밋을 확인하세요.

새로운 기능

Kotlin 1.6.0과 호환되도록 업데이트되었습니다.

버전 1.1.0-beta03

2021년 11월 17일

androidx.compose.compiler:compiler:1.1.0-beta03이 출시되었습니다. 버전 1.1.0-beta03에 포함된 커밋을 확인하세요.

버전 1.1.0-beta02

2021년 11월 3일

androidx.compose.compiler:compiler:1.1.0-beta02가 출시되었습니다. 버전 1.1.0-beta02에 포함된 커밋을 확인하세요.

버전 1.1.0-beta01

2021년 10월 27일

androidx.compose.compiler:compiler:1.1.0-beta01이 출시되었습니다. 버전 1.1.0-beta01에 포함된 커밋을 확인하세요.

버전 1.1.0-alpha06

2021년 10월 13일

androidx.compose.compiler:compiler:1.1.0-alpha06이 출시되었습니다. 버전 1.1.0-alpha06에 포함된 커밋을 확인하세요.

버전 1.1.0-alpha05

2021년 9월 29일

androidx.compose.compiler:compiler:1.1.0-alpha05가 출시되었습니다. 버전 1.1.0-alpha05에 포함된 커밋을 확인하세요.

버전 1.1.0-alpha04

2021년 9월 15일

androidx.compose.compiler:compiler:1.1.0-alpha04가 출시되었습니다. 버전 1.1.0-alpha04에 포함된 커밋을 확인하세요.

버전 1.1.0-alpha03

2021년 9월 1일

androidx.compose.compiler:compiler:1.1.0-alpha03이 출시되었습니다. 버전 1.1.0-alpha03에 포함된 커밋을 확인하세요.

새로운 기능

이제 Compose 컴파일러가 이전 버전의 Compose Runtime(1.0)을 지원합니다. 이 변경 전에 Compose 컴파일러는 같은 버전 이상의 Compose Runtime과만 호환되었습니다. 이 변경 후에는 Compose 컴파일러가 이전 버전의 Compose Runtime(1.0)과 호환됩니다. (aosp/1796968)
Kotlin 1.5.30에 종속되도록 Compose 1.1.0-alpha03을 업데이트했습니다. (I74545)

버전 1.1.0-alpha02

2021년 8월 18일

androidx.compose.compiler:compiler:1.1.0-alpha02가 출시되었습니다. 버전 1.1.0-alpha02에 포함된 커밋을 확인하세요.

버전 1.1.0-alpha01

2021년 8월 4일

androidx.compose.compiler:compiler:1.1.0-alpha01이 출시되었습니다. 버전 1.1.0-alpha01에 포함된 커밋을 확인하세요.

버전 1.0

버전 1.0.5

2021년 11월 3일

androidx.compose.compiler:compiler:1.0.5가 출시되었습니다. 버전 1.0.5에 포함된 커밋을 확인하세요.

버그 수정

derivedStateOf 인스턴스를 추적할 때 발생하는 비정상 종료 문제를 수정했습니다. (aosp/1792247)

버전 1.0.4

2021년 10월 13일

androidx.compose.compiler:compiler:1.0.4가 출시되었습니다. 버전 1.0.4에 포함된 커밋을 확인하세요.

종속 항목 업데이트

Kotlin 1.5.31에 종속되도록 업데이트했습니다.

버전 1.0.3

2021년 9월 29일

androidx.compose.compiler:compiler:1.0.3이 출시되었습니다. 버전 1.0.3에 포함된 커밋을 확인하세요.

종속 항목 업데이트

Kotlin 1.5.30에 종속되도록 업데이트했습니다.

버전 1.0.2

2021년 9월 1일

androidx.compose.compiler:compiler:1.0.2가 출시되었습니다. 버전 1.0.2에 포함된 커밋을 확인하세요.

Compose 1.0.2 출시를 지원하도록 업데이트되었습니다. Compose 1.0.2는 여전히 Kotlin 1.5.21과 호환됩니다.

버전 1.0.1

2021년 8월 4일

androidx.compose.compiler:compiler:1.0.1이 출시되었습니다. 버전 1.0.1에 포함된 커밋을 확인하세요.

종속 항목 업데이트

Kotlin 1.5.21에 종속되도록 업데이트했습니다.

버전 1.0.0

2021년 7월 28일

androidx.compose.compiler:compiler:1.0.0이 출시되었습니다. 버전 1.0.0에 포함된 커밋을 확인하세요.

1.0.0의 주요 기능

Compose의 첫 번째 공개 버전입니다. 자세한 내용은 공식 Compose 출시 블로그를 참고하세요.

버전 1.0.0-rc02

2021년 7월 14일

androidx.compose.compiler:compiler:1.0.0-rc02가 출시되었습니다. 버전 1.0.0-rc02에 포함된 커밋을 확인하세요.

버전 1.0.0-rc01

2021년 7월 1일

androidx.compose.compiler:compiler:1.0.0-rc01이 출시되었습니다. 버전 1.0.0-rc01에 포함된 커밋을 확인하세요.

버전 1.0.0-beta09

2021년 6월 16일

androidx.compose.compiler:compiler:1.0.0-beta09가 출시되었습니다. 버전 1.0.0-beta09에 포함된 커밋을 확인하세요.

버전 1.0.0-beta08

2021년 6월 2일

androidx.compose.compiler:compiler:1.0.0-beta08이 출시되었습니다. 버전 1.0.0-beta08에 포함된 커밋을 확인하세요.

버전 1.0.0-beta07

2021년 5월 18일

androidx.compose.compiler:compiler:1.0.0-beta07이 출시되었습니다. 버전 1.0.0-beta07에 포함된 커밋을 확인하세요.

버전 1.0.0-beta06

2021년 5월 5일

androidx.compose.compiler:compiler:1.0.0-beta06이 출시되었습니다. 버전 1.0.0-beta06에 포함된 커밋을 확인하세요.

버전 1.0.0-beta05

2021년 4월 21일

androidx.compose.compiler:compiler:1.0.0-beta05가 출시되었습니다. 버전 1.0.0-beta05에 포함된 커밋을 확인하세요.

버전 1.0.0-beta04

2021년 4월 7일

androidx.compose.compiler:compiler:1.0.0-beta04가 출시되었습니다. 버전 1.0.0-beta04에 포함된 커밋을 확인하세요.

버전 1.0.0-beta03

2021년 3월 24일

androidx.compose.compiler:compiler:1.0.0-beta03이 출시되었습니다. 버전 1.0.0-beta03에 포함된 커밋을 확인하세요.

버전 1.0.0-beta02

2021년 3월 10일

androidx.compose.compiler:compiler:1.0.0-beta02가 출시되었습니다. 버전 1.0.0-beta02에 포함된 커밋을 확인하세요.

버전 1.0.0-beta01

2021년 2월 24일

androidx.compose.compiler:compiler:1.0.0-beta01이 출시되었습니다. 버전 1.0.0-beta01에 포함된 커밋을 확인하세요.

Compose 1.0.0 베타의 첫 번째 버전입니다.

버전 1.0.0-alpha12

2021년 2월 10일

androidx.compose.compiler:compiler:1.0.0-alpha12가 출시되었습니다. 버전 1.0.0-alpha12에 포함된 커밋을 확인하세요.

버전 1.0.0-alpha11

2021년 1월 28일

androidx.compose.compiler:compiler:1.0.0-alpha11이 출시되었습니다. 버전 1.0.0-alpha11에 포함된 커밋을 확인하세요.

버전 1.0.0-alpha10

2021년 1월 13일

androidx.compose.compiler:compiler:1.0.0-alpha10이 출시되었습니다. 버전 1.0.0-alpha10에 포함된 커밋을 확인하세요.

버전 1.0.0-alpha09

2020년 12월 16일

androidx.compose.compiler:compiler:1.0.0-alpha09가 출시되었습니다. 버전 1.0.0-alpha09에 포함된 커밋을 확인하세요.

버전 1.0.0-alpha08

2020년 12월 2일

androidx.compose.compiler:compiler:1.0.0-alpha08이 출시되었습니다. 버전 1.0.0-alpha08에 포함된 커밋을 확인하세요.

버전 1.0.0-alpha07

2020년 11월 11일

androidx.compose.compiler:compiler:1.0.0-alpha07이 출시되었습니다. 버전 1.0.0-alpha07에 포함된 커밋을 확인하세요.

새로운 기능

안정성 추론 및 전파. Compose 컴파일러 플러그인은 컴파일하는 유형을 분석하여 런타임에 특정 최적화를 적용할 수 있는지 추론합니다. 이렇게 추론된 결과는 다른 모듈의 컴파일러에서 활용할 클래스에 메타데이터로 합성됩니다. 또한 이러한 추론의 런타임 결과는 컴포지션 중에 구성 가능한 호출에 전달된 메타데이터로 전달됩니다. 따라서 구성 가능한 함수의 다른 메타데이터 프로토콜이 필요했습니다. 즉, alpha07 컴파일러로 컴파일된 구성 가능한 함수가 이전 컴파일러 버전으로 컴파일된 구성 가능한 함수와 호환되는 바이너리가 아닙니다. (aosp/1431988)

버전 1.0.0-alpha06

2020년 10월 28일

androidx.compose.compiler:compiler:1.0.0-alpha06이 출시되었습니다. 버전 1.0.0-alpha06에 포함된 커밋을 확인하세요.

버전 1.0.0-alpha05

2020년 10월 14일

androidx.compose.compiler:compiler:1.0.0-alpha05가 출시되었습니다. 버전 1.0.0-alpha05에 포함된 커밋을 확인하세요.

버전 1.0.0-alpha04

2020년 10월 1일

androidx.compose.compiler:compiler:1.0.0-alpha04가 출시되었습니다. 버전 1.0.0-alpha04에 포함된 커밋을 확인하세요.

androidx.compose:compose-compiler가 androidx.compose.compiler:compiler로 리팩터링되었습니다. 새 그룹의 첫 번째 버전입니다.