Glance Wear

  
Glance Wear는 Wear OS용 위젯을 빌드하기 위한 라이브러리입니다.
최근 업데이트 안정화 버전 출시 후보 버전 베타 버전 알파 버전
2026년 9월 23일 - - - 1.0.0-alpha19

종속 항목 선언

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

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

Groovy

dependencies {
    implementation "androidx.glance.wear:wear:1.0.0-alpha19"

    implementation "androidx.glance.wear:wear-core:1.0.0-alpha19"
}

Kotlin

dependencies {
    implementation("androidx.glance.wear:wear:1.0.0-alpha19")

    implementation("androidx.glance.wear:wear-core:1.0.0-alpha19")
}

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

의견

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

새로운 문제 제출하기

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

Glance Wear 버전 1.0

버전 1.0.0-alpha19

2026년 9월 23일

androidx.glance.wear:wear:1.0.0-alpha19, androidx.glance.wear:wear-core:1.0.0-alpha19 및 androidx.glance.wear:wear-tooling-preview:1.0.0-alpha19이 출시되었습니다. 버전 1.0.0-alpha19에는 이러한 커밋이 포함되어 있습니다.

내부 테스트 변경사항만 있습니다.

버전 1.0.0-alpha18

2026년 9월 9일

androidx.glance.wear:wear:1.0.0-alpha18, androidx.glance.wear:wear-core:1.0.0-alpha18 및 androidx.glance.wear:wear-tooling-preview:1.0.0-alpha18이 출시되었습니다. 버전 1.0.0-alpha18에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • 이전 호스트에서 지원되는 작업의 안전한 대체 집합으로 위젯을 미리 볼 수 있도록 WearWidgetPreview에 useSafeFallbackRendererVersion 매개변수가 추가되었습니다. (I9c324)

버그 수정

  • Compose 라이브러리의 compileSdk가 37.1로 업데이트되었습니다. 이렇게 하면 Compose를 사용하는 모든 앱과 라이브러리의 compileSdk가 전이적으로 업데이트됩니다. (I05b0f)
  • Wear 위젯에서 중복된 fontFamily 매개변수 사용을 경고하는 린트 검사를 추가했습니다. (I7730c)

버전 1.0.0-alpha17

2026년 8월 26일

androidx.glance.wear:wear:1.0.0-alpha17, androidx.glance.wear:wear-core:1.0.0-alpha17 및 androidx.glance.wear:wear-tooling-preview:1.0.0-alpha17이 출시되었습니다. 버전 1.0.0-alpha17에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

  • 위젯 메타데이터의 <wearwidget-provider> XML에 있는 각 <container>가 지원되는 유형 속성을 명시적으로 지정하고 중복 유형을 정의하지 않도록 강제하는 Glance Wear에 린트 검사를 추가했습니다. (I52c9a, b/464458215)

버전 1.0.0-alpha16

2026년 8월 12일

androidx.glance.wear:wear:1.0.0-alpha16, androidx.glance.wear:wear-core:1.0.0-alpha16 및 androidx.glance.wear:wear-tooling-preview:1.0.0-alpha16이 출시되었습니다. 버전 1.0.0-alpha16에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

  • 필수 구성 요소 (예: container 및 previewImage)가 있는지 확인하기 위해 <wearwidget-provider> XML 메타데이터의 린트 유효성 검사를 추가했습니다. (Ia9983, b/464458215)
  • Wear 위젯에 검은색 또는 투명 배경을 설정하는 경우 린트 오류 경고가 추가되었습니다. (Idedb0, b/529269573)
  • Wear 위젯 프로필의 CORE_TEXT 원격 Compose 작업을 사용 설정했습니다. 이를 통해 RemoteText는 지원되는 호스트 렌더러에서 글꼴 축, 행 간격 등과 같은 가변 글꼴 기능을 사용할 수 있으며, 지원되지 않는 경우 자동으로 대체됩니다.

해결된 문제

  • 개발자 의견에 따라 AssociateWithGlanceWearWidget 주석의 KDocs 업데이트

버전 1.0.0-alpha15

2026년 7월 29일

androidx.glance.wear:wear:1.0.0-alpha15, androidx.glance.wear:wear-core:1.0.0-alpha15 및 androidx.glance.wear:wear-tooling-preview:1.0.0-alpha15이 출시되었습니다. 버전 1.0.0-alpha15에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

  • Wear 위젯 문서에 빈 배경을 설정할 때 린트 경고가 추가되었습니다. (Ic6475, b/529269573)

버전 1.0.0-alpha14

2026년 7월 15일

androidx.glance.wear:wear:1.0.0-alpha14, androidx.glance.wear:wear-core:1.0.0-alpha14 및 androidx.glance.wear:wear-tooling-preview:1.0.0-alpha14이 출시되었습니다. 버전 1.0.0-alpha14에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • 완전히 둥근 Glance Wear 위젯을 위한 RoundAllWidgetPreviewParams, RoundSmallWidgetPreviewParams, RoundLargeWidgetPreviewParams 미리보기 매개변수 제공자를 추가했습니다. (If5336, b/512405233)

새로운 기능

  • Glance Wear 위젯용 Linter 라이브러리를 설정하고 추가했습니다(If4218, b/527402079).
    • GlanceWearWidgetService의 하위 클래스가 @AssociateWithGlanceWearWidget 주석을 사용하여 연결된 위젯 클래스를 명시적으로 선언하도록 하는 린트 검사를 추가했습니다. (Idc575, b/477024153)
  • WearWidgetParams를 통해 지원되는 작업을 전파하고 허용된 작업의 프로필을 이러한 작업에 필터링하여 이전 호스트에서 실행되는 위젯의 하위 호환성을 개선했습니다. (Ib0a1b, I83cb1, [b/526716195])

버전 1.0.0-alpha13

2026년 7월 1일

androidx.glance.wear:wear:1.0.0-alpha13, androidx.glance.wear:wear-core:1.0.0-alpha13 및 androidx.glance.wear:wear-tooling-preview:1.0.0-alpha13이 출시되었습니다. 버전 1.0.0-alpha13에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

버그 수정

  • UX 의견에 따라 미리보기를 위해 Squircle 모양의 Wear 위젯 매개변수를 조정했습니다.

버전 1.0.0-alpha12

2026년 6월 17일

androidx.glance.wear:wear:1.0.0-alpha12, androidx.glance.wear:wear-core:1.0.0-alpha12 및 androidx.glance.wear:wear-tooling-preview:1.0.0-alpha12이 출시되었습니다. 버전 1.0.0-alpha12에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

  • GlanceWearWidgetService에서 사용되어 GlanceWearWidget의 어떤 구현과 연결되어 있는지 제공해야 하는 AssociateWithGlanceWearWidget 추가 (Ifcabb, b/514679763)

    • 예를 들면 다음과 같습니다.
     @AssociateWithGlanceWearWidget(MyGlanceWearWidget::class)
 class MyGlanceWearWidgetService : GlanceWearWidgetService() {
   override val widget = MyGlanceWearWidget()
 }
 ```

  • Wear 위젯에서 비트맵 배경을 지원하기 위해 WearWidgetBrush에 image 브러시를 추가했습니다. (I9a228, b/513481558)

  • IDE 미리보기에 필요한 상용구를 삭제하여 Glance Wear 위젯 개발을 간소화하기 위해 @Composable 도우미 함수 WearWidgetPreview가 도입되었습니다.

API 변경사항

  • androidx.glance.wear.health.DataType의 이름을 androidx.glance.wear.health.HealthData로 바꿨습니다. (I4cb0b, b/516746689)
  • isHeartRateBpmAvailable는 호스트에서 heartRateBpm를 사용할 수 있는지 확인하기 위해 노출됩니다. (I5999d, b/514641567)
  • RemoteInt 비교 연산자가 노출되었습니다. (I5fe3d, b/513228889)
  • captureRemoteDocument 흐름 API와 새로운 captureSingleRemoteDocument 오버로드 (RemoteCreationDisplayInfo 사용)를 공개 API로 노출했습니다. (I87b0e, b/513228889)
  • GlanceWearWidgetService 수명 주기 메서드에 @CallSuper가 추가되었습니다.

버전 1.0.0-alpha11

2026년 6월 3일

androidx.glance.wear:wear:1.0.0-alpha11, androidx.glance.wear:wear-core:1.0.0-alpha11 및 androidx.glance.wear:wear-tooling-preview:1.0.0-alpha11이 출시되었습니다. 버전 1.0.0-alpha11에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • Android 스튜디오에서 Wear 위젯을 미리 볼 수 있도록 WearWidgetPreview를 추가했습니다. (I36504, b/485147770)
  • is*Available (isDailyStepsAvailable 등) 변수를 노출하여 관련 건강 데이터 유형이 사용 가능하고 유효한지 확인합니다. (Ib98a7, b/498179656)
  • GlanceWearWidget에 triggerUpdateAll API를 추가하여 지정된 앱의 모든 위젯에서 업데이트를 트리거했습니다. (I6ab20, b/510896410)

버그 수정

  • alpha10 버전으로 생성된 문서의 손상을 방지하기 위해 렌더러 버전 정보를 WearWidgetParams에 내부 필드로 포함 (Idcf8e, b/511263591, b/512830184)
  • 디버그 모드 또는 에뮬레이터에서 Wear 위젯의 강제 풀 업데이트 흐름을 트리거합니다.

버전 1.0.0-alpha10

2026년 5월 19일

androidx.glance.wear:wear:1.0.0-alpha10, androidx.glance.wear:wear-core:1.0.0-alpha10 및 androidx.glance.wear:wear-tooling-preview:1.0.0-alpha10이 출시되었습니다. 버전 1.0.0-alpha10에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • Wear 위젯에서 glance.wear.health.DataType API 노출 이러한 API는 개발자가 시스템 건강 데이터에 액세스하는 데 사용할 수 있습니다.

버그 수정

  • 빈 글꼴 축이 Glance Wear 위젯의 플레이어에 전송되지 않도록 하여 Wear 7 에뮬레이터 또는 1.6 렌더러를 실행하는 기기에서 alpha09 버전에서 발생하는 비정상 종료 루프를 수정했습니다.

버전 1.0.0-alpha09

2026년 5월 6일

androidx.glance.wear:wear:1.0.0-alpha09 및 androidx.glance.wear:wear-core:1.0.0-alpha09이 출시되었습니다. 버전 1.0.0-alpha09에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • 실험적인 Glance Wear 기능에 사용될 ExperimentalGlanceWearApi을 추가했습니다. (Id2f76, b/498179813)

버그 수정

  • 부팅 중에 위젯을 인식하도록 Wear 위젯 XML 메타데이터 파서가 업데이트되었습니다.

버전 1.0.0-alpha08

2026년 4월 22일

androidx.glance.wear:wear:1.0.0-alpha08 및 androidx.glance.wear:wear-core:1.0.0-alpha08이 출시되었습니다. 버전 1.0.0-alpha08에는 이러한 커밋이 포함되어 있습니다.

버그 수정

  • PackageManager가 푸시 업데이트를 위해 올바른 서비스를 쿼리하도록 glance:wear:wear 라이브러리의 매니페스트에 <queries> 태그가 추가되었습니다. (I192787)

기타

  • glance-wear에도 적용되는 'Compose compileSdk를 37로 업데이트' (I6007)이 되돌려졌으므로 이 출시에서는 compileSdk 요구사항이 더 이상 37이 아닙니다.

버전 1.0.0-alpha07

2026년 4월 8일

androidx.glance.wear:wear:1.0.0-alpha07 및 androidx.glance.wear:wear-core:1.0.0-alpha07이 출시되었습니다. 버전 1.0.0-alpha07에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

  • WearWidgetBrush가 비어 있거나 지정되지 않은 경우 기본 Wear 위젯 배경 추가 (I8300b)
  • 위젯의 컨테이너 유형을 반환하도록 getActiveWidgets API 업데이트 (2772eb1)

API 변경사항

  • WidgetInstanceId를 사용하도록 위젯 업데이트 API를 변경하고 지정된 위젯의 ID를 가져오는 도우미 추가 제공된 ID가 잘못되었거나 호출자가 소유하지 않은 경우 새 API는 IllegalArgumentException을 발생시킵니다. (I6f3c5, b/446828899)
  • WearWidgetBrush에 세로 및 가로 그라데이션을 추가합니다. (If70ae, b/470080675)

버전 1.0.0-alpha06

2026년 3월 25일

androidx.glance.wear:wear:1.0.0-alpha06 및 androidx.glance.wear:wear-core:1.0.0-alpha06이 출시되었습니다. 버전 1.0.0-alpha06에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

  • Wear 위젯 프로필의 작업을 인라인으로 정의합니다.

API 변경사항

  • 전체 화면 호환성 위젯을 더 잘 구분하기 위해 CONTAINER_TYPE_FULLSCREEN의 이름을 CONTAINER_TYPE_TILE_COMPAT로 바꿨습니다. 여기에는 위젯 매개변수에서 이전에 FULLSCREEN 유형을 LARGE로 매핑한 것을 되돌리는 작업이 포함됩니다.

버전 1.0.0-alpha05

2026년 3월 11일

androidx.glance.wear:wear:1.0.0-alpha05 및 androidx.glance.wear:wear-core:1.0.0-alpha05이 출시되었습니다. 버전 1.0.0-alpha05에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • Wear 위젯 배경에 사용되는 color 메서드가 있는 WearWidgetBrushAPI가 추가되었습니다. (I66f54, b/464273091)
  • fetchActiveWidgets이 이미 있으므로 fetchActiveWidgetsForProvider 메서드가 삭제되었습니다. (I85e4e, b/486197890)

버전 1.0.0-alpha04

2026년 2월 25일

androidx.glance.wear:wear:1.0.0-alpha04 및 androidx.glance.wear:wear-core:1.0.0-alpha04이 출시되었습니다. 버전 1.0.0-alpha04에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • 앱이 활성 위젯과 타일을 쿼리할 수 있도록 GlanceWearWidgetManager API가 추가되었습니다. (I5be95)
  • glance:wear:wear-core 라이브러리의 API를 androidx.glance.wear.core 패키지로 이동했습니다. (I429cf)

버그 수정

  • 일반적인 원격 컴포저블 및 수정자 유형 노출 (Id1d40)

버전 1.0.0-alpha03

2026년 2월 11일

androidx.glance.wear:wear:1.0.0-alpha03 및 androidx.glance.wear:wear-core:1.0.0-alpha03이 출시되었습니다. 버전 1.0.0-alpha03에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

버전 1.0.0-alpha02

2026년 1월 28일

androidx.glance.wear:wear:1.0.0-alpha02 및 androidx.glance.wear:wear-core:1.0.0-alpha02이 출시되었습니다. 버전 1.0.0-alpha02에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

  • 위젯 매개변수에서 FULLSCREEN을 LARGE로 다시 매핑 (ad78d95)

버그 수정

  • 여러 위젯 인스턴스가 표시되지 않도록 하는 DataStore 사용 수정 (474f3e4)

버전 1.0.0-alpha01

2026년 1월 14일

androidx.glance.wear:wear:1.0.0-alpha01 및 androidx.glance.wear:wear-core:1.0.0-alpha01이 출시되었습니다. 버전 1.0.0-alpha01에는 이러한 커밋이 포함되어 있습니다.

  • Glance Wear는 RemoteCompose를 사용하여 Wear OS용 위젯을 빌드하기 위한 라이브러리입니다.