자동차 UI 환경설정 맞춤설정

이 도움말에서는 앱의 환경설정을 표시하는 데 사용하는 UI 요소를 포함한 com.android.car.ui.preference 패키지의 요소를 사용하고 맞춤설정하는 방법을 설명합니다.

대부분의 요소는 CarUi 맞춤설정을 추가하는 com.androidx.preference 클래스의 서브클래스로 만듭니다. 대부분의 경우 com.android.car.PreferenceFragment를 사용하여 com.android.car.ui.preferences 패키지의 요소를 사용할 수 있습니다. PreferenceFragment는 모든 androidx.preference 요소를 그에 대응하는 car.ui.preferences의 요소로 대체합니다. 기능의 실제 동작을 보려면 car-ui-lib Paintbooth 참조 앱을 확인하세요. 예:

자동차 UI 환경설정 레이아웃

그림 1. 자동차 UI 환경설정 레이아웃

사용 가능한 환경설정 유형

PreferenceFragment

PreferenceFragment는 androidx.preference.PreferenceFragmentCompat의 서브클래스이며, 클라이언트가 사용해야 하는 기본 클래스입니다. 이 클래스는 setPreferenceScreen을 호출하는 동안 androidx.preference의 요소를 car.ui.preference의 동일한 요소 중 사용할 수 있는 요소로 자동 대체합니다.

<style name="PreferenceFragment.CarUi">
        <item name="android:divider">?android:attr/listDivider</item>
        <item name="android:layout">@layout/car_ui_preference_fragment_with_toolbar</item>
</style>

CarUiPreference

다음 속성을 지원하는 androidx.preference.Preference 클래스의 CarUi와 같으며, 런타임 리소스 오버레이(RRO)를 사용하여 맞춤설정할 수 있습니다. CarUiPreference 스타일의 변형을 사용하는 다른 모든 CarUi 요소도 다음 속성을 지원합니다.

<declare-styleable name="CarUiPreference">
      <!-- Toggle for showing chevron -->
      <attr name="showChevron" format="boolean" />
      <!-- Show ripple when disabled preference is clicked -->
      <attr name="showRippleOnDisabledPreference" format="boolean" />
</declare-styleable>

다음은 androidx.Preference 테마를 확장하는 com.android.car.ui.preference의 기본 스타일입니다. chevron 드로어블은 car_ui_preference_icon_chevron.xml에 정의되어 있습니다.

<selector xmlns:android="http://schemas.android.com/apk/res/android">
  <item android:state_enabled="false" android:drawable="@drawable/car_ui_preference_icon_chevron_disabled"/>
  <item android:state_enabled="true" android:drawable="@drawable/car_ui_preference_icon_chevron_enabled"/>
</selector>

ripple은 car_ui_recyclerview_button_ripple_background에 정의되어 있습니다.

<ripple
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:color="@color/car_ui_ripple_color" />

<style name="Preference.CarUi">
        <item name="allowDividerBelow">false</item>
        <item name="allowDividerAbove">false</item>
        <item name="android:layout">@layout/car_ui_preference</item>
</style>

위 스타일의 레이아웃이 오버레이되고 있다면 클라이언트는 최소한 새 레이아웃이 그에 상응하는 androidx 클래스에서 예상하는 ID를 제공하는지 확인해야 합니다. 이는 이 기본 스타일을 사용하는 다른 요소에도 적용됩니다.

CarUiDropDownPreference

androidx.preference.DropDownPreference 클래스의 CarUi이며 다음과 같은 스타일을 사용합니다.

<style name="Preference.CarUi.DropDown">
        <item name="android:layout">@layout/car_ui_preference_dropdown</item>
</style>

CarUiRadioButtonPreference

androidx.preference.TwoStatePreference의 서브클래스는 초기화 중에 car_ui_radio_button_preference_widget 레이아웃을 확장합니다. 이 레이아웃이 RRO에서 오버레이되고 있다면 새 레이아웃에서 ID가 R.id.radio_button인 android.widget.RadioButton 유형의 요소를 포함해야 하며, 기본 클래스에서 필요한 다른 요소와 ID도 포함해야 합니다.

CarUiSwitchPreference

androidx.preference.SwitchPreference 클래스의 CarUi와 같습니다. CarUi와의 차이는 이 요소가 사용 설정되지 않으면 토스트 메시지가 표시된다는 것입니다. 토스트 메시지는 Android 10과 Android 11에서 setMessageToShowWhenDisabledPreferenceClicked 메서드를 호출하여 맞춤설정할 수 있습니다. 이 요소는 다음 스타일을 사용합니다.

<style name="Preference.CarUi.SwitchPreference">
        <item name="android:widgetLayout">@layout/car_ui_preference_widget_switch</item>
        <item name="android:switchTextOn">@string/car_ui_preference_switch_on</item>
        <item name="android:switchTextOff">@string/car_ui_preference_switch_off</item>
</style>

CarUiTwoActionPreference

보조 작업을 사용 설정하는 CarUiPreference의 서브클래스입니다. 이 요소를 맞춤설정하는 데 사용할 수 있는 속성 유형은 아래와 같습니다.

<declare-styleable name="CarUiTwoActionPreference">
        <!-- Determines if the secondary action is initially shown -->
        <attr name="actionShown" format="boolean"/>
</declare-styleable>

이 요소는 기본 클래스와 동일한 스타일을 사용하며 R.id.action_widget_container와 android.R.id.widget_frame이 필요합니다.

CarUiDialogFragment

이 클래스는 CarUi와 관련된 몇 가지 추가 사항 외에 androidx.preference.PreferenceDialogFragmentCompat에서 현재 상태로 제공됩니다. 클라이언트는 이 클래스의 서브클래스를 사용하여 테마 플랫폼 AlertDialog를 표시해야 합니다.

PreferenceDialogFragment

CarUiDialogFragment 의 직접적인 서브클래스입니다. 클라이언트는 이 클래스를 서브클래스화하여 테마 플랫폼 AlertDialog를 표시해야 합니다.

CarUiEditTextPreference

이는 androidx.preference.EditTextPreference 클래스의 CarUi와 같습니다.

<style name="Preference.CarUi.DialogPreference.EditTextPreference">
        <item name="android:dialogLayout">@layout/car_ui_preference_dialog_edittext</item>
</style>

위 스타일의 레이아웃이 오버레이되고 있다면 클라이언트는 새 레이아웃이 androidx.preference.EditTextPreference 클래스에서 예상하는 ID를 제공하는지 확인해야 합니다.

EditTextPreferenceDialogFragment

PreferenceDialogFragment의 직접적인 서브클래스입니다. 또한, androidx.preference.PreferenceDialogFragments 클래스의 CarUi와 같습니다. 클라이언트는 이 클래스를 사용하여 테마 플랫폼 AlertDialog를 표시해야 합니다.

CarUiSeekBarDialogPreference

SeekBar 기능을 제공하는 androidx.preference.DialogPreference 클래스의 구현은 다음과 같습니다.

<style name="Preference.CarUi.SeekBarPreference">
        <item name="android:layout">@layout/car_ui_preference_widget_seekbar</item>
        <item name="adjustable">true</item>
        <item name="showSeekBarValue">false</item>
</style>

SeekBarPreferenceDialogFragment

대화상자에 SeekBar가 있는 레이아웃을 제공하는 프래그먼트입니다.

CarUiListPreference

androidx.preference.ListPreference 클래스의 CarUi와 같습니다.

ListPreferenceFragment

androidx.preference.ListPreference가 있는 레이아웃을 제공하는 프래그먼트입니다.

CarUiMultiSelectListPreference

androidx.preference.Preference 클래스의 CarUi와 같습니다.

MultiSelectListPreferenceFragment

com.android.car.ui.CarUiMultiSelectListPreference가 있는 레이아웃을 제공하는 프래그먼트입니다.