แอปรถยนต์
อัปเดตล่าสุด | รุ่นที่เสถียร | รุ่นที่อาจได้รับการเผยแพร่ | รุ่นเบต้า | เวอร์ชันอัลฟ่า |
---|---|---|---|---|
15 มกราคม 2025 | 1.4.0 | 1.7.0-rc01 | - | - |
การประกาศทรัพยากร Dependency
หากต้องการเพิ่มทรัพยากร Dependency ใน Car App Library คุณต้องเพิ่มที่เก็บข้อมูล Google Maven ลงในโปรเจ็กต์ อ่านข้อมูลเพิ่มเติมในที่เก็บ Maven ของ Google
เพิ่มการอ้างอิงสำหรับอาร์ติแฟกต์ที่คุณต้องการในไฟล์ 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-rc01
15 มกราคม 2025
androidx.car.app:app-*:1.7.0-rc01
เปิดตัวโดยไม่มีการเปลี่ยนแปลงที่สำคัญจาก beta03 เวอร์ชัน 1.7.0-rc01 มีการคอมมิตเหล่านี้
- ซึ่งเป็น RC เวอร์ชันแรกที่มีการแก้ไข 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 มีการคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- อัปเดตโค้ดการจัดรูปแบบ / การถอดรูปแบบ CAL เพื่อจัดการเฉพาะออบเจ็กต์ที่มีการประกาศคำอธิบายประกอบ
@CarProtocol
(Ic730e) - ตอนนี้คุณใช้
CarAppExtender
เพื่อขยายเฟรมเวิร์กNotification.Builder
ได้แล้ว แทนที่จะใช้กับNotificationCompat.Builder
เท่านั้น (Id3ad7) - เพิ่มอีก
KEY_EXCLUDE_MEDIA_ITEM_FROM_MIXED_APP_LIST
(I201f9) - เลิกใช้งานตัวสร้าง Builder ที่ว่างเปล่าใน
ConversationItem
และแทนที่ด้วยตัวสร้างที่ใช้พารามิเตอร์ที่จำเป็น รวมถึงเพิ่มการตรวจสอบเพื่อป้องกันข้อความ Null ด้วย (Ic8221)
การแก้ไขข้อบกพร่อง
- ตรวจสอบว่าแมป
PlaceList
ใช้ชื่อส่วนหัวสตริง (ข้อความเท่านั้น) (Ic992f) - ตอนนี้ไลบรารีนี้ใช้แอตทริบิวต์ JSpecify nullness ซึ่งเป็นการใช้ประเภท นักพัฒนาซอฟต์แวร์ 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 มีการคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เพิ่ม
KEY_ROOT_HINT_MEDIA_HOST_VERSION
พิเศษ (I8796b) - แทนที่คลาส
TabContents.Api8Builder
ด้วยตัวสร้าง@ExperimentalCarApi
ในคลาสTabContents.Builder
(I26fbe) - เพิ่มการดำเนินการผ่าน Intent และรายการเพิ่มเติมสำหรับ
CarMediaApp
(I50782) - ทำเครื่องหมาย API การรับส่งข้อความว่าไม่ใช่เวอร์ชันทดลอง (I0b070)
- เพิ่มการโหลดรายการระยะไกลลงใน
SectionedItemTemplate
(ช่วยให้โหลดรายการที่ยาวได้โดยไม่ขัดข้อง) (I0d122) - เพิ่ม
SectionedItemTemplate
ลงในรายการเทมเพลตที่รองรับภายในTabTemplate
ใน API 8 (Idc5d6)
การแก้ไขข้อบกพร่อง
- นำการระบุการเข้าถึง API ของแพลตฟอร์มใหม่ด้วยตนเองออกแล้ว เนื่องจากการดำเนินการนี้จะทําโดยอัตโนมัติผ่านโมเดล API เมื่อใช้ R8 กับ AGP 7.3 ขึ้นไป (เช่น R8 เวอร์ชัน 3.3) และสำหรับบิลด์ทั้งหมดเมื่อใช้ 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 ซึ่งแสดงซ้ำด้านล่าง
ฟีเจอร์ใหม่
- แผนที่พร้อมเนื้อหา: เทมเพลตใหม่คือ Canvas แผนที่พร้อมเทมเพลตเนื้อหา ซึ่งตอนนี้จะเป็นรายการ / ตารางกริด / แผง / ข้อความก็ได้
RoutePreview
,PlaceListNavigation
,MapTemplate
เลิกใช้งานแล้ว เทมเพลตจะยังคงทำงานต่อไปตามเดิม- แอปตัวอย่างได้รับการอัปเดตให้แสดงการใช้งาน
MapWithContent
แทนเทมเพลตที่เลิกใช้งานแล้ว
- รายการการสนทนา: API ใหม่สำหรับการแสดงการสนทนา (IM, SMS) และการอ่านออกเสียงของ Assistant ในรถยนต์
- ขนาดยานพาหนะ: API ใหม่สําหรับดึงข้อมูลการวัดยานพาหนะ (ข้อมูลใน AAOS ในขณะนั้น)
การเปลี่ยนแปลง API
- เพิ่มแท็ก
@ExperimentalCarApi
ลงในMediaPlaybackTemplate.Builder
(Ic1957) - เพิ่ม
SectionedItemTemplate
ใหม่ในเวอร์ชันทดลอง (I5958a) - แนะนำ
CarAppApiLevel 8
(I3fa22) - เพิ่ม
MediaPlaybackTemplate
สำหรับการแสดงเนื้อหาระหว่างการเล่นสื่อในคลังแอปของรถยนต์ (I3c10d) - เพิ่ม API ใหม่สำหรับแอปเพื่อตรวจจับว่าระบบรองรับเสียงเบื้องหลังขณะขับรถหรือไม่ (I0f868)
การแก้ไขข้อบกพร่อง
- แก้ไขบางกรณีที่หน่วยความจำรั่วไหลและข้อขัดข้องในโค้ดไคลเอ็นต์ CAL และในแอปตัวอย่างการนำทางของ CAL (I55e04)
- แทนที่
requireNotNull instances
ในเมธอดonDestroy
ของBaseCarAppActivity
ด้วยการตรวจสอบ if-null เพื่อหลีกเลี่ยงข้อขัดข้อง (Iec676)
เวอร์ชัน 1.7.0-alpha02
17 เมษายน 2024
androidx.car.app:app-*:1.7.0-alpha02
ได้รับการปล่อยแล้ว เวอร์ชัน 1.7.0-alpha02 มีการคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เพิ่ม Flag ที่เลิกใช้งานสำหรับเทมเพลตที่อิงตามแผนที่ซึ่งเทมเพลต
MapWithContent
จะใช้แทนในอนาคต
การเปลี่ยนแปลง API
- เลิกใช้งาน
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
- รายการการสนทนา: API ใหม่สำหรับแสดงการสนทนา (IM, SMS) และการอ่านออกเสียงของ Assistant ในรถยนต์
- ขนาดยานพาหนะ: API ใหม่สําหรับดึงข้อมูลการวัดยานพาหนะ (ข้อมูลใน AAOS ในขณะนั้น)
การเปลี่ยนแปลง API
- ทำเครื่องหมายประเภทรูปภาพแถวขนาดเล็กพิเศษเป็นการทดลอง (I5184b)
- เพิ่ม
CarInfo#fetchExteriorDimensions
API ซึ่งอนุญาตให้เข้าถึงข้อมูลขนาดภายนอกของยานพาหนะ เช่น ความสูง ความกว้าง ฯลฯ (Ia40c5) - นําแท็ก
ExperimentalAPI
ออกจากMapWithContentTemplate
แล้ว (I66db8) - อัปเดตพารามิเตอร์
GridItem#setTitle
ให้มีค่า Null ได้ (I3d610) GetHeader
API ไม่จำเป็นต้องใช้ API 7 เนื่องจากเข้ากันได้แบบย้อนหลัง (I8c812)- เพิ่มการรองรับ
Header
ในListTemplate
, เลิกใช้งานheaderAction
,headerTitle
,actionStrip
(I7ae01) - เลิกใช้งาน
title
,headerAction
,actionStrip
ในGridTemplate
และเพิ่มการรองรับHeader
(I41a9c) - นำข้อกำหนดระดับ 7 สำหรับ API เวอร์ชันทดลองออก ได้แก่ ป้าย
GridTemplate
Getter/Setter สำหรับขนาดสินค้าและรูปร่างรูปภาพGridItem
วิธีการรับ/ตั้งค่าป้าย (Id71eb) - เลิกใช้งาน
title
,headerAction
,actionStrip
ในPaneTemplate
เพิ่มการรองรับHeader
ใหม่ (I23154) - เปลี่ยนการวัดผลของ Media Center จาก
BroadcastReceiver
เป็นเรียกดูการดําเนินการที่กำหนดเอง (I4185f) - เพิ่มการรองรับแอตทริบิวต์
Header
ในMessageTemplate
เลิกใช้งานการรองรับActionStrip
,headerAction
และtitle
(Ie2de8) - แก้ไขระดับการเข้าถึงค่าคงที่ของการแจ้งเตือน (Icf8a8)
- นำแอตทริบิวต์
isLoading
ออกจากเทมเพลตหลัก (I651e6) - เพิ่มข้อมูลเพิ่มเติมเพื่อแจ้งแอปสื่อเกี่ยวกับพารามิเตอร์ UI หลัก (I85ca2)
- เพิ่มฟีเจอร์ข้อมูลวิเคราะห์ของศูนย์สื่อไปยัง
MediaExtensions
(I7ce28) - เพิ่มตัวเลือกสำหรับรูปภาพขนาดเล็กพิเศษในแถว (I72c03)
การแก้ไขข้อบกพร่อง
- อัปเดต Javadoc ใน
ConversationItem
เพื่อระบุว่าควรจัดเรียงข้อความตามลำดับจากเก่าสุดไปใหม่สุด (I77a2a) - อัปเดตตรรกะการตัดข้อความของ
ListTemplate
เพื่อนำข้อความเก่าที่สุดออกจากConversationItem
(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 มีการคอมมิตเหล่านี้ การแก้ไขเล็กน้อยเท่านั้น
การแก้ไขข้อบกพร่อง
- อัปเดต Javadoc ใน
ConversationItem
เพื่อระบุว่าควรจัดเรียงข้อความจากเก่าสุดไปใหม่สุด (I77a2a) - อัปเดตตรรกะการตัดข้อความของ
ListTemplate
เพื่อนำข้อความเก่าที่สุดออกจากConversationItem
(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 จะแก้ไขปัญหานี้ หรือจะเพิ่ม
android.suppressUnsupportedCompileSdk=34
ลงในไฟล์settings.gradle
ของโปรเจ็กต์เพื่อระงับคำเตือนชั่วคราวอย่างปลอดภัยก็ได้
ฟีเจอร์ใหม่
- การแสดงผลแผนที่ในแผงหน้าปัดสําหรับแอปการนําทาง
- เทมเพลตแท็บใหม่เพื่อเลย์เอาต์ / ความสามารถในการใช้งานแอปที่ดีขึ้น
- การรองรับขีดจํากัดงานแบบปรับได้
- การดําเนินการรองในองค์ประกอบรายการ
การเปลี่ยนแปลง API
- ดู alpha02
เวอร์ชัน 1.4.0-alpha02
26 กรกฎาคม 2023
androidx.car.app:app-*:1.4.0-alpha02
ได้รับการปล่อยแล้ว เวอร์ชัน 1.4.0-alpha02 มีการคอมมิตเหล่านี้
- การเปิดตัว Alpha02 มีไว้เพื่อเตรียมความพร้อมสำหรับรุ่น beta01 ที่กำลังจะเปิดตัว
ฟีเจอร์ใหม่
- การรองรับการแสดงผลแผนที่บนแผงหน้าปัดสำหรับแอปการนำทาง
- เพิ่มแท็บสำหรับแอปเพื่อปรับปรุงประสบการณ์การใช้งานเลย์เอาต์
- เพิ่มตัวเลือกการแสดงผลเทมเพลตรายการ / ตารางกริด
- เพิ่มหมวดหมู่ใหม่สำหรับสภาพอากาศและการติดต่อ
- ย้าย API หลายรายการไปยังรุ่นถัดไปของ CarApi 7
การเปลี่ยนแปลง API
- เพิ่มช่องมัลติมีเดียลงใน
CarMessage
(I5aaf6) - เพิ่มการดำเนินการที่กำหนดเองลงใน
ConversationItem
ในคลังแอปรถยนต์ (Ie5ed6) - เพิ่มข้อมูลเพิ่มเติมเพื่อระบุว่ารายการสื่อเล่นด้วยรูปแบบเสียงสมจริงและแสดงโลโก้รูปแบบเนื้อหา (Icb5bb)
- เพิ่มประเภทการดําเนินการใหม่
ActionsConstraints
API เพื่อรองรับปุ่มเขียน (I31661) - เปลี่ยน
set/getTemplate
เป็นset/get ContentTemplate
(Ica036) - ตอนนี้พารามิเตอร์เทมเพลตจะเป็น
@NonNull
อัปเดตเอกสารประกอบของMapWithContentTemplate
API (I0f8ed) - นำแท็ก
@ExperimentalCarApi
ออกสําหรับการดําเนินการในListTemplate
สําหรับการเปิดตัวใน CAL 1.4 (I2cfcb) - นำแท็ก
@ExperimentalCarApi
ของTabTemplate
(Ifcb82) ออก - นำคำอธิบายประกอบ
@ExperimentalCarApi
ออกจากการดำเนินการสำรองและการตกแต่งของแถว (I8487e) - เพิ่มรหัสเนื้อหาของแท็บที่ใช้งานอยู่ไปยัง
TabTemplate
และเลิกใช้งานสถานะ "ใช้งานอยู่" ในแท็บ (I96932) - เพิ่มพร็อพเพอร์ตี้
ItemImageShape
ไปยังGridTemplate
(Ibf431) - เพิ่มพร็อพเพอร์ตี้
ItemSize
ลงในGridTemplate
ซึ่งควบคุมขนาดของรายการตารางกริดตามกลุ่มขนาดเล็ก กลาง และใหญ่แบบสัมพัทธ์ (Icdb3b) - เปิดการเข้าถึง API ให้กับนักพัฒนาแอปเพื่อรับสำเนาของกองหน้าจอปัจจุบัน (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 มีการคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เพิ่มการดำเนินการระดับบนสุดลงใน
GridTemplate
ในคลังแอปรถยนต์ (Id0191) - เพิ่มการดำเนินการระดับบนสุดลงใน
ListTemplate
ในคลังแอปของรถยนต์ (I9efab) - เพิ่มข้อมูลเพิ่มเติมเพื่อลิงก์คำบรรยายหรือคำอธิบายของรายการสื่อกับรายการสื่ออื่นๆ (Ic84bf)
- อัปเดตระดับ API สําหรับการดําเนินการของแถวเป็นระดับ 6 (Ie0a69)
- เพิ่มการติดต่อกลับทางการรับส่งข้อความไปยัง A4C (Ie3986)
การแก้ไขข้อบกพร่อง
- เพิ่มข้อมูลอ้างอิง JavaDoc ที่ขาดหายไปสําหรับ
CarMessage
(I5db1c) - ลบล้าง
equals()
และhashCode()
สำหรับConversationItem
และCarMessage
(I6fd10) - ปรับปรุงการตรวจสอบ
ConversationItem.mMessages
(ต้องไม่ใช่ค่า Null และไม่ใช่ค่าว่าง (Iafc51) - เพิ่มคำอธิบายประกอบ
@Keep
ลงในช่องConversationItem
(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 มีการคอมมิตเหล่านี้
- ตอนนี้แอปรถยนต์ที่สร้างโดยใช้ไลบรารีนี้สามารถเผยแพร่ใน Play Store โดยใช้ API ระดับ 5 ได้แล้ว (ดูคู่มือการพัฒนา) ฟีเจอร์ที่มีคำอธิบายประกอบเป็น API ระดับ 5 หรือต่ำกว่าจะเข้ากันได้กับทั้ง Android Auto 8.1 ขึ้นไปและ Google Automotive App Host 1.4 ขึ้นไป
ฟีเจอร์ใหม่
นอกจากความสามารถที่เพิ่มเข้ามาในคลังแอปรถยนต์ 1.3.0-alpha01 แล้ว เรายังได้เพิ่มฟีเจอร์ต่อไปนี้ในรุ่นเบต้า 01 ด้วย (ฟีเจอร์ทั้งหมดนี้เกี่ยวข้องกับการเปลี่ยนแปลงฝั่งโฮสต์เท่านั้น โดยไม่มีการเปลี่ยนแปลง API)
- แถบนําทางแบบลอยจะแสดงต่อไปแม้ว่าผู้ใช้จะอยู่ในหน้าจอการเลือกตามแผนที่ใน
PlaceListNavigationTemplate
,RoutePreviewNavigationTemplate
และMapTemplate
ซึ่งทำได้โดยการอัปเดตข้อมูลการนำทางผ่านNavigationManager.updateTrip()
- เปิดใช้ปุ่มดำเนินการด้วย
FLAG_DEFAULT
เพื่อให้มีภาพเคลื่อนไหวหมดเวลา ระบบจะคลิกปุ่มนี้โดยค่าเริ่มต้นหลังจากหมดเวลา ([API 5 - All Templates]
) - ระบบจะไม่ตัดข้อความย่อยของ
Row
เมื่อรถจอดอยู่ แต่ระบบจะตัดข้อความย่อยเป็น 2 บรรทัดขณะขับรถ ([API 5 - All Templates]
) - รองรับสถานะปิดใช้สำหรับ
Action
,Toggle
,Row
([API 5 - All Templates]
)
การเปลี่ยนแปลง API
- ผ่อนคลายข้อจำกัดในรายการ
MapTemplate
เพื่อรองรับรายการที่เลือกได้ (I961ed) - นำข้อจำกัดของการดำเนินการส่วนหัวออกเพื่อให้ใช้ไอคอนที่กำหนดเองได้ (Iad28f)
- เพิ่มข้อจำกัด
setOnClickListenerAllowed()
ไปยังActionsConstraints
ซึ่งอนุญาตให้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 มีการคอมมิตเหล่านี้
ฟีเจอร์ที่มีคำอธิบายประกอบระดับ API 5 ใช้ได้กับ Android Auto 7.9 ขึ้นไป
ฟีเจอร์ใหม่
- API ระดับ 5:
MapTemplate
ใหม่ที่แอปนำทางสามารถใช้เพื่อแสดงแผงหรือเนื้อหารายการข้างแผนที่ (If5826, If44b8) - ระดับ API 5:
CarAudioRecord
API ใหม่เพื่ออนุญาตให้บันทึกอินพุตเสียงผ่านไมโครโฟนของยานพาหนะโฮสต์ (I5e71a) - ระดับ API 5:
SuggestionManager
API ใหม่เพื่ออนุญาตให้แอปแสดงคำแนะนำแก่โฮสต์ (I5c103) - ระดับ API 5:
Alert
API ใหม่เพื่อแสดงการแจ้งเตือนตามบริบทในNavigationTemplate
(I163a7, I5ad70) - API ระดับ 5: คอมโพเนนต์
Header
และMapController
ใหม่เพื่ออำนวยความสะดวกในการใช้ซ้ำในเทมเพลตต่างๆ (If5826) - เพิ่ม
androidx.car.app.category.POI
เป็นหมวดหมู่สําหรับเปิดใช้แอปจุดที่น่าสนใจ (และเลิกใช้งานandroidx.car.app.category.PARKING
และandroidx.car.app.category.CHARGING
) (I59da1)
การเปลี่ยนแปลง API
- ระดับ API 5: เมธอด
onClick
ใหม่ในอินเทอร์เฟซSurfaceCallback
เพื่อแตะการโต้ตอบของแผนที่ (Ia9777) - API ระดับ 5: Flag ใหม่
Action.FLAG_IS_PERSISTENT
และAction.FLAG_DEFAULT
เพื่ออธิบายAction
(I96318, I5ad70) - ระดับ API 5: สถานะเปิด/ปิดใช้ใหม่สำหรับคอมโพเนนต์
Action
,Row
และToggle
(การรองรับโฮสต์จะพร้อมใช้งานในไลบรารีรุ่น 1.3.0-beta01) (Id8a09) - ระดับ API 5: แนะนำให้ใช้คอมโพเนนต์
Header
ใหม่ผ่านsetHeader
ในPlaceListNavigationTemplate.Builder
และRoutePreviewNavigationTemplate.Builder
โดยเลิกใช้งานเมธอดsetTitle
และsetHeaderAction
ที่มีอยู่ (I30e6a) - ระดับ API 5: เมธอด
setOnContentRefreshListner
ใหม่ในPlaceListMapTemplate.Builder
และPlaceListNavigationTemplate.Builder
สำหรับใช้กับการติดตั้งใช้งานอินเทอร์เฟซOnContentRefreshListner
ใหม่ - API ระดับ 5:
setTripText
และsetTripIcon
ใหม่ในTravelEstimate.Builder
เพื่อปรับแต่งการ์ดเวลาเดินทางโดยประมาณ (Idcc6d, Ic620d) - เพิ่มการรองรับ
CarIconSpan
ในชื่อของPaneTemplate
(Ia1ee0) - เพิ่มการรองรับ
CarIconSpan
ในชื่อและข้อความของRow
(Ic1e3c) - ตอนนี้
ActionStrip
ของแผนที่สามารถมีการดำเนินการได้สูงสุด 4 รายการ (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_UNKNOWN
แทนSTATUS_UNAVAILABLE
โดยค่าเริ่มต้น (Ic9444) - ตรวจสอบว่ามีจอแสดงผลอยู่หรือไม่ก่อนที่จะสร้างแพลตฟอร์ม (Ice027a)
- แก้ไขข้อบกพร่อง
CarValue.equals()
ที่เกี่ยวข้องกับSTATUS_UNIMPLEMENTED
(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 มีการคอมมิตเหล่านี้
- นี่เป็นรุ่นที่เสถียรและไม่มีการเปลี่ยนแปลง API เมื่อเทียบกับ
v1.2.0-beta02
เราได้เพิ่มฟีเจอร์ทดลองใหม่ (API ระดับ 5) ที่มีไว้สำหรับรุ่น Android Auto และ Android Automotive ในอนาคต
การแก้ไขข้อบกพร่อง
- แก้ไขข้อยกเว้นที่เกิดขึ้นหากมีการแก้ไขกองหน้าจอหลังจาก
State.DESTROYED
(I3c8eb) - อัปเดต
CarSensors
API เพื่อระบุว่าไม่ได้ติดตั้งใช้งานสําหรับ 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 ได้แล้ว ดูรายละเอียดเพิ่มเติมได้ที่คู่มือการพัฒนา
ฟีเจอร์ที่มีคำอธิบายประกอบระดับ API 4 และต่ำกว่าจะใช้งานร่วมกับทั้ง Android Auto
7.2 ขึ้นไปและแพลตฟอร์ม Android Automotive OS
เวอร์ชันใหม่ได้ ดูข้อควรระวังได้ที่ส่วน Known Issues
ด้านล่าง
การเปลี่ยนแปลง API
- เพิ่ม
setOnContentRefreshListener
API เวอร์ชันทดลองลงในเทมเพลตจุดที่น่าสนใจ (I6bf22)
การแก้ไขข้อบกพร่อง
- แก้ไขหน่วยความจำรั่วไหลใน
CarAppService
เมื่อโฮสต์รถยนต์ยกเลิกการเชื่อมโยง (I5c9ca, b/203594731) - อัปเดต
CarAppActivity
javadoc ให้รวมข้อกำหนดสำหรับ launchmode แบบ singleTask (Id2f95) - ลดภาพกระตุกเมื่อกลับมาทำงาน (Iff7e0)
ปัญหาที่ทราบ
- แผนที่
ActionStrip
ในPlaceListNavigationTemplate
และRoutePreviewNavigateTemplate
จะเริ่มพร้อมใช้งานในรุ่นAndroid Auto
และAndroid Automotive OS
ถัดไป
เวอร์ชัน 1.2.0-alpha02
15 ธันวาคม 2021
androidx.car.app:app-*:1.2.0-alpha02
ได้รับการปล่อยแล้ว เวอร์ชัน 1.2.0-alpha02 มีการคอมมิตเหล่านี้
ฟีเจอร์ที่มีคำอธิบายประกอบด้วย API ระดับ 4 ได้อัปเกรดจากเวอร์ชันทดลองเป็นเวอร์ชันเสถียรแล้ว ซึ่งรวมถึงActionStrip
แผนที่ใน PlaceListNavigationTemplate
และ RoutePreviewNavigateTemplate
, รูปภาพ CarIcon
ใน Pane
, QRCodeSignInMethod
และความสามารถในการตั้งค่าคำแนะนำการแสดงผล (เช่น Flag) ใน Action
ฟีเจอร์ใหม่
- ใน Android Auto 7.1 ขึ้นไป ขีดจำกัดรายการสำหรับ
Pane
ได้เพิ่มขึ้นจาก 2 เป็น 4
การเปลี่ยนแปลง API
- เพิ่มวิธีการ
toString()
เวอร์ชันทดลองลงในCarUnit
(I36a3b)
การแก้ไขข้อบกพร่อง
- แก้ไขข้อขัดข้องที่จะเกิดขึ้นใน
CarAppPermissionActivity
หากการเรียกกลับไม่ทำงาน (If9823) - เปลี่ยนขีดจํากัดรายการเริ่มต้นของ
Pane
เป็น 4 (I0068b)
เวอร์ชัน 1.2.0-alpha01
3 พฤศจิกายน 2021
androidx.car.app:app-*:1.2.0-alpha01
ได้รับการปล่อยแล้ว เวอร์ชัน 1.2.0-alpha01 มีการคอมมิตเหล่านี้
ขณะนี้ฟีเจอร์ v1.2.0
ใหม่ทั้งหมด (API 4 ขึ้นไป) อยู่ในช่วงทดลองเพื่อกำหนดเป้าหมายเป็น Android Auto และ Android Automotive OS เวอร์ชันในอนาคต ดูรายละเอียดเพิ่มเติมได้ที่คู่มือการพัฒนา
การเปลี่ยนแปลง API
- ทำให้
AutomotiveCarInfo
API เป็นแบบทดลอง (Ia13e5) - เพิ่ม Car App Library API ระดับ 4 (I2a2e7)
- ระดับ API 4: เพิ่มการรองรับการตั้งค่า
CarIcon
ในPane
(Ifcc12) - ระดับ API 4: เพิ่มวิธีการลงชื่อเข้าใช้ด้วยคิวอาร์โค้ด (Ib623e)
- ระดับ API 4: เพิ่ม set/getFlags ลงใน
Action
(Ic03ab) - ระดับ API 4: เพิ่มการรองรับการเลื่อนและซูมเข้าใน
PlaceListNavigationTemplate
และRoutePreviewNavigationTemplate
(I9d8a3)
การแก้ไขข้อบกพร่อง
- ระดับ API 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
- API ระดับ 2:
SignInTemplate
และLongMessageTemplate
ที่สามารถใช้สำหรับขั้นตอนการลงชื่อเข้าใช้เมื่อรถจอดอยู่ - API ระดับ 2: การรองรับการโต้ตอบของแผนที่ภายใน
NavigationTemplate
- API ระดับ 2: การรองรับข้อความที่มีความยาวหลายแบบเพื่อให้แอประบุสตริงหลายเวอร์ชันสำหรับแสดงผลโดยขึ้นอยู่กับขนาดหน้าจอของรถยนต์
- API ระดับ 3:
CarHardwareManager
ที่ใช้เพื่อค้นหาข้อมูลฮาร์ดแวร์ของยานพาหนะ เช่น รุ่นและยี่ห้อ ระดับน้ำมันเชื้อเพลิง และเซ็นเซอร์อื่นๆ
เวอร์ชัน 1.1.0-rc01
3 พฤศจิกายน 2021
androidx.car.app:app-*:1.1.0-rc01
ได้รับการปล่อยแล้ว เวอร์ชัน 1.1.0-rc01 มีการคอมมิตเหล่านี้
นี่เป็นรุ่นที่เสถียรและไม่มีการเปลี่ยนแปลง API เมื่อเทียบกับ v1.1.0-beta01
เราได้เพิ่มฟีเจอร์ทดลองใหม่ (API ระดับ 4) ที่มีไว้สำหรับรุ่น Android Auto ในอนาคต ดูรายละเอียดเพิ่มเติมเกี่ยวกับ API เวอร์ชันทดลองได้ในบันทึกประจำรุ่นของ 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
ทั้งหมด (API 2 ขึ้นไป) ใช้ได้กับ Android Auto 6.7 ขึ้นไปอย่างเต็มรูปแบบ ดูรายละเอียดเพิ่มเติมได้ที่คู่มือการพัฒนา
การเปลี่ยนแปลง API
- นํา
Manager
ออกจากอินเทอร์เฟซสาธารณะ (Ie381b) - เพิ่มความสามารถในการตั้งค่าพื้นหลังที่มีแบรนด์ที่กำหนดเองสำหรับคำขอสิทธิ์ (I74b76)
- เพิ่ม
ScreenManager.getStackSize
(I0b16a) แล้ว - นำตัวสร้าง
ScreenController
ที่รับTestCarContext
อย่างชัดเจนออก (Iefebc)
การแก้ไขข้อบกพร่อง
- เพิ่มการตรวจสอบระดับ API เมื่อสร้าง
CarHardwareManager
(I48f9b) - เพิ่มการตรวจสอบการใช้งาน
CarSpan
ที่ไม่ถูกต้องใน API (I65ae6) - แก้ไขปัญหาในกรณีที่มีการทําเครื่องหมาย
Screen
ว่าเสร็จสิ้นระหว่างการสร้าง กองจะอยู่ในสถานะใช้งานไม่ได้ (I81b13) - แก้ไขปัญหาที่
CarNotificationManager.notify
จะบันทึกข้อผิดพลาดสำหรับ AutomotiveOS หากมีการดําเนินการที่มีไอคอนในCarAppExtender
(I3633d) - เพิ่มเมธอดแฮนด์เชคสำหรับแอปและโฮสต์เพื่อสร้างเวอร์ชัน API (I7d6f8)
เวอร์ชัน 1.1.0-alpha02
21 กรกฎาคม 2021
androidx.car.app:app-*:1.1.0-alpha02
ได้รับการปล่อยแล้ว เวอร์ชัน 1.1.0-alpha02 มีการคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ระดับ API 3: เพิ่ม
CarHardwareManager
ที่ใช้เพื่อค้นหาข้อมูลฮาร์ดแวร์ของยานพาหนะ เช่น รุ่นและยี่ห้อ ระดับน้ำมันเชื้อเพลิง และเซ็นเซอร์อื่นๆ ปัจจุบันฟีเจอร์นี้ใช้ได้เฉพาะใน Android Auto เวอร์ชัน 6.7 ขึ้นไปในช่องทางการทดสอบแบบเปิดเท่านั้น การทดสอบในสภาพแวดล้อมเดสก์ท็อปต้องใช้Desktop Head Unit
เวอร์ชันใหม่ที่จะเปิดตัวแยกต่างหาก โปรดติดตามรายละเอียดเกี่ยวกับเวลาที่เวอร์ชันใหม่จะพร้อมใช้งานในหน้าทดสอบแอป Android สำหรับรถยนต์ - ทำตามคู่มือการพัฒนาและข้อมูลอ้างอิงไลบรารีเพื่อดูรายละเอียดเพิ่มเติมและหลักเกณฑ์การออกแบบเกี่ยวกับวิธีใช้ฟีเจอร์เหล่านี้ในโฮสต์รถยนต์ที่เข้ากันได้กับ API ระดับ 3
การเปลี่ยนแปลง API
- รวมวิธีการเกี่ยวกับวงจรชีวิตของ
SessionController
และScreenController
เข้าเป็นวิธีการmoveToState
เดียว (I1ed00) - เพิ่ม
CarContext#getHostInfo()
(I8977e) แล้ว - นําฟิลด์ที่เลิกใช้งานแล้วออก (I67168)
- อัปเดต
SessionController
และScreenController
เพื่อแสดงตัวสร้างโดยตรง (Iabf22) - นำ
PinSignInMethod.Builder
และProviderSignInMethod.Builder
ออกแล้ว (I9f0cb) - เพิ่ม "setCarAppResult()" เพื่อเปิดใช้แอปเทมเพลต "สำหรับผลการค้นหา" ใน AAOS (I37741)
CarHardware
กำกับเนื้อหาในอินเทอร์เฟซด้วย@MainThread
(Ib2f85)- เปลี่ยนชื่อ
OnCarDataListener
เป็นOnCarDataAvailableListener
(I518ca) - อัปเดตชื่อเมธอดและ javadoc ของ
CarInfo
,Speed
,Mileage
(I86672) - เปลี่ยนชื่อ
Toll
เป็นTollCard
แล้ว (I3e7c8) - นำ
PinSignInMethod.getPin
ที่เลิกใช้งานแล้วออกและแทนที่ด้วยPinSignInMethod.getPinCode
(I996ce) - นำ
OnInputCompletedListener
ออกแล้ว (แทนที่ด้วยInputCallback
) (Ib5be1) - เปลี่ยน
PinSignInMethod
ให้ใช้CharSequence
แทนString
(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 มีการคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- API ระดับ 2:
SignInTemplate
และLongMessageTemplate
ใหม่ที่ใช้สำหรับขั้นตอนการลงชื่อเข้าใช้เมื่อรถจอดอยู่ - API ระดับ 2: การรองรับการโต้ตอบแบบใหม่ของแผนที่ภายใน
NavigationTemplate
- API ระดับ 2: การรองรับข้อความที่มีความยาวหลายแบบใหม่เพื่อให้แอประบุสตริงหลายเวอร์ชันสำหรับแสดงผลโดยขึ้นอยู่กับขนาดหน้าจอของรถยนต์
- ทำตามคู่มือการพัฒนาและ Javadoc ของไลบรารีเพื่อดูรายละเอียดเพิ่มเติมและหลักเกณฑ์การออกแบบเกี่ยวกับวิธีใช้ฟีเจอร์เหล่านี้ในโฮสต์รถยนต์ที่เข้ากันได้กับ API ระดับ 2
การเปลี่ยนแปลง API
- กำหนดให้เมธอดอินเทอร์เฟซ
*Callback
ทั้งหมดเป็นค่าเริ่มต้นและเปลี่ยนชื่อOnRequestPermissionsCallback
->OnRequestPermissionsListener
(Ib3ec9) - อัปเดตคลาส
androidx.car.app.hardware
เพื่อนำคลาสพารามิเตอร์และคลาสบิลเดอร์ที่ไม่จำเป็นออก (I67beb) - เพิ่มคลาส
androidx.car.app.hardware
สำหรับการเข้าถึงข้อมูลเฉพาะของรถยนต์ เช่น เชื้อเพลิง แบตเตอรี่ และความเร็ว (Iff3c9) - เพิ่มการรองรับ
ActionStrip
ในวันที่MessageTemplate
(Ida657) - เพิ่ม
setLoading
ไปยังMessageTemplate
แล้ว (I2a4b5) - เปลี่ยนชื่อ
ConnectionToCar
เป็นCarConnection
(Ife9bd) - เปลี่ยน
NavigationTemplate
ให้แสดงPanModeDelegate
แบบชัดเจน (I13877) - อัปเดตลําดับพารามิเตอร์สําหรับ
CarContext.requestPermissions
(Ib890a) - อัปเดตคีย์ข้อมูลเมตาเพื่อกำหนดระดับ API ขั้นต่ำของรถยนต์เป็น
androidx.car.api.minCarApiLevel
(Ib0d41) - สร้าง API ที่อนุญาตให้สังเกตสถานะการเชื่อมต่อรถยนต์ (Ifc935)
- เพิ่มการรองรับการตั้งค่าปุ่มเปิด/ปิดสําหรับ
Action
และเพิ่มAction
ประเภทโหมดแพน (Ica6af) - สร้าง
CarNotificationManager
เพื่อรองรับการส่งการแจ้งเตือนในรถ (I10d7a) - เพิ่ม
ConstraintManager
สำหรับระบุขีดจำกัดรายการจากโฮสต์ (I8690e) - เพิ่มโหมดการเลื่อนและ API แถบการดำเนินการบนแผนที่ใน
NavigationTemplate
(I77aa6) - เพิ่ม API การเลื่อนและซูมใน
SurfaceCallback
สําหรับแอปการนําทาง (Id5e9d) - อัปเดต
CarAppApiLevel
เป็น 2 (Ic1540) - เพิ่มความสามารถในการขอสิทธิ์จาก
CarAppService
(I5421e) - เพิ่มคำอธิบายประกอบ
RequiresCarApi(2)
ลงใน Multi-Text API (Iacb62) - อนุญาตให้ใช้ข้อความหลายรูปแบบในชื่อเทมเพลตรายการครึ่งหน้า (Ib8df7)
- เพิ่ม
LongMessageTemplate
ใหม่ (ต้องใช้ Car API ระดับ 2) (Ic5cee)
การแก้ไขข้อบกพร่อง
- อัปเดตข้อกำหนดขนาดรูปภาพให้สอดคล้องกับหน้าจอรถยนต์ขนาดใหญ่ขึ้น (I116dc)
- ไม่อนุญาตให้เพิ่มการดำเนินการมากกว่า 2 รายการในเนื้อหาเทมเพลต (I32157)
- ตรวจสอบว่าการสร้าง
PendingIntent
ทั้งหมดในคลังแอปรถยนต์ตั้งค่า Flag แล้ว (If84fe, b/186394900) - อัปเดต Javadoc เพื่ออนุญาตให้ข้อความของ
Row
เปลี่ยนแปลงเมื่อรีเฟรช (If3f9c) - ตอนนี้
androidx.activity:activity:1.2.0
ขึ้นกับ API แล้ว (Id1cb9) - กำหนดให้
SignInTemplate
และLongMessageTemplate
ใช้เฉพาะการดําเนินการเมื่อจอดรถในเนื้อหาและอัปเดตเอกสารประกอบเพื่อระบุว่าแอตทริบิวต์จะแสดงเฉพาะเมื่อรถจอดอยู่ (Iddaa9) - แก้ไขข้อยกเว้นที่เกิดขึ้นเมื่อป๊อป
Screen
ขึ้นระหว่างการเริ่มต้น (Ifcf40, b/184664896) - สีข้อความที่กำหนดเองที่อนุญาตใน
ForegroundCarColorSpan
(I69e59) - แก้ไขปัญหาที่ระบบตรวจพบ
ON_DESTROY
ในSession
หลังจากON_DESTROY
ของScreen
(I52e01, b/183696617) - อัปเดต Javadoc เกี่ยวกับกรณีที่อนุญาตให้ตั้งค่าเวลาที่เหลือของ
TravelEstimate
เป็น "ไม่ทราบ" (I99610, b/183632456) - อัปเดต
Action
ให้รองรับForegroundColorSpan
ในชื่อและสีพื้นหลังที่กำหนดเอง (I578e4) - อย่าเรียกใช้
NavigationManagerCallback#onStopNavigation
หากล้างการเรียกกลับก่อนที่ผู้ดำเนินการจะเรียกใช้ (I7fc5e, b/181143772) - แก้ไขปัญหาที่แอปต้องอาศัยแพ็กเกจ lifecycle-common-java8 (I8b8c8) อย่างชัดแจ้ง
ปัญหาที่ทราบ
- ใน
SignInTemplate
แป้นพิมพ์บนหน้าจอจะแสดงไอคอน "ค้นหา" แทนไอคอน "Enter" เมื่อผู้ใช้ต้องการยืนยันข้อมูลที่ป้อน วิธีแก้ปัญหาชั่วคราวคือผู้ใช้สามารถเข้าถึงแป้นพิมพ์โทรศัพท์ที่เปิดใช้งานเมื่อช่องป้อนข้อมูลอยู่ในโฟกัส - ใน 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 สำหรับไลบรารีการทดสอบแบบซอร์สโค้ดปิดก่อนหน้านี้ ดูตัวอย่างเกี่ยวกับวิธีใช้ไลบรารีนี้ในการทดสอบ
ฟีเจอร์ใหม่
- ระบบได้นำตัวควบคุมสำหรับคลาสโมเดลออกแล้ว ตอนนี้ตัวรับค่าโมเดลเป็นส่วนหนึ่งของแพลตฟอร์ม API สาธารณะ ซึ่งช่วยให้ตรวจสอบค่าที่ตั้งไว้ในเครื่องมือสร้างได้
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
ตอนนี้ไลบรารีแอปในรถเวอร์ชัน 1.0.0 ทำงานได้อย่างเสถียรและเข้ากันได้กับ Android Auto 6.1 ขึ้นไปอย่างเต็มรูปแบบ - ทำตามคู่มือการพัฒนาเพื่อดูรายละเอียดเกี่ยวกับวิธีสร้างแอปการนำทาง การจอดรถ และการชาร์จสำหรับ Android Auto โดยใช้ไลบรารี
การแก้ไขข้อบกพร่อง
- แก้ไขข้อยกเว้นที่เกิดขึ้นเมื่อแสดง
Screen
ในระหว่างการเริ่มต้น (70aae1, b/184664896) - แก้ไขปัญหาที่ระบบตรวจพบ
ON_DESTROY
ในSession
หลังจากON_DESTROY
ของScreen
(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) - แก้ไขปัญหาที่ API ขั้นต่ำที่ไม่ถูกต้องซึ่งระบุไว้ในไฟล์ Manifest ของแอปจะแสดงขึ้น ซึ่งทำให้เกิด ANR ในโฮสต์ (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
ที่แอปของคุณสามารถใช้เพื่อแสดงรายการองค์ประกอบ UI ในเลย์เอาต์ตารางกริด - เปิดตัววิธีการ
CarAppService.createHostValidator
เพื่อตรวจสอบว่าการเชื่อมต่อโฮสต์มาจากแหล่งที่มาที่เชื่อถือได้ (เช่น Android Auto) - เพิ่ม
CarAppExtender.Builder.setColor
API (b/174231592)
การแก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่ระบบกลับมาเปิด
Screen
ที่ไม่ถูกต้องเมื่อป๊อปหน้าจอตามลำดับ (b/177590791)