अपना प्रोजेक्ट सेट अप करें

इस पेज पर, कार ऐप्लिकेशन की लाइब्रेरी इंस्टॉल करने और अपने ऐप्लिकेशन के लिए मेनिफ़ेस्ट फ़ाइल को कॉन्फ़िगर करने का तरीका बताया गया है.

कार ऐप्लिकेशन की लाइब्रेरी इंस्टॉल करना

अपने ऐप्लिकेशन में लाइब्रेरी जोड़ने के लिए, Jetpack लाइब्रेरी के रिलीज़ पेज पर जाएं.

अपने ऐप्लिकेशन की मेनिफ़ेस्ट फ़ाइलें कॉन्फ़िगर करना

कार के लिए ऐप्लिकेशन बनाने से पहले, आपको अपने ऐप्लिकेशन की मेनिफ़ेस्ट फ़ाइलें कॉन्फ़िगर करनी होंगी.

अपने CarAppService की जानकारी देना

होस्ट, आपके CarAppService को लागू करने के ज़रिए आपके ऐप्लिकेशन से कनेक्ट होता है. होस्ट को आपके ऐप्लिकेशन के बारे में पता चले और वह उससे कनेक्ट हो सके, इसके लिए आपको अपने मेनिफ़ेस्ट में इस सेवा की जानकारी देनी होगी.

आपको अपने ऐप्लिकेशन के इंटेंट फ़िल्टर के <category> एलिमेंट में, अपने ऐप्लिकेशन की कैटगरी की जानकारी भी देनी होगी. इस एलिमेंट के लिए मान्य वैल्यू देखने के लिए, इस्तेमाल की जा सकने वाली ऐप्लिकेशन कैटगरी की सूची देखें.

नीचे दिए गए कोड स्निपेट में, अपने मेनिफ़ेस्ट में दिलचस्पी के पॉइंट वाले ऐप्लिकेशन के लिए, कार ऐप्लिकेशन की सेवा की जानकारी देने का तरीका बताया गया है:

<application>
    ...
   <service
       ...
        android:name=".MyCarAppService"
        android:exported="true">
      <intent-filter>
        <action android:name="androidx.car.app.CarAppService"/>
        <category android:name="androidx.car.app.category.POI"/>
      </intent-filter>
    </service>

    ...
<application>

इस्तेमाल की जा सकने वाली ऐप्लिकेशन कैटगरी

अपने CarAppService की जानकारी देने के बारे में, अपने CarAppService की जानकारी देना में बताए गए तरीके के मुताबिक, आपको इंटेंट फ़िल्टर में इनमें से एक या एक से ज़्यादा वैल्यू जोड़कर, अपने ऐप्लिकेशन की कैटगरी की जानकारी भी देनी होगी.

• androidx.car.app.category.NAVIGATION: मोड़-दर-मोड़ रास्ते की जानकारी देता है. कार के लिए नेविगेशन ऐप्लिकेशन बनाना लेख पढ़ें.

• androidx.car.app.category.POI: दिलचस्पी के पॉइंट ढूंढने से जुड़ी सुविधाएं देता है. जैसे, पार्किंग की जगहें, चार्जिंग स्टेशन, और पेट्रोल पंप. कार के लिए दिलचस्पी के पॉइंट वाले ऐप्लिकेशन बनाना लेख पढ़ें.

• androidx.car.app.category.IOT: उपयोगकर्ताओं को कार में बैठे-बैठे, कनेक्ट किए गए डिवाइसों पर काम की कार्रवाइयां करने की अनुमति देता है. कार के लिए इंटरनेट ऑफ़ थिंग्स वाले ऐप्लिकेशन बनाना लेख पढ़ें.

• androidx.car.app.category.WEATHER: उपयोगकर्ताओं को उनकी मौजूदा जगह या रास्ते से जुड़ी मौसम की जानकारी देखने की अनुमति देता है. कार के लिए मौसम की जानकारी देने वाले ऐप्लिकेशन बनाना लेख पढ़ें.

• androidx.car.app.category.MEDIA: उपयोगकर्ताओं को कार में संगीत, रेडियो, ऑडियोबुक, और अन्य ऑडियो कॉन्टेंट ब्राउज़ करने और चलाने की अनुमति देता है. कार के लिए टेंप्लेट वाले मीडिया ऐप्लिकेशन बनाना लेख पढ़ें.

• androidx.car.app.category.MESSAGING: उपयोगकर्ताओं को छोटे-छोटे टेक्स्ट मैसेज के ज़रिए बातचीत करने की अनुमति देता है. Android Auto के लिए टेंप्लेट वाले मैसेजिंग अनुभव बनाना लेख पढ़ें .

• androidx.car.app.category.CALLING: उपयोगकर्ताओं को वॉइस कॉलिंग के ज़रिए बातचीत करने की अनुमति देता है. Android Auto के लिए कॉलिंग अनुभव बनाना लेख पढ़ें.

हर कैटगरी के बारे में ज़्यादा जानकारी और किसी कैटगरी के लिए ज़रूरी शर्तें देखने के लिए, कार के लिए Android ऐप्लिकेशन की क्वालिटी लेख पढ़ें.

ऐप्लिकेशन का नाम और आइकॉन तय करना

सिस्टम यूज़र इंटरफ़ेस (यूआई) में अपने ऐप्लिकेशन को दिखाने के लिए, carPermissionActivityLayout में होस्ट के लिए ऐप्लिकेशन का नाम और आइकॉन तय करना ज़रूरी है. होस्ट, आपके ऐप्लिकेशन को दिखाने के लिए, CarAppService के label और icon एट्रिब्यूट का इस्तेमाल करता है. इसलिए, इन एट्रिब्यूट का इस्तेमाल करके, ऐप्लिकेशन का नाम और आइकॉन तय करें:

...
<service
   android:name=".MyCarAppService"
   android:exported="true"
   android:label="@string/my_app_name"
   android:icon="@drawable/my_app_icon">
   ...
</service>
...

अगर आपने <service> एलिमेंट में कोई लेबल या आइकॉन तय नहीं किया है, तो होस्ट , <application> एलिमेंट में तय की गई वैल्यू का इस्तेमाल करता है.

पसंद के मुताबिक थीम सेट करना

कार के लिए ऐप्लिकेशन की पसंद के मुताबिक थीम सेट करने के लिए:

1. अपनी मेनिफ़ेस्ट फ़ाइल में, <meta-data> एलिमेंट जोड़ें:

   <meta-data
       android:name="androidx.car.app.theme"
       android:resource="@style/MyCarAppTheme />
   

2. कार के लिए ऐप्लिकेशन की पसंद के मुताबिक थीम के एट्रिब्यूट सेट करने के लिए, अपने स्टाइल रिसॉर्स की जानकारी दें:

   <resources>
     <style name="MyCarAppTheme">
       <item name="carColorPrimary">@color/my_primary_car_color</item>
       <item name="carColorPrimaryDark">@color/my_primary_dark_car_color</item>
       <item name="carColorSecondary">@color/my_secondary_car_color</item>
       <item name="carColorSecondaryDark">@color/my_secondary_dark_car_color</item>
       <item name="carPermissionActivityLayout">@layout/my_custom_background</item>
     </style>
   </resources>
   

कार ऐप्लिकेशन का एपीआई लेवल

कार ऐप्लिकेशन की लाइब्रेरी, अपने एपीआई लेवल तय करती है. इससे आपको यह पता चलता है कि किसी वाहन पर टेंप्लेट होस्ट, लाइब्रेरी की किन सुविधाओं के साथ काम करता है. किसी होस्ट के साथ काम करने वाले, कार ऐप्लिकेशन के सबसे बड़े एपीआई लेवल को पाने के लिए, getCarAppApiLevel() तरीके का इस्तेमाल करें.

अपनी AndroidManifest.xml फ़ाइल में, कार ऐप्लिकेशन के उस कम से कम एपीआई लेवल की जानकारी दें जिस पर आपका ऐप्लिकेशन काम करता है:

<manifest ...>
    <application ...>
        <meta-data
            android:name="androidx.car.app.minCarApiLevel"
            android:value="1"/>
    </application>
</manifest>

पिछड़े वर्शन के साथ काम करने की सुविधा बनाए रखने और किसी सुविधा का इस्तेमाल करने के लिए ज़रूरी कम से कम एपीआई लेवल की जानकारी देने के बारे में जानने के लिए, एनोटेशन के दस्तावेज़ देखें.RequiresCarApi कार ऐप्लिकेशन की लाइब्रेरी की किसी सुविधा का इस्तेमाल करने के लिए, किस एपीआई लेवल की ज़रूरत होती है, यह जानने के लिए, रेफ़रंस दस्तावेज़ देखें CarAppApiLevels.