نمای کلی

هر صفحه تنظیمات می تواند تعدادی تنظیمات برگزیده مختلف را در خود جای دهد.

برای چگونگی ارتباط این اجزاء به تصویر زیر نگاه کنید:

شکل 1. اجزای تنظیمات خودرو

PreferenceController یک جزء آگاه از چرخه حیات است که به کپسوله کردن منطق تجاری مربوط به Preferences خاص کمک می کند. PreferenceControllers فقط می توان از طریق XML به Preference مربوطه متصل کرد.

// example_settings_fragment.xml
<PreferenceScreen
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:settings="http://schemas.android.com/apk/res-auto"
    android:title="@string/example_settings_title">
  <Preference
    android:key="@string/pk_example_preference_key"
    android:title="@string/example_preference_title"
    settings:controller="com.android.car.settings.example.ExamplePreferenceController"/>
</PreferenceScreen>

تنظیمات خودرو به صراحت از ایجاد PreferenceController از طریق کد جلوگیری می کند تا اصلاح سلسله مراتب تنظیمات را با حداقل تغییرات در کد جاوا آسان تر کند.

این امکان وجود دارد که یک PreferenceController برای عملکرد صحیح به مقداری داده پویا نیاز داشته باشد. برای مثال، یک PreferenceController که اعلان‌های یک برنامه را خاموش می‌کند، باید بداند روی کدام برنامه عمل کند. از آنجایی که PreferenceControllers همیشه در XML تعریف می شوند، راهی برای ارائه آرگومان های سازنده اضافی وجود ندارد. در عوض، این مقادیر اضافی از طریق تنظیم کننده های عمومی در PreferenceController ارائه می شوند و با استفاده از روش use(...) از SettingsFragment تنظیم می شوند.

// ExamplePreferenceController.java
public class ExamplePreferenceContorller extends PreferenceController<Preference> {

  private ExampleArg mExampleArg;

  public ExamplePreferenceController(...) {
    ...
  }

  public void setExampleArg(ExampleArg exampleArg) {
    mExampleArg = exampleArg;
  }
}

// ExampleSettingsFragment.java
public class ExampleSettingsFragment extends SettingsFragment {

  @Override
  @XmlRes
  protected int getPreferenceScreenResId() {
    Return R.xml.example_settings_fragment;
  }

  @Override
  public void onAttach(Context context) {
    ExampleArg arg = (ExampleArg) getArguments().getSerializeable(ARG_KEY);
    ExamplePreferenceController controller =
        use(ExamplePreferenceController.class, R.string.pk_example_preference_key);
    controller.setExampleArg(arg);
  }
}

هرچه بیشتر از روش use(...) استفاده شود، حفظ هدف اصلی یعنی امکان تنظیم مجدد سلسله مراتب تنظیمات با حداقل تغییرات در کد جاوا سخت تر می شود، زیرا بخش های بزرگی از کد قطعه موجود باید در قطعه جدید ایجاد شده کپی شود. یک راه برای به حداقل رساندن دشواری انجام این کار این است که:

• استفاده از use(...) .
• سعی کنید هر فراخوانی برای use(...) در یک مکان در قطعه نگه دارید (مثلاً در متد onAttach() ).

// ExampleSettingsFragment.java
public class ExampleSettingsFragment extends SettingsFragment {

    @Override
    protected List<MenuItem> getToolbarMenuItems() {
        return Collections.singletonList(mClearConfirmButton);
    }

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        mButton = new MenuItem.Builder(getContext())
                .setTitle(R.string.text)
                .setOnClickListener(mOnClickListener)
                .setUxRestrictions(CarUxRestrictions.UX_RESTRICTIONS_NO_SETUP)
                .build();
    }

    private void updateState() {
        button.setVisible(false);
    }
}

// example_settings_fragment.xml
<PreferenceScreen
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:settings="http://schemas.android.com/apk/res-auto"
    android:title="@string/example_settings_title">
  <Preference
    android:key="@string/pk_example_preference_key"
    android:title="@string/example_preference_title"
    settings:controller="com.android.car.settings.example.ExamplePreferenceController"/>
</PreferenceScreen>

// ExamplePreferenceController.java
public class ExamplePreferenceContorller extends PreferenceController<Preference> {

  private ExampleArg mExampleArg;

  public ExamplePreferenceController(...) {
    ...
  }

  public void setExampleArg(ExampleArg exampleArg) {
    mExampleArg = exampleArg;
  }
}

// ExampleSettingsFragment.java
public class ExampleSettingsFragment extends SettingsFragment {

  @Override
  @XmlRes
  protected int getPreferenceScreenResId() {
    Return R.xml.example_settings_fragment;
  }

  @Override
  public void onAttach(Context context) {
    ExampleArg arg = (ExampleArg) getArguments().getSerializeable(ARG_KEY);
    ExamplePreferenceController controller =
        use(ExamplePreferenceController.class, R.string.pk_example_preference_key);
    controller.setExampleArg(arg);
  }
}