원격 Compose

  
원격 Compose는 원격 기기용 UI를 만드는 프레임워크입니다.
최근 업데이트 안정화 버전 출시 후보 버전 베타 버전 알파 버전
2026년 5월 19일 - - - 1.0.0-alpha11

종속 항목 선언

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

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

Groovy

dependencies {
    implementation "androidx.compose.remote:remote-core:1.0.0-alpha11"

    // Use to create Remote Compose documents
    implementation "androidx.compose.remote:remote-creation:1.0.0-alpha11"
    implementation "androidx.compose.remote:remote-creation-core:1.0.0-alpha11"
    implementation "androidx.compose.remote:remote-creation-android:1.0.0-alpha11"
    implementation "androidx.compose.remote:remote-creation-jvm:1.0.0-alpha11"
    implementation "androidx.compose.remote:remote-creation-compose:1.0.0-alpha11"

    // Use to render a Remote Compose document
    implementation "androidx.compose.remote:remote-player-core:1.0.0-alpha11"
    implementation "androidx.compose.remote:remote-player-view:1.0.0-alpha11"

    implementation "androidx.compose.remote:remote-tooling-preview:1.0.0-alpha11"
}

Kotlin

dependencies {
    implementation("androidx.compose.remote:remote-core:1.0.0-alpha11")

    // Use to create Remote Compose documents
    implementation("androidx.compose.remote:remote-creation:1.0.0-alpha11")
    implementation("androidx.compose.remote:remote-creation-core:1.0.0-alpha11")
    implementation("androidx.compose.remote:remote-creation-android:1.0.0-alpha11")
    implementation("androidx.compose.remote:remote-creation-jvm:1.0.0-alpha11")
    implementation("androidx.compose.remote:remote-creation-compose:1.0.0-alpha11")

    // Use to render a Remote Compose document
    implementation("androidx.compose.remote:remote-player-core:1.0.0-alpha11")
    implementation("androidx.compose.remote:remote-player-view:1.0.0-alpha11")

    implementation("androidx.compose.remote:remote-tooling-preview:1.0.0-alpha11")
}

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

의견

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

새로운 문제 제출하기

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

버전 1.0

버전 1.0.0-alpha11

2026년 5월 19일

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

API 변경사항

  • RemoteInt 정적 팩토리를 노출합니다. (Ic0096, b/484137042)
  • RemoteState 정적 팩토리를 노출합니다. (I544f0, b/484137042)
  • RemoteLong은 이제 산술 연산자의 제한된 하위 집합 (덧셈, 뺄셈, 곱셈, RemoteInt로의 자르기 변환)을 지원합니다. (I1d416)
  • FontFamily 대신 RemoteFontFamily를 사용하도록 RemoteText를 업데이트합니다. (Ib76b6, b/502907551)
  • 수정자 알파, 회전, 크기 조정이 추가되었습니다. (I5d682, b/505427444)

버전 1.0.0-alpha010

2026년 5월 6일

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

기능

  • EnforceCleanRecomposition 플래그를 추가합니다. (I6e4408) RemoteCompose에서 리컴포지션을 지원하기 위한 단계로 컴포지션이 완료되기 전에 문서에 쓰기 작업을 하지 못하도록 했습니다. 이렇게 하면 리컴포지션 중에 문서가 부분적으로 작성되는 것을 방지할 수 있습니다. 이 동작으로 인해 기존 코드에 문제가 발생하는 경우 isEnforceCleanRecompositionEnabled를 false로 설정하여 사용 중지할 수 있습니다.

API 변경사항

  • 원격 Compose용 테스트 라이브러리가 추가되었습니다. (I78746, b/504687418)

버그 수정

  • 정적 색상 대신 RemoteColor를 배경 색상으로 사용할 때 배경 클리핑을 수정합니다. (If70842, b/505116577)
  • URI에서 로드된 비트맵의 명시적 크기 제공을 지원합니다. 이전에는 크기가 1x1로 계산되고 해당 픽셀이 컨테이너 크기로 조정되었습니다. (Id4fff, b/487936996)
  • SensorManager가 없는 기기에서 비정상 종료 버그를 방지합니다. (I1fc947,b/498302479)
  • 제공된 시계를 사용하지 않는 TIME_FROM 표현식을 수정합니다 (기간 표현식의 안정적인 테스트 방지). (I5f816, b/501405389)

버전 1.0.0-alpha09

2026년 4월 22일

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

API 변경사항

  • 수정자 클릭 가능이 작업 매개변수의 null 값을 허용하지 않도록 변경되었습니다. 대신 Action.Empty를 사용해야 합니다. (I21be9, b/498881738)
  • 패딩 수정자 매개변수가 왼쪽/오른쪽에서 시작/끝으로 변경되었습니다. (Id781c, b/500760020)
  • 수정자 onTouchDown(varargs action) 및 onTouchUp(varargs action)이 onTouchDown/onTouchUp(action)으로 변경되었습니다. 작업 목록에는 CombinedAction을 사용합니다. (I8af9d, b/498881738)
  • 수정자 clickable(varargs action)이 clickable(action)으로 변경되었습니다. 작업 목록에는 CombinedAction을 사용합니다. (I8432d, b/498881738)

버그 수정

  • MatrixExpression.write를 수정합니다. (Id3c52)

버전 1.0.0-alpha08

2026년 4월 8일

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

새로운 기능

  • CoreText, TextStyle, TextTransform 및 ColorTheme 작업을 기준 AndroidX 및 위젯 프로필로 승격합니다. (I69671, b/494482597)
    • CoreText는 적응형 텍스트 크기 조정을 비롯한 텍스트 렌더링을 위한 다양한 기능을 제공하고 줄바꿈 및 오버플로 동작과 같은 텍스트 레이아웃 기능을 개선합니다.
    • TextStyle을 사용하면 일반적인 텍스트 스타일 지정 속성을 문서에 한 번 캡처하고 여러 텍스트 실행에서 참조할 수 있습니다.
    • TextTransform은 텍스트 변환(예: 텍스트 대문자 표시)을 지원합니다.
  • 레이아웃 방향이 RTL이고 절대 가로 정렬을 사용하지 않는 경우 가로 레이아웃에서 항목의 렌더링을 반전합니다. (I2d38e)

API 변경사항

  • toRemoteString(DecimalFormat)을 개발자 API로 선호합니다. (Ia4925, b/493924433)
  • 수정자 clip(shape, size)가 삭제되었습니다. 대신 수정자 clip(shape)을 사용해야 합니다. (I76301)

버그 수정

  • 배열 요소 변경사항을 추적하도록 TextLookup을 업데이트합니다. 이렇게 하면 배열에서 조회하는 요소가 변경된 경우 표현식이 다시 평가됩니다. (I162c7)

버전 1.0.0-alpha07

2026년 3월 25일

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

새로운 기능

  • 비선형 글꼴 크기 조정을 구현합니다. (73b23c0)
  • 레이아웃이 LayoutDirection을 인식하도록 합니다. (81f984b)

API 변경사항

  • RemoteSpacer를 공개 API로 노출합니다. (I1a540)
  • RemoteBrush applyTo 및 서체 API를 공개합니다. (I87ce9, b/493249631)
  • drawTextOnCircle에서 정렬 및 배치 매개변수를 생략합니다. (I7fd16, b/446824085)
  • 의미 체계 수정자 함수를 노출합니다. (Ice73b)
  • RemoteImageVector 및 painterRemoteVector를 노출합니다. (If8f38, b/446824085)
  • remote-creation-compose에서 RemoteTimeDefaults를 공개 API로 노출합니다. (Iddc74, b/446824085)
  • RemoteArrangement.spacedBy 메서드를 공개합니다. (I36e86)
  • 더 많은 RemoteDrawScope API를 노출합니다. (I1dde7)
  • API에서 RemotePainter 유형을 노출합니다. (I1ec8e)
  • RemoteBrush API를 노출합니다. (I4b074)
  • RemoteCanvas의 최소 공개 API (I00853, b/446824085)
  • RC 시맨틱스 수정자를 노출합니다. (I8b175, b/446824085)
  • RemoteFloat.asRemoteDp()를 노출합니다. (I28b36, b/446824085)
  • RemoteFloat 작업을 노출합니다. (I85fb5, b/446824085)
  • RemoteArrangement.CenterHorizontally가 삭제되고 RemoteArrangement.Center로 대체되었습니다. (I2f907, b/471212869, b/471153933)
  • 단일 RemoteAlignment를 허용하도록 RemoteBox 정렬을 변경합니다. (I0bfbf, b/471212869)

버전 1.0.0-alpha06

2026년 3월 11일

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

새로운 기능

  • TextStyle의 새로운 실험용 작업을 추가합니다. TextStyle을 사용하면 흔히 사용되는 서체 스타일 지정을 문서에 한 번 작성하고 여러 텍스트 실행에서 재사용할 수 있습니다. (bfc6487)

API 변경사항

  • RemoteTextStyle 병합을 노출합니다. (I971ce, b/446824085)
  • RemotePainter를 공개 API로 노출합니다. (I252c1, b/446824085)
  • Border/Clip 수정자 및 RemoteShape를 노출합니다. (Id26dd, b/446824085)
  • remote-creation-compose에서 RemoteColor API를 노출합니다. (I4ab00, b/446824085)
  • RemoteText API를 노출합니다. (I6b019)
  • RemoteImage API를 노출합니다. (Ided31)
  • RemoteBoolean, RemoteString, RemoteFloat API를 노출합니다. (Id9ee6)
  • WidthIn 주석의 원격 컴포저블 (I80784)

버그 수정

  • Java 11 타겟을 사용하도록 라이브러리를 이동합니다. 즉, 생성된 바이트 코드는 Java 11 (클래스 파일 버전 55)이며 라이브러리를 사용하려면 디슈가링이 필요할 수 있습니다. (If4c2a, b/457821470)
    • 길이와 textlookup이 올바르게 업데이트되는지 확인합니다. 이전에는 RemoteStrings의 길이가 첫 번째 프레임에서 계산되고 이후에는 업데이트되지 않았습니다. (e49cb53)
    • 소수점 이하 자릿수가 많은 숫자의 TextFromFloat를 지원합니다. 이전에는 'digitsAfter' 값이 크면 부동 소수점이 0으로 평가될 수 있었습니다. (5080bc54)

버전 1.0.0-alpha05

2026년 2월 25일

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

새로운 기능

  • fillParentMaxWidth 및 fillParentMaxHeight를 도입했습니다. (4c6d77c)

API 변경사항

  • 일반적인 원격 컴포저블 및 수정자 유형을 노출합니다. Id1d40
  • RemoteState의 유형을 노출합니다. (I22429, b/465453482)

버그 수정

  • 스크롤 수정 (0a25299)
  • 터치 슬롭 수정 (0192b69)
  • 렌더링 프로세스에서 밀도를 더 일찍 설정하여 첫 번째 프레임(스크린샷 테스트에서 자주 캡처됨)에 올바르게 적용되도록 합니다. f775399

버전 1.0.0-alpha04

2026년 2월 11일

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

새로운 기능

  • 원격 UI를 만들 때 원격이 아닌 컴포저블 함수를 사용하지 못하도록 기본적으로 RemoteApplier를 사용하도록 설정합니다. RemoteComposeCreationComposeFlags에서 isRemoteApplierEnabled를 변경하여 사용 중지할 수 있습니다. (67a405f)
  • 비트맵 글꼴의 글리프 간격을 추가합니다. (0852657)
  • RemoteCanvas에서 피벗으로 회전합니다. (9a292b3)
  • RemoteSpacer를 추가합니다. (12beb72)
  • java.time 종속 항목을 방지하여 생성 라이브러리의 minSdk를 23으로 낮출 수 있습니다. (59e30d0)
  • FlowLayout (7efef02)

버그 수정

  • 전역이 아닌 ColorExpression 및 계산된 문자열의 평가를 수정합니다. (c08d0bd)

외부 기여

  • androidx.compose.ui.graphics.NativePaint typealias가 지원 중단되었습니다. 대신 android.graphics.Paint를 직접 사용하세요. (I6303c, b/477394763)
  • Paint.asFrameworkPaint()를 Paint.nativePaint 확장으로 바꾸어 typealias를 통해 플랫폼 유형이 commonMain 소스 세트에 노출되지 않도록 합니다. (I6303c, b/477394763)

버전 1.0.0-alpha03

2026년 1월 28일

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

새로운 기능

  • BorderModifier에서 다양한 도형 및 RemoteColors 지원 0afd343
  • 클릭 이벤트에서 여러 작업을 지원하도록 CombinedAction 추가 10e16a2

API 변경사항

  • Android 유형을 직접 노출하는 대신 Compose 유형을 사용하도록 RemoteColor 및 RemoteBitmap의 API를 이전했습니다. a9bfbb8
  • 원격 기기용 문서를 생성할 때 플레이어에서 밀도를 평가할지 아니면 표현식을 인라인할지(동일한 기기에서 문서 크기를 최적화하기 위해) 결정할 수 있도록 RemoteDensity 유형을 도입합니다. 54352bb
  • RemoteState constantValueOrNull 이름 바꾸기 (I6ad5c, b/467050397)

버전 1.0.0-alpha02

2026년 1월 14일

androidx.compose.remote:remote-*:1.0.0-alpha02이 출시되었습니다. 버전 1.0.0-alpha02에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

  • CoreText의 최소/최대 글꼴 크기를 추가합니다. I7bd3c

API 변경사항

  • Glance Wear 인프라의 최소 공개 API를 노출합니다. (I7b4b9, b/467532762)
  • captureSingleRemoteDocument에서 CapturedDocument를 반환합니다. (I5a283, b/467532762)

버그 수정

  • 레이아웃 변경 후 스크롤 위치를 수정하고 가장자리 효과 지원을 추가합니다. (6d4551)

버전 1.0.0-alpha01

2025년 12월 17일

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

  • 원격 Compose는 원격 기기용 UI를 만드는 프레임워크입니다.