Wear

사용자 가이드 코드 샘플

API 참조
androidx.wear.activity
androidx.wear.ambient
androidx.wear.complications
androidx.wear.input
androidx.wear.utils
androidx.wear.widget
androidx.wear.watchface
androidx.wear.widget.drawer
(모든 wear 패키지 관련 refdoc 참고)

Wear OS by Google 스마트시계용 애플리케이션을 만듭니다.

이 표에는 androidx.wear 그룹의 모든 아티팩트가 나열됩니다.

아티팩트	현재 안정화 버전	다음 버전 후보	베타 버전	알파 버전
Wear	1.1.0	-	-	1.2.0-alpha02
wear-input	-	1.0.0-rc01	-	-
wear-complications-data	-	-	-	1.0.0-alpha02
wear-complications-provider	-	-	-	1.0.0-alpha02
wear-watchface	-	-	-	1.0.0-alpha02
wear-watchface-client	-	-	-	1.0.0-alpha02
wear-watchface-complications-rendering	-	-	-	1.0.0-alpha02
wear-watchface-data	-	-	-	1.0.0-alpha02
wear-watchface-style	-	-	-	1.0.0-alpha02

이 라이브러리는 2020년 11월 11일에 최종 업데이트되었습니다.

종속 항목 선언

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

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

dependencies {
    implementation "androidx.wear:wear:1.1.0"

    // Add support for wearable specific inputs
    implementation "androidx.wear:wear-input:1.0.0"
    implementation "androidx.wear:wear-input-testing:1.0.0"

    // Use to implement wear watchface complications
    implementation "androidx.wear:wear-complications-provider:1.0.0-alpha04"

    // Use to implement wear watchfaces
    implementation "androidx.wear:wear-watchface:1.0.0-alpha04"
}

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

의견

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

새 문제 만들기

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

Wear Complications 및 Watchface 1.0.0

버전 1.0.0-alpha02

2020년 11월 11일

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

API 변경사항

ComplicationDetails는 이제 ComplicationState라고 불리며 적절하게 래핑됩니다. 웨어러블 지원 @ComplicationData.ComplicationType을 androidx ComplicationType으로 이전하여 사용하게 되었습니다. (I4dd36)
선택적 highlightedComplicationId 매개변수가 RenderParameters에 추가되어 단일 정보 표시가 스크린샷에 강조표시되도록 요청할 수 있습니다. (I66ce9)
ComplicationProviderService에서 일관성을 위해 새로운 스타일의 정보 표시 API를 사용합니다.(Id5aea 참조)
getPreviewReferenceTimeMillis가 이제 DeviceConfig에서 참조 시간을 가져옵니다. (I779fe 참조)
Renderer API 노출 영역을 단순화하여 대신 SurfaceHolder.Callback을 사용하여 변경사항을 관찰할 수 있습니다. (I210db 참조)
CanvasComplicationRenderer는 Renderer에서 확장되지 않으므로 명확히 하기 위해 이름이 바뀌었습니다. (Ibe880)

버그 수정

androidx.wear:wear-watchface-client의 첫 번째 버전(I1e35e 참조)
명확히 하기 위해 GlesTextureComplication#renderer의 이름을 바꿈(Ib78f7 참조)
명확히 하기 위해 StyleCategory의 이름을 StyleSetting으로 바꿈(I488c7 참조)
더 깔끔한 API를 위해 UserStyleSchema 추가(If36f8 참조)

버전 1.0.0-alpha01

2020년 10월 28일

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

API 변경사항

공개 API에 노출할 의도가 아니었던 사항을 삭제했습니다. (I41669 참조)
androidx.wear:wear-complications-provider 라이브러리를 만듭니다. (I77f1f 참조)
ComplicationsUserStyleCategory는 정보 표시 구성에 추천되는 새로운 카테고리(I96909 참조)
wear-complication-data API를 추가합니다. (I7c268 참조)
부울 반환 값이 있는 함수에 'get'이 아닌 'is'라는 접두사를 사용함(If36ff 참조)
이 클래스가 생성자를 통해 매개변수를 가져오도록 리팩터링되었으므로 보호 대상 API를 사용하지 않는 것이 좋습니다. (I61644 참조)
명확히 하기 위해 setBackgroundComplication의 이름을 바꿉니다. (I96fe3 참조)
ComplicationDrawable isHighlighted 및 데이터에 Kotlin 속성 사용(I4dcc8 참조)
ComplicationRenderer.InvalidateCallback 대신 Complication#invalidate() 추가(I4f4c6 참조)
이러한 API는 WearableSupport에서 지원 중단되어 여기에서 삭제되었습니다. (Ib425c 참조)
Wear 2.0 기존 특성을 강조하기 위해 일부 WatchFace 빌더 메서드 이름을 바꿨습니다. (Idb775 참조)
wear/wear-watchface용 첫 번째 베타 API 후보(Id3981 참조)
최초의 추적되는 API 버전입니다. (Ie9fe6 참조)
ComplicationDrawable.BorderStyle IntDef를 적절하게 숨기고 일관성을 위해 ComplicationStyle로 이동합니다. (I27f7a 참조)
ComplicationStyle 메서드의 누락된 주석 추가(I838fd 참조)
이 라이브러리에는 공개 API 노출 영역이 없습니다.(I88e2b 참조)
모든 스타일 카테고리 Option 클래스가 이제 적절하게 마무리되었습니다. (Ib8323 참조)
최초의 추적되는 API 버전입니다. (I27c85)

버그 수정

명시적인 getComplicationPreviewData 메서드를 포함하도록 ComplicationProviderService를 변경했습니다. (I4905f 참조)
MissingGetterMatchingBuilder의 API 린트 검사가 androidx용으로 사용 설정되었습니다. (I4bbea, b/138602561 참조)
wear-complications-rendering의 이름을 바꿉니다. (Ifea02 참조)
이제 스타일 카테고리 표시 이름이 CharSequences임(I28990 참조)
현재 테마 및 스타일 이름 지정 규칙에 맞게 Override를 Overlay로 대체합니다. (I4fde9 참조)
명확히 하기 위해 UserStyle#getOptions의 이름을 바꿨습니다. (I695b6)

버전 1.2.0

버전 1.2.0-alpha02

2020년 11월 11일

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

이 릴리스에서는 새로운 'Ongoing Activities API'를 처음 추가했습니다. 개발자는 이 API를 사용하여 피트니스 운동이나 미디어 재생 세션과 같은 장시간 활동이 진행 중임을 알릴 수 있습니다. 이 API를 통해 개발자는 시계 모드 또는 앱 런처에 표시되도록 '달린 거리 및 시간' 또는 '재생 중인 현재 트랙' 같은 주기적인 상태 업데이트를 제공할 수 있습니다. 이 기능은 진행 중인 활동 기능이 사용 설정되는 미래 기기를 타겟팅합니다.

API 변경사항

진행 중인 활동을 위한 새로운 API는 '지원되지 않는 기기'에서 노옵스(no-ops)입니다. (I69a31)

버전 1.2.0-alpha01

2020년 10월 28일

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

새로운 기능

뷰에 표현될 수 있는 가장 큰 원의 곡선에 따라 구부러진 텍스트가 쉽게 작성되도록 WearCurvedTextView 구성요소를 추가했습니다. 사용 예는 다음과 같습니다.

<androidx.wear.widget.WearCurvedTextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="example curved text"
        app:anchorAngleDegrees="180"
        app:anchorPosition="center"
        app:clockwise="false"
        style="@android:style/TextAppearance.Large"
/>

Android Wear의 구부러진 텍스트 예

원호에 시계 방향이나 시계 반대 방향으로 하위 요소를 하나씩 배치하는 WearArcLayout 컨테이너를 추가했습니다. 하위 요소는 ArcLayoutWidget 인터페이스를 구현하는 표준 Android 위젯 또는 '구부러진' 위젯일 수 있습니다. 사용 예는 다음과 같습니다.

<androidx.wear.widget.WearArcLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:anchorPosition="center">
      <ImageView
              android:layout_width="20dp"
              android:layout_height="20dp"
              android:src="@drawable/ic_launcher"
      />
      <androidx.wear.widget.WearCurvedTextView
              android:layout_width="match_parent"
              android:layout_height="match_parent"
              android:text="Curved Text"
              style="@android:style/TextAppearance.Small"
              android:padding="2dp"
       />
  </androidx.wear.widget.WearArcLayout>

Android Wear의 아치 텍스트 예

(I536da 참조)

Wear-Input 1.0.0

버전 1.0.0-rc01

2020년 11월 11일

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

이 버전은 1.0.0-beta01 버전과 동일합니다.

버전 1.0.0-beta01

2020년 10월 28일

androidx.wear:wear-input:1.0.0-beta01 및 androidx.wear:wear-input-testing:1.0.0-beta01 버전은 1.1.0-alpha01 이후 변경사항 없이 출시되었습니다. 버전 1.0.0-beta01에 포함된 커밋을 확인하세요.

Wear-Input-Testing 버전 1.0.0-alpha01

2020년 10월 14일

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

API 변경사항

androidx.wear:wear-input 라이브러리로 개발된 애플리케이션의 테스트를 지원하는 androidx.wear.input.WearableButtonsProvider를 구현하는 androidx.wear.input.test.TestWearableButtonsProvider를 추가했습니다. (I0ed0c)

Wear-Input 버전 1.0.0-alpha01

2020년 9월 2일

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

새로운 기능

WearableButtons 기능을 웨어러블 지원 라이브러리에서 Jetpack으로 이전합니다. 추가 테스트 지원은 다음 Jetpack 출시의 androidx.wear:wear-input-testing 라이브러리에서 제공됩니다.

버전 1.1.0

2020년 10월 14일

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

1.0.0 이후 주요 변경사항

Android 이름 지정 규칙을 준수하기 위해 BoxInsetLayout의 boxedEdges 속성(현재 layout_BoxedEdges)에 layout_ 접두사가 추가되었습니다. 이렇게 하면 Android 스튜디오에서 이 속성의 린터 오류가 삭제됩니다. (I4272f 참조)
확인 대화상자가 표시되는 기간을 허용하도록 선택사항인 EXTRA_ANIMATION_DURATION_MILLIS가 ConfirmationActivity에 추가되었습니다. (adb83ce, b/143356547 참조)
창이 처음 열릴 때까지 작업 창 확장을 지연하는 WearableActionDrawView가 업데이트되었습니다. (I01026, b/163870541)

버전 1.1.0-rc03

2020년 9월 2일

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

버그 수정

작업 창이 열릴 때 내용이 표시되지 않는 문제가 해결되었습니다. (I01026, b/163870541)

버전 1.1.0-rc02

2020년 6월 24일

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

버그 수정

Android 이름 지정 규칙을 준수하기 위해 BoxInsetLayout의 boxedEdges 속성(현재 layout_boxedEdges)에 layout_ 접두사가 추가되었습니다. 이렇게 하면 Android 스튜디오에서 이 속성의 린터 오류가 삭제됩니다.

버전 1.1.0-rc01

2020년 5월 14일

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

버전 1.1.0-beta01

2020년 4월 29일

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

버전 1.1.0-alpha01

2020년 4월 15일

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

API 변경사항

확인 대화상자가 표시되는 기간을 허용하도록 선택사항인 EXTRA_ANIMATION_DURATION_MILLIS가 ConfirmationActivity에 추가되었습니다. (adb83ce, 134523c, b/143356547)

버그 수정

창이 처음 열릴 때까지 작업 창 확장을 지연하는 WearableActionDrawView가 업데이트되었습니다. (5cd32f7)