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

इस पेज पर, Car App library को इंस्टॉल करने का तरीका बताया गया है. साथ ही, इसमें आपके ऐप्लिकेशन के लिए मेनिफ़ेस्ट फ़ाइल को कॉन्फ़िगर करने का तरीका भी बताया गया है.

Car App library इंस्टॉल करना

अपने ऐप्लिकेशन में लाइब्रेरी जोड़ने के लिए, 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>

चेतावनी: आपको लिंट की चेतावनी दिख सकती है, क्योंकि सेवा एक्सपोर्ट की गई है. हालांकि, इसके लिए अनुमति की ज़रूरत नहीं है. आम तौर पर, इस चेतावनी को अनदेखा करना सुरक्षित होता है, क्योंकि आपको createHostValidator() तरीके को बदलना होगा. इससे आपको यह तय करने का ज़्यादा कंट्रोल मिलता है कि कौनसे होस्ट ऐप्लिकेशन आपके ऐप्लिकेशन से कनेक्ट हो सकते हैं.

ऐप्लिकेशन की इन कैटगरी के लिए, यह सुविधा उपलब्ध है

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 ऐप्लिकेशन की क्वालिटी देखें.

इस कैटगरी का इस्तेमाल, लोगों को Play Store में उनके काम के ऐप्लिकेशन खोजने में मदद करने के लिए किया जाता है.

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

सिस्टम यूज़र इंटरफ़ेस (यूआई) में अपने ऐप्लिकेशन को दिखाने के लिए, 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> एलिमेंट में दी गई वैल्यू का इस्तेमाल करेगा.

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

कार ऐप्लिकेशन के लिए कस्टम थीम सेट करने के लिए:

अपनी मेनिफ़ेस्ट फ़ाइल में <meta-data> एलिमेंट जोड़ें:
```
<meta-data
    android:name="androidx.car.app.theme"
    android:resource="@style/MyCarAppTheme />
```

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

<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>

पीछे जाएं

Car App library इंस्टॉल करना

आगे बढ़ें

CarAppService और सेशन बनाना