앱용 Compose 코드를 작성하거나 Compose 라이브러리 및 API를 빌드하는 경우 권장사항에 따라 코드를 확장 가능하고 성능이 우수하며 나머지 생태계와 일관되도록 만드세요.
다음 문서는 Compose를 사용하는 코드를 작성하는 모든 사용자를 위한 가이드라인을 제공합니다.
- Jetpack Compose의 API 가이드라인: Jetpack Compose 컴파일러 플러그인 및 런타임을 사용하는 모든 시스템에 관한 패턴, 권장사항, 규정 스타일 가이드라인을 간략히 설명합니다. 여기에는 다음 주제가 포함됩니다.
- Kotlin 코딩 규칙에 기반한 Compose용 Kotlin 스타일 가이드라인
- Compose 런타임 기능을 기반으로 빌드되는
@Composable함수 및 API에 관한 안내 - Compose UI 도구 키트를 사용하고 확장하는 API를 위한 가이드라인
- Compose API를 설계할 때 사용 사례를 해결하기 위한 패턴
- Jetpack Compose의
@Composable구성요소용 API 가이드라인: 다음 주제를 비롯하여@ComposableUI 구성요소를 만들고 사용하는 방법에 관한 가이드라인과 권장사항을 제공합니다.- 구성요소 만들기 및 레이어링
- 새 구성요소 이름 지정
- 구성요소 종속 항목 표현
@Composable구성요소의 매개변수- 구성요소 관련 클래스 및 함수를 만들기 위한 올바른 패턴 따르기
@Composable구성요소 문서화- 구성요소의 접근성 개선
- 하위 호환성을 유지하면서 구성요소 API 업데이트
대상
이 가이드라인은 다음 세 가지 잠재고객을 대상으로 작성되었습니다.
- Jetpack Compose를 기반으로 앱을 빌드하는 개발자 앱의 일부에서 Jetpack Compose를 사용하는 경우 이 그룹에 속합니다.
- Jetpack Compose 프레임워크 개발을 담당하는 개발자
androidx.compose라이브러리에 기여하는 경우 이 그룹에 속하게 됩니다. - Jetpack Compose를 기반으로 라이브러리를 만드는 개발자 Compose API 또는 Compose UI 요소의 라이브러리를 만드는 경우 이 그룹에 속합니다. 이러한 Compose 구성요소 라이브러리는 공개적으로 제공되거나 회사 또는 팀에 로컬로 제공될 수 있습니다.
속한 그룹에 따라 스타일 가이드라인마다 엄격도 수준이 다릅니다. 예를 들어 Jetpack Compose 프레임워크 개발은 일반적으로 이러한 가이드라인을 가장 엄격하게 준수합니다.
각 개발자 대상의 요구사항에 관한 자세한 내용은 RFC2119를 참고하세요.
프레임워크 및 가이드라인에 기여
androidx 코드베이스의 일부 라이브러리와 스타일 가이드라인 (Compose API 가이드라인 및 @Composable 구성요소 가이드라인) 자체에 대한 기여는 언제나 환영합니다.
참여하려면 androidx 참여 가이드의 안내를 따르세요.