Изменить настройки автомобиля

По большей части перестановка иерархии настроек относительно проста и обычно состоит из перемещения соответствующего предпочтения и PreferenceController в другой XML-файл. Если PreferenceController использует use(...) , обязательно удалите его из предыдущего SettingsFragment и добавьте в новый SettingsFragment .

На этой странице представлены примеры изменения порядка настроек для рассмотрения ситуаций, которые могут возникнуть.

Переместить базовое предпочтение

В этом примере объясняется, как переместить предпочтение с одного экрана предпочтений на другой, в котором предпочтение имеет только контроллер предпочтений по умолчанию. В этом примере вы перемещаете настройку «Единицы» с экрана настроек «Домашняя страница» на экран настроек «Система». Для этого переместите следующий XML-код из homepage_fragment.xml в соответствующее место в system_settings_fragment.xml : 

<Preference
        android:icon="@drawable/ic_settings_units"
        android:key="@string/pk_units_settings_entry"
        android:title="@string/units_settings"
        settings:controller="com.android.car.settings.common.DefaultRestrictionsPreferenceController">
        <intent android:targetPackage="com.android.car.settings"
            android:targetClass="com.android.car.settings.common.CarSettingActivities$UnitsSettingsActivity"/>
    </Preference>

Переместите настройку, которая использует use(...)

Рассмотрим следующий, более сложный пример, который перемещает все настройки во фрагменте «Предупреждение и ограничение данных» на один уровень вверх во фрагмент «Использование данных», который обновляет DataWarningAndLimitFragment.java , включив в него метод use для передачи информации в контроллеры предпочтений после создания.

  1. Переместите соответствующий XML в нужное место в data_usage_fragment.xml :
    <Preference
                android:key="@string/pk_data_usage_cycle"
                android:title="@string/app_usage_cycle"
                settings:controller="com.android.car.settings.datausage.CycleResetDayOfMonthPickerPreferenceController"/>
            <com.android.car.settings.common.LogicalPreferenceGroup
                android:key="@string/pk_data_warning_group"
                settings:controller="com.android.car.settings.datausage.DataWarningPreferenceController">
                <SwitchPreference
                    android:key="@string/pk_data_set_warning"
                    android:title="@string/set_data_warning"/>
                <Preference
                    android:key="@string/pk_data_warning"
                    android:title="@string/data_warning"/>
            </com.android.car.settings.common.LogicalPreferenceGroup>
            <com.android.car.settings.common.LogicalPreferenceGroup
                android:key="@string/pk_data_limit_group"
                settings:controller="com.android.car.settings.datausage.DataLimitPreferenceController">
                <SwitchPreference
                    android:key="@string/pk_data_set_limit"
                    android:title="@string/set_data_limit"/>
                <Preference
                    android:key="@string/pk_data_limit"
                    android:title="@string/data_limit"/>
            </com.android.car.settings.common.LogicalPreferenceGroup>
  2. В DataWarningAndLimitFragment.java определите, как используется метод use .
    @Override
    public void onAttach(Context context) {
            super.onAttach(context);

        mPolicyEditor     = new NetworkPolicyEditor(NetworkPolicyManager.from(context));
        mNetworkTemplate     = getArguments().getParcelable(
                    NetworkPolicyManager.EXTRA_NETWORK_TEMPLATE);
            if (mNetworkTemplate == null) {
            mTelephonyManager     = context.getSystemService(TelephonyManager.class);
            mSubscriptionManager     = context.getSystemService(SubscriptionManager.class);
            mNetworkTemplate     = DataUsageUtils.getMobileNetworkTemplate(mTelephonyManager,
                        DataUsageUtils.getDefaultSubscriptionId(mSubscriptionManager));
            }

            // Loads the current policies to the policy editor cache.
        mPolicyEditor    .read();

            List<DataWarningAndLimitBasePreferenceController> preferenceControllers =
                    Arrays.asList(
                           use(CycleResetDayOfMonthPickerPreferenceController.class,
                                R    .string.pk_data_usage_cycle),
                           use(DataWarningPreferenceController.class, R.string.pk_data_warning_group),
                           use(DataLimitPreferenceController.class, R.string.pk_data_limit_group));

            for (DataWarningAndLimitBasePreferenceController preferenceController :
                preferenceControllers    ) {
            preferenceController    .setNetworkPolicyEditor(mPolicyEditor);
            preferenceController    .setNetworkTemplate(mNetworkTemplate);
            }
    }

    В этом случае метод use устанавливает редактор сетевой политики и шаблон сети для контроллеров предпочтений. Поскольку в этом примере перемещаются все настройки, а весь код метода onAttach имеет отношение к установке этих параметров предпочтений, было бы целесообразно скопировать все содержимое метода в новый фрагмент. Однако это зависит от конкретных предпочтений. Вам также необходимо переместить соответствующие переменные экземпляра.

    Однако есть осложнение. Исходный фрагмент ожидал, что NetworkPolicyManager.EXTRA_NETWORK_TEMPLATE будет передан в качестве аргумента, который должен поступать от намерения к действию (если он предоставлен).

    Чтобы получить эту необходимую информацию, либо создайте метод newInstance и передайте шаблон, если он присутствует (в противном случае передайте значение null), а затем обновите действие для DataUsageFragment , либо получите информацию о намерении непосредственно в методе onAttach с помощью getActivity().getIntent() . В любом случае вы можете передать необходимую информацию для этого метода, как вы это сделали выше.

  3. Определите любые другие зависимости или ожидаемые действия намерения в старом фрагменте, прежде чем очищать старые фрагменты и файлы XML. В этом случае значение конфигурации наложения указывает на старое действие, которое необходимо обновить, чтобы оно указывало на правильное действие.

Добавьте экран предпочтений в иерархию

Чтобы добавить новый экран предпочтений в иерархию, см. раздел «Добавление настроек автомобиля» .

После создания нового экрана предпочтений используйте приведенные выше примеры, чтобы изменить иерархию предпочтений по своему усмотрению.