Wear Tiles

Wear OS by Google 스마트시계용 애플리케이션을 만듭니다.
최근 업데이트 안정화 버전 출시 후보 베타 버전 알파 버전
2022년 6월 1일 1.0.1 - - 1.1.0-alpha08

종속 항목 선언

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

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

Groovy

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

    // Use to utilize components and layouts with Material design in your tiles
    implementation "androidx.wear.tiles:tiles-material:1.1.0-alpha08"

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

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

Kotlin

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

    // Use to utilize components and layouts with Material design in your tiles
    implementation("androidx.wear.tiles:tiles-material:1.1.0-alpha08")

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

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

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

의견

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

새로운 문제 제출하기

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

버전 1.1

버전 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가 ProgressIndicatorLayoutPrimaryLayout에 추가되었습니다. 이제 이러한 클래스의 모든 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가 없는 CompactChipTitleChip에서 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을 사용하여 카드 레이아웃을 더 쉽고 빠르게 빌드할 수 있는 구성요소가 포함되어 있습니다. 초기 구성요소는 다음과 같습니다.
    • 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-alpha10androidx.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-alpha09androidx.wear.tiles:tiles-renderer:1.0.0-alpha09가 출시되었습니다. 버전 1.0.0-alpha09에 포함된 커밋을 확인하세요.

새로운 기능

  • Wear Tiles 렌더기에 레이아웃 검사기가 추가되었습니다. (I3a869)
    • 검사기는 카드에서 권장사항을 확인하는 데 사용됩니다. 검사기를 처음 사용하는 경우 카드에 Semantics 수정자가 있는 요소가 포함되어 있지 않으면 경고가 발생합니다.
  • DefaultTileProviderClientTestingTileProviderClient 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-alpha08androidx.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-alpha07androidx.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-alpha06androidx.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가 아닌 RequestBuildersEventBuilders의 요청 및 이벤트 클래스를 사용하도록 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-alpha05androidx.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-alpha04androidx.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-alpha03androidx.wear.tiles:tiles-renderer:1.0.0-alpha03이 출시되었습니다. 버전 1.0.0-alpha03에 포함된 커밋을 확인하세요.

API 변경사항

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

버그 수정

  • ProGuard가 사용 설정된 상태에서 tilestiles-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-alpha02androidx.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.LoadActionListenerandroidx.wear.tiles.proto.StateProto.State가 아닌 androidx.wear.tiles.builders.StateBuilders.State 인스턴스를 사용합니다.
  • 이제 TileRendererandroidx.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-alpha01androidx.wear:wear-tiles-renderer:1.0.0-alpha01이 출시되었습니다. 버전 1.0.0-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

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