मेनिफ़ेस्ट फ़ाइलें कॉन्फ़िगर करना

. keywords_public: Android Auto, Android Automotive OS, AAOS, Manifest, Media Browser Service, App Icons, Car UI, Manifest Configuration, Media App, Car Development

Android Auto और Android Automotive OS (AAOS) के साथ इंटिग्रेट करने के लिए, अपने ऐप्लिकेशन की मेनिफ़ेस्ट फ़ाइलें कॉन्फ़िगर करें. इन प्लैटफ़ॉर्म को मीडिया ब्राउज़र सेवा ढूंढने और उससे कनेक्ट करने की अनुमति देने के लिए, मेनिफ़ेस्ट में अपनी मीडिया ब्राउज़र सेवा के बारे में बताएं. ज़रूरी ऐप्लिकेशन आइकॉन तय करें. इनमें एट्रिब्यूशन आइकॉन के लिए लॉन्चर आइकॉन भी शामिल है. इसका इस्तेमाल सिस्टम यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट, जैसे कि मीडिया कंट्रोल के लिए किया जाता है.

मेनिफ़ेस्ट फ़ाइलों के बारे में ज़्यादा जानने के लिए, ऐप्लिकेशन मेनिफ़ेस्ट की खास जानकारी लेख पढ़ें.

मीडिया ब्राउज़र सेवा के बारे में जानकारी देना

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

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

<application>
    ...
    <service android:name=".MyMediaBrowserService"
             android:exported="true">
        <intent-filter>
            <action android:name="android.media.browse.MediaBrowserService"/>
        </intent-filter>
    </service>
    ...
</application>

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

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

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

लॉन्चर आइकॉन तय करना
एट्रिब्यूशन आइकॉन तय करना

लॉन्चर आइकॉन तय करना

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

डिफ़ॉल्ट रूप से, आपके ऐप्लिकेशन के <application> एलिमेंट के android:icon एट्रिब्यूट का इस्तेमाल लॉन्चर आइकॉन के तौर पर किया जाता है:

<application
    ...
    android:icon="@mipmap/ic_launcher"
>

किसी दूसरे आइकॉन का इस्तेमाल करने के लिए, मीडिया ब्राउज़र सेवा के <service> एलिमेंट का android:icon एट्रिब्यूट सेट करें:

<application>
    ...
    <service
        ...
        android:icon="@mipmap/ic_car_launcher"/>
</application>

एट्रिब्यूशन आइकॉन तय करना

एट्रिब्यूशन आइकॉन का इस्तेमाल उन जगहों पर किया जाता है जहां मीडिया कॉन्टेंट को प्राथमिकता दी जाती है. जैसे, मीडिया कार्ड पर. सूचनाओं के लिए इस्तेमाल किए गए छोटे आइकॉन का फिर से इस्तेमाल करें. यह आइकॉन मोनोक्रोम होना चाहिए. हमारा सुझाव है कि आप वेक्टर ऐसेट का इस्तेमाल करें, ताकि आइकॉन धुंधला न दिखे.

पहली इमेज. मीडिया कार्ड पर एट्रिब्यूशन आइकॉन.

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

<application>
    ...
    <meta-data
        android:name="androidx.car.app.TintableAttributionIcon"
        android:resource="@drawable/ic_status_icon" />
    ...
</application>

अपने ऐप्लिकेशन का लेबल तय करना

डिफ़ॉल्ट रूप से, आपकी कार की स्क्रीन पर ऐप्लिकेशन के डिसप्ले नेम के तौर पर, ऐप्लिकेशन के <application> एलिमेंट के android:label एट्रिब्यूट की वैल्यू का इस्तेमाल किया जाता है.

अगर आपको कोई दूसरा डिसप्ले नेम इस्तेमाल करना है या आपके ऐप्लिकेशन में एक से ज़्यादा मीडिया ब्राउज़र सेवाएं हैं, तो मीडिया ब्राउज़र सेवा के <service> एलिमेंट के android:label एट्रिब्यूट को सेट करें.

अपने ऐप्लिकेशन के ऐक्सेंट का रंग तय करना

आपके ऐप्लिकेशन के ऐक्सेंट कलर का इस्तेमाल, Android Auto और AAOS करते हैं. इससे वे प्लेबैक कंट्रोल और अन्य यूज़र इंटरफ़ेस (यूआई) एलिमेंट को स्टाइल करते हैं.

डिफ़ॉल्ट रूप से, ऐक्सेंट का रंग आपके ऐप्लिकेशन के <application> एलिमेंट के android:theme स्टाइल रिसॉर्स के colorAccent आइटम से लिया जाता है.

अगर आपको कार में मिलने वाले अनुभव के लिए, किसी दूसरे एक्सेंट कलर का इस्तेमाल करना है, तो <meta-data> एलिमेंट को शामिल करें. यह एलिमेंट, स्टाइल के ऐसे संसाधन के लिए होता है जिसमें colorAccent आइटम शामिल होता है:

<application>
    ...
    <meta-data
        android:name="com.google.android.gms.car.application.theme"
        android:resource="@style/THEME_NAME"/>
    ...
</application>

प्लैटफ़ॉर्म के हिसाब से कॉन्फ़िगरेशन

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