רוב הדפים ב-Car Settings מיושמים כסדרה של קטעים המרחיבים SettingsFragment
, כאשר לכל אחד מהם יש פעילות משלו המוגדרת ב- CarSettingActivities
. פעילויות סטטיות אלו מורחבות מ- BaseCarSettingsActivity
. בנוסף להגדרות אלו, תוכל להזין העדפות מיישומי מערכת אחרים שיופיעו ב-CarSettings.
הוסף העדפה חדשה בהגדרות רכב
כדי להוסיף הגדרה חדשה:
- הגדר קובץ XML:
- ודא שכל ההעדפות הגדירו את
android:key
. רשימת המפתחות נשמרת ב-preference_keys.xml
. מפתחות העדפות צריכים להיות ייחודיים. - למטרות הוספת חיפוש לאינדקס, מסכי העדפות צריכים להיות בעלי
android:key
מוגדר. רשימת מקשי מסך ההעדפות נשמרת ב-preference_screen_keys.xml
. גם מקשי מסך העדפות צריכים להיות ייחודיים. - אם ההעדפה מציגה מידע סטטי בלבד (לדוגמה, ללא היגיון עסקי מיוחד), הגדר את בקר ההעדפות כ-
com.android.car.settings.common.DefaultRestrictionsPreferenceController
. - אם ההעדפה דורשת לוגיקה עסקית, הגדר את בקר ההעדפות עם שם בקר העדפה חדש.
- ודא שכל ההעדפות הגדירו את
- ( אם נדרש ) צור את בקר ההעדפות בחבילה המתאימה, שמרחיבה את
PreferenceController
. עיין ב-Javadoc במידת הצורך. - צור קטע עם
getPreferenceScreenResId
שמחזיר את קובץ ה-XML שהוגדר בשלב 1. - צור פעילות ב-
CarSettingActivities
שמרחיבהBaseCarSettingsActivity
ולאחר מכן יישםgetInitialFragment()
, והחזרת הפרגמנט שהוגדר בשלב 3. - עדכן את
AndroidManifest.xml
כדי לכלול את הפעילות שהוגדרה בשלב 4.
דוגמא
החומר הבא ממחיש תהליך זה.
- הגדר קובץ XML בשם
demo_fragment.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>
- הוסף את מפתחות ההעדפה ל-
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>
- הוסף את מקש מסך ההעדפות ל-
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; } }
- כדי ליצור מקטע, דחוף את
getPreferenceScreenResId
: - כדי להחזיק את הקטע החדש, צור פעילות ב-
CarSettingActivities
: - עדכן את קובץ המניפסט עם הפעילות החדשה:
- אינו מיושם ישירות באפליקציית CarSettings (כגון הזרקת הגדרה המיושמת על ידי יצרני OEM).
- אמור להופיע באפליקציית CarSettings.
- כדי לסמן את הפעילות כהגדרה מוזרקת, הוסף מסנן כוונות לפעילות.
- ספר לאפליקציית CarSettings לאיזו קטגוריה היא שייכת. הקטגוריה היא קבועה, מוגדרת ב-
CategoryKey
, ומשמשת לציון באיזו רמה של CarSettings ההגדרה המוזרקת צריכה להופיע. אנו מספקים קבוצה של קטגוריות בתוךCategoryKey
, אך אין הגבלות עבור יצרני OEM להגדיר קטגוריות משלהם. - ( אופציונלי ) הוסף טקסט סיכום כאשר ההגדרה מוצגת:
<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>
public class DemoFragment extends SettingsFragment { @Override @XmlRes protected int getPreferenceScreenResId() { return R.xml.demo_fragment; } }
public class CarSettingActivities { [...] public static class DemoActivity extends BaseCarSettingsActivity { @Nullable @Override protected Fragment getInitialFragment() { return new DemoFragment(); } } }
<application [...] <activity android:name=".common.CarSettingActivities$DemoActivity" android:exported="true"> <meta-data android:name="distractionOptimized" android:value="true"/> </activity> [...] </application>
הוסף העדפת כוונה חיצונית בתוך הגדרות רכב
כחלופה להעדפות המוזרקות, אפשר גם להכניס העדפה ישירות ל-Car Settings שמתכוונת לצאת לאפליקציה אחרת. זה יכול להיעשות על ידי הוספת העדפה למסך העדפות עם פעולת כוונה שנפתרת לאפליקציה חיצונית. כמו העדפות אחרות בהגדרות רכב, להעדפות אלה יש אותן תכונות 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, כלול את הקוד לדוגמה הבא ב-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>