Glance

Glance

  코드 샘플

API 참조
androidx.glance

Jetpack Compose 스타일의 API를 사용하여 원격 표면의 레이아웃을 빌드합니다.

최근 업데이트	안정화 버전	출시 후보 버전	베타 버전	알파 버전
2025년 12월 3일	1.1.1	1.2.0-rc01	-	-

종속 항목 선언

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

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

Groovy

dependencies {
    // For Glance support
    implementation "androidx.glance:glance:1.2.0-beta01"
    // For AppWidgets support
    implementation "androidx.glance:glance-appwidget:1.2.0-beta01"

    // For Wear-Tiles support
    implementation "androidx.glance:glance-wear-tiles:1.0.0-alpha07"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.0-beta03"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

dependencies {
    // For Glance support
    implementation("androidx.glance:glance:1.2.0-beta01")
    
    // For AppWidgets support
    implementation("androidx.glance:glance-appwidget:1.2.0-beta01")

    // For Wear-Tiles support
    implementation("androidx.glance:glance-wear-tiles:1.0.0-alpha07")
}

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.0-beta03"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

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

의견

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

새로운 문제 제출하기

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

버전 1.2

버전 1.2.0-rc01

2025년 12월 3일

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

버전 1.2.0-beta01

2025년 8월 27일

androidx.glance:glance-*:1.2.0-beta01이 출시되었습니다. 버전 1.2.0-beta01에는 이 커밋이 포함되어 있습니다.

버그 수정

• 기본 minSdk을 API 21에서 API 23으로 이동 (Ibdfca, b/380448311, b/435705964, b/435705223)

버전 1.2.0-alpha01

2025년 5월 7일

androidx.glance:glance-*:1.2.0-alpha01이 출시되었습니다. 버전 1.2.0-alpha01에는 이 커밋이 포함되어 있습니다.

API 변경사항

• currentCompositeKeyHash를 이제 지원 중단했습니다. 대신 currentCompositeKeyHashCode를 사용합니다. 대체 API는 더 많은 비트로 동일한 해시를 인코딩하므로 컴포지션 계층 구조에서 무작위로 선택된 관련 없는 두 그룹이 동일한 해시 키를 가질 가능성이 기하급수적으로 줄어듭니다.(I4cb6a, b/177562901)
• 글랜스 이미지 컴포저블 및 배경 이미지 수정자의 알파 (0f~1f)를 지정하는 새로운 API를 추가합니다. 지정하지 않으면 소스 이미지의 알파가 유지됩니다. (I8ad05)
• 생성된 미리보기를 위한 Glance API 추가 GlanceAppWidget.providePreview를 재정의하여 위젯의 미리보기 레이아웃을 제공합니다. 그런 다음 GlanceAppWidgetManager.setWidgetPreview를 호출하여 미리보기를 설정합니다. (Iced16)
• 멀티 프로세스 구성을 지원하기 위해 MultiProcessGlanceAppWidget 추가 (Idbb90)
• 실험용 태그가 삭제되었으며 이제 람다를 지원합니다 (I74d98, b/299361317).
• GlanceAppWidget.runComposition의 람다 수신자 지정 허용 (I84829)
• requestPinGlanceAppWidget에 previewSize 매개변수 추가 (I9f8f0, b/303256067)

버그 수정

• AGP 7.3 이상 (예: R8 버전 3.3)을 사용하여 R8을 사용하는 경우 API 모델링을 통해 자동으로 발생하고 AGP 8.1 이상 (예: D8 버전 8.1)을 사용하는 모든 빌드의 경우 새 플랫폼 API에 대한 액세스의 수동 윤곽이 삭제되었습니다. AGP를 사용하지 않는 클라이언트는 D8 버전 8.1 이상으로 업데이트하는 것이 좋습니다. 자세한 내용은 이 도움말을 참조하세요. (If6b4c, b/345472586)
• glance-appwidget 라이브러리를 compileSdk 35로 업데이트 (I2e26b)

버전 1.1

버전 1.1.1

2024년 10월 16일

androidx.glance:glance-*:1.1.1이 출시되었습니다. 버전 1.1.1에는 이 커밋이 포함되어 있습니다.

보안 수정사항

• 이 변경사항에 따라 androidx는 CVE-2024-7254를 해결하기 위해 protobuf 4.28.2에 대해 컴파일됩니다. 취약점 위험을 해결하려면 androidx.glance:glance-appwidget-proto 및 androidx.glance:glance-appwidget-external-protobuf의 버전 1.1.0에 대한 종속 항목을 1.1.1로 업그레이드하세요.

버전 1.1.0

2024년 6월 12일

androidx.glance:glance-*:1.1.0이 출시되었습니다. 버전 1.1.0에는 이 커밋이 포함되어 있습니다.

1.0.0 이후 중요 변경사항

• Glance를 1.1.0 안정화 버전으로 이동

버전 1.1.0-rc01

2024년 5월 14일

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

새로운 기능

• Glance의 미리보기 주석에 너비 및 높이 매개변수가 추가되었습니다. 1.1.0을 출시 후보로 이동

API 변경사항

• 선택적 매개변수를 Scaffold에 추가합니다. (If753f)
• Glance @Preview에 너비 및 높이 매개변수 추가 (Ibabe8)
• 글랜스 Wear 타일 미리보기 지원 삭제 (I3850a)
• FontStyle의 맞춤 가중치 값을 설정하는 API를 추가했습니다. (I7390a)
• 기본 구현을 더 잘 반영하도록 Viewfinder의 ImplementationMode 열거형 이름을 변경하고 TransformationInfo.sourceRotation의 고정 상수를 추가합니다 (Ic6149).

버그 수정

• 이전 버전과의 호환성 모드에서 ViewGroups의 렌더링 문제를 일으키는 버그를 수정했습니다 (I8de92).

외부 기여

• 실험용 SharedTransitionScope는 이제 클래스가 아닌 인터페이스입니다. (Iaf856, b/338415048, b/338414702)

버전 1.1.0-beta02

2024년 4월 17일

androidx.glance:glance-*:1.1.0-beta02이 출시되었습니다. 이 버전에는 이전 버전에서 누락된 소스 jar가 포함되어 있습니다.

버전 1.1.0-beta01

2024년 4월 3일

androidx.glance:glance-*:1.1.0-beta01이 출시되었습니다. 버전 1.1.0-beta01에는 이 커밋이 포함되어 있습니다.

버전 1.1.0-alpha01

2024년 2월 7일

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

새로운 기능

• UI Automator가 필요하지 않은 Glance용 단위 테스트 라이브러리 글랜스 코드는 뷰를 확장하지 않고도 직접 테스트할 수 있습니다.
• 더 간단한 레이아웃을 위한 상위 수준 구성요소
• 새로운 수정자 및 테마 옵션
• 컴포지션에서 RemoteViews 흐름을 가져오는 새로운 API, runComposition

API 변경사항

• Glance 테마에 새 widgetBackground 색상 역할을 추가합니다. (Ia2ab8)
• GlanceAppWidget.runComposition 추가 (I6344c, b/298066147)
• 새 TopBar 구성요소 추가 (Ibd361)
• clickable 수정자에 재정의를 추가합니다. (Iacecf)
• 버튼에 색조를 적용하는 새로운 API를 추가합니다. 1.0이 출시될 때까지는 실험적이어야 합니다. (I92523)
• provideComposable와 같은 GlanceAppWidgetUnitTest의 메서드를 호출하는 범위를 제공하는 runGlanceAppWidgetUnitTest를 추가하여 테스트를 위한 작은 격리된 컴포저블을 제공하고 onNode를 사용하여 제공된 콘텐츠에서 Glance 컴포저블 요소를 찾습니다. 이를 통해 앱 위젯의 개별 컴포저블 함수에 대한 단위 테스트를 작성하여 특정 입력이 주어지면 함수가 의도한 글랜스 컴포저블 요소 집합을 출력하는지 확인할 수 있습니다. (I2f682)
• 단위 테스트에 사용할 수 있도록 시맨틱에 testTag 수정자를 추가합니다. (I8f62f)
• TitleBar 업데이트 - 텍스트와 아이콘을 개별적으로 색조 지정할 수 있음 (Ia0a60)
• 스캐폴드 구성요소 추가 (I8a736)
• actionRunCallack를 테스트하기 위해 hasActionRunCallbackClickAction 필터와 assertHasActionRunCallbackClickAction 어설션을 추가합니다. 또한 작업 관련 테스트 필터(hasStartActivityClickAction<activityClass>(..), hasStartServiceAction<receiverClass>(..), hasSendBroadcastAction<receiverClass>(..))를 위한 추가 약식 변형 함수를 추가합니다. assertHasXXX 상응 항목에 유사한 변형을 추가합니다. (Ieca63)
• 출시되지 않은 API를 이동합니다. 수정자를 내부에서 공개로 변경하지만 라이브러리 제한 (If2a08)
• 오류가 발생할 때 개발자가 코드를 실행할 수 있는 onCompositionError 메서드 추가 (I9b56f)
• 글랜스에 버튼 및 iconbutton API 추가 (I0fd6f)
• 진행률 표시기와 일치하도록 isLinearProgressIndicator, isIndeterminateLinearProgressIndicator, isIndeterminateCircularProgressIndicator 필터를 추가합니다. 노드의 하위 계층에 특정 매처 (Ifd426)와 일치하는 하위 요소가 있는지 테스트하는 hasAnyDescendants 필터가 추가되었습니다.
• 서비스 / 활동 또는 브로드캐스트를 시작하는 클릭 작업의 테스트를 지원하기 위해 어설션과 필터를 추가합니다. 입력 요소가 선택되었는지 테스트하는 것도 포함됩니다. (I3041c)

버전 1.0.0

버전 1.0.0-alpha07

2025년 8월 27일

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

새로운 기능

• 글랜스 Wear 타일은 현재 지원이 중단되었으며 향후 출시에서 삭제될 예정입니다. 새로운 Glance Wear 위젯 라이브러리로 대체됩니다.

API 변경사항

• glance-wear-tiles 지원 중단 (I82afd)
• 더 이상 사용되지 않는 @RequiresApi(21) 주석 삭제 (Ic4792)
• 더 이상 사용되지 않는 @RequiresApi(21) 주석 삭제 (I9103b)
• 사용하지 않는 모듈을 삭제합니다. 템플릿은 더 이상 진행되지 않습니다. (I3fc90, b/430070874)
• Kotlin 2.0으로 출시된 프로젝트를 사용하려면 KGP 2.0.0 이상이 필요합니다 (Idb6b5).
• API 위원회 의견 수정 (I284c8)
• 버튼에 색조를 적용하는 새로운 API를 추가합니다. 1.0이 출시될 때까지 실험적이어야 합니다 (I92523).
• 호환성 억제를 주석 처리하도록 API 파일을 업데이트했습니다. (I8e87a, b/287516207)
• 이제 모든 타일 렌더러 API에서 protolayout 유형이 완전히 지원됩니다. (I428b0)
• d,e,f,g 경로의 공개 API 파일과 실험용 API 파일을 병합했습니다. (I03646, b/278769092)
• Button, Checkbox, RadioButton, Switch용 *Defaults API를 추가했습니다. 이를 통해 Glance가 Jetpack Compose의 패턴에 더 가까워집니다. (I94828)
• 새 Glance 템플릿 모듈 (I94459)
• androidx.wear.protolayout 유형 지원을 TileRenderer에 추가했습니다 (I4ac7f).
• 지원 중단된 숨겨진 함수의 반환 유형 null 허용 여부를 더 추가했습니다. (Ibf7b0)
• @JvmDefaultWithCompatibility 주석 추가 (I8f206, b/251463569)
• 람다를 콜백으로 사용하는 지원 추가 (Ia0bbd)

버그 수정

• glance-appwidget 라이브러리를 compileSdk 35로 업데이트 (I2e26b)

버전 1.0.0-alpha06

2024년 2월 7일

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

새로운 기능

• 기본 Glance 모듈을 따르도록 버전이 업데이트되었습니다.

버전 1.0.0

2023년 9월 6일

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

1.0.0의 주요 기능

• Glance를 안정적인 버전 1.0.0으로 이동

버전 1.0.0-rc01

2023년 7월 26일

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

1.0.0 안정화 버전 출시를 위해 Glance를 rc01로 이동합니다.

새로운 기능

• 더 안정적인 작업 호출을 위해 작업 람다에 주요 매개변수를 추가합니다.
• startActivity 작업에 ActvityOptions을 제공하는 기능을 추가합니다.
• Android 14 지원 추가

API 변경사항

• 람다를 허용하는 모든 요소에 선택적 키 매개변수가 추가되었습니다. (Id96c1, b/282445798)
• actionStartActivity의 ActivityOptions 번들 설정 지원 추가 (I6a08d)
• d,e,f,g 경로의 공개 API 파일과 실험용 API 파일을 병합했습니다. (I03646, b/278769092)
• 해당 사항 없음, API 파일 변경사항은 메서드 재정렬뿐임 (I5fa95)
• GlanceAppWidgetReceiver 요청의 CoroutineContext 설정을 위한 API 추가 (I0a100)
• 목록의 모든 작업에 사용될 LazyColumn 및 LazyVerticalGrid에 ActivityOptions를 제공하는 새 API가 추가되었습니다.(Id8d71)

버그 수정

• 해당 사항 없음, API 파일 변경사항은 메서드 재정렬뿐임 (I5fa95)
• 글랜스 텍스트 구성요소 스타일 데모 (Ie78a4)

버전 1.0.0-beta01

2023년 5월 10일

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

새로운 기능

• 라이브러리를 베타로 이동합니다.
• GlanceTheme를 사용한 테마 설정 지원: Glance에서 Material 2 및 Material 3 스타일 테마를 지원하기 위해 glance-material 및 glance-material3 모듈을 추가합니다.
• 텍스트 API에 FontFamily 지원이 추가되었습니다.
• GlanceAppWidget를 세션 기반 업데이트 메커니즘인 WorkManager로 이동했습니다. 이제 AppWidgets용 Glance 사용자는 이전 Content 메서드 대신 GlanceAppWidget.provideGlance를 재정의해야 합니다. 이제 워커에서 이 작업이 실행되므로 별도의 워커 없이 리소스, 데이터베이스 또는 네트워크 항목을 로드하기에 적합한 위치입니다.

API 변경사항

• Button, Checkbox, RadioButton, Switch용 *Defaults API를 추가했습니다. 이를 통해 Glance가 Jetpack Compose의 패턴에 더 가까워집니다. (I94828)
• 새 Glance 템플릿 모듈 (I94459)
• ResourceColorProvider를 모듈 내부로 만듦 브레이킹 체인지입니다. 일부 색상은 동적 리소스이고 일부는 완전히 해결된 상황을 방지하기 위해 동적 테마 설정에만 ResourceColorProvider를 사용해야 하기 때문에 필요합니다. (Ib0db7)
• FontFamily을 TextStyle의 옵션으로 추가합니다. (Ic19ba, b/274179837)
• Enum.valueOf의 값 매개변수 이름이 변경됨 (Ia9b89)
• enum valueOf에서 더 많은 예외가 발생합니다 (I818fe).
• provideGlance을 기본 진입점으로 사용하도록 GlanceAppWidget 업데이트 이제 GlanceAppWidget.Content이 지원 중단됩니다. (I202b5)
• 이미지의 색조 색상을 제공하는 옵션 추가 (I26192, b/212418562)
• 지원 중단된 숨겨진 함수의 반환 유형 null 허용 여부를 더 추가했습니다. (Ibf7b0)
• @JvmDefaultWithCompatibility 주석을 추가합니다. (I8f206)
• 사용하지 않는 SingleEntityTemplateData.displayHeader가 삭제되었습니다. (I7f094)
• 람다를 콜백으로 사용하는 지원 추가 (Ia0bbd)
• DayNightColorProvider를 glance 모듈로 이동했습니다 (I1842c, b/256934779).
• 템플릿에서 LocalColorProvider을 삭제합니다. 이제 템플릿에서 GlanceTheme.colors을 사용합니다 (Ic15e2).
• Text(style: TextStyle)에서 null 허용 여부를 삭제했습니다. (I7123b, b/237012816)
• 기본 텍스트 색상을 검은색으로 설정하고 null 허용 여부를 삭제했습니다. (I3072c, b/237012816)
• 동적 테마 ColorProviders를 자체 객체로 만듭니다. ResourceColorProvider를 모듈 내부로 만듭니다. (Id0e2d, b/237012816)
• 정의되지 않음 카테고리를 ImageSize에 추가합니다. (I2fa39)
• 지원 중단된 GlanceAppWidget.Content 함수 삭제 (Ib05f6)
• 수정자를 AndroidRemoteViews의 매개변수로 추가합니다. (I515d4)
• 단위 테스트를 더 쉽게 할 수 있도록 GlanceAppWidget.compose 추가 (Ie9b28)

버그 수정

• Glance 텍스트 글꼴의 데모 위젯 추가 (I5c3d7)
• 수정자를 사용하여 AndroidRemoteViews의 크기를 조정할 수 있습니다.
• 일관되지 않은 테마 색상 문제가 해결됨
• 이제 충돌을 방지하기 위해 모든 리소스에 접두사가 지정됨

버전 1.0.0-alpha05

2022년 10월 5일

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

새로운 기능

• 앱이 홈 화면에 Glance 기반 위젯을 추가하기 위해 사용자에게 메시지를 표시할 수 있도록 GlanceAppWidgetManager에 requestPinGlanceAppWidget을 추가합니다. (Ic6e47)
• 개발자가 루팅된 기기와 에뮬레이터의 adb에서 위젯을 강제로 업데이트할 수 있도록 ACTION_DEBUG_UPDATE를 GlanceAppWidgetReceiver에 추가합니다. (I94ae1)

API 변경사항

• 사용 사례를 간소화하기 위해 Glance 템플릿에서 헤더 작업 버튼을 삭제합니다. (Ie4387)
• Block 하위 시스템 설계를 재사용하도록 Single Entity Template을 리팩터링했습니다. (Iecd2c)
• Text/Image/Action Block 디자인을 사용하도록 Glance List Template을 리팩터링했습니다. (If0cc1)
• TextBlock과 ImageBlock에 우선순위 번호 범위를 추가합니다. (I73100)

버그 수정

• Material3 종속 항목을 삭제했습니다. (I28d1c)
• Glance Template 레이아웃에서 여백 및 간격을 추가하기 위해 더 일관된 시스템으로 이동합니다. (I29773)
• 압축된 출시가 빌드되지 않도록 차단하던 잘못된 Proguard 규칙을 수정했습니다.

버전 1.0.0-alpha04

2022년 8월 10일

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

새로운 기능

• 버튼 색상 지정 기능을 추가합니다.
• 컴파일 시간을 더 잘 확인하기 위해 GlanceComposable 주석을 추가합니다.
• Wear 전용 Glance 기능을 추가합니다.

API 변경사항

• Glance Gallery Data API와 축소 뷰를 업데이트합니다. (Ibc7a8)
• 버튼 구성을 위한 ButtonColors를 추가합니다. (Iea88d, b/236305351)
• ColorProvider.resolve를 ColorProvider.getColor로 이름을 바꿨습니다. (Ic9dfe)
• TextStyle에 copy() 메서드를 추가합니다. (I9aef6)
• Glance 테마의 일부로 사용할 수 있는 ColorProviders 클래스를 추가합니다. (I848b9, b/237012816)
• 목록 스타일 및 축소 뷰에 목록 템플릿 지원을 추가합니다. (I50cdc)
• GlanceModiier와 GlanceCurvedModifier에 시맨틱을 추가합니다. (Ifda7e)
• GlanceComposable 주석을 추가합니다. (I5dbf0)
• Glance 템플릿을 기본 Glance 프로젝트로 이동합니다. (I9db94)
• ColorProvider.resolve()를 추가합니다. (Ife532, b/214733442)
• 기존 appWidgetId에서 GlanceId를 가져오거나 구성 활동에서 인텐트를 가져오는 새 메서드를 사용합니다. (Icb70c, b/230391946)
• GlanceComposable 주석을 추가합니다. (I2c21f)
• GlanceAppWidget 외부에서 컴포지션을 실행하기 위한 GlanceRemoteViews를 추가했습니다. (I18f92)
• ProgressIndicatorDefaults에서 색상을 삭제합니다. (I40299)
• API 검토 의견에 따라 공개 API와의 일관성을 위해 ActionCallback의 onRun 메서드 이름을 onAction으로 바꿨습니다. (Icfa57)
• 지도를 사용하도록 Glance 템플릿 레이아웃을 변환합니다. (I46bfd)
• RadioButton 컴포저블을 추가합니다. (I4ecce)
• Wear 카드 구성을 위한 GlanceWearTiles를 추가했습니다. (Ia9f65)
• GlanceCurvedModifier에 클릭 가능 항목을 추가했습니다. (Iec2a0)
• CurvedRow를 범위로 구현하고, DSL을 만들어 일반 컴포저블 또는 곡선 요소를 추가합니다. proto 카드에서 ArcLine 및 ArcSpacer로 변환되는 curvedLine 및 curvedSpacer도 추가했습니다. (Ib955b)
• Tiramisu DP2와 일치하도록 코어 및 appcompat의 null 허용 여부를 업데이트했습니다. (I0cbb7)
• glance-wear-tiles에서 RuncallbackAction 지원을 추가했습니다. 지금은 매개변수가 없는 RunCallbackAction만 지원됩니다. (Ide64a)

외부 기여

• test-coroutines-lib 이전으로 인해 :compose:ui:ui-test api(updateApi)가 업데이트되었습니다. (I3366d)

버전 1.0.0-alpha03

2022년 2월 23일

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

새로운 기능

• 환경설정 기본값의 상태 정의가 간소화되었습니다.

API 변경사항

• PreferencesGlanceStateDefinition을 기본 상태로 처리하여 상태 처리를 간소화합니다. GlanceAppWidget.updateAppWidgetState를 삭제하고 기본적으로 Preferences를 사용하는 updateAppWidgetState를 도입했습니다. (I58963)
• Glance TemplateText 클래스를 추가하고 템플릿 디자인을 업데이트했습니다. (I4e146)
• 자유형 템플릿의 개요 인프라를 추가했습니다. (If03d6)
• SingleEntityTemplate 레이아웃을 업데이트했습니다. (If925d)
• LazyVerticalGrid가 추가되었습니다. (I5f442)
• SingleEntityTemplate에서 ColorProvider를 사용합니다. (I01ee0)
• 템플릿 클래스 이름을 업데이트했습니다. (I3720e)
• LinearProgressIndicator 및 CircularProgressIndicator 컴포저블이 추가되었습니다. (Ie116b)

버그 수정

• 초기 템플릿 구현으로 '단일 항목 템플릿' 데이터와 예시 템플릿 레이아웃을 정의했습니다. (I35837)
• 기본적으로 타일 콘텐츠가 가운데로 정렬됩니다. (I264be)
• glance-wear-tiles에서 fillMaxSize/Width/Height 버그를 수정했습니다. (I0a39f)

버전 1.0.0-alpha02

2022년 1월 26일

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

새로운 기능

이 버전에는 'Glanceable'에 최적화된 컴포저블을 Compose 런타임에 사용하여 Wear 타일을 빌드하기 위한 API 집합이 포함되어 있습니다.

• 구성 가능한 Content() 함수에서 타일을 만드는 서비스인 GlanceTileService를 확장하여 Wear 타일 서비스를 선언합니다.
• Glance 컴포저블의 Wear 타일: CurvedRow, CurvedText
• TimelineMode.SingleEntry 및 TimelineMode.TimeBoundEntries를 정의하여 타일의 다양한 타임라인 모드를 처리합니다.
• LocalTimeInterval은 특정한 시간 간격을 나타내는 로컬 컴포지션입니다.
• BorderModifer는 요소 주위에 테두리를 적용하는 GlanceModifier입니다.

또한 이 버전에서는 AppWidget Glance에 진행률 표시기가 추가됩니다.

API 변경사항

• LinearProgressIndicator 및 CircularProgressIndicator 컴포저블이 추가되었습니다. (Ie116b)
• actionStartBroadcastReceiver를 actionSendBroadcast로 변경합니다. (I7d555)
• GlanceAppWidget onDelete 콜백에 컨텍스트를 전달합니다. (I4c795)

버그 수정

• OPTIONS_APPATTRIBUTE_SIZES가 존재하지만 비어 있을 때의 처리 방법을 수정했습니다. (I01f82)

버전 1.0.0-alpha01

2021년 12월 15일

androidx.glance:glance:1.0.0-alpha01, androidx.glance:glance-appwidget:1.0.0-alpha01 및 androidx.glance:glance-appwidget-proto:1.0.0-alpha01이 출시되었습니다. 버전 1.0.0-alpha01에 포함된 커밋을 확인하세요.

최초 출시의 기능

• Glance의 첫 출시 버전에는 Compose Runtime을 사용하여 'Glanceable'에 최적화된 일련의 새로운 컴포저블을 포함하는 AppWidget을 빌드하기 위한 첫 번째 API 모음이 포함되어 있습니다.

참고: Glance는 자체 컴포저블 세트를 사용합니다. androidx.compose와 androidx.glance 컴포저블을 결합하지 마세요.

기능

• GlanceAppWidget 및 GlanceAppWidgetReceiver로 앱 위젯을 선언합니다.
• 초기 Glance 컴포저블 세트인 Box, Row, Column, Text, Button, LazyColumn, Image, Spacer로 UI를 구성합니다.
• GlanceModifier 메서드를 사용하여 컴포저블에 수정자를 적용합니다.
• 사전 정의된 작업으로 사용자 상호작용을 처리합니다.
  • actionStartActivity
  • actionRunCallback
  • actionStartService
  • actionStartBroadcastReceiver
• ActionParameters를 통해 Action에 매개변수를 제공합니다.
• SizeMode.Single, SizeMode.Exact 또는 SizeMode.Responsive를 정의하여 다양한 크기 모드를 처리합니다.
• GlanceStateDefinition을 제공하여 GlanceAppWidget 상태를 유지합니다.
• 로컬 컴포지션은 LocalContext, LocalState, LocalGlanceId, LocalSize와 같습니다.
• AndroidRemoteViews 컴포저블을 사용하여 기존 RemoteViews와 상호 운용합니다.