कार ऐप्लिकेशन
नया अपडेट | रिलीज़ किया गया जांचा और परखा हुआ वर्शन | रिलीज़ कैंडिडेट | बीटा रिलीज़ | ऐल्फ़ा रिलीज़ |
---|---|---|---|---|
13 नवंबर, 2024 | 1.4.0 | - | 1.7.0-beta03 | - |
डिपेंडेंसी का एलान करना
कार ऐप्लिकेशन लाइब्रेरी पर डिपेंडेंसी जोड़ने के लिए, आपको अपने प्रोजेक्ट में Google Maven रिपॉज़िटरी जोड़नी होगी. ज़्यादा जानकारी के लिए, Google की Maven रिपॉज़िटरी पढ़ें.
अपने ऐप्लिकेशन या मॉड्यूल के लिए, build.gradle
फ़ाइल में उन आर्टफ़ैक्ट की डिपेंडेंसी जोड़ें जिनकी आपको ज़रूरत है:
ग्रूवी
dependencies { implementation "androidx.car.app:app:1.4.0" // For Android Auto specific functionality implementation "androidx.car.app:app-projected:1.4.0" // For Android Automotive specific functionality implementation "androidx.car.app:app-automotive:1.4.0" // For testing testImplementation "androidx.car.app:app-testing:1.4.0" }
Kotlin
dependencies { implementation("androidx.car.app:app:1.4.0") // For Android Auto specific functionality implementation("androidx.car.app:app-projected:1.4.0") // For Android Automotive specific functionality implementation("androidx.car.app:app-automotive:1.4.0") // For testing testImplementation("androidx.car.app:app-testing:1.4.0") }
डिपेंडेंसी के बारे में ज़्यादा जानने के लिए, बिल्ड डिपेंडेंसी जोड़ना लेख पढ़ें.
सुझाव
आपके सुझाव, शिकायत या राय से हमें Jetpack को बेहतर बनाने में मदद मिलती है. अगर आपको कोई नई समस्या मिलती है या इस लाइब्रेरी को बेहतर बनाने के लिए आपके पास कोई सुझाव है, तो हमें बताएं. नई लाइब्रेरी बनाने से पहले, कृपया इस लाइब्रेरी में मौजूद मौजूदा समस्याओं पर एक नज़र डालें. किसी मौजूदा समस्या पर अपना वोट जोड़ने के लिए, स्टार बटन पर क्लिक करें.
ज़्यादा जानकारी के लिए, समस्या ट्रैकर का दस्तावेज़ देखें.
वर्शन 1.7
वर्शन 1.7.0-beta03
13 नवंबर, 2024
सुरक्षा से जुड़ी एक समस्या को ठीक किया गया. साथ ही, सामान्य गड़बड़ियों को भी ठीक किया गया. अगर आपके पास ऐप्लिकेशन का पुराना वर्शन है, तो कृपया इस वर्शन का इस्तेमाल करने के लिए अपडेट करें.
androidx.car.app:app-*:1.7.0-beta03
रिलीज़ हो गया है. वर्शन 1.7.0-beta03 में ये कमिट शामिल हैं.
एपीआई में हुए बदलाव
- सिर्फ़ उन ऑब्जेक्ट को हैंडल करने के लिए, सीएएल सीरियलाइज़ेशन / डी-सीरियलाइज़ेशन कोड अपडेट करें जिन पर एनोटेशन
@CarProtocol
का एलान किया गया है. (Ic730e) CarAppExtender
का इस्तेमाल अब सिर्फ़NotificationCompat.Builder
के बजाय, फ़्रेमवर्कNotification.Builder
को बढ़ाने के लिए किया जा सकता है. (Id3ad7)KEY_EXCLUDE_MEDIA_ITEM_FROM_MIXED_APP_LIST
और जोड़ें. (I201f9)ConversationItem
पर, खाली बिल्डर कंस्ट्रक्टर को बंद करें और उसे ऐसे कंस्ट्रक्टर से बदलें जो ज़रूरी पैरामीटर लेता हो. यह शून्य मैसेज से बचने के लिए भी जांच करता है. (Ic8221)
गड़बड़ियां ठीक की गईं
- पक्का करें कि
PlaceList
मैप में स्ट्रिंग (सिर्फ़ टेक्स्ट) हेडर टाइटल का इस्तेमाल किया गया हो. (Ic992f) - यह लाइब्रेरी अब JSpecify nullness एनोटेशन का इस्तेमाल करती है, जो टाइप-इस्तेमाल के लिए हैं. Kotlin डेवलपर को सही तरीके से इस्तेमाल करने के लिए, कंपाइलर के इन आर्ग्युमेंट का इस्तेमाल करना चाहिए:
-Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode
. (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.Builder
क्लास मेंTabContents.Api8Builder
क्लास को@ExperimentalCarApi
कंस्ट्रक्टर से बदलें (I26fbe)CarMediaApp
के लिए इंटेंट ऐक्शन और अन्य चीज़ें जोड़ना (I50782)- मैसेजिंग एपीआई को एक्सपेरिमेंटल के तौर पर मार्क करना (I0b070)
SectionedItemTemplate
में आइटम को रिमोट से लोड करने की सुविधा जोड़ी गई है. इससे लंबी सूचियां क्रैश किए बिना लोड हो सकती हैं (I0d122)- एपीआई 8 में,
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)- कार ऐप्लिकेशन लाइब्रेरी में मीडिया चलाने के दौरान कॉन्टेंट दिखाने के लिए,
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
सेExperimentalAPI
टैग हटाया गया (I66db8)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)- लाइनों पर बहुत छोटी इमेज के लिए विकल्प जोड़ा गया. (I72c03)
गड़बड़ियां ठीक की गईं
ConversationItem
पर javadoc को अपडेट करें, ताकि यह बताया जा सके कि मैसेज को सबसे पुराने से सबसे नए के क्रम में क्रम से लगाया जाना चाहिए. (I77a2a)ConversationItem
से सबसे पुराने मैसेज हटाने के लिए,ListTemplate
के मैसेज काटने के लॉजिक को अपडेट करना (Ie0a61)
वर्शन 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)ConversationItem
से सबसे पुराने मैसेज हटाने के लिए,ListTemplate
के मैसेज काटने के लॉजिक को अपडेट करना (Ie0a61)
वर्शन 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 रिलीज़ का मकसद, आने वाले समय में बीटा01 रिलीज़ करने की तैयारी करना है.
नई सुविधाएं
- नेविगेशन ऐप्लिकेशन के लिए, इंस्ट्रूमेंट क्लस्टर पर मैप रेंडर करने की सुविधा
- लेआउट के अनुभव को बेहतर बनाने के लिए, ऐप्लिकेशन के लिए टैब जोड़े गए
- लिस्ट / ग्रिड टेंप्लेट रेंडर करने के विकल्प जोड़े गए
- मौसम और कम्यूनिकेशन के लिए नई कैटगरी जोड़ी गईं
- कई एपीआई को CarApi 7 के अगले वर्शन पर ले जाना
एपीआई में हुए बदलाव
CarMessage
(I5aaf6) में मल्टीमीडिया फ़ील्ड जोड़ना- कार ऐप्लिकेशन लाइब्रेरी में
ConversationItem
में कस्टम ऐक्शन जोड़ता है (Ie5ed6) - मीडिया आइटम को इमर्सिव ऑडियो फ़ॉर्मैट में चलाया जा रहा है, यह बताने के लिए अतिरिक्त एलिमेंट जोड़ें. साथ ही, उसके कॉन्टेंट फ़ॉर्मैट का लोगो (Icb5bb) दिखाएं
ActionsConstraints
एपीआई को 'लिखें' बटन के साथ काम करने के लिए, नया ऐक्शन टाइप जोड़ें. (I31661)set/getTemplate
कोset/get ContentTemplate
(Ica036) के तौर पर सेट किया गया- टेम्प्लेट पैरामीटर अब
@NonNull
होगा.MapWithContentTemplate
एपीआई के दस्तावेज़ को अपडेट किया गया (I0f8ed) - CAL 1.4 में लॉन्च करने के लिए,
ListTemplate
में मौजूद कार्रवाइयों के लिए@ExperimentalCarApi
टैग हटाता है (I2cfcb) TabTemplate
के लिए@ExperimentalCarApi
टैग हटाता है (Ifcb82)- पंक्ति के सेकंडरी ऐक्शन और डेकोरेशन से
@ExperimentalCarApi
एनोटेशन हटाएं (I8487e) TabTemplate
में चालू टैब का Content ID जोड़ता है और टैब पर 'चालू है' स्टेटस को बंद कर देता है (I96932)ItemImageShape
प्रॉपर्टी कोGridTemplate
में जोड़ना (Ibf431)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 वर्शन में ये बदलाव शामिल हैं.
एपीआई में हुए बदलाव
- कार ऐप्लिकेशन लाइब्रेरी (Id0191) में
GridTemplate
में टॉप-लेवल ऐक्शन जोड़ता है - कार ऐप्लिकेशन लाइब्रेरी (I9efab) में
ListTemplate
में टॉप-लेवल ऐक्शन जोड़ता है - मीडिया आइटम के सबटाइटल या उसके ब्यौरे को दूसरे मीडिया आइटम से लिंक करने के लिए एक्सट्रा जोड़ें (Ic84bf)
- पंक्ति की कार्रवाइयों के लिए एपीआई लेवल को 6 पर अपडेट करें. (Ie0a69)
- A4C (Ie3986) में मैसेजिंग कॉलबैक जोड़ना
गड़बड़ियां ठीक की गईं
CarMessage
के लिए, जो JavaDoc रेफ़रंस मौजूद नहीं हैं उन्हें जोड़ें. (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]
) - कार पार्क होने पर,
Row
के सबटेक्स्ट को छोटा नहीं किया जाता. हालांकि, गाड़ी चलाते समय इसे दो लाइन में छोटा कर दिया जाता है. ([API 5 - All Templates]
) Action
,Toggle
,Row
के लिए, बंद की गई स्थिति के साथ काम करना ([API 5 - All Templates]
)
एपीआई में हुए बदलाव
- चुनी जा सकने वाली सूचियों के साथ काम करने के लिए,
MapTemplate
सूची में पाबंदियों को कम करना (I961ed) - कस्टम आइकॉन इस्तेमाल करने की अनुमति देने के लिए, हेडर ऐक्शन की पाबंदी हटाएं. (Iad28f)
ActionsConstraints
मेंsetOnClickListenerAllowed()
की पाबंदी जोड़ें. जहांAction
को स्टैंडर्ड आइकॉन टाइप के अलावा, कार्रवाइयों के लिएOnClickDelegate()
सेट करने की अनुमति दी गई थी. (TYPE_APP_ICON
,TYPE_BACK
, औरTYPE_PAN
) (I3c745)
गड़बड़ियां ठीक की गईं
- Android Automotive Template Host 1.4+ को कर्व्ड डिसप्ले (
[Host change]
) के साथ काम करने लायक बनाया गया
वर्शन 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:
Action
के बारे में बताने के लिए नए फ़्लैगAction.FLAG_IS_PERSISTENT
औरAction.FLAG_DEFAULT
(I96318, I5ad70) - एपीआई लेवल 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: यात्रा के अनुमान वाले कार्ड को पसंद के मुताबिक बनाने के लिए,
TravelEstimate.Builder
पर नएsetTripText
औरsetTripIcon
(Idcc6d, Ic620d) PaneTemplate
के टाइटल मेंCarIconSpan
s के लिए सहायता जोड़ें (Ia1ee0)Row
के टाइटल और टेक्स्ट मेंCarIconSpan
s के लिए सहायता जोड़ें (Ic1e3c)- मैप
ActionStrip
में अब ज़्यादा से ज़्यादा चार कार्रवाइयां हो सकती हैं (If3522) - कार ऐप्लिकेशन के एपीआई लेवल को 5 (I26b8e) पर अपडेट करना
PlaceListMapTemplate
,PlaceListNavigationTemplate
,RoutePreviewNavigationTemplate
,GridTemplate
,ListTemplate
,LongMessageTemplate
,MessageTemplate
,PaneTemplate
, औरSignInTemplate
(I2078d, Icadde) एट्रिब्यूट के लिए, हेडर/टाइटल देना अब ज़रूरी नहीं है
गड़बड़ियां ठीक की गईं
PaneTemplate
इमेज के साइज़ तय करने के नियमों को स्क्वेयर बाउंडिंग बॉक्स (Idd72e) के तौर पर अपडेट किया गयाState.DESTROYED
के बाद स्क्रीन स्टैक में बदलाव करने पर होने वाली गड़बड़ी को ठीक किया गया. (I3c8eb)- ऐप्लिकेशन आइकॉन (I3f710) को वापस पाने के लिए, शून्य की जांच जोड़ी गई
- डिफ़ॉल्ट रूप से
STATUS_UNAVAILABLE
के बजायSTATUS_UNKNOWN
का इस्तेमाल करने के लिए, Car Hardware API को अपडेट करना (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
सेक्शन देखें.
एपीआई में हुए बदलाव
- लोकप्रिय जगहों के टेंप्लेट में, प्रयोग के तौर पर
setOnContentRefreshListener
एपीआई जोड़ा गया (I6bf22)
गड़बड़ियां ठीक की गईं
CarAppService
में, कार के होस्ट के अनबाइंड होने पर मेमोरी लीक की समस्या को ठीक किया गया. (I5c9ca, b/203594731)- singleTask launchmode (Id2f95) की ज़रूरी शर्तों को शामिल करने के लिए,
CarAppActivity
javadoc को अपडेट किया गया - वीडियो फिर से शुरू करने पर, विज़ुअल में होने वाली गड़बड़ी को कम करता है. (Iff7e0)
आम समस्याएं
PlaceListNavigationTemplate
औरRoutePreviewNavigateTemplate
में मौजूद मैपActionStrip
, अगली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
के लिए आइटम की सीमा को दो से बढ़ाकर चार कर दिया गया है.
एपीआई में हुए बदलाव
CarUnit
(I36a3b) में प्रयोग के तौर परtoString()
तरीका जोड़ा गया
गड़बड़ियां ठीक की गईं
CarAppPermissionActivity
में होने वाली क्रैश की समस्या को ठीक किया गया. यह समस्या तब होती है, जब कॉलबैक काम नहीं करता (If9823)Pane
की डिफ़ॉल्ट सूची की सीमा को चार पर सेट किया गया (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 API लेवल 4 (I2a2e7) जोड़ा गया
- एपीआई लेवल 4:
Pane
मेंCarIcon
सेट करने की सुविधा जोड़ी गई (Ifcc12) - एपीआई लेवल 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 के लिए गड़बड़ी को लॉग करेगा अगरCarAppExtender
(I3633d) में आइकॉन वाली कार्रवाइयां थीं - एपीआई वर्शन सेट अप करने के लिए, ऐप्लिकेशन और होस्ट के लिए हैंडशेक का तरीका जोड़ा गया (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)
@MainThread
के साथ एनोटेट किए गएCarHardware
इंटरफ़ेस. (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 देखें. साथ ही, एपीआई लेवल 2 के साथ काम करने वाले कार होस्ट में इन सुविधाओं को इस्तेमाल करने के तरीके के बारे में डिज़ाइन से जुड़े दिशा-निर्देश भी देखें.
एपीआई में हुए बदलाव
*Callback
इंटरफ़ेस के सभी तरीकों को डिफ़ॉल्ट के तौर पर सेट किया औरOnRequestPermissionsCallback
->OnRequestPermissionsListener
का नाम बदला (Ib3ec9)androidx.car.app.hardware
क्लास को अपडेट किया गया है, ताकि ज़रूरत के मुताबिक न (I67beb)- कार के खास डेटा को ऐक्सेस करने के लिए,
androidx.car.app.hardware
क्लास जोड़ी गई हैं. जैसे, ईंधन, बैटरी, और स्पीड. (Iff3c9) MessageTemplate
परActionStrip
के लिए सहायता जोड़ी गई (Ida657)setLoading
कोMessageTemplate
में जोड़ा गया. (I2a4b5)ConnectionToCar
का नाम बदलकरCarConnection
किया गया (Ife9bd)- साफ़ तौर पर
PanModeDelegate
दिखाने के लिए,NavigationTemplate
को बदला गया (I13877) CarContext.requestPermissions
(Ib890a) के लिए पैरामीटर का अपडेट किया गया क्रम- कार के एपीआई लेवल को
androidx.car.api.minCarApiLevel
(Ib0d41) पर सेट करने के लिए, मेटाडेटा की अपडेट की गई कुंजी - कार के कनेक्शन की स्थिति देखने की सुविधा देने वाला एपीआई बनाया गया (Ifc935)
Action
के लिए टॉगल सेट करने की सुविधा जोड़ी गई. साथ ही, पैन मोडAction
टाइप (Ica6af) जोड़ा गया- कार में सूचना भेजने की सुविधा के लिए,
CarNotificationManager
बनाया गया (I10d7a) - होस्ट की ओर से सूची की सीमाएं तय करने के लिए,
ConstraintManager
जोड़ा गया (I8690e) NavigationTemplate
(I77aa6) में पैन मोड और मैप ऐक्शन स्ट्रिप एपीआई जोड़ा गया- नेविगेशन ऐप्लिकेशन के लिए,
SurfaceCallback
में पैन और ज़ूम एपीआई जोड़ा गया (Id5e9d) CarAppApiLevel
को 2 (Ic1540) पर अपडेट किया गयाCarAppService
से अनुमतियों का अनुरोध करने की सुविधा जोड़ी गई (I5421e)- मल्टी-टेक्स्ट एपीआई (Iacb62) में
RequiresCarApi(2)
एनोटेशन जोड़ा गया - आधी सूची वाले टेंप्लेट के टाइटल में, एक से ज़्यादा टेक्स्ट वैरिएंट इस्तेमाल करने की अनुमति है (Ib8df7)
- नया
LongMessageTemplate
जोड़ा गया (इसके लिए, Car API लेवल 2 की ज़रूरत है) (Ic5cee)
गड़बड़ियां ठीक की गईं
- कार की बड़ी स्क्रीन के हिसाब से, इमेज के साइज़ से जुड़ी ज़रूरी शर्तों को अपडेट किया गया है (I116dc)
- टेंप्लेट के मुख्य हिस्से में दो से ज़्यादा कार्रवाइयां जोड़ने की अनुमति नहीं है (I32157)
- पक्का करें कि कार की ऐप्लिकेशन लाइब्रेरी में, सभी
PendingIntent
s के लिए फ़्लैग सेट किए गए हों. (If84fe, b/186394900) Row
के टेक्स्ट में बदलाव होने पर, उसे रीफ़्रेश करने की अनुमति देने के लिए, javadoc को अपडेट किया गया (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
में पैन और ज़ूम कॉलबैक गलत तरीके से चालू हो सकते हैं.
कार ऐप्लिकेशन टेस्टिंग का वर्शन 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 का 1.0.0 वर्शन अब पूरी तरह से काम करता है. साथ ही, यह Android Auto के 6.1 और उसके बाद के वर्शन के साथ पूरी तरह से काम करता है. - लाइब्रेरी का इस्तेमाल करके, Android Auto के लिए नेविगेशन, पार्किंग, और चार्जिंग ऐप्लिकेशन बनाने का तरीका जानने के लिए, डेवलपमेंट गाइड पढ़ें.
गड़बड़ियां ठीक की गईं
- शुरू करने के दौरान
Screen
पॉप-अप होने पर होने वाली गड़बड़ी को ठीक किया गया (70aae1, b/184664896) Screen
केON_DESTROY
के बाद,Session
परON_DESTROY
दिखने की समस्या को ठीक किया गया (0ceecb, b/183696617)
वर्शन 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)