Wear Tiles

Wear OS by Google 스마트시계용 애플리케이션을 만듭니다.
최근 업데이트 안정화 버전 출시 후보 버전 베타 버전 알파 버전
2024년 12월 11일 1.4.1 - - 1.5.0-alpha05

종속 항목 선언

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

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

Groovy

dependencies {
    // Use to implement support for wear tiles
    implementation "androidx.wear.tiles:tiles:1.5.0-alpha04"

    // Use to utilize standard components and layouts in your tiles
    implementation "androidx.wear.protolayout:protolayout:1.3.0-alpha04"

    // Use to utilize components and layouts with Material Design in your tiles
    implementation "androidx.wear.protolayout:protolayout-material:1.3.0-alpha04"

    // Use to include dynamic expressions in your tiles
    implementation "androidx.wear.protolayout:protolayout-expression:1.3.0-alpha04"

    // Use to preview wear tiles in your own app
    debugImplementation "androidx.wear.tiles:tiles-renderer:1.5.0-alpha04"

    // Use to fetch tiles from a tile provider in your tests
    testImplementation "androidx.wear.tiles:tiles-testing:1.5.0-alpha04"
}

Kotlin

dependencies {
    // Use to implement support for wear tiles
    implementation("androidx.wear.tiles:tiles:1.5.0-alpha04")

    // Use to utilize standard components and layouts in your tiles
    implementation("androidx.wear.protolayout:protolayout:1.3.0-alpha04")

    // Use to utilize components and layouts with Material Design in your tiles
    implementation("androidx.wear.protolayout:protolayout-material:1.3.0-alpha04")

    // Use to include dynamic expressions in your tiles
    implementation("androidx.wear.protolayout:protolayout-expression:1.3.0-alpha04")

    // Use to preview wear tiles in your own app
    debugImplementation("androidx.wear.tiles:tiles-renderer:1.5.0-alpha04")

    // Use to fetch tiles from a tile provider in your tests
    testImplementation("androidx.wear.tiles:tiles-testing:1.5.0-alpha04")
}

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

의견

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

새로운 문제 제출하기

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

버전 1.5

버전 1.5.0-alpha05

2024년 12월 11일

androidx.wear.tiles:tiles-*:1.5.0-alpha05이 출시되었습니다. 버전 1.5.0-alpha05에는 이 커밋이 포함되어 있습니다.

새로운 기능

  • TileService가 일괄적으로 상호작용 이벤트를 처리할 수 있는 API를 추가합니다. (I04d1b)

버그 수정

  • 이제 이 라이브러리는 유형 사용인 JSpecify nullness 주석을 사용합니다. Kotlin 개발자는 올바른 사용을 적용하기 위해 다음 컴파일러 인수 -Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode를 사용해야 합니다. (I390e9, b/326456246)
  • 앱 targetSdk가 34보다 클 때 API 34에서 카드 업데이트를 요청하면 SecurityException이 발생하는 버그를 수정했습니다. (If62a1)
  • Robolectric 테스트에서 WearSdk 종속 항목을 수정했습니다. (I37796)

버전 1.5.0-alpha04

2024년 11월 13일

androidx.wear.tiles:tiles-*:1.5.0-alpha04이 출시되었습니다. 버전 1.5.0-alpha04에는 이 커밋이 포함되어 있습니다.

버전 1.5.0-alpha03

2024년 10월 30일

androidx.wear.tiles:tiles-*:1.5.0-alpha03이 출시되었습니다. 버전 1.5.0-alpha03에는 이 커밋이 포함되어 있습니다.

버전 1.5.0-alpha02

2024년 10월 16일

androidx.wear.tiles:tiles-*:1.5.0-alpha02이 출시되었습니다. 버전 1.5.0-alpha02에는 이 커밋이 포함되어 있습니다.

보안 수정사항

  • 이 변경사항부터 androidx는 CVE-2024-7254를 해결하기 위해 protobuf 4.28.2를 기준으로 컴파일합니다. 취약점 위험을 해결하려면 androidx.wear.tiles:tiles-proto 버전 1.5.0-alpha01의 종속 항목을 1.5.0-alpha02로 업그레이드하세요.

버전 1.5.0-alpha01

2024년 10월 2일

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

버전 1.4

버전 1.4.1

2024년 10월 16일

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

보안 수정사항

  • 이 변경사항부터 androidx는 CVE-2024-7254를 해결하기 위해 protobuf 4.28.2를 기준으로 컴파일합니다. 취약점 위험을 해결하려면 androidx.wear.tiles:tiles-proto 버전 1.4.0의 종속 항목을 1.4.1로 업그레이드하세요.

버전 1.4.0

2024년 8월 7일

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

1.3.0 이후 중요 변경사항

  • Android 스튜디오에서 카드 미리보기의 맞춤 플랫폼 데이터를 지정하기 위한 도구 지원

버전 1.4.0-rc01

2024년 7월 24일

androidx.wear.tiles:tiles-*:1.4.0-rc01은 이전 버전에서 변경사항 없이 출시되었습니다. 버전 1.4.0-rc01에는 이 커밋이 포함되어 있습니다.

버전 1.4.0-beta01

2024년 7월 10일

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

새로운 기능

Wear Tiles의 1.4.0-beta01 출시는 이 라이브러리 버전의 기능이 완전하고 API가 잠겨 있음을 나타냅니다 (실험용으로 표시된 경우 제외). Wear Tiles 1.4에는 다음과 같은 새로운 기능과 API가 포함되어 있습니다.

  • Android 스튜디오에서 카드 미리보기의 맞춤 플랫폼 데이터를 지정하기 위한 도구 지원

버전 1.4.0-alpha05

2024년 6월 26일

androidx.wear.tiles:tiles-*:1.4.0-alpha05이 출시되었습니다. 버전 1.4.0-alpha05에는 이 커밋이 포함되어 있습니다.

버전 1.4.0-alpha04

2024년 5월 29일

androidx.wear.tiles:tiles-*:1.4.0-alpha04이 출시되었습니다. 버전 1.4.0-alpha04에는 이 커밋이 포함되어 있습니다.

버전 1.4.0-alpha03

2024년 5월 14일

androidx.wear.tiles:tiles-*:1.4.0-alpha03이 출시되었습니다. 버전 1.4.0-alpha03에는 이 커밋이 포함되어 있습니다.

버그 수정

  • 이제 TileService#getActiveTilesAsync는 WearSdk API (사용 가능한 경우)를 사용하여 더 정확한 결과를 제공합니다. (I57bd8)

버전 1.4.0-alpha02

2024년 5월 1일

androidx.wear.tiles:tiles-*:1.4.0-alpha02이 출시되었습니다. 버전 1.4.0-alpha02에는 이 커밋이 포함되어 있습니다.

API 변경사항

  • tileId를 필수 입력란으로 빌더 생성자 매개변수로 이동하고 getter에서 기본 타임스탬프 값을 문서화합니다. (I98c2b)
  • 카드 진입/종료 이벤트 일괄 처리에 필요한 TileInteractionEvent, TileEnter, TileLeave 프로토 메시지와 Java 래퍼를 추가합니다. (I112b0)
  • TileRenderer.Config 객체 대신 Builder를 사용하도록 TileRenderer를 리팩터링합니다. (Ib66f9)
  • TileRenderer.Config에 platformDataProviders 속성을 추가합니다. (I6030d)
  • 새 TileRenderer.Config 클래스를 지원하는 새 생성자를 TileRenderer에 추가합니다. 다른 생성자는 지원 중단되었습니다. (Iae7ff)
  • 플랫폼 데이터 값 재정의를 허용하도록 TilePreviewData에 platformDataValues 필드를 추가합니다. (If437a)

버그 수정

  • TileRenderer.Config.Builder#setTilesTheme의 기본값은 0이라고 문서화합니다. (Iced18)

버전 1.4.0-alpha01

2024년 3월 6일

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

버전 1.3

버전 1.3.0

2024년 2월 7일

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

1.2.0 이후 중요 변경사항

  • 카드 미리보기 지원을 위한 도구를 업데이트했습니다.
  • 앱에 속한 활성 카드 쿼리 지원

기타 변경사항

  • 버전 1.3.0에서 도입된 더 완전한 변경사항 세트는 beta01 출시 노트를 참고하세요.

버전 1.3.0-rc01

2024년 1월 24일

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

API 변경사항

  • TileService#getActiveTilesSnapshotAsync에서 getActiveTilesAsync로 이름이 변경되었습니다. (If6b87)

버전 1.3.0-beta01

2024년 1월 10일

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

Wear Tiles 1.3.0-beta01 출시는 이 라이브러리 버전의 기능이 완전하고 API가 잠겨 있음을 나타냅니다 (실험용으로 표시된 경우 제외). Wear Tiles 1.3에는 다음과 같은 새로운 기능과 API가 포함되어 있습니다.

  • Wear 카드 도구 모듈이 카드 미리보기 지원을 위해 업데이트되고 게시되도록 설정되었습니다.
  • TileService.getActiveTilesSnapshotAsync를 사용하여 앱에 속한 활성 타일을 쿼리하는 기능이 지원됩니다.

버전 1.3.0-alpha04

2023년 12월 13일

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

버전 1.3.0-alpha03

2023년 11월 29일

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

새로운 기능

  • 앱에 속한 활성 타일을 쿼리하기 위한 새 API TileService#getActiveTilesSnapshotAsync를 추가했습니다. (I6850e)

API 변경사항

  • @TilePreview의 이름을 @Preview로 바꿨습니다. (Ifc08a)

버전 1.3.0-alpha02

2023년 11월 15일

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

새로운 기능

  • 상위 요소 내의 공간을 기반으로 텍스트 크기를 자동으로 조정하는 실험용 API를 추가했습니다. (Ibbe63)

버전 1.3.0-alpha01

2023년 10월 18일

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

새로운 기능

  • 컨텍스트를 TilePreviewData 콜백 매개변수 대신 미리보기 메서드 매개변수로 제공합니다. (I5e97d)
  • Wear 카드 도구 모듈이 카드 미리보기 지원을 위해 업데이트되고 게시되도록 설정되었습니다. (I63d0f)

버전 1.2

버전 1.2.0

2023년 8월 9일

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

1.1.0 이후 중요 변경사항

  • Wear Tiles 1.2.0의 안정화 버전 (자세히 알아보기)
  • 카드 1.2에서는 레이아웃 요소를 플랫폼 데이터에 결합 (더 빠른 업데이트)하는 기능과 애니메이션을 지원합니다. 이전 안내는 (1.2.0-rc01) 출시 노트를 참고하세요.

버전 1.2.0-rc01

2023년 7월 26일

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

  • v1.2 출시에서는 카드 라이브러리가 리팩터링되었으며 대부분의 기능과 API가 새로운 ProtoLayout 라이브러리 (패키지 androidx.wear.protolayout)로 이동하고 일부 하위 집합은 카드 (androidx.wear.tiles)에 남아 있습니다.

    • 모든 클래스 이름은 동일하게 유지되었으며 v1.1에만 추가사항이 있습니다.
    • 대부분의 API는 동일하게 유지되었으며 패키지 이름만 변경되었습니다.
    • TileService/TileBuilder의 일부 메서드가 지원 중단되었으며 이제 지원 중단된 Tiles 메서드 대신 새 ProtoLayout 유형을 허용하는 버전의 이름이 변경되었습니다.

  • 이 이전을 더 쉽게 하기 위해 이름을 바꾸는 간단한 안내와 스크립트를 준비했습니다. 여기를 참고하세요.

API 변경사항

  • 레이아웃의 최대 깊이를 카드의 중첩된 요소 30개로 제한했습니다. 이 깊이를 초과하면 카드 렌더러에 이전에 확장된 레이아웃이 표시됩니다. (I8a74b)

버전 1.2.0-beta01

2023년 6월 21일

androidx.wear.tiles:tiles-*:1.2.0-beta01은 변경사항 없이 출시되었습니다. 버전 1.2.0-beta01에 포함된 커밋을 확인하세요.

버전 1.2.0-alpha07

2023년 6월 7일

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

새로운 기능

  • TileRenderer.setState를 사용하면 렌더링 세션의 상태를 설정할 수 있습니다. 이 상태는 현재 레이아웃과 향후 레이아웃 (새 상태가 설정될 때까지)에 적용됩니다. (Iaaf35)
  • 이제 모든 카드 렌더러 API에서 protolayout 유형이 완전히 지원됩니다. (I428b0)

버그 수정

  • 이제 ProtoLayoutViewInstance에서 맞춤 테마를 설정할 수 있습니다. (Iae8c0)

버전 1.2.0-alpha06

2023년 5월 24일

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

API 변경사항

  • StateEntryValue의 이름을 DynamicDataValue로 바꾸고 DynamicDataKey를 사용하도록 상태 API를 업데이트했습니다. (If1c01)
  • StateStore의 각 인스턴스에서 메모리 사용량과 상태 업데이트 시간이 잘 포함되고 제어되도록 StateStore에서 허용되는 항목 수를 제한하고 있습니다. 따라서 개발자는 지도에 MAX_STATE_ENTRY_COUNT개가 넘는 항목이 없어야 합니다. 그러지 않으면 StateStore를 만들거나 업데이트할 때 IllegalStateException이 발생합니다. (Ibadb3)

버전 1.2.0-alpha05

2023년 5월 10일

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

새로운 기능

  • 카드 이벤트 및 요청에 카드 ID가 추가되었습니다. 이 ID는 일부 데이터를 캐러셀의 카드 인스턴스와 연결하는 데 사용할 수 있습니다. (Ic4f83)

API 변경사항

  • 이제 TileRenderer.inflateAsync이 ListenableFuture를 반환합니다. (I2f2b9)
  • protolayout 라이브러리에 대체 항목이 있는 카드 빌더가 이제 지원 중단됨으로 표시됩니다. (Ie2029)

버그 수정

  • 이제 TileService.onTileResourcesRequest의 javadoc에서 시스템에서 메서드를 호출할 수 있는 시점을 명확히 합니다. (Iee037)

버전 1.2.0-alpha04

2023년 4월 19일

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

버그 수정

  • 이제 필요한 경우 Gradle 종속 항목이 implementation 대신 api로 올바르게 설정됩니다. (I40503)

버전 1.2.0-alpha03

2023년 4월 5일

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

API 변경사항

  • TileRenderer에 androidx.wear.protolayout 유형 지원을 추가했습니다. (I4ac7f)
  • ObservableStateStore에서 StateStore로 이름을 바꿨습니다. (Ieb0e2)
  • TileRenderer에 protolayout 유형의 오버로드를 추가했습니다. (I4ac7f)
  • TileRenderer에서 애니메이션 사용 설정 (I07dcf)

버전 1.2.0-alpha02

2023년 3월 22일

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

API 변경사항

  • Tiles Material 라이브러리가 지원 중단되었습니다. 동일한 기능을 가진 새 ProtoLayout Material 라이브러리를 사용하세요. (If242b)

버그 수정

  • protolayout 라이브러리의 새 기능을 사용하도록 TileRenderer가 업데이트되었습니다. (I832f9)

버전 1.2.0-alpha01

2023년 3월 8일

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

새로운 기능

  • protolayout 라이브러리의 리소스를 제공하기 위해 TileService에 onTileResourceRequest를 추가했습니다. (983d9c5)
  • protolayout 라이브러리의 State 및 DeviceParameters 유형을 지원하도록 ResourcesRequest 및 TileRequest를 업데이트했습니다. (88fa01d)
  • protolayout 라이브러리의 State 및 Timeline 유형을 지원하도록 TileBuilders.Tile를 업데이트했습니다. (168619c)

버그 수정

  • Javadoc이 개선되었습니다. (I3ed73)
  • onPrimary 및 노출 영역의 기본 색상이 변경되었습니다. (I0b039)

버전 1.1

버전 1.1.0

2022년 8월 24일

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

1.0.0 이후 중요 변경사항

  • Tiles Material 라이브러리가 포함된 첫 번째 공개 버전입니다. (블로그에서 자세히 알아보기)
  • 이 라이브러리에는 Material 가이드라인에 따라 사용하기 쉬운 구성요소와 레이아웃이 포함되어 있습니다. 포함된 구성요소는 Button, Chip, CompactChip, TitleChip, CircularProgressIndicator, Text입니다. 이러한 모든 구성요소에는 기본 Colors 클래스로 빌드할 수 있는 자체 색상 객체가 있어 모든 구성요소에 동일한 테마를 쉽게 적용할 수 있습니다. 색상 외에도 서체 이름을 사용하여 FontStyle 객체를 쉽게 가져올 수 있는 Typography 클래스가 있습니다.
  • 구성요소 외에 권장되는 타일 레이아웃은 PrimaryLayout, EdgeContentLayout, MultiButtonLayout, MultiSlotLayout입니다. 모든 레이아웃에는 Material 가이드라인 내에서 권장되는 패딩과 스타일이 적용되었습니다.
  • Tiles Material 라이브러리의 구성요소 및 레이아웃 목록은 Tiles의 출시 노트를 참고하세요.

버전 1.1.0-rc01

2022년 8월 10일

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

  • 베타와 RC 출시 간에 새로운 변경사항은 없습니다.

버전 1.1.0-beta01

2022년 7월 27일

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

Tiles Material 라이브러리의 1.0.0-beta01 버전에는 Material 가이드라인에 따라 빌드하기 쉬운 구성요소 및 레이아웃이 포함되어 있습니다.

포함된 구성요소는 다음과 같습니다.

  • Button: 클릭 가능한 원형 모양 객체입니다. 사전 정의된 크기 3개가 있는 아이콘이나 텍스트, 이미지가 포함되어 있습니다.
  • Chip: 클릭 가능한 경기장 모양 객체입니다. 아이콘과 기본 및 보조 라벨이 포함될 수 있고 높이는 고정되고 너비는 맞춤설정할 수 있습니다.
  • CompactChip 및 TitleChip: 각각 높이가 더 작거나 큰 두 개의 표준 칩 버전이며 텍스트 한 줄이 포함될 수 있습니다.
  • CircularProgressIndicator: 지정된 시작 각도와 종료 각도로 화면 가장자리 주변에 색상이 있는 원호입니다. 그 뒤에 전체 진행률 원호가 있는 전체 또는 부분 원을 설명할 수 있습니다.
  • Text: 권장되는 Wear Material 서체 스타일을 사용하는 스타일이 지정된 텍스트입니다.

이러한 모든 구성요소에는 기본 Colors 클래스로 빌드할 수 있는 자체 색상 객체가 있어 모든 구성요소에 동일한 테마를 쉽게 적용할 수 있습니다. 색상 외에도 서체 이름을 사용하여 FontStyle 객체를 쉽게 가져오는 Typography 클래스가 있습니다.

구성요소 외에도 권장되는 타일 레이아웃은 다음과 같습니다.

  • PrimaryLayout: 기본 또는 보조 라벨, 중앙에 콘텐츠, 하단에 기본 칩을 추가하여 맞춤설정할 수 있는 레이아웃입니다. 이 레이아웃 내의 기본 콘텐츠는 MultiSlotLayout 또는 MultiButtonLayout 객체로 추가될 수 있습니다.
  • EdgeContentLayout: 내부에 기본 콘텐츠가 있고 그 주변에 기본 또는 보조 라벨이 있는 CircularProgressIndicator를 가장자리 주위에 호스팅하는 레이아웃입니다.
  • MultiButtonLayout: 1~7개의 버튼을 포함할 수 있는 레이아웃으로, 그 수에 따라 Material 가이드라인에 따라 정렬됩니다.
  • MultiSlotLayout: 가로로 정렬되고 간격이 있는 슬롯(아이콘이나 기타 작은 콘텐츠의 경우)이 있는 행과 같은 스타일의 레이아웃입니다.

모든 레이아웃에는 Material 가이드라인 내에서 권장되는 패딩과 스타일이 적용되었습니다.

API 변경사항

  • 가이드라인과 일치하도록 이름을 변경하여 콘텐츠의 각 부분이 별도로 전달되도록 빌더에서 분리 setter를 포함하는 칩 구성요소로의 주요 리팩터링을 실행합니다. 또한 설정하지 않으면 콘텐츠 설명이 자동으로 생성됩니다. (I57622)
  • ProgressIndicatorLayout의 이름을 EdgeContentLayout으로 바꿨습니다. (Ic1aa6)
  • 버튼 크기 콘텐츠의 이름이 without _BUTTON 접미사 이름으로 바뀌었으며 Button에 관한 Javadoc 설명이 추가되었습니다. (I1dfe2)

버그 수정

  • Material Layouts의 여백, 패딩, 전체 정렬이 모든 유형의 권장 레이아웃과 화면 크기, 모양을 수용하도록 업데이트되었습니다.
  • Material Layouts를 개선했습니다. MultiSlotLayout에서 슬롯의 너비는 이제 고정 크기가 아니라 유연하기 때문에 콘텐츠를 래핑할 수 있습니다. (I52919), (If18b4)
  • CompactChip에서 탭할 수 있는 영역이 접근성 가이드라인을 준수하도록 증가되었습니다. (Ie8264)

버전 1.1.0-alpha09

2022년 6월 29일

androidx.wear.tiles:tiles-*:1.1.0-alpha09가 출시되었습니다. 버전 1.1.0-alpha09에 포함된 커밋을 확인하세요.

새로운 기능

  • ProgressIndicatorLayout에 선택적 라벨을 추가할 수 있습니다. (I30788)

API 변경사항

  • 이제 ElementMetadata의 도우미 메서드가 Modifiers 대신 ElementMetadata를 허용합니다. (I5a70f)

버그 수정

  • CompactChip의 9자 제한이 삭제되었습니다. 너무 커서 PrimaryLayout의 화면에 맞지 않는 텍스트는 생략됩니다. (Id56ec)
  • 이제 Chip의 getter에는 Content라는 접미사가 있습니다. (Iba437)
  • Tiles Material 클래스 전반의 Javadoc을 명확히 했습니다. (I56e41), (I80f31), (Iba437)

버전 1.1.0-alpha08

2022년 6월 1일

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

새로운 기능

  • Helper 클래스에 추가된 도우미 메서드로 구성요소의 메타데이터를 추적하는 데 사용할 수 있도록 메타데이터 태그를 수정자에 추가했습니다. (I70db2),(I30c3d)
  • 정적 메서드 fromLayoutElement가 Tiles Material 내부의 모든 구성요소와 레이아웃에 추가되었습니다. 컨테이너의 콘텐츠에 액세스하여 얻은 LayoutElement를 원래 유형으로 변환하고자 할 때 테스트에 사용해야 합니다. (Ia572a), (Idbd8a), (I3ae13), (I292fe), (I8b20f), (I3cacb), (I84b24)

버전 1.1.0-alpha07

2022년 5월 18일

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

API 변경사항

  • 이제 콘텐츠의 다양한 setter와 관련된 getter가 ProgressIndicatorLayout 및 PrimaryLayout에 추가되었습니다. 이제 이러한 클래스의 모든 setter에 일치하는 getter가 있습니다. (Iddbe5) (Iabe4e)
  • Material Components에서 콘텐츠 설명 관련 getter는 그 setter가 필수가 아니므로 null을 반환할 수 있습니다.
  • 전달된 콘텐츠가 없는 Button을 만들려고 하면 IllegalArgumentException이 발생합니다. (I7fc0c)
  • ChipColors의 아이콘 색상 관련 필드 이름이 iconTintColor에서 iconColor로 변경되었습니다. (Ic053b)

버그 수정

  • Tiles Material의 레이아웃에 관한 androidTests를 추가했습니다. (I96404)

버전 1.1.0-alpha06

2022년 5월 11일

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

새로운 기능

  • Material Layouts 하위 라이브러리에 새 레이아웃이 추가되었습니다. (MultiButtonLayout) Material 가이드라인에 따라 정렬된 버튼 1~7개를 포함할 수 있는 레이아웃을 나타냅니다. 대부분의 경우 이 레이아웃은 PrimaryLayout에 콘텐츠로 전달되어야 합니다. (Ib727f)

API 변경사항

  • 슬롯만 포함되도록 MultiSlotLayout이 리팩터링되었습니다. 이 레이아웃은 기본 PrimaryLayout에 콘텐츠로 전달되어야 합니다. (I1870f)
  • CircularProgressIndicator의 정의된 기본 색상을 기본 및 보조 값이 아닌 하나의 값으로 업데이트했습니다. (I64a51)
  • MultiSlotLayout에 수평 스페이서용 getter가 추가되었습니다. (I11e1e)

버그 수정

  • Tiles Material에 구성요소에 대한 Android 테스트가 추가되었습니다. (I20041)

버전 1.1.0-alpha05

2022년 4월 6일

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

새로운 기능

  • 더 쉬운 카드 빌드를 위해 LayoutElement를 Layout, Timeline, TimelineEntry로 변환하는 도우미 메서드를 추가했습니다. (I2f6d1)
  • 구성요소 색상 전체에 걸쳐 테마로 전달하도록 Colors 객체를 Material 라이브러리에 추가했습니다. (I0792c)

API 변경사항

  • Material Text 구성요소를 사용하려면 생성자에 전달되는 텍스트가 필요합니다. 이제 두께를 설정하여 이 구성요소를 맞춤설정할 수 있습니다. (I25dbd)
  • 공개 setter에서 사용되지 않는 ChipDefaults에서 상수를 삭제했습니다. (I7baed)
  • 일치하는 setter가 없는 CompactChip 및 TitleChip에서 getter를 삭제했습니다. (I99e85)
  • ProgressIndicatorDefaults에서 DEFAULT_PADDING을 삭제했습니다. (Idabcd)
  • Material 구성요소가 이제 문자열 대신 콘텐츠 설명에 CharSequence를 허용합니다. (I5b21a)

버그 수정

  • Button에서 선택적 매개변수의 setter 구현을 리팩터링했습니다. (Ib7135)
  • 글꼴 스타일 변형을 Typography의 글꼴에 추가했습니다. (I8dbc6)

버전 1.1.0-alpha04

2022년 3월 23일

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

새로운 기능

  • PrimaryLayout에 기본 또는 보조 라벨(선택사항)을 추가할 수 있습니다. (Ib9916)
  • 오버플로, 기울임꼴, 밑줄 등을 설정하여 텍스트 구성요소를 맞춤설정할 수 있습니다. (I703f7)

API 변경사항

  • Tiles Material API에서 기본 색상 상수가 삭제되었습니다. (I0ab55)
  • Tiles Material에서 클릭 가능한 모든 구성요소는 작업 대신 빌더의 생성자에 Clickable 객체가 있어야 합니다. (I2f101)

버그 수정

  • 이제 텍스트가 칩 및 텍스트 구성요소 오버플로에 생략 부호를 표시합니다. (I8a2f8)
  • 사용자가 글꼴 크기를 크게로 설정했을 때 표시되는 구성요소의 모양이 개선되었습니다. (Ib63b1)
  • PrimaryLayout에서 setPrimaryChipContent의 javadoc을 명확하게 설명합니다. (Ie6296)

버전 1.1.0-alpha03

2022년 2월 23일

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

API 변경사항

  • 권장 서체 스타일이 포함된 Text 구성요소가 Tiles Material에 추가되었습니다. (Iec0ae)

버전 1.1.0-alpha02

2022년 2월 9일

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

새로운 기능

  • Tiles Material에 새로운 하위 라이브러리 layouts를 추가했습니다. 권장되는 패딩과 여백이 적용된 체계적인 카드 레이아웃이 포함되어 있어 카드 개발을 더 빠르고 쉽게 구현할 수 있습니다. 초기 레이아웃은 다음과 같습니다.
    • PrimaryLayout(I7ba91): 하단에 기본 칩이 있고 중앙에 콘텐츠가 있는 레이아웃을 나타냅니다.
    • MultiSlotLayout(I32104): 첫 번째 행과 세 번째 행에 라벨이 있고 두 번째 행과 기본 칩이 포함된 네 번째 행 이후 모든 행에는 가로로 정렬되고 간격이 지정된 슬롯이 있는 레이아웃을 나타냅니다.
    • ProgressIndicatorLayout(I9fec6): 화면 가장자리 주위에 원형 진행률 표시기가 있고 내부에 지정된 콘텐츠가 있는 레이아웃을 나타냅니다.
  • CircularProgressIndicator(Ic4b88): Tiles Material 구성요소에 추가되었습니다.

API 변경사항

  • 이름에 제목을 포함하기 위해 TitleChip에서 사용하는 나머지 상수의 이름을 바꿨습니다. (I14f4c)
  • setHorizontalAlignment 메서드를 Chip에 추가했습니다. (Ie6e0b)

버전 1.1.0-alpha01

2022년 1월 26일

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

새로운 기능

  • 새 라이브러리 Tiles Material이 추가되었습니다. 여기에는 Material Design을 사용하여 Tiles 레이아웃을 더 쉽고 빠르게 빌드할 수 있는 구성요소가 포함되어 있습니다. 초기 구성요소는 다음과 같습니다.
    • Button
    • Chip
    • CompactChip
    • TitleChip

버그 수정

  • TileUiClient에서 캐시된 리소스가 삭제되도록 하는 버그가 수정되었습니다. (I60e0b)

버전 1.0

버전 1.0.1

2022년 1월 26일

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

버그 수정

  • TileUiClient에서 캐시된 리소스가 삭제되도록 하는 버그가 수정되었습니다. (I60e0b)

버전 1.0.0

2021년 11월 3일

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

1.0.0의 주요 기능

  • Wear Tiles 라이브러리는 Wear OS 기기용 맞춤 카드를 빌드하는 기능과 함께 시스템이 카드를 가져와서 시계 화면 바로 옆에 표시할 수 있도록 하는 클래스를 제공합니다.
  • 카드 렌더기를 사용하면 카드를 Android 활동의 일부로 표시할 수 있으므로 카드 레이아웃을 빠르게 테스트할 수 있습니다.

버전 1.0.0-rc01

2021년 10월 27일

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

버전 1.0.0-beta01

2021년 10월 13일

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

버그 수정

  • 빈 리소스 버전이 제공되었을 때 TileUiClient에서 NullPointerException을 수정했습니다. (I0586e)

버전 1.0.0-alpha12

2021년 9월 29일

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

버그 수정

  • 더 이상 UpdateScheduler가 약한 참조를 사용하지 않으며 TileUiClient가 업데이트되지 않는 문제를 수정했습니다. (I1120d, b/199061124)

  • SysUiTileUpdateRequester가 PacakgeManager를 쿼리하여 R+ 기기에서 카드 업데이트가 작동하지 않는 버그를 수정했습니다. (I1120d)

버전 1.0.0-alpha11

2021년 9월 1일

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

새로운 기능

  • 개발자가 카드를 더 쉽게 테스트할 수 있도록 테스트 라이브러리 androidx.wear.tiles:tiles-testing 라이브러리를 추가하고 출시했습니다. (Iedb6b)

API 변경사항

  • TileProviderService의 이름이 TileService로 변경되었습니다. (I1ad2c)
  • 카드 빌더를 업데이트했습니다. 정적 .builder() 메서드를 지원 중단하고 new Foo.Builder() 호출로 대체했으며 Builder 인스턴스를 허용하는 setter 오버로드를 삭제했습니다. (Ia9606)
  • 이제 TileRenderer가 애플리케이션 컨텍스트가 아닌 UI 컨텍스트를 사용해야 합니다. (I84b61)

버그 수정

  • 특정 상황에서 여러 밑줄이 적용되는 버그를 수정했습니다. (Ib6712)

버전 1.0.0-alpha10

2021년 8월 18일

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

API 변경사항

  • 공개 API에서 레이아웃 검사기를 삭제했습니다. 레이아웃 검사기는 항상 사용 설정되어 있지만 검사에 실패하는 경우에만 경고가 발생합니다. (Ie9f29)
  • TileRenderer가 이제 애플리케이션 컨텍스트가 아닌 UI 컨텍스트를 허용합니다.

버그 수정

  • Spannable에서 클릭 가능한 요소가 클릭되지 않는 버그를 수정했습니다.

버전 1.0.0-alpha09

2021년 7월 21일

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

새로운 기능

  • Wear Tiles 렌더기에 레이아웃 검사기가 추가되었습니다. (I3a869)
    • 검사기는 카드에서 권장사항을 확인하는 데 사용됩니다. 검사기를 처음 사용하는 경우 카드에 Semantics 수정자가 있는 요소가 포함되어 있지 않으면 경고가 발생합니다.
  • DefaultTileProviderClient 및 TestingTileProviderClient constructors에 관한 문서가 추가되었습니다. (I9f4b9)

API 변경사항

  • TileProviderClient에서 다음과 같이 이름이 변경되었습니다. (I0ec36)
    • getApiVersion -> requestApiVersion
    • tile/resourcesRequest -> requestTile/Resources
    • onTileFooEvent -> sendOnTileFooEvent
  • Wear Tiles 렌더기에 레이아웃 검사기가 추가되었습니다. (I3a869)

버그 수정

  • LaunchAction 대상에 특수 권한이 없는지 확인합니다. (I39136)

버전 1.0.0-alpha08

2021년 6월 30일

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

새로운 기능

  • 이제 Spannable이 line_spacing 대신 line_height를 지원합니다.

API 변경사항

  • Spannable의 line_height 지원을 추가하고 line_spacing을 삭제했습니다. (Ibeb54)
    • line_spacing을 사용하는 코드는 line_height를 대신 사용하도록 포팅해야 합니다.

버그 수정

  • 비례 측정기준을 사용할 때 발생하는 버그를 수정했습니다. (I37ace)
  • Text 요소에 콘텐츠 설명이 포함되지 못하게 하는 버그를 수정했습니다. (Id2c7d)

버전 1.0.0-alpha07

2021년 6월 16일

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

API 변경사항

  • TileProviderClient 인터페이스를 추가하고 DefaultTileProviderClient를 노출하여 구현이 TileProviderService 인터페이스에 결합할 수 있습니다. (I69165)

버전 1.0.0-alpha06

2021년 6월 2일

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

API 변경사항

  • 이제 모든 빌더 클래스가 모든 속성의 getter를 포함합니다. getter는 테스트 목적으로만 사용됩니다. (I9d155)
  • 패키지 변경: androidx.wear.tiles.builders의 클래스가 androidx.wear.tiles로 이동했습니다.
  • Tiles에 실험적인 색조 지원을 추가합니다. (I38929)
  • LayoutElementBuilders.HALIGN_*에서 LayoutElementBuilders.HORIZONTAL_ALIGN_*으로 이름이 변경되었습니다. (I67e58)
  • LayoutElementBuilders.VALIGN_*에서 LayoutElementBuilders.VERTICAL_ALIGN_*으로 이름이 변경되었습니다. (I67e58)
  • LayoutElementBuilders.SPAN_VALIGN_*에서 LayoutElementBuilders.SPAN_VERTICAL_ALIGN_*으로 이름이 변경되었습니다. (I67e58)
  • 요청 및 이벤트에 관한 빌더 클래스를 추가했습니다. (Ib5cf4)
  • RequestReaders/EventReaders가 아닌 RequestBuilders와 EventBuilders의 요청 및 이벤트 클래스를 사용하도록 TileProviderService를 이전했습니다(예: onTileRequest는 이제 RequestReaders.TileRequest가 아닌 RequestBuilders.TileRequest를 제공합니다). (I46ea1)

버그 수정

  • Tiles 렌더기의 비동기 이미지를 로드할 때 발생하는 버그를 수정했습니다. (Iad9b0)
  • 너비 또는 높이가 wrap()으로 설정된 Box에 너비 또는 높이가 expand()로 설정된 이미지를 배치할 때 발생하는 레이아웃 버그를 수정했습니다. (I33770)

버전 1.0.0-alpha05

2021년 5월 18일

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

API 변경사항

  • 수신되는 타일 이벤트(TileAddEvent, TileRemoveEvent, TileEnterEvent, TileLeaveEvent, TileRequest)에서 getTileId가 삭제되었습니다. (Ifbba2).
  • ImageResource#setAndroidResourceByResid에서 setAndroidResourceByResId로 이름이 변경되었습니다. (I4ba6e)
  • 닫기 위한 TimelineManager#deInit의 이름이 변경되었으며 AutoCloseable이 구현되었습니다. (I5dff2)

버전 1.0.0-alpha04

2021년 5월 5일

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

API 변경사항

  • 숨겨진 구체적인 TileProviderService 클래스입니다.
    • TileUpdateRequester가 Class<? extends TileProviderService>를 사용하도록 했습니다. (Ib7cca)
  • AndroidActivity에 extras를 추가하는 기능을 추가했습니다. (I748f4)

Tiles 버전 1.0.0-alpha03

2021년 4월 21일

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

API 변경사항

  • TileManager의 이름을 TileClient로 변경합니다.
    • TileManager#create의 이름을 TileClient#connect로 변경합니다. (I91839)

버그 수정

  • ProGuard가 사용 설정된 상태에서 tiles 및 tiles-renderer가 제대로 작동하도록 ProGuard 규칙을 추가했습니다. (Ie3d85)

버전 1.0.0-alpha02

2021년 4월 7일

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

API 변경사항

  • androidx.wear:wear-tiles가 그룹을 이동했으며 이제 androidx.wear.tiles:tiles라고 해야 합니다.
  • androidx.wear:wear-tiles-renderer가 그룹을 이동했으며 이제 androidx.wear.tiles:tiles-renderer라고 해야 합니다.
  • 이제 TileRenderer.LoadActionListener는 androidx.wear.tiles.proto.StateProto.State가 아닌 androidx.wear.tiles.builders.StateBuilders.State 인스턴스를 사용합니다.
  • 이제 TileRenderer는 androidx.wear.tiles.renderer.ResourceAccessors의 인스턴스가 아닌 androidx.wear.tiles.builders.ResourceBuilders.Resources의 Tile 리소스를 허용합니다.

버그 수정

  • LoadActionListener가 내부 클래스를 노출하기 때문에 사용할 수 없는 문제를 수정했습니다.

버전 1.0.0-alpha01

2021년 3월 10일

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

새로운 기능

  • Wear Tiles Renderer 라이브러리는 Wear OS 기기용 맞춤 카드를 빌드하는 기능과 함께 시스템이 카드를 가져와서 시계 화면 바로 옆에 표시할 수 있는 클래스를 제공합니다.