重新排列汽車設置

在大多數情況下,重新排列設定層次結構相對簡單,通常包括將相關首選項和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的活動,或使用getActivity().getIntent() 。無論哪種情況,您都可以像上面那樣傳遞此方法所需的資訊。

  3. 在清理舊片段和 XML 檔案之前,請確定舊片段中的任何其他依賴項或預期意圖操作。在這種情況下, 覆蓋配置值指向舊的活動,必須更新該值以指向正確的活動。

將首選項畫面新增至層次結構中

若要將新的首選項畫面新增至層次結構,請參閱新增汽車設定

建立新的首選項畫面後,使用上面的範例根據需要重新排列首選項層次結構。