Car App

Car App

इस्तेमाल के लिए गाइड  कोड सैंपल  कोडलैब

एपीआई का संदर्भ
androidx.car.app
androidx.car.app.model
androidx.car.app.navigation
androidx.car.app.notification
androidx.car.app.serialization
androidx.car.app.validation
androidx.car.app.versioning

Android Auto और Android Automotive OS के लिए, टेंप्लेट वाले ऐप्लिकेशन बनाएं.

नया अपडेट	स्टेबल रिलीज़	रिलीज़ कैंडिडेट	बीटा रिलीज़	ऐल्फ़ा रिलीज़
19 नवंबर, 2025	1.7.0	-	-	1.8.0-alpha03

डिपेंडेंसी का एलान करना

Car App Library पर डिपेंडेंसी जोड़ने के लिए, आपको अपने प्रोजेक्ट में Google Maven रिपॉज़िटरी जोड़नी होगी. ज़्यादा जानकारी के लिए, Google की Maven रिपॉज़िटरी पढ़ें.

अपने ऐप्लिकेशन या मॉड्यूल के लिए, build.gradle फ़ाइल में उन आर्टफ़ैक्ट की डिपेंडेंसी जोड़ें जिनकी आपको ज़रूरत है:

ग्रूवी

dependencies {
    implementation "androidx.car.app:app:1.7.0"

    // For Android Auto specific functionality
    implementation "androidx.car.app:app-projected:1.7.0"

    // For Android Automotive specific functionality
    implementation "androidx.car.app:app-automotive:1.7.0"

    // For testing
    testImplementation "androidx.car.app:app-testing:1.7.0"
}

Kotlin

dependencies {
    implementation("androidx.car.app:app:1.7.0")

    // For Android Auto specific functionality
    implementation("androidx.car.app:app-projected:1.7.0")

    // For Android Automotive specific functionality
    implementation("androidx.car.app:app-automotive:1.7.0")

    // For testing
    testImplementation("androidx.car.app:app-testing:1.7.0")
}

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

सुझाव/राय दें या शिकायत करें

आपके सुझाव, शिकायत या राय से Jetpack को बेहतर बनाने में मदद मिलती है. अगर आपको कोई नई समस्या मिलती है या आपके पास इस लाइब्रेरी को बेहतर बनाने के लिए सुझाव हैं, तो हमें बताएं. कृपया नई समस्या सबमिट करने से पहले, इस लाइब्रेरी में शामिल मौजूदा समस्याओं को देखें. स्टार बटन पर क्लिक करके, किसी मौजूदा समस्या के लिए वोट किया जा सकता है.

नई समस्या दर्ज करने का तरीका

ज़्यादा जानकारी के लिए, Issue Tracker का दस्तावेज़ देखें.

वर्शन 1.8

वर्शन 1.8.0-alpha03

19 नवंबर, 2025

androidx.car.app:app-*:1.8.0-alpha03 रिलीज़ हो गया है. वर्शन 1.8.0-alpha03 में ये बदलाव शामिल हैं.

नई सुविधाएं

• लाइनों में इमेज जोड़ने की सुविधा जोड़ी गई है. इससे सूची के इस्तेमाल के नए उदाहरणों को लागू किया जा सकेगा.
• सूची के ऐक्सलरेटर के लिए अलग-अलग वर्णमाला के हिसाब से इंडेक्सिंग की अनुमति देने के लिए, SectionedItemTemplate#alphabeticalIndexingStrategy जोड़ें.

एपीआई में हुए बदलाव

• Rows (I8865b) में endImages के लिए endImageType जोड़ा गया
• SectionedItemTemplate#alphabeticalIndexingStrategy जोड़ें. यह #isAlphabeticalIndexingAllowed की जगह इस्तेमाल किया जाता है. इससे डेवलपर को वर्णमाला के क्रम में इंडेक्स करने के ज़्यादा विकल्प मिलते हैं. (Ia164d, b/410092683)
• कार ऐप्लिकेशन की लाइन में, आखिर में दिखने वाली इमेज के लिए सहायता जोड़ी गई. (If93f0)
• स्टैंडर्ड ऐक्शन MediaPlayback को आसानी से इस्तेमाल करने के लिए, CarIcon MediaPlayback जोड़ा गया. (Ib6cb7)

गड़बड़ियां ठीक की गईं

• डिफ़ॉल्ट minSdk को एपीआई 21 से एपीआई 23 पर ले जाना (Ibdfca, b/380448311, b/435705964, b/435705223)

वर्शन 1.8.0-alpha02

18 जून, 2025

androidx.car.app:app-*:1.8.0-alpha02 रिलीज़ हो गया है. वर्शन 1.8.0-alpha02 में ये बदलाव शामिल हैं.

नई सुविधाएं

• Action.MEDIA_PLAYBACK के लिए सहायता जोड़ी गई है. यह मीडिया चलाने की स्थिति के आधार पर इंडिकेटर दिखाता है.
• SectionedItemTemplate को रीफ़्रेश करने पर, उपयोगकर्ता की स्क्रोल पोज़िशन को कंट्रोल करने की सुविधा जोड़ी गई है.

एपीआई में हुए बदलाव

• इस कुकी का इस्तेमाल, रीफ़्रेश होने के दौरान SectionedItemTemplate में उपयोगकर्ता की स्क्रोल की गई जगह को सेव करने के लिए किया जाता है. (Ia4c51)
• लाइन के आखिर में की जाने वाली कार्रवाई (I05cc4) के लिए, MEDIA_PLAYBACK कार्रवाई को चालू किया गया
• कार्रवाई का नया टाइप जोड़ें (I6cc5a)
• CarAppExtender#addAction(Action) जोड़ें, ताकि CarAppExtender में किसी भी तरह की कार्रवाई जोड़ी जा सके. (Idc4d7)
• SectionedItemTemplate को API 8 और उसके बाद के वर्शन के लिए ऐक्सेस किया जा सकता है. (I9a079)

वर्शन 1.8.0-alpha01

20 मई, 2025

androidx.car.app:app-*:1.8.0-alpha01 रिलीज़ हो गया है. वर्शन 1.8.0-alpha01 में ये बदलाव शामिल हैं.

नई सुविधाएं

फ़िलहाल, सभी सुविधाएं सिर्फ़ Android Auto पर उपलब्ध हैं. AAOS के सभी वर्शन में एक ही एपीआई का इस्तेमाल किया जाएगा

• कस्टम ऐप्लिकेशन बनाने के लिए, मीडिया कैटगरी जोड़ी गई है. यह MediaBrowse पर आधारित ऐप्लिकेशन के विकल्प के तौर पर काम करती है
• प्लेबैक टेंप्लेट जोड़ा गया है. इससे मीडिया प्लेबैक व्यू के दौरान, सबसे ऊपर मौजूद कार्रवाइयों को कंट्रोल किया जा सकता है. यह सिर्फ़ मीडिया ऐप्लिकेशन के लिए उपलब्ध है
• Android Auto पर सेक्शन वाले आइटम टेंप्लेट के लिए पूरी तरह से काम करने की सुविधा जोड़ी गई है. इससे सूचियों/ग्रिड से बने उप-सेक्शन के कॉम्बिनेशन इस्तेमाल किए जा सकते हैं.
• ग्रिड आइटम के लिए, एक्स्ट्रा-लार्ज साइज़ को अतिरिक्त साइज़ के तौर पर जोड़ा गया है.

एपीआई में हुए बदलाव

• ग्रिड आइटम (I35b58) के लिए, साइज़ का एक और विकल्प जोड़ा गया
• कार के लिए ऐप्लिकेशन लाइब्रेरी में मीडिया ऐप्लिकेशन के लिए कैटगरी और अनुमति जोड़ता है (I8e100)
• ऐप्लिकेशन के लिए नया एपीआई जोड़ा गया है. इससे यह पता लगाया जा सकेगा कि CarAppLibrary मीडिया कैटगरी काम करती है या नहीं (Ic4b08)
• OnItemVisibilityChangeListener को सेक्शन में जोड़ा गया. (I2c2fd)
• Mileage#getOdometerKilometers को जोड़ा गया और Mileage#getOdometerMeters को बंद किया गया (Ic91af)

गड़बड़ियां ठीक की गईं

• CarIcon.setTint के Javadoc में टाइप की गई गलतियों को ठीक करें (Iabd72)
• Row.Builder#setNumericDecoration दस्तावेज़ अपडेट किया गया है. इसमें बताया गया है कि एक ऐक्शन + संख्या वाले डेकोरेशन का इस्तेमाल नहीं किया जा सकता. हालांकि, शून्य या दो ऐक्शन + संख्या वाले डेकोरेशन का इस्तेमाल किया जा सकता है. (Ic0b08)
• ग्रिड आइटम के लिए, बैज आइकॉन के बैकग्राउंड कलर का फ़ील्ड जोड़ा गया. (I2b6ae)

वर्शन 1.7

वर्शन 1.7.0

16 जुलाई, 2025

androidx.car.app:app-*:1.7.0 रिलीज़ हो गया है. वर्शन 1.7.0 में ये बदलाव शामिल हैं.

• यह पहला स्टेबल वर्शन है. इसमें CVE-2024-10382 को ठीक किया गया है. इसे beta03 पर पैच किया गया था. अगर आपके पास 1.7-beta03 से पहले का वर्शन है, तो कृपया इस वर्शन का इस्तेमाल करने के लिए अपडेट करें.

वर्शन 1.7.0-rc01

15 जनवरी, 2025

androidx.car.app:app-*:1.7.0-rc01 को beta03 के बाद बिना किसी खास बदलाव के रिलीज़ किया गया है. वर्शन 1.7.0-rc01 में ये बदलाव शामिल हैं.

• यह पहला आरसी है, जिसमें CVE-2024-10382 को ठीक किया गया है. इसे beta03 पर पैच किया गया था. अगर आपके पास 1.7-beta03 से पहले का वर्शन है, तो कृपया इस वर्शन का इस्तेमाल करने के लिए अपडेट करें.

वर्शन 1.7.0-beta03

13 नवंबर, 2024

सुरक्षा से जुड़ी जोखिम की संभावना को ठीक किया गया है. साथ ही, अन्य सामान्य गड़बड़ियों को ठीक किया गया है. अगर आपके पास इससे कम वर्शन है, तो कृपया इस वर्शन का इस्तेमाल करने के लिए अपडेट करें.

androidx.car.app:app-*:1.7.0-beta03 रिलीज़ हो गया है. वर्शन 1.7.0-beta03 में ये बदलाव शामिल हैं.

एपीआई में हुए बदलाव

• CAL के सीरियल बनाने / सीरियल हटाने वाले कोड को अपडेट करें, ताकि सिर्फ़ उन ऑब्जेक्ट को हैंडल किया जा सके जिन पर @CarProtocol एनोटेशन का एलान किया गया है. (Ic730e)
• अब CarAppExtender का इस्तेमाल, सिर्फ़ NotificationCompat.Builder के बजाय Notification.Builder फ़्रेमवर्क को बढ़ाने के लिए किया जा सकता है. (Id3ad7)
• KEY_EXCLUDE_MEDIA_ITEM_FROM_MIXED_APP_LIST अतिरिक्त जोड़ें. (I201f9)
• ConversationItem पर खाली बिल्डर कंस्ट्रक्टर को बंद करें और उसे ऐसे कंस्ट्रक्टर से बदलें जो ज़रूरी पैरामीटर लेता हो. यह शून्य मैसेज से सुरक्षा के लिए भी जांच करता है. (Ic8221)

गड़बड़ियां ठीक की गईं

• पक्का करें कि PlaceList मैप में, स्ट्रिंग (सिर्फ़ टेक्स्ट) हेडर टाइटल का इस्तेमाल किया गया हो. (Ic992f)
• यह लाइब्रेरी अब JSpecify nullness annotations का इस्तेमाल करती है. ये टाइप-यूज़ होते हैं. Kotlin डेवलपर को सही इस्तेमाल के लिए, कंपाइलर के इस तर्क का इस्तेमाल करना चाहिए: -Xjspecify-annotations=strict (यह Kotlin कंपाइलर के 2.1.0 वर्शन से डिफ़ॉल्ट रूप से शुरू होता है). (Ib5367, b/326456246)

वर्शन 1.7.0-beta02

18 सितंबर, 2024

androidx.car.app:app-*:1.7.0-beta02 रिलीज़ हो गया है. वर्शन 1.7.0-beta02 में ये बदलाव शामिल हैं.

एपीआई में हुए बदलाव

• बैक अप के तौर पर एक और KEY_ROOT_HINT_MEDIA_HOST_VERSION जोड़ना (I8796b)
• TabContents.Api8Builder क्लास को TabContents.Builder क्लास में @ExperimentalCarApi कंस्ट्रक्टर से बदलें (I26fbe)
• CarMediaApp (I50782) के लिए इंटेंट ऐक्शन और अतिरिक्त जानकारी जोड़ें
• मैसेजिंग एपीआई को गैर-एक्सपेरिमेंटल के तौर पर मार्क करें (I0b070)
• SectionedItemTemplate में रिमोट आइटम लोडिंग की सुविधा जोड़ी गई. इससे लंबी सूचियां क्रैश हुए बिना लोड हो सकती हैं (I0d122)
• एपीआई 8 में, TabTemplate के अंदर मौजूद TabTemplate में, इस्तेमाल किए जा सकने वाले टेंप्लेट की सूची में SectionedItemTemplate जोड़ा गया. (Idc5d6)

गड़बड़ियां ठीक की गईं

• नए प्लैटफ़ॉर्म एपीआई को ऐक्सेस करने के लिए, मैन्युअल तरीके से आउटलाइन बनाने की सुविधा हटा दी गई है. ऐसा इसलिए, क्योंकि AGP 7.3 या इसके बाद के वर्शन (जैसे, R8 का वर्शन 3.3) के साथ R8 का इस्तेमाल करने पर, एपीआई मॉडलिंग के ज़रिए यह काम अपने-आप हो जाता है. साथ ही, AGP 8.1 या इसके बाद के वर्शन (जैसे, D8 का वर्शन 8.1) का इस्तेमाल करने पर, सभी बिल्ड के लिए यह काम अपने-आप हो जाता है. AGP का इस्तेमाल न करने वाले क्लाइंट को D8 के 8.1 या उसके बाद के वर्शन पर अपडेट करने का सुझाव दिया जाता है. ज़्यादा जानकारी के लिए यह लेख देखें. (I9496c, b/345472586)

वर्शन 1.7.0-beta01

26 जून, 2024

androidx.car.app:app-*:1.7.0-beta01 रिलीज़ हो गया है. वर्शन 1.7.0-beta01 में ये बदलाव शामिल हैं. इसमें वही सुविधाएं हैं जो alpha01 में पब्लिश की गई थीं. इन्हें यहां दोहराया गया है:

नई सुविधाएं

• कॉन्टेंट के साथ मैप: यह एक नया टेंप्लेट है. इसमें मैप कैनवस के साथ-साथ कॉन्टेंट टेंप्लेट भी शामिल है. फ़िलहाल, कॉन्टेंट टेंप्लेट के तौर पर सूची / ग्रिड / पैन / मैसेज का इस्तेमाल किया जा सकता है.
  • RoutePreview, PlaceListNavigation, MapTemplate अब काम नहीं करते. टेंप्लेट पहले की तरह काम करते रहेंगे.
  • सैंपल ऐप्लिकेशन को अपडेट किया गया है, ताकि काम न करने वाले टेंप्लेट के बजाय MapWithContent के इस्तेमाल को दिखाया जा सके
• बातचीत की सुविधा: कार में बातचीत (आईएम, एसएमएस) दिखाने और Assistant के जवाब पढ़ने के लिए नए एपीआई.
• वाहन के डाइमेंशन: वाहन के मेज़रमेंट (फ़िलहाल, AAOS पर मौजूद डेटा) पाने के लिए नया एपीआई.

एपीआई में हुए बदलाव

• MediaPlaybackTemplate.Builder में @ExperimentalCarApi टैग जोड़ें. (Ic1957)
• एक्सपेरिमेंट के तौर पर उपलब्ध सुविधा में नया SectionedItemTemplate जोड़ता है. (I5958a)
• CarAppApiLevel 8 के बारे में जानकारी दो (I3fa22)
• Car App Library में मीडिया चलाने के दौरान कॉन्टेंट दिखाने के लिए, MediaPlaybackTemplate जोड़ता है. (I3c10d)
• ऐप्लिकेशन के लिए नया एपीआई जोड़ा गया है. इससे यह पता लगाया जा सकेगा कि ड्राइविंग के दौरान सिस्टम, बैकग्राउंड ऑडियो की सुविधा के साथ काम करता है या नहीं (I0f868)

गड़बड़ियां ठीक की गईं

• CAL क्लाइंट कोड और CAL नेविगेशन सैंपल ऐप्लिकेशन में, मेमोरी लीक और क्रैश होने की कुछ समस्याओं को ठीक किया गया है. (I55e04)
• क्रैश से बचने के लिए, BaseCarAppActivity के onDestroy तरीके में requireNotNull instances को if-null चेक से बदलें. (Iec676)

वर्शन 1.7.0-alpha02

17 अप्रैल, 2024

androidx.car.app:app-*:1.7.0-alpha02 रिलीज़ हो गया है. वर्शन 1.7.0-alpha02 में ये बदलाव शामिल हैं.

नई सुविधाएं

• मैप पर आधारित टेंप्लेट के लिए, बंद किए गए फ़्लैग जोड़े गए हैं. आने वाले समय में, MapWithContent टेंप्लेट का इस्तेमाल किया जाएगा.

एपीआई में हुए बदलाव

• पुरानी MapTemplate, RoutePreviewNavigationTemplate, PlaceListNavigationTemplate को बंद करें और नई MapWithContentTemplate का इस्तेमाल करने के लिए बढ़ावा दें (Ib0a08)

वर्शन 1.7.0-alpha01

3 अप्रैल, 2024

androidx.car.app:app-*:1.7.0-alpha01 रिलीज़ हो गया है. हमने अपनी लाइब्रेरी के वर्शनिंग स्कीम को, CarApi के चालू वर्शन से मैच करने के लिए बदल दिया है. डेवलपर से मिले सुझावों के आधार पर, नाम रखने के तरीके से जुड़ी उलझन को कम करने के लिए ऐसा किया गया है. इसलिए, हम सीधे तौर पर वर्शन 1.5 और 1.6 को छोड़कर, वर्शन 1.7 पर चले जाएंगे. वर्शन 1.7.0-alpha01 में ये बदलाव शामिल हैं.

नई सुविधाएं

• कॉन्टेंट के साथ मैप: MapWithContent नाम का नया टेंप्लेट. इसमें मैप के अंदर कॉन्टेंट के तौर पर सूची / ग्रिड / पैनल / मैसेज का इस्तेमाल किया जा सकता है.
  • RoutePreview, PlaceListNavigation, मैप टेंप्लेट अब सेवा में नहीं हैं.
  • MapWithContent का इस्तेमाल करके, बंद किए गए टेंप्लेट की सुविधाओं को दिखाने के लिए, सैंपल ऐप्लिकेशन अपडेट किए गए हैं.
• बातचीत वाला आइटम: बातचीत (आईएम, एसएमएस) दिखाने और कार में Assistant के जवाब पढ़ने के लिए नए एपीआई.
• वाहन के डाइमेंशन: वाहन के मेज़रमेंट (फ़िलहाल, AAOS पर मौजूद डेटा) पाने के लिए नया एपीआई.

एपीआई में हुए बदलाव

• बहुत छोटी लाइन वाली इमेज टाइप को एक्सपेरिमेंट के तौर पर उपलब्ध सुविधा के तौर पर मार्क करें (I5184b)
• CarInfo#fetchExteriorDimensions एपीआई जोड़ा गया है. इससे वाहन के बाहरी डाइमेंशन की जानकारी ऐक्सेस की जा सकती है. जैसे, ऊंचाई, चौड़ाई वगैरह (Ia40c5)
• MapWithContentTemplate (I66db8) से ExperimentalAPI टैग हटाया गया
• GridItem#setTitle पैरामीटर को अपडेट करके, शून्य वैल्यू स्वीकार करने की अनुमति दी गई है. (I3d610)
• GetHeader एपीआई के लिए एपीआई 7 की ज़रूरत नहीं है, क्योंकि यह पिछले वर्शन के साथ काम करता है (I8c812)
• ListTemplate में Header के लिए सहायता जोड़ी गई, headerAction, headerTitle, actionStrip को बंद किया गया (I7ae01)
• GridTemplate में title, headerAction, actionStrip को बंद करें और Header के लिए सहायता जोड़ें (I41a9c)
• एक्सपेरिमेंट के तौर पर उपलब्ध एपीआई के लिए, लेवल 7 की ज़रूरी शर्त हटा दी गई है: बैज, GridTemplate आइटम के साइज़ और इमेज के शेप को पाने/सेट करने वाले फ़ंक्शन, GridItem बैज को पाने/सेट करने के तरीके. (Id71eb)
• PaneTemplate में title, headerAction, actionStrip को बंद करें, Header के लिए नई सुविधा जोड़ें (I23154)
• Media Center की टेलीमेट्री को BroadcastReceiver से बदलकर, कस्टम ऐक्शन ब्राउज़ करें पर सेट किया गया. (I4185f)
• MessageTemplate में Header एट्रिब्यूट के लिए सहायता जोड़ी गई. ActionStrip, headerAction, और title के लिए सहायता बंद कर दी गई है. (Ie2de8)
• सूचना की लगातार दिखने की सेटिंग में बदलाव करें (Icf8a8)
• पैरंट टेंप्लेट (I651e6) से isLoading एट्रिब्यूट हटाएं
• मीडिया ऐप्लिकेशन को मुख्य यूज़र इंटरफ़ेस (यूआई) पैरामीटर के बारे में बताने के लिए, अतिरिक्त जानकारी जोड़ी गई (I85ca2)
• MediaExtensions (I7ce28) में मीडिया सेंटर की Analytics सुविधा जोड़ें
• लाइनों में सबसे छोटी इमेज जोड़ने का विकल्प जोड़ा गया. (I72c03)

गड़बड़ियां ठीक की गईं

• ConversationItem पर javadoc को अपडेट करें, ताकि यह बताया जा सके कि मैसेज को सबसे पुराने से सबसे नए के क्रम में लगाया जाना चाहिए. (I77a2a)
• ListTemplate में मौजूद सबसे पुराने मैसेज हटाने के लिए, ListTemplate के ट्रंकेशन लॉजिक को अपडेट करें (Ie0a61)ConversationItem

वर्शन 1.4

वर्शन 1.4.0

29 मई, 2024

androidx.car.app:app-*:1.4.0 रिलीज़ हो गया है. वर्शन 1.4.0, 1.4.0-rc02 का प्रमोशन है.

1.3.0 के बाद हुए अहम बदलाव

• नेविगेशन ऐप्लिकेशन के लिए, इंस्ट्रूमेंट क्लस्टर पर मैप रेंडर करने की सुविधा
• ऐप्लिकेशन के लेआउट / इस्तेमाल को बेहतर बनाने के लिए, नया टैब टेंप्लेट
• अडैप्टिव टास्क की सीमाओं के लिए सहायता
• सूची में मौजूद एलिमेंट पर की जाने वाली सेकंडरी कार्रवाइयां

वर्शन 1.4.0-rc02

13 दिसंबर, 2023

androidx.car.app:app-*:1.4.0-rc02 रिलीज़ हो गया है. वर्शन 1.4.0-rc02 में ये बदलाव शामिल हैं.. सिर्फ़ छोटी-मोटी गड़बड़ियां ठीक की गई हैं

गड़बड़ियां ठीक की गईं

• ConversationItem पर javadoc को अपडेट करें, ताकि यह बताया जा सके कि मैसेज को सबसे पुराने से लेकर सबसे नए तक के क्रम में लगाया जाना चाहिए (I77a2a)
• ListTemplate में मौजूद सबसे पुराने मैसेज हटाने के लिए, ListTemplate के ट्रंकेशन लॉजिक को अपडेट करें (Ie0a61)ConversationItem

वर्शन 1.4.0-rc01

1 नवंबर, 2023

androidx.car.app:app-*:1.4.0-rc01 को बिना किसी खास बदलाव के रिलीज़ किया गया है. वर्शन 1.4.0-rc01 में ये बदलाव शामिल हैं..

वर्शन 1.4.0-beta02

20 सितंबर, 2023

androidx.car.app:app-*:1.4.0-beta02 रिलीज़ हो गया है. वर्शन 1.4.0-beta02 में ये बदलाव शामिल हैं.. यह वर्शन, beta01 वर्शन के जैसा ही है. हालांकि, इसमें compileSdk की ज़रूरी शर्त को 33 पर सेट किया गया है.

गड़बड़ियां ठीक की गईं

• उस गड़बड़ी को ठीक किया गया है जिसमें टैब पर लोड हो रही स्क्रीन सही तरीके से नहीं दिखती थीं. (cae860)

वर्शन 1.4.0-beta01

9 अगस्त, 2023

androidx.car.app:app-*:1.4.0-beta01 रिलीज़ हो गया है. वर्शन 1.4.0-beta01 में ये बदलाव शामिल हैं..

ध्यान दें: 1.4-beta01 के लिए compileSdk34 की ज़रूरत होती है. यह अब भी डेवलपमेंट स्टेटस में है. 1.4-beta02 में इस समस्या को ठीक कर दिया जाएगा. इसके अलावा, अपने प्रोजेक्ट की settings.gradle फ़ाइल में android.suppressUnsupportedCompileSdk=34 जोड़कर, चेतावनी को कुछ समय के लिए सुरक्षित तरीके से हटाया जा सकता है.

नई सुविधाएं

• नेविगेशन ऐप्लिकेशन के लिए, इंस्ट्रूमेंट क्लस्टर पर मैप रेंडर करने की सुविधा
• ऐप्लिकेशन के लेआउट / इस्तेमाल को बेहतर बनाने के लिए, नया टैब टेंप्लेट
• अडैप्टिव टास्क लिमिट की सुविधा के लिए सहायता
• सूची में मौजूद एलिमेंट पर की जाने वाली सेकंडरी कार्रवाइयां

एपीआई में हुए बदलाव

• alpha02 देखें

वर्शन 1.4.0-alpha02

26 जुलाई, 2023

androidx.car.app:app-*:1.4.0-alpha02 रिलीज़ हो गया है. वर्शन 1.4.0-alpha02 में ये बदलाव शामिल हैं.

• Alpha02 को इसलिए रिलीज़ किया गया है, ताकि आने वाली beta01 रिलीज़ के लिए तैयारी की जा सके.

नई सुविधाएं

• नेविगेशन ऐप्लिकेशन के लिए, इंस्ट्रूमेंट क्लस्टर पर मैप रेंडर करने की सुविधा
• लेआउट को बेहतर बनाने के लिए, ऐप्लिकेशन के लिए टैब जोड़े गए
• लिस्ट / ग्रिड टेंप्लेट रेंडरिंग के विकल्प जोड़े गए
• मौसम और कम्यूनिकेशन के लिए नई कैटगरी जोड़ी गईं
• कई एपीआई को CarApi 7 के अगले वर्शन पर ले जाएं

एपीआई में हुए बदलाव

• CarMessage (I5aaf6) में मल्टीमीडिया फ़ील्ड जोड़ें
• यह कुकी, Car App Library (Ie5ed6) में ConversationItem के लिए कस्टम ऐक्शन जोड़ती है
• इमर्सिव ऑडियो फ़ॉर्मैट में मीडिया आइटम चलाने के लिए, एक्सट्रा जोड़ें. साथ ही, कॉन्टेंट फ़ॉर्मैट का लोगो (Icb5bb) दिखाएं
• कंपोज़ बटन के लिए, ActionsConstraints एपीआई के साथ नया ऐक्शन टाइप जोड़ा गया. (I31661)
• set/getTemplate को set/get ContentTemplate (Ica036) के तौर पर मार्क किया गया
• टेंप्लेट पैरामीटर अब @NonNull होगा. MapWithContentTemplate एपीआई के दस्तावेज़ (I0f8ed) को अपडेट किया गया
• यह कुकी, CAL 1.4 (I2cfcb) में लॉन्च करने के लिए, ListTemplate में कार्रवाइयों के लिए @ExperimentalCarApi टैग को हटाती है
• यह फ़ंक्शन, TabTemplate के लिए @ExperimentalCarApi टैग हटाता है (Ifcb82)
• लाइन के सेकंडरी ऐक्शन और डेकोरेशन से @ExperimentalCarApi एनोटेशन हटाएं (I8487e)
• इस कुकी का इस्तेमाल, TabTemplate में चालू टैब का कॉन्टेंट आईडी जोड़ने के लिए किया जाता है. साथ ही, यह टैब पर ऐक्टिव स्टेट को बंद कर देती है (I96932)
• ItemImageShape (Ibf431) में ItemImageShape प्रॉपर्टी जोड़ेंGridTemplate
• GridTemplate में ItemSize प्रॉपर्टी जोड़ें. यह प्रॉपर्टी, छोटे, सामान्य, और बड़े बकेट के हिसाब से ग्रिड आइटम के साइज़ को कंट्रोल करती है. (Icdb3b)
• डेवलपर के लिए एपीआई ऐक्सेस खोलें, ताकि वे मौजूदा स्क्रीन स्टैक की कॉपी पा सकें. (I48107)
• इस कुकी से, कार के लिए ऐप्लिकेशन लाइब्रेरी (I2be44) में मौसम की जानकारी देने वाले ऐप्लिकेशन की कैटगरी जोड़ी जाती है
• कार के लिए ऐप्लिकेशन लाइब्रेरी में, कॉल करने वाले ऐप्लिकेशन के लिए कैटगरी जोड़ता है (Icab33)
• GridItem.Builder#setBadge() को ओवरलोड किए गए setImage() तरीकों (Id2000) से बदला गया
• बैज (I629b2) में आइकॉन प्रॉपर्टी जोड़ी गई
• डॉट बैज के बैकग्राउंड का रंग सेट करने के लिए, तरीका जोड़ा गया (I6411c)
• GridItem में बैज प्रॉपर्टी जोड़ें, ताकि GridItem इमेज के ऊपर बैज दिखाया जा सके. (I95de7)
• एक एक्सपेरिमेंटल बैज ऑब्जेक्ट जोड़ा गया है. यह एक बैज को दिखाएगा, जिसे किसी इमेज पर दिखाया जाएगा. (I9878d)

वर्शन 1.4.0-alpha01

22 फ़रवरी, 2023

androidx.car.app:app-*:1.4.0-alpha01 रिलीज़ हो गया है. वर्शन 1.4.0-alpha01 में ये बदलाव शामिल हैं.

एपीआई में हुए बदलाव

• यह कुकी, Car App Library (Id0191) में GridTemplate के लिए टॉप-लेवल की कार्रवाइयां जोड़ती है
• यह कुकी, Car App Library (I9efab) में ListTemplate के लिए टॉप-लेवल के ऐक्शन जोड़ती है
• किसी मीडिया आइटम के सबटाइटल या उसके ब्यौरे को दूसरे मीडिया आइटम से लिंक करने के लिए, एक्सट्रा जोड़ें (Ic84bf)
• लाइन की कार्रवाइयों के लिए एपीआई लेवल को लेवल 6 पर अपडेट करें. (Ie0a69)
• A4C (Ie3986) में मैसेजिंग के लिए कॉलबैक जोड़ें

गड़बड़ियां ठीक की गईं

• CarMessage के लिए, Java Doc के छूटे हुए रेफ़रंस जोड़ें. (I5db1c)
• ConversationItem और CarMessage के लिए, equals() और hashCode() को बदला गया (I6fd10)
• ConversationItem.mMessages की पुष्टि करने की सुविधा को बेहतर बनाएं. इसके लिए, यह ज़रूरी है कि वैल्यू शून्य न हो और खाली न हो (Iafc51)
• ConversationItem फ़ील्ड में @Keep एनोटेशन जोड़ें (I5d250)
• लाइन को सजाने और सेकंडरी कार्रवाइयों के लिए, Java दस्तावेज़ अपडेट किए गए. (I000b6)

वर्शन 1.3

वर्शन 1.3.0-rc01

7 दिसंबर, 2022

androidx.car.app:app-*:1.3.0-rc01 रिलीज़ हो गया है. वर्शन 1.3.0-rc01 में ये बदलाव शामिल हैं.

• beta01 वर्शन में मौजूद छोटी-मोटी गड़बड़ियां ठीक की गई हैं. कोई बड़ा बदलाव नहीं किया गया है.

वर्शन 1.3.0-beta01

7 सितंबर, 2022

androidx.car.app:app:1.3.0-beta01, androidx.car.app:app-projected:1.3.0-beta01, androidx.car.app:app-automotive:1.3.0-beta01, और androidx.car.app:app-testing:1.3.0-beta01 रिलीज़ किए गए हैं. वर्शन 1.3.0-beta01 में ये बदलाव शामिल हैं.

• इस लाइब्रेरी का इस्तेमाल करके बनाए गए कार ऐप्लिकेशन, अब एपीआई लेवल 5 का इस्तेमाल करके Play Store पर उपलब्ध कराए जा सकते हैं. इसके बारे में ज़्यादा जानने के लिए, हमारी डेवलपमेंट गाइड देखें. एपीआई लेवल 5 और इससे कम लेवल के साथ एनोटेट की गई सुविधाएं, Android Auto 8.1+ और Google Automotive App Host 1.4+, दोनों के साथ काम करती हैं.

नई सुविधाएं

Car App Library 1.3.0-alpha01 में जोड़ी गई सुविधाओं के अलावा, beta01 के तहत ये सुविधाएं जोड़ी गई हैं. यहां दी गई सभी सुविधाएं, सिर्फ़ होस्ट साइड में बदलावों से जुड़ी हैं. इनमें एपीआई में कोई बदलाव नहीं किया गया है:

• फ़्लोटिंग नेविगेशन बार, PlaceListNavigationTemplate, RoutePreviewNavigationTemplate, और MapTemplate में मैप पर आधारित चुनने की स्क्रीन पर भी दिखता रहेगा. इसके लिए, NavigationManager.updateTrip() में जाकर नेविगेशन की जानकारी अपडेट करें.
• टाइम आउट ऐनिमेशन के लिए, FLAG_DEFAULT की मदद से कार्रवाई करने वाले बटन को चालू करें. समयसीमा खत्म होने के बाद, यह बटन डिफ़ॉल्ट रूप से क्लिक हो जाएगा. ([API 5 - All Templates])
• कार पार्क होने पर, Rows का सबटेक्स्ट छोटा नहीं होता. हालांकि, गाड़ी चलाते समय यह दो लाइनों में छोटा हो जाता है. ([API 5 - All Templates])
• Action, Toggle, Row ([API 5 - All Templates]) के लिए, बंद होने की स्थिति की सुविधा उपलब्ध नहीं है

एपीआई में हुए बदलाव

• चुनी जा सकने वाली सूचियों (I961ed) के लिए, MapTemplate सूची में मौजूद शर्तों को आसान बनाया गया
• कस्टम आइकॉन इस्तेमाल करने के लिए, हेडर ऐक्शन से जुड़ी पाबंदी हटाएं. (Iad28f)
• ActionsConstraints में setOnClickListenerAllowed() कंस्ट्रेंट जोड़ें. इसमें, स्टैंडर्ड आइकॉन टाइप को छोड़कर अन्य आइकॉन टाइप के लिए Action को OnClickDelegate() पर सेट करने की अनुमति दी गई थी. (TYPE_APP_ICON, TYPE_BACK, और TYPE_PAN) (I3c745)

गड़बड़ियां ठीक की गईं

• घुमावदार डिसप्ले ([Host change]) के साथ Android Automotive Template Host 1.4 या इसके बाद के वर्शन के काम करने की सुविधा जोड़ी गई

वर्शन 1.3.0-alpha01

27 जुलाई, 2022

androidx.car.app:app:1.3.0-alpha01, androidx.car.app:app-projected:1.3.0-alpha01, androidx.car.app:app-automotive:1.3.0-alpha01, और androidx.car.app:app-testing:1.3.0-alpha01 रिलीज़ किए गए हैं. वर्शन 1.3.0-alpha01 में ये बदलाव शामिल हैं.

एपीआई लेवल 5 के साथ एनोटेट की गई सुविधाएं, Android Auto 7.9 और इसके बाद के वर्शन के साथ काम करती हैं.

नई सुविधाएं

• एपीआई लेवल 5: नया MapTemplate, जिसका इस्तेमाल नेविगेशन ऐप्लिकेशन, मैप के साथ-साथ पैन या सूची का कॉन्टेंट दिखाने के लिए कर सकते हैं (If5826, If44b8)
• एपीआई लेवल 5: होस्ट वाहन के माइक्रोफ़ोन से ऑडियो इनपुट रिकॉर्ड करने की अनुमति देने के लिए नया CarAudioRecord एपीआई (I5e71a)
• एपीआई लेवल 5: नया SuggestionManager एपीआई, ताकि ऐप्लिकेशन होस्ट को सुझाव दे सकें (I5c103)
• एपीआई लेवल 5: NavigationTemplate पर कॉन्टेक्स्ट के हिसाब से सूचनाएं दिखाने के लिए नया Alert एपीआई (I163a7, I5ad70)
• एपीआई लेवल 5: टेंप्लेट में फिर से इस्तेमाल करने के लिए नए Header और MapController कॉम्पोनेंट (If5826)
• लोकप्रिय जगह के ऐप्लिकेशन चालू करने के लिए, androidx.car.app.category.POI को कैटगरी के तौर पर जोड़ा गया. साथ ही, androidx.car.app.category.PARKING और androidx.car.app.category.CHARGING को बंद कर दिया गया (I59da1)

एपीआई में हुए बदलाव

• एपीआई लेवल 5: SurfaceCallback इंटरफ़ेस में नया onClick तरीका, ताकि मैप पर टैप करने की सुविधा दी जा सके (Ia9777)
• एपीआई लेवल 5: Actions (I96318, I5ad70) के बारे में बताने के लिए नए फ़्लैग Action.FLAG_IS_PERSISTENT और Action.FLAG_DEFAULT
• एपीआई लेवल 5: Action, Row, और Toggle कॉम्पोनेंट के लिए, चालू/बंद की नई स्थिति (लाइब्रेरी के 1.3.0-beta01 वर्शन के रिलीज़ होने के बाद, होस्ट के लिए उपलब्ध होगा) (Id8a09)
• एपीआई लेवल 5: PlaceListNavigationTemplate.Builder और RoutePreviewNavigationTemplate.Builder पर setHeader के ज़रिए, नए Header कॉम्पोनेंट को प्राथमिकता दें. साथ ही, मौजूदा setTitle और setHeaderAction तरीकों को बंद करें (I30e6a)
• एपीआई लेवल 5: PlaceListMapTemplate.Builder और PlaceListNavigationTemplate.Builder पर नया setOnContentRefreshListner तरीका. इसका इस्तेमाल, नए OnContentRefreshListner इंटरफ़ेस को लागू करने के लिए किया जाता है.
• एपीआई लेवल 5: यात्रा के अनुमानित समय के कार्ड (Idcc6d, Ic620d) को पसंद के मुताबिक बनाने के लिए, TravelEstimate.Builder पर नए setTripText और setTripIcon
• PaneTemplate के टाइटल में CarIconSpan इस्तेमाल करने की सुविधा जोड़ी गई (Ia1ee0)
• Row के टाइटल और टेक्स्ट में CarIconSpan इस्तेमाल करने की सुविधा जोड़ी गई (Ic1e3c)
• अब मैप ActionStrip में ज़्यादा से ज़्यादा चार कार्रवाइयां हो सकती हैं (If3522)
• Car App API के लेवल को 5 पर अपडेट करें (I26b8e)
• अब PlaceListMapTemplate, PlaceListNavigationTemplate, RoutePreviewNavigationTemplate, GridTemplate, ListTemplate, LongMessageTemplate, MessageTemplate, PaneTemplate, और SignInTemplate के लिए हेडर/टाइटल देना ज़रूरी नहीं है (I2078d, Icadde)

गड़बड़ियां ठीक की गईं

• PaneTemplate इमेज के साइज़ से जुड़े नियमों को अपडेट किया गया है, ताकि इमेज को स्क्वेयर बाउंडिंग बॉक्स (Idd72e) में रखा जा सके
• State.DESTROYED के बाद स्क्रीन स्टैक में बदलाव करने पर होने वाली गड़बड़ी को ठीक किया गया है. (I3c8eb)
• ऐप्लिकेशन आइकॉन (I3f710) को वापस पाने के लिए, शून्य की जांच करने की सुविधा जोड़ी गई
• Car Hardware API को अपडेट करके, डिफ़ॉल्ट रूप से STATUS_UNAVAILABLE के बजाय STATUS_UNKNOWN का इस्तेमाल करना (Ic9444)
• सरफ़ेस बनाने से पहले, यह जांच करें कि डिसप्ले मौजूद है या नहीं (Ice027a)
• STATUS_UNIMPLEMENTED से जुड़ी CarValue.equals() गड़बड़ी ठीक की गई (I24451)

वर्शन 1.2

वर्शन 1.2.0

9 नवंबर, 2022

androidx.car.app:app-*:1.2.0 रिलीज़ हो गया है. वर्शन 1.2.0 में ये बदलाव शामिल हैं.

• यह एक स्टेबल रिलीज़ है. इसमें v1.2.0-rc01 की तुलना में कोई बदलाव नहीं किया गया है.

वर्शन 1.2.0-rc01

23 मार्च, 2022

androidx.car.app:app-*:1.2.0-rc01 रिलीज़ हो गया है. वर्शन 1.2.0-rc01 में ये बदलाव शामिल हैं.

• यह एक स्टेबल रिलीज़ है. इसमें v1.2.0-beta02 की तुलना में एपीआई में कोई बदलाव नहीं किया गया है. इसमें एक्सपेरिमेंट के तौर पर नई सुविधाएं (एपीआई लेवल 5) जोड़ी गई हैं. ये सुविधाएं, Android Auto और Android Automotive के आने वाले वर्शन के लिए हैं.

गड़बड़ियां ठीक की गईं

• State.DESTROYED के बाद स्क्रीन स्टैक में बदलाव करने पर होने वाली गड़बड़ी को ठीक किया गया है. (I3c8eb)
• CarSensors एपीआई को अपडेट किया गया है, ताकि यह पता चल सके कि इन्हें AAOS (Idd57b) के लिए लागू नहीं किया गया है
• PlaceListMapTempalte.Builder#setCurrentLocationEnabled को अपडेट किया गया है, ताकि यह बताया जा सके कि इस सुविधा के लिए ACCESS_COARSE_LOCATION की अनुमति काफ़ी होगी (I510c2)
• गोल चक्कर में मुड़ने के अलग-अलग तरीकों (Ife7d1) के लिए, निकास संख्या को वैकल्पिक बनाया गया

वर्शन 1.2.0-beta02

26 जनवरी, 2022

androidx.car.app:app-*:1.2.0-beta02 रिलीज़ हो गया है. वर्शन 1.2.0-beta02 में ये बदलाव शामिल हैं.

इस लाइब्रेरी वर्शन का इस्तेमाल करके, Android Automotive OS प्लैटफ़ॉर्म के लिए बनाए गए कार ऐप्लिकेशन को अब Play Store के ओपन टेस्टिंग चैनल पर पब्लिश किया जा सकता है. ज़्यादा जानकारी के लिए, डेवलपमेंट गाइड देखें.

एपीआई लेवल 4 और इससे पहले के वर्शन के साथ काम करने वाली सुविधाएं, Android Auto 7.2 और इसके बाद के वर्शन और नए Android Automotive OS प्लैटफ़ॉर्म, दोनों के साथ काम करती हैं. चेतावनी के लिए, नीचे दिया गया Known Issues सेक्शन देखें.

एपीआई में हुए बदलाव

• POI टेंप्लेट में एक्सपेरिमेंट के तौर पर setOnContentRefreshListener API जोड़ा गया (I6bf22)

गड़बड़ियां ठीक की गईं

• कार होस्ट के अनबाइंड होने पर, CarAppService में मेमोरी लीक की समस्या को ठीक किया गया है. (I5c9ca, b/203594731)
• singleTask launchmode के लिए ज़रूरी शर्तों को शामिल करने के लिए, CarAppActivity javadoc अपडेट किया गया (Id2f95)
• इससे वीडियो फिर से शुरू होने पर दिखने वाली गड़बड़ी कम हो जाती है. (Iff7e0)

मौजूदा समस्याएं

• PlaceListNavigationTemplate और RoutePreviewNavigateTemplate में मौजूद ActionStrips, अगली Android Auto और Android Automotive OS रिलीज़ में उपलब्ध होने लगेंगे.

वर्शन 1.2.0-alpha02

15 दिसंबर, 2021

androidx.car.app:app-*:1.2.0-alpha02 रिलीज़ हो गया है. वर्शन 1.2.0-alpha02 में ये बदलाव शामिल हैं.

एपीआई लेवल 4 के साथ एनोटेट की गई सुविधाओं को एक्सपेरिमेंट के तौर पर उपलब्ध होने से अपग्रेड करके, स्टेबल वर्शन में उपलब्ध करा दिया गया है. इनमें PlaceListNavigationTemplate और RoutePreviewNavigateTemplate में मौजूद मैप ActionStrip, Pane में मौजूद CarIcon इमेज, QRCodeSignInMethod, और Action में रेंडरिंग के सुझाव (जैसे, फ़्लैग) सेट करने की सुविधा शामिल है.

नई सुविधाएं

• Android Auto 7.1 या इसके बाद के वर्शन में, Pane के लिए आइटम की सीमा को 2 से बढ़ाकर 4 कर दिया गया है.

एपीआई में हुए बदलाव

• CarUnit(I36a3b) में, एक्सपेरिमेंट के तौर पर toString() तरीका जोड़ा गया

गड़बड़ियां ठीक की गईं

• अगर कॉलबैक बंद हो जाता है (If9823), तो CarAppPermissionActivity में होने वाली क्रैश की समस्या को ठीक किया गया है
• Pane के लिए डिफ़ॉल्ट सूची की सीमा को 4 (I0068b) पर सेट किया गया

वर्शन 1.2.0-alpha01

3 नवंबर, 2021

androidx.car.app:app-*:1.2.0-alpha01 रिलीज़ हो गया है. वर्शन 1.2.0-alpha01 में ये बदलाव शामिल हैं.

v1.2.0 की सभी नई सुविधाएं (एपीआई 4+) फ़िलहाल एक्सपेरिमेंटल हैं. इन्हें Android Auto और Android Automotive OS के आने वाले वर्शन को टारगेट करने के लिए बनाया गया है. ज़्यादा जानकारी के लिए, डेवलपमेंट गाइड देखें.

एपीआई में हुए बदलाव

• AutomotiveCarInfo एपीआई को एक्सपेरिमेंटल के तौर पर उपलब्ध कराया गया. (Ia13e5)
• Car App Library के एपीआई लेवल 4 (I2a2e7) को जोड़ा गया
• एपीआई लेवल 4: Pane (Ifcc12) में CarIcon सेट करने की सुविधा जोड़ी गई
• एपीआई लेवल 4: क्यूआर कोड से साइन इन करने का तरीका जोड़ा गया (Ib623e)
• एपीआई लेवल 4: Action (Ic03ab) में set/getFlags जोड़ा गया
• एपीआई लेवल 4: PlaceListNavigationTemplate और RoutePreviewNavigationTemplate में पैन करने और ज़ूम करने की सुविधा जोड़ी गई (I9d8a3)

गड़बड़ियां ठीक की गईं

• एपीआई लेवल 4: ऐप्लिकेशन को कार होस्ट (I3bad3) को जगह की जानकारी के अपडेट भेजने की अनुमति देने के लिए, एक तरीका जोड़ें
• उस समस्या को ठीक किया गया है जिसमें होस्ट की पुष्टि करने वाला लॉजिक, TEMPLATE_RENDERER की अनुमति को सही तरीके से नहीं ढूंढ रहा था (I62618)

वर्शन 1.1.0

वर्शन 1.1.0

15 दिसंबर, 2021

androidx.car.app:app-*:1.1.0 रिलीज़ हो गया है. वर्शन 1.1.0 में ये बदलाव शामिल हैं.

यह एक स्टेबल रिलीज़ है. इसमें v1.1.0-rc01 की तुलना में कोई बदलाव नहीं किया गया है. कार ऐप्लिकेशन लाइब्रेरी की नई सुविधाओं के बारे में ज़्यादा जानने के लिए, v1.2.0-alpha02 के लिए रिलीज़ नोट भी देखें.

1.0.0 के बाद हुए अहम बदलाव

• एपीआई लेवल 2: SignInTemplate और LongMessageTemplate. इनका इस्तेमाल, वाहन के पार्क होने पर साइन-इन फ़्लो के लिए किया जा सकता है
• एपीआई लेवल 2: NavigationTemplate में मैप इंटरैक्टिविटी की सुविधा
• एपीआई लेवल 2: इसमें अलग-अलग लंबाई वाले टेक्स्ट का इस्तेमाल किया जा सकता है. इससे ऐप्लिकेशन, कार की स्क्रीन के साइज़ के हिसाब से स्ट्रिंग के अलग-अलग वर्शन दिखा सकते हैं.
• एपीआई लेवल 3: CarHardwareManagerइसका इस्तेमाल, वाहन के हार्डवेयर डेटा के बारे में क्वेरी करने के लिए किया जा सकता है. जैसे, मॉडल और मेक, ईंधन का लेवल, और अन्य सेंसर.

वर्शन 1.1.0-rc01

3 नवंबर, 2021

androidx.car.app:app-*:1.1.0-rc01 रिलीज़ हो गया है. वर्शन 1.1.0-rc01 में ये बदलाव शामिल हैं.

यह एक स्टेबल रिलीज़ है. इसमें v1.1.0-beta01 की तुलना में एपीआई में कोई बदलाव नहीं किया गया है. प्रयोग के तौर पर नई सुविधाएं (एपीआई लेवल 4) जोड़ी गई हैं. ये सुविधाएं, Android Auto के आने वाले वर्शन के लिए हैं. एक्सपेरिमेंट के तौर पर उपलब्ध एपीआई के बारे में ज़्यादा जानने के लिए, v1.2.0-alpha01 के रिलीज़ नोट देखें.

वर्शन 1.1.0-beta01

1 सितंबर, 2021

androidx.car.app:app-*:1.1.0-beta01 रिलीज़ हो गया है. वर्शन 1.1.0-beta01 में ये बदलाव शामिल हैं.

v1.1.0 की सभी सुविधाएं (एपीआई 2+), Android Auto 6.7 और इसके बाद के वर्शन के साथ पूरी तरह से काम करती हैं. ज़्यादा जानकारी के लिए, डेवलपमेंट गाइड देखें.

एपीआई में हुए बदलाव

• Manager को सार्वजनिक इंटरफ़ेस के तौर पर हटाया गया (Ie381b)
• अनुमति के अनुरोध के लिए, ब्रैंड के हिसाब से कस्टम बैकग्राउंड सेट करने की सुविधा जोड़ी गई (I74b76)
• ScreenManager.getStackSize को जोड़ा गया (I0b16a)
• ScreenController कंस्ट्रक्टर हटाया गया, जो साफ़ तौर पर TestCarContext (Iefebc) लेता है

गड़बड़ियां ठीक की गईं

• CarHardwareManager बनाते समय, एपीआई लेवल की जांच करने की सुविधा जोड़ी गई (I48f9b)
• एपीआई में, अमान्य CarSpan के इस्तेमाल की जांच करने की सुविधा जोड़ी गई (I65ae6)
• हमने उस समस्या को ठीक कर दिया है जिसमें Screen को बनाते समय, उसे 'पूरा हो गया' के तौर पर मार्क करने पर, स्टैक की स्थिति खराब हो जाती थी (I81b13)
• उस समस्या को ठीक किया गया है जिसमें CarNotificationManager.notify, AutomotiveOS के लिए गड़बड़ी लॉग करता था. ऐसा तब होता था, जब CarNotificationManager.notify (I3633d) में आइकॉन वाली कार्रवाइयां मौजूद होती थींCarAppExtender
• ऐप्लिकेशन और होस्ट के लिए हैंडशेक करने का तरीका जोड़ा गया है, ताकि एपीआई वर्शन (I7d6f8) सेट अप किया जा सके

वर्शन 1.1.0-alpha02

21 जुलाई, 2021

androidx.car.app:app-*:1.1.0-alpha02 रिलीज़ हो गया है. वर्शन 1.1.0-alpha02 में ये बदलाव शामिल हैं.

नई सुविधाएं

• एपीआई लेवल 3: CarHardwareManager जोड़ा गया है. इसका इस्तेमाल, वाहन के हार्डवेयर डेटा के बारे में क्वेरी करने के लिए किया जा सकता है. जैसे, मॉडल और मेक, ईंधन का लेवल, और अन्य सेंसर. फ़िलहाल, यह सुविधा सिर्फ़ Android Auto 6.7 या इसके बाद के वर्शन के लिए, ओपन-टेस्टिंग चैनल में उपलब्ध है. डेस्कटॉप एनवायरमेंट में इसकी टेस्टिंग के लिए, Desktop Head Unit के नए वर्शन की ज़रूरत होगी. इसे अलग से रिलीज़ किया जाएगा. नया वर्शन कब उपलब्ध होगा, इस बारे में ज़्यादा जानकारी पाने के लिए कार के लिए Android ऐप्लिकेशन की जांच करें पेज पर बने रहें.
• ज़्यादा जानकारी और डिज़ाइन से जुड़े दिशा-निर्देशों के लिए, डेवलपमेंट गाइड और लाइब्रेरी का रेफ़रंस देखें. इससे आपको यह पता चलेगा कि एपीआई लेवल 3 के साथ काम करने वाले कार होस्ट में इन सुविधाओं का इस्तेमाल कैसे किया जाता है.

एपीआई में हुए बदलाव

• SessionController और ScreenController लाइफ़साइकल के तरीकों को एक ही moveToState तरीके में शामिल किया गया (I1ed00)
• CarContext#getHostInfo() को जोड़ा गया (I8977e)
• अब इस्तेमाल में नहीं आने वाले फ़ील्ड हटाए गए. (I67168)
• कंस्ट्रक्टर को सीधे तौर पर दिखाने के लिए, SessionController और ScreenController को अपडेट किया गया (Iabf22)
• PinSignInMethod.Builder और ProviderSignInMethod.Builder (I9f0cb) को हटाया गया
• AAOS में 'नतीजे के लिए' टेंप्लेट वाले ऐप्लिकेशन इस्तेमाल करने की सुविधा चालू करने के लिए, 'setCarAppResult()' जोड़ा गया (I37741)
• CarHardware इंटरफ़ेस को @MainThread के साथ एनोटेट किया गया है. (Ib2f85)
• OnCarDataListener का नाम बदलकर OnCarDataAvailableListener किया गया (I518ca)
• CarInfo, Speed, Mileage के तरीके के नामों और javadoc को अपडेट किया गया. (I86672)
• Toll का नाम बदलकर TollCard कर दिया गया. (I3e7c8)
• अब इस्तेमाल में नहीं रहे PinSignInMethod.getPin को हटा दिया गया है. इसकी जगह PinSignInMethod.getPinCode (I996ce) का इस्तेमाल किया जाएगा
• OnInputCompletedListener को हटाया गया और उसकी जगह InputCallback को जोड़ा गया. (Ib5be1)
• PinSignInMethod को String के बजाय CharSequence लेने के लिए बदला गया (I275d5)

गड़बड़ियां ठीक की गईं

• कार के हार्डवेयर के लिए Javadoc से जुड़ी समस्याएं ठीक की गई हैं. (I2abbc)

बाहरी योगदान

मौजूदा समस्याएं

• SignInTemplate में, InputSignInMethod का इस्तेमाल करने पर, कार होस्ट में NullPointerException हो सकता है. इस समस्या को लाइब्रेरी के अगले वर्शन में ठीक कर दिया जाएगा. इस समस्या को हल करने के लिए, अपने ऐप्लिकेशन के Proguard कॉन्फ़िगरेशन में यह लाइन शामिल करें: -keep class androidx.car.app.model.signin.InputSignInMethod { *; }

वर्शन 1.1.0-alpha01

16 जून, 2021

androidx.car.app:app:1.1.0-alpha01, androidx.car.app:app-automotive:1.1.0-alpha01, और androidx.car.app:app-testing:1.1.0-alpha01 रिलीज़ किए गए हैं. वर्शन 1.1.0-alpha01 में ये बदलाव शामिल हैं.

नई सुविधाएं

• एपीआई लेवल 2: नए SignInTemplate और LongMessageTemplate. इनका इस्तेमाल, वाहन के पार्क होने पर साइन-इन फ़्लो के लिए किया जा सकता है.
• एपीआई लेवल 2: NavigationTemplate में मैप के साथ इंटरैक्ट करने की नई सुविधा
• एपीआई लेवल 2: इसमें अलग-अलग लंबाई वाले टेक्स्ट को इस्तेमाल करने की नई सुविधा जोड़ी गई है. इससे ऐप्लिकेशन, कार की स्क्रीन के साइज़ के हिसाब से स्ट्रिंग के कई वर्शन दिखा सकते हैं.
• ज़्यादा जानकारी और डिज़ाइन से जुड़े दिशा-निर्देशों के लिए, डेवलपमेंट गाइड और लाइब्रेरी Javadoc देखें. इनमें, API लेवल 2 के साथ काम करने वाले कार होस्ट में इन सुविधाओं का इस्तेमाल करने का तरीका बताया गया है.

एपीआई में हुए बदलाव

• सभी *Callback इंटरफ़ेस के तरीकों को डिफ़ॉल्ट बनाया गया और OnRequestPermissionsCallback का नाम बदलकर OnRequestPermissionsListener कर दिया गया (Ib3ec9)
• ग़ैर-ज़रूरी बिल्डर और पैरामीटर क्लास हटाने के लिए, androidx.car.app.hardware क्लास अपडेट की गई हैं. (I67beb)
• कार के बारे में खास डेटा ऐक्सेस करने के लिए, androidx.car.app.hardware क्लास जोड़ी गई हैं. जैसे, ईंधन, बैटरी, और स्पीड. (Iff3c9)
• MessageTemplate पर ActionStrip के लिए सहायता जोड़ी गई (Ida657)
• setLoading को MessageTemplate में जोड़ा गया. (I2a4b5)
• ConnectionToCar का नाम बदलकर CarConnection कर दिया गया (Ife9bd)
• NavigationTemplate को बदलकर, साफ़ तौर पर PanModeDelegate (I13877) को रिटर्न करने की सुविधा जोड़ी गई
• CarContext.requestPermissions (Ib890a) के लिए अपडेट किया गया पैरामीटर ऑर्डर
• मेटाडेटा की अपडेट की गई कुंजी, कार के एपीआई के कम से कम लेवल को androidx.car.api.minCarApiLevel (Ib0d41) पर सेट करती है
• एक ऐसा एपीआई बनाया गया है जो कार के कनेक्शन की स्थिति को मॉनिटर करने की अनुमति देता है (Ifc935)
• Action के लिए टॉगल सेट करने की सुविधा जोड़ी गई है. साथ ही, पैन मोड Action टाइप (Ica6af) जोड़ा गया है
• कार में सूचनाएं भेजने की सुविधा के लिए, CarNotificationManager बनाया गया (I10d7a)
• होस्ट से सूची की सीमाएं तय करने के लिए ConstraintManager जोड़ा गया (I8690e)
• NavigationTemplate (I77aa6) में पैन मोड और मैप ऐक्शन स्ट्रिप API जोड़ा गया
• नेविगेशन ऐप्लिकेशन के लिए, SurfaceCallback में पैन और ज़ूम एपीआई जोड़ा गया (Id5e9d)
• CarAppApiLevel को 2 (Ic1540) पर अपडेट किया गया
• CarAppService से अनुमतियों का अनुरोध करने की सुविधा जोड़ी गई (I5421e)
• मल्टी-टेक्स्ट एपीआई (Iacb62) में RequiresCarApi(2) एनोटेशन जोड़ा गया
• आधी सूची वाले टेम्प्लेट के टाइटल (Ib8df7) में, टेक्स्ट के एक से ज़्यादा वैरिएंट इस्तेमाल करने की अनुमति दी गई
• नया LongMessageTemplate जोड़ा गया है. इसके लिए, Car API लेवल 2 की ज़रूरत होती है (Ic5cee)

गड़बड़ियां ठीक की गईं

• कार की बड़ी स्क्रीन के हिसाब से, इमेज के साइज़ से जुड़ी ज़रूरी शर्तों को अपडेट किया गया है (I116dc)
• टेंप्लेट के मुख्य हिस्से में दो से ज़्यादा कार्रवाइयां जोड़ने की अनुमति नहीं है (I32157)
• कार ऐप्लिकेशन की लाइब्रेरी में मौजूद सभी PendingIntent के लिए, सेट फ़्लैग किए गए हैं. (If84fe, b/186394900)
• javadoc को अपडेट किया गया है, ताकि रीफ़्रेश होने पर Row के टेक्स्ट में बदलाव हो सकें (If3f9c)
• androidx.activity:activity:1.2.0 अब एक एपीआई डिपेंडेंसी (Id1cb9) है
• SignInTemplate और LongMessageTemplate को इस तरह बनाया गया है कि इनमें सिर्फ़ पार्क की गई कार से जुड़ी कार्रवाइयां शामिल हों. साथ ही, दस्तावेज़ को अपडेट किया गया है, ताकि यह बताया जा सके कि ये कार्रवाइयां सिर्फ़ तब दिखेंगी, जब कार पार्क की गई हो (Iddaa9)
• स्टार्टअप के दौरान Screen को पॉप अप करते समय होने वाली गड़बड़ी को ठीक किया गया (Ifcf40, b/184664896)
• ForegroundCarColorSpan में पसंद के मुताबिक टेक्स्ट के रंग की अनुमति है (I69e59)
• उस समस्या को ठीक किया गया है जिसमें Screen के ON_DESTROY के बाद, Session पर ON_DESTROY दिखता था (I52e01, b/183696617)
• TravelEstimate के बचे हुए समय को 'जानकारी नहीं है' पर सेट करने की अनुमति कब होती है, इस बारे में अपडेट किया गया javadoc. (I99610, b/183632456)
• टाइटल में ForegroundColorSpan और पसंद के मुताबिक बैकग्राउंड के किसी भी रंग (I578e4) का इस्तेमाल करने के लिए, Action को अपडेट किया गया
• अगर एक्ज़ीक्यूटर के एक्ज़ीक्यूट करने से पहले कॉलबैक को हटा दिया जाता है, तो NavigationManagerCallback#onStopNavigation को एक्ज़ीक्यूट न करें (I7fc5e, b/181143772)
• ऐसी समस्या को ठीक किया गया है जिसमें ऐप्लिकेशन को साफ़ तौर पर lifecycle-common-java8 (I8b8c8) पर निर्भरता लेनी पड़ती है

मौजूदा समस्याएं

• SignInTemplate में, जब उपयोगकर्ता को इनपुट की पुष्टि करनी होती है, तब ऑन-स्क्रीन कीबोर्ड में “enter” आइकॉन की जगह “search” आइकॉन दिखता है. हालांकि, इसके बजाय उपयोगकर्ता फ़ोन के कीबोर्ड को ऐक्सेस कर सकते हैं. यह कीबोर्ड तब चालू होता है, जब इनपुट फ़ील्ड पर फ़ोकस किया जाता है.
• Android Auto के 6.5 वर्शन में, कुछ टच जेस्चर के लिए SurfaceCallback में पैन और ज़ूम कॉलबैक को गलत तरीके से शुरू किया जा सकता है.

Car App Testing का वर्शन 1.0.0

वर्शन 1.0.0-alpha01

24 मार्च, 2021

androidx.car.app:app-testing:1.0.0-alpha01 रिलीज़ हो गया है. वर्शन 1.0.0-alpha01 में ये बदलाव शामिल हैं.

यह पहले बंद हो चुकी सोर्स टेस्टिंग लाइब्रेरी की पहली Jetpack रिलीज़ है. अपनी जांचों में इस लाइब्रेरी का इस्तेमाल करने का तरीका जानने के लिए, हमारे सैंपल देखें.

नई सुविधाएं

• मॉडल क्लास के कंट्रोलर हटा दिए गए हैं. मॉडल गेटर अब सार्वजनिक एपीआई का हिस्सा हैं. इससे, बिल्डर में सेट की गई वैल्यू की पुष्टि की जा सकती है.
• पिछले CarAppServiceController को नए SessionController से बदल दिया गया है. ऐसा इसलिए किया गया है, ताकि हॉटस्पॉट से कनेक्शन के लाइफ़टाइम से जुड़े लॉजिक की जांच की जा सके.

वर्शन 1.0.0

वर्शन 1.0.0

21 अप्रैल, 2021

androidx.car.app:app:1.0.0 रिलीज़ हो गया है. वर्शन 1.0.0 में ये बदलाव शामिल हैं.

1.0.0 वर्शन की मुख्य सुविधाएं

• हमने अप्रैल की शुरुआत में एलान किया था कि ऐप्लिकेशन, androidx.car.app:app:1.0.0-rc01 का इस्तेमाल करके प्रोडक्शन चैनल पर पब्लिश किए जा सकते हैं. Car App Library का v1.0.0 वर्शन अब स्टेबल है. साथ ही, यह Android Auto 6.1 और इसके बाद के वर्शन के साथ पूरी तरह काम करता है.
• लाइब्रेरी का इस्तेमाल करके, Android Auto के लिए नेविगेशन, पार्किंग, और चार्जिंग ऐप्लिकेशन बनाने के तरीके के बारे में जानने के लिए, डेवलपमेंट गाइड पढ़ें.

गड़बड़ियां ठीक की गईं

• शुरू होने के दौरान Screen को पॉप अप करते समय होने वाली गड़बड़ी को ठीक किया गया (70aae1, b/184664896)
• उस समस्या को ठीक किया गया है जिसमें Screen के ON_DESTROY (0ceecb, b/183696617) के बाद, Session पर ON_DESTROY दिखता है

वर्शन 1.0.0-rc01

24 मार्च, 2021

androidx.car.app:app:1.0.0-rc01 रिलीज़ हो गया है. वर्शन 1.0.0-rc01 में ये बदलाव शामिल हैं.

गड़बड़ियां ठीक की गईं

• रेस कंडीशन से जुड़ी गड़बड़ी को ठीक किया गया है. इस गड़बड़ी में, कॉलबैक के बंद होने के बाद NavigationManagerCallback#onStopNavigation को कॉल किया जा रहा था. ऐसा तब होता है, जब कॉलबैक एक्ज़ीक्यूटर के चलने से पहले ही कॉलबैक को हटा दिया जाता है (I7fc5e, b/181143772)
• उस समस्या को ठीक कर दिया गया है जिसकी वजह से ऐप्लिकेशन को lifecycle-common-java8 (I8b8c8) पर साफ़ तौर पर निर्भर रहना पड़ता था
• ऐसी NullPointerException को ठीक किया गया है जो ऐप्लिकेशन को stopNavigation कॉल मिलने पर ट्रिगर होती थी. ऐसा तब होता था, जब ऐप्लिकेशन पहले ही कॉलबैक हटा चुका होता था (Ib8b89, b/181143772)
• अगर ऐप्लिकेशन का लाइफ़साइकल कम से कम CREATED स्थिति में नहीं है, तो ऐप्लिकेशन को कॉल डिसपैच न करने से जुड़ी सुविधाएं बेहतर बनाई गई हैं (I86965, b/179800224, b/177921120)
• ऐप्लिकेशन के मेनिफ़ेस्ट में, अमान्य तौर पर कम से कम एपीआई तय किए जाने की वजह से होने वाली समस्या को ठीक किया गया है. इससे होस्ट पर एएनआर की समस्या होती थी. (Iffedd, b/174231592)

वर्शन 1.0.0-beta01

24 फ़रवरी, 2021

androidx.car.app:app:1.0.0-beta01 रिलीज़ हो गया है. वर्शन 1.0.0-beta01 में ये बदलाव शामिल हैं.

यह पहले बंद हो चुकी लाइब्रेरी का पहला Jetpack वर्शन है. यह Android Auto 6.1 या इसके बाद के वर्शन के साथ काम करता है. लाइब्रेरी का इस्तेमाल करके कार ऐप्लिकेशन बनाने के तरीके के बारे में जानने के लिए, डेवलपमेंट गाइड पढ़ें.

नई सुविधाएं

• एक GridTemplate पेश किया गया है. इसका इस्तेमाल करके, आपका ऐप्लिकेशन ग्रिड लेआउट में यूज़र इंटरफ़ेस (यूआई) एलिमेंट की सूची दिखा सकता है.
• यह पुष्टि करने के लिए कि होस्ट कनेक्शन किसी भरोसेमंद सोर्स (जैसे, Android Auto) से है, CarAppService.createHostValidator तरीका पेश किया गया है.
• CarAppExtender.Builder.setColor एपीआई जोड़ा गया. (b/174231592)

गड़बड़ियां ठीक की गईं

• उस समस्या को ठीक किया गया है जिसमें स्क्रीन को क्रम से पॉप-अप करते समय, गलत Screen फिर से शुरू हो जाता था. (b/177590791)