위젯 강화

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

동적 색상 사용

Android 12부터 위젯은 기기 테마 색상을 사용할 수 있습니다. 다른 구성요소를 적용할 수 있습니다. 이렇게 하면 여러 위젯 간의 전환 및 일관성을 개선할 수 있습니다.

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

• 루트 레이아웃에서 시스템의 기본 테마(@android:style/Theme.DeviceDefault.DayNight)를 사용합니다.

• 다음에서 Material 3 테마 (Theme.Material3.DynamicColors.DayNight)를 사용하세요. Android 라이브러리(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>

<ph type="x-smartling-placeholder">

</ph>

그림 1. 밝은 테마의 위젯

를 통해 개인정보처리방침을 정의할 수 있습니다.

를 통해 개인정보처리방침을 정의할 수 있습니다.

그림 2. 어두운 테마의 위젯

도움말: Material 3 테마를 사용하여 기기 간 일관성을 위한 Material Design 가이드라인 호환성을 제공합니다.

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

동적 색상은 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 어시스턴트가 관련 사용자 음성 명령에 대한 응답으로 위젯을 표시합니다. GCP 콘솔에서 위젯을 사용하여 내장 인텐트 (BII), 앱이 사전에 Android 및 Android와 같은 어시스턴트 노출 영역에 위젯을 표시할 수 있습니다. Android Auto 사용자는 어시스턴트가 표시한 위젯을 런처에 고정하여 향후 참여를 유도할 수 있습니다.

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

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

앱의 위젯 선택 도구 환경 개선

Android 12에서는 동적 위젯 미리보기와 위젯 설명을 추가하여 앱의 위젯 선택 도구 환경을 개선할 수 있습니다.

위젯 선택 도구에 확장 가능한 위젯 미리보기 추가

Android 12부터 위젯 선택 도구에 표시되는 위젯 미리보기는 크기를 조절할 수 있습니다. 이를 위젯의 기본 크기로 설정됩니다. 이전에는 위젯 미리보기가 경우에 따라 홈 화면에 추가됩니다.

확장 가능한 위젯 미리보기를 구현하려면 appwidget-provider 요소의 previewLayout 속성을 사용하여 XML 레이아웃을 대신 제공합니다.

<appwidget-provider
    android:previewLayout="@layout/my_widget_preview">
</appwidget-provider>

실제 위젯과 동일한 레이아웃을 사용하고 현실적인 기본값을 사용하는 것이 좋습니다. 또는 테스트 값일 수 있습니다. 대부분의 앱은 동일한 previewLayout 및 initialLayout를 사용합니다. 정확한 미리보기 레이아웃을 만드는 방법에 관한 안내는 이 페이지의 다음 섹션을 참고하세요.

previewLayout 속성과 previewImage 속성을 모두 지정하는 것이 좋습니다. 사용자의 기기가 다시 작동하는 경우 앱이 previewImage를 사용하도록 되돌아갈 수 있습니다. previewLayout을(를) 지원하지 않습니다. previewLayout 속성이 우선 적용됨 previewImage 속성에 매핑해야 합니다.

정확한 미리보기를 빌드하기 위한 권장 접근 방식

확장 가능한 위젯 미리보기를 구현하려면 다음 항목의 previewLayout 속성을 사용합니다. appwidget-provider 요소를 사용하여 XML 레이아웃을 제공합니다.

<appwidget-provider
    ...
    android:previewLayout="@layout/my_widget_preview">
</appwidget-provider>

<ph type="x-smartling-placeholder">

</ph> <ph type="x-smartling-placeholder">

</ph> 그림 3. 기본적으로 3x3 영역에 표시되지만 XML 레이아웃으로 인해 3x1 영역에 맞을 수 있는 위젯 미리보기입니다.

정확한 미리보기를 표시하려면 다음 단계를 완료하여 실제 위젯 레이아웃에 기본값을 직접 제공하면 됩니다.

• TextView 요소의 android:text="@string/my_widget_item_fake_1" 설정

  참고: tools 태그를 사용하여 설정된 값(예: tools:text="@string/my_wdiget_item_fake_1"는 미리보기에 표시되지 않습니다.

• ImageView 구성요소에 기본 이미지 또는 자리표시자 이미지 또는 아이콘(예: android:src="@drawable/my_widget_icon")을 설정합니다.

기본값이 없으면 미리보기에 잘못되거나 빈 값이 표시될 수 있습니다. 이 접근 방식의 중요한 이점은 현지화된 미리보기를 제공할 수 있다는 것입니다. 있습니다.

ListView가 포함된 더 복잡한 미리보기에 권장되는 접근 방식의 경우 GridView 또는 StackView의 경우 동적을 포함하는 정확한 미리보기 빌드 항목을 참조하세요.

확장 가능한 위젯 미리보기와의 하위 호환성

Android 11 (API 수준 30) 이하에서 위젯 선택 도구에 위젯에서 previewImage를 속성의 값을 제공합니다.

위젯의 모양을 변경하면 미리보기 이미지를 업데이트합니다.

위젯 설명 추가

Android 12부터 위젯에 대한 설명 제공 위젯에 표시할 선택 도구입니다.

그림 4. 위젯을 보여주는 샘플 위젯 선택 도구 확인할 수 있습니다

<appwidget-provider> 요소의 description 속성을 사용하여 위젯 설명을 제공합니다.

<appwidget-provider
    android:description="@string/my_widget_description">
</appwidget-provider>

참고: 간결하게 작성하세요. 글자 수 제한은 없지만 설명의 표시 및 사용 가능한 공간은 기기에 따라 다를 수 있습니다.

이 descriptionRes 속성을 지원하지만 위젯에서 무시됩니다. 선택 도구를 클릭합니다.

더 원활한 전환 사용 설정

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

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

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

경고: 브로드캐스트를 사용하지 마세요. 트램펄린 Android 12부터 앱은 계속해서 broadcast receiver 또는 서비스(위젯 클릭의 PendingIntent 하지만 새로운 앱은 broadcast receiver나 서비스에서 실행된 앱에는 애니메이션이 사용되지 않습니다. 이로 인해 사용자 경험이 저하됩니다.

앱은 이전 버전의 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)

Java

// 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);