Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

위젯 강화

이 페이지에는 Android 12 (API 수준 31)부터 사용할 수 있는 선택적 위젯 개선사항에 관한 세부정보가 포함되어 있습니다. 이러한 기능은 선택사항이지만 구현하기 쉽고 사용자 위젯 환경을 개선합니다.

위젯을 개선하는 방법을 알아보려면 Compose 가이드 위젯 개선을 참고하세요.

동적 색상 사용

Android 12부터 위젯은 버튼, 배경, 기타 구성요소에 기기 테마 색상을 사용할 수 있습니다. 이를 통해 여러 위젯 간에 전환이 원활해지고 일관성이 유지될 수 있습니다.

동적 색상을 구현하는 방법에는 두 가지가 있습니다.

루트 레이아웃에서 시스템의 기본 테마(@android:style/Theme.DeviceDefault.DayNight)를 사용합니다.
Android용 Material 구성요소 라이브러리에서 Material 3 테마 (Theme.Material3.DynamicColors.DayNight)를 사용합니다. 이 테마는 Android용 Material 구성요소 v1.6.0부터 사용할 수 있습니다.

루트 레이아웃에서 테마를 설정한 후에는 루트 또는 그 하위 요소에서 일반 색상 속성을 사용하여 동적 색상을 선택할 수 있습니다.

사용할 수 있는 색상 속성의 예는 다음과 같습니다.

?attr/primary
?attr/primaryContainer
?attr/onPrimary
?attr/onPrimaryContainer

Material 3 테마를 사용하는 다음 예에서는 기기의 테마 색상이 '보라색'입니다. 강조 색상과 위젯 배경은 그림 1과 2에 표시된 대로 밝은 모드와 어두운 모드에 맞게 조정됩니다.

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:app="http://schemas.android.com/apk/res-auto"
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  android:background="?attr/colorPrimaryContainer"
  android:theme="@style/Theme.Material3.DynamicColors.DayNight">

  <ImageView
    ...
    app:tint="?attr/colorPrimaryContainer"
    android:src="@drawable/ic_partly_cloudy" />

    <!-- Other widget content. -->

</LinearLayout>

동적 색상의 이전 버전과의 호환성

동적 색상은 Android 12 이상을 실행하는 기기에서만 사용할 수 있습니다. 이전 버전의 맞춤 테마를 제공하려면 사용자 지정 색상과 기본 테마 속성을 사용하는 새 한정자 (values-v31)로 기본 테마를 만듭니다.

다음은 Material 3 테마를 사용하는 예입니다.

`/values/styles.xml`

<resources>
  <style name="MyWidgetTheme" parent="Theme.Material3.DynamicColors.DayNight">
    <!-- Override default colorBackground attribute with custom color. -->
    <item name="android:colorBackground">@color/my_background_color</item>

    <!-- Add other colors/attributes. -->

  </style>
</resources>

`/values-v31/styles.xml`

<resources>
  <!-- Do not override any color attribute. -->
  <style name="MyWidgetTheme" parent="Theme.Material3.DynamicColors.DayNight" />
</resources>

`/layout/my_widget_layout.xml`

<resources>
  <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    ...
    android:background="?android:attr/colorBackground"
    android:theme="@style/MyWidgetTheme" />
</resources>

음성 지원 사용 설정

앱 작업을 사용하면 Google 어시스턴트가 관련 사용자 음성 명령에 응답하여 위젯을 표시할 수 있습니다. 기본 인텐트 (BII)에 응답하도록 위젯을 구성하면 앱이 Android 및 Android Auto와 같은 어시스턴트 화면에 위젯을 사전에 표시할 수 있습니다. 사용자는 어시스턴트에서 표시하는 위젯을 런처에 고정하여 향후 참여를 유도할 수 있습니다.

예를 들어 운동 앱의 운동 요약 위젯을 구성하여 GET_EXERCISE_OBSERVATION BII를 트리거하는 사용자 음성 명령을 처리할 수 있습니다. 사용자가"Hey Google, 내가 ExampleApp에서 이번주에 몇 km나 뛰었지?" 와 같은 요청을 하여 이 BII를 트리거하면 어시스턴트가 위젯을 사전에 표시합니다.

여러 사용자 상호작용 카테고리를 다루는 수십 개의 BII가 있으므로 거의 모든 Android 앱에서 음성을 위한 위젯을 개선할 수 있습니다. 시작하려면, Android 위젯과 앱 작업 통합을 참고하세요.

더 원활한 전환 사용 설정

Android 12부터 런처는 사용자가 위젯에서 앱을 실행할 때 더 원활한 전환을 제공합니다.

이 개선된 전환을 사용 설정하려면 @android:id/background나 android.R.id.background를 사용하여 배경 요소를 식별합니다.

// Top-level layout of the widget.
<LinearLayout
    android:id="@android:id/background">
</LinearLayout>

앱은 이전 버전의 Android에서 @android:id/background를 중단 없이 사용할 수 있지만 무시됩니다.

RemoteViews의 런타임 수정 사용

Android 12부터 RemoteViews 속성의 런타임 수정을 제공하는 여러 RemoteViews 메서드를 활용할 수 있습니다. 추가된 메서드의 전체 목록은 RemoteViews API 참조를 확인하세요.

다음 코드 예에서는 이러한 메서드 중 일부를 사용하는 방법을 보여줍니다.

Kotlin

// Set the colors of a progress bar at runtime.
remoteView.setColorStateList(R.id.progress, "setProgressTintList", createProgressColorStateList())

// Specify exact sizes for margins.
remoteView.setViewLayoutMargin(R.id.text, RemoteViews.MARGIN_END, 8f, TypedValue.COMPLEX_UNIT_DP)

자바

// Set the colors of a progress bar at runtime.
remoteView.setColorStateList(R.id.progress, "setProgressTintList", createProgressColorStateList());

// Specify exact sizes for margins.
remoteView.setViewLayoutMargin(R.id.text, RemoteViews.MARGIN_END, 8f, TypedValue.COMPLEX_UNIT_DP);