कार सेटिंग्स में अधिकांश पृष्ठ टुकड़ों की एक श्रृंखला के रूप में कार्यान्वित किए जाते हैं जो SettingsFragment
विस्तार करते हैं, जिनमें से प्रत्येक की अपनी गतिविधि CarSettingActivities
में परिभाषित होती है। ये स्थिर गतिविधियाँ BaseCarSettingsActivity
से विस्तारित हैं। इन सेटिंग्स के अलावा, आप कारसेटिंग्स में प्रदर्शित होने के लिए अन्य सिस्टम ऐप्स से प्राथमिकताएं इंजेक्ट कर सकते हैं।
कार सेटिंग्स में एक नई प्राथमिकता जोड़ें
नई सेटिंग जोड़ने के लिए:
- एक XML फ़ाइल परिभाषित करें:
- सुनिश्चित करें कि सभी प्राथमिकताओं में
android:key
परिभाषित है। कुंजियों की सूचीpreference_keys.xml
में रखी जाती है। प्राथमिकताएँ कुंजियाँ अद्वितीय होनी चाहिए. - खोज अनुक्रमण उद्देश्यों के लिए, प्राथमिकता स्क्रीन में एक परिभाषित
android:key
भी होनी चाहिए। प्राथमिकता स्क्रीन कुंजियों की सूचीpreference_screen_keys.xml
में रखी जाती है। वरीयता स्क्रीन कुंजियाँ भी अद्वितीय होनी चाहिए। - यदि प्राथमिकता केवल स्थिर जानकारी प्रदर्शित करती है (उदाहरण के लिए, कोई विशेष व्यावसायिक तर्क नहीं), तो प्राथमिकता नियंत्रक को
com.android.car.settings.common.DefaultRestrictionsPreferenceController
के रूप में सेट करें। - यदि प्राथमिकता के लिए व्यावसायिक तर्क की आवश्यकता होती है, तो प्राथमिकता नियंत्रक को नए प्राथमिकता नियंत्रक नाम के साथ सेट करें।
- सुनिश्चित करें कि सभी प्राथमिकताओं में
- ( यदि आवश्यक हो ) उपयुक्त पैकेज में वरीयता नियंत्रक बनाएं, जो
PreferenceController
विस्तार करता है। यदि आवश्यक हो तो Javadoc देखें। - चरण 1 में परिभाषित XML फ़ाइल को लौटाते हुए
getPreferenceScreenResId
के साथ एक टुकड़ा बनाएं। -
CarSettingActivities
में एक गतिविधि बनाएं जोBaseCarSettingsActivity
बढ़ाती है और फिर चरण 3 में परिभाषित टुकड़े को वापस करते हुएgetInitialFragment()
को लागू करती है। - चरण 4 में परिभाषित गतिविधि को शामिल करने के लिए
AndroidManifest.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>
नामक XML फ़ाइल को परिभाषित करें - प्राथमिकता कुंजी को
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
में एक गतिविधि बनाएं: - नई गतिविधि के साथ मेनिफेस्ट फ़ाइल को अपडेट करें:
- सीधे कारसेटिंग्स ऐप में लागू नहीं किया जाता है (जैसे कि ओईएम द्वारा लागू की गई सेटिंग को इंजेक्ट करना)।
- कारसेटिंग्स ऐप में दिखना चाहिए।
- गतिविधि को इंजेक्टेड सेटिंग के रूप में चिह्नित करने के लिए, गतिविधि में एक इरादा-फ़िल्टर जोड़ें।
- कारसेटिंग्स ऐप को बताएं कि यह किस श्रेणी का है। श्रेणी एक स्थिरांक है, जिसे
CategoryKey
में परिभाषित किया गया है, और इसका उपयोग यह इंगित करने के लिए किया जाता है कि इंजेक्टेड सेटिंग कारसेटिंग्स के किस स्तर पर दिखाई देनी चाहिए। हम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>
कार सेटिंग्स के भीतर एक बाहरी आशय प्राथमिकता जोड़ें
इंजेक्टेड प्राथमिकताओं के विकल्प के रूप में, किसी प्राथमिकता को सीधे कार सेटिंग्स में सम्मिलित करना भी संभव है जो किसी अन्य ऐप में लक्षित होता है। यह केवल एक प्राथमिकता स्क्रीन पर एक प्राथमिकता जोड़कर एक इरादे की कार्रवाई के साथ किया जा सकता है जो बाहरी ऐप को हल करता है। कार सेटिंग्स में अन्य प्राथमिकताओं की तरह, इन प्राथमिकताओं में समान 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 सेटिंग आइटम एक इंजेक्टेड प्राथमिकता है। निम्न में से कोई भी सत्य होने पर इंजेक्ट की गई प्राथमिकताएँ विशेष रूप से उपयोगी होती हैं। सेटिंग:
किसी गतिविधि को इंजेक्शन सेटिंग के रूप में कॉन्फ़िगर करने के लिए:
कारसेटिंग्स ऐप में एक विशिष्ट पृष्ठ पर इंजेक्ट की गई सेटिंग प्रदर्शित करने के लिए, 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>