新增車輛設定

汽車設定中的大部分頁面都會實作為一系列可擴充 SettingsFragment 的區塊，每個區塊都有在 CarSettingActivities 中定義的專屬活動。這些靜態活動是從 BaseCarSettingsActivity 擴充而來。除了這些設定之外，您也可以將其他系統應用程式的偏好設定插入 CarSettings。

在「車輛設定」中新增偏好設定

如要新增設定，請按照下列步驟操作：

  1. 定義 XML 檔案：
    1. 請確認所有偏好設定都已定義 android:key。鍵清單會保留在 preference_keys.xml 中。偏好設定鍵不得重複。
    2. 為了進行搜尋索引，偏好設定畫面也應定義 android:key。偏好設定畫面鍵的清單會保留在 preference_screen_keys.xml 中。偏好設定畫面鍵也應是唯一的。
    3. 如果偏好設定只顯示靜態資訊 (例如沒有特殊商業邏輯)，請將偏好設定控制器設為 com.android.car.settings.common.DefaultRestrictionsPreferenceController。
    4. 如果偏好設定需要商務邏輯，請使用新的偏好設定控制器名稱設定偏好設定控制器。
  2. (如有必要) 在適當的套件中建立偏好設定控制器，該套件會擴充 PreferenceController。如有需要，請參閱 Javadoc。
  3. 使用 getPreferenceScreenResId 建立片段，並傳回步驟 1 中定義的 XML 檔案。
  4. 在 CarSettingActivities 中建立可擴充 BaseCarSettingsActivity 的活動，然後實作 getInitialFragment()，傳回在步驟 3 中定義的片段。
  5. 更新 AndroidManifest.xml，納入步驟 4 中定義的活動。

範例

以下說明這項程序。

  1. 定義名為 demo_fragment.xml 的 XML 檔案：
    <PreferenceScreen
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:settings="http://schemas.android.com/apk/res-auto"
    android:title="@string/demo_label"
    android:key="@string/psk_demo">
    <Preference
        android:icon="@drawable/ic_settings_demo_preference_1"
        android:key="@string/pk_demo_preference_1"
        android:title="@string/demo_preference_1_title"
settings:controller="com.android.car.settings.common.DefaultRestrictionsPreferenceController">
        <intent android:targetPackage="com.android.car.settings"
android:targetClass="com.android.car.settings.common.CarSettingActivities$DemoSetting1Activity"/>
    </Preference>
    <Preference
        android:icon="@drawable/ic_settings_demo_preference_2"
        android:key="@string/pk_demo_preference_2"
        android:title="@string/demo_preference_2_title"
settings:controller="com.android.car.settings.example.MyCustomRestrictionsPreferenceController">
        <intent android:targetPackage="com.android.car.settings"
android:targetClass="com.android.car.settings.common.CarSettingActivities$DemoSetting2Activity"/>
    </Preference>
</PreferenceScreen>
  2. 將偏好設定鍵加入 preference_keys：
    <resources>
    [...]
    <string name="pk_demo_preference_1" translatable="false">demo_preference_1</string>
    <string name="pk_demo_preference_2" translatable="false">demo_preference_2</string>
</resources>
  3. 將偏好設定畫面鍵新增至 preference_screen_keys.xml：
    <resources>
    [...]
    <string name="psk_demo" translatable="false">demo_screen</string>
</resources>

    在第一個偏好設定範例中，請使用 DefaultRestrictionsPreferenceController。針對第二個偏好設定，請使用自訂偏好設定控制器，並定義該控制器。在本例中，您可以將這項偏好設定自訂為「僅限」可用的管理員使用者。如要這麼做，請定義下列自訂控制器：

    public class MyCustomRestrictionsPreferenceController extends 
    PreferenceController<Preference> {

    private final UserManager mUserManager;

    public MyCustomRestrictionsPreferenceController(Context context, String 
        preferenceKey, FragmentController fragmentController, 
        CarUxRestrictions uxRestrictions) {
        super(context, preferenceKey, fragmentController, uxRestrictions);
        mUserManager = UserManager.get(context);
    }

    @Override
    protected Class<Preference> getPreferenceType() {
        return Preference.class;
    }

    @Override
    public int getAvailabilityStatus() {
        return mUserManager.isAdminUser() ? AVAILABLE : DISABLED_FOR_USER;
    }
}
  4. 如要建立片段，請覆寫 getPreferenceScreenResId：
    5. public class DemoFragment extends SettingsFragment {

    @Override
    @XmlRes
    protected int getPreferenceScreenResId() {
        return R.xml.demo_fragment;
    }
}
  5. 如要保留新的片段，請在 CarSettingActivities 中建立活動：
    6. public class CarSettingActivities {
    [...]
    public static class DemoActivity extends BaseCarSettingsActivity {
        @Nullable
        @Override
        protected Fragment getInitialFragment() {
            return new DemoFragment();
        }
    }
}
  6. 使用新活動更新資訊清單檔案：
    7. <application
    [...]
    <activity
        android:name=".common.CarSettingActivities$DemoActivity"
        android:exported="true">
        <meta-data android:name="distractionOptimized" android:value="true"/>
    </activity>
    [...]
</application>

    在「車輛設定」中新增外部意圖偏好設定

    除了插入偏好設定，您也可以將偏好設定直接插入 Car 設定，讓系統將意圖傳送至其他應用程式。只要在偏好設定畫面中加入偏好設定，並使用可解析至外部應用程式之意圖動作，即可完成這項操作。與 Car 設定中的其他偏好設定一樣，這些偏好設定具有相同的 XML 屬性。

    <Preference
    android:key="@string/pk_demo_preference"
    android:title="@string/demo_preference_title"
    android:summary="@string/demo_preference_summary"
settings:controller="com.android.car.settings.common.DefaultRestrictionsPreferenceController">
        <intent android:action="android.intent.action.DEMO_ACTION"/>
</Preference>

    新增插入的偏好設定

    插入的偏好設定包含意圖，可導向外部或內部活動。舉例來說，設定首頁上的「Google」設定項目就是插入的偏好設定。在下列任一情況下，插入的偏好設定特別實用：設定：

    • 並未直接在 CarSettings 應用程式中實作 (例如插入原始設備製造商 (OEM) 實作的設定)。
    • 應該會顯示在 CarSettings 應用程式中。

    如何將活動設為注入的設定：

    1. 如要將活動標示為插入設定，請將意圖篩選器新增至活動。
    2. 告訴 CarSettings 應用程式所屬類別。類別是常數，在 CategoryKey 中定義，用於指出要插入的設定應出現在 CarSettings 的哪個層級。我們會在 CategoryKey 中提供一組類別，但 OEM 可自行定義類別，不受任何限制。
    3. (選用) 在顯示設定時加入摘要文字： 
      <activity android:name="Settings$DemoSettingsActivity"
    <!-- Mark the activity as an injected setting -->
    <intent-filter>
        <action android:name="com.android.settings.action.EXTRA_SETTINGS"/>
    </intent-filter>
    <!-- Tell CarSettings app which category it belongs to -->
    <meta-data android:name="com.android.settings.category"
               android:value="com.android.settings.category.demo_category"/>
    <!-- Tell CarSettings the what the preference title should be -->
    <meta-data android:name="com.android.settings.title"
               android:value="@string/app_name" />
    <!-- Optional: specify the icon to show with the preference -->
    <meta-data android:name="com.android.settings.icon"
               android:resource="@drawable/ic_demo"
               android:value="true"/>
    <!-- Optional: Add a summary text when the string is displayed -->
    <meta-data android:name="com.android.settings.summary"
               android:resource="@string/demo_summary"/>
</activity>

    如要讓插入的設定顯示在 CarSettings 應用程式的特定頁面上，請在 XML 中加入下列範例程式碼，並視需要修改變數：

    <com.android.car.settings.common.LogicalPreferenceGroup
    <!-- Replace key string -->
    android:key="@string/pk_system_extra_settings"
    <!-- Indicates the preferences in the group should be injected in.
         ExtraSettingsPreferenceController contains the logic to pull in injected
         preferences. -->
settings:controller="com.android.settings.common.ExtraSettingsPreferenceController">
    <!-- Tells the controller what activities should be pulled into this preference
         group. -->
    <intent android:action="com.android.settings.action.EXTRA_SETTINGS">
        <!-- Name and value should match the metadata in your activity -->
        <extra android:name="com.android.settings.category"
               android:value="com.android.settings.category.demo_category"/>
    </intent>
</com.android.car.settings.common.LogicalPreferenceGroup>