Car App
Bản cập nhật mới nhất | Bản phát hành ổn định | Bản phát hành dùng thử | Bản phát hành beta | Bản phát hành alpha |
---|---|---|---|---|
Ngày 26 tháng 6 năm 2024 | 1.4.0 | - | 1.7.0-beta01 | - |
Khai báo phần phụ thuộc
Để thêm một phần phụ thuộc vào Thư viện Car App (Ứng dụng dành cho ô tô), bạn phải thêm kho lưu trữ Google Maven vào dự án. Đọc nội dung Kho lưu trữ Maven của Google để biết thêm thông tin.
Thêm các phần phụ thuộc cho cấu phần phần mềm bạn cần trong tệp build.gradle
cho ứng dụng hoặc mô-đun:
Groovy
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") }
Để biết thêm thông tin về các phần phụ thuộc, hãy xem bài viết Thêm phần phụ thuộc vào bản dựng.
Ý kiến phản hồi
Ý kiến phản hồi của bạn có thể giúp chúng tôi cải thiện Jetpack. Hãy cho chúng tôi biết nếu bạn phát hiện lỗi mới hoặc có ý tưởng cải thiện thư viện này. Vui lòng xem các lỗi hiện có trong thư viện này trước khi báo một lỗi mới. Bạn có thể thêm lượt bình chọn cho lỗi hiện có bằng cách nhấp vào nút dấu sao.
Xem tài liệu về Công cụ theo dõi lỗi để biết thêm thông tin.
Phiên bản 1.7
Phiên bản 1.7.0-beta01
Ngày 26 tháng 6 năm 2024
Phát hành androidx.car.app:app-*:1.7.0-beta01
. Phiên bản 1.7.0-beta01 bao gồm các thay đổi sau. Các tính năng giống như đã phát hành trong phiên bản alpha01 và được lặp lại như sau:
Tính năng mới
- Bản đồ có nội dung: Mẫu mới cho Canvas bản đồ cùng với một mẫu nội dung mà hiện tại có thể là Danh sách / Lưới / Ngăn / Thông báo.
RoutePreview
,PlaceListNavigation
,MapTemplate
hiện không được dùng nữa. Các mẫu sẽ tiếp tục hoạt động như nguyên trạng.- Các ứng dụng mẫu đã được cập nhật để cho thấy mức sử dụng
MapWithContent
thay vì các mẫu không dùng nữa
- Mục cuộc trò chuyện: Các API mới để hiển thị cuộc trò chuyện (IM, SMS) và đọc to Trợ lý trên ô tô.
- Phương diện xe: API mới để truy xuất thông tin đo lường của xe (dữ liệu hiện tại trên AAOS).
Các thay đổi về API
- Thêm thẻ
@ExperimentalCarApi
vàoMediaPlaybackTemplate.Builder
. (Ic1957) - Thêm
SectionedItemTemplate
mới trong thử nghiệm. (I5958a) - Ra mắt
CarAppApiLevel 8
(I3fa22) - Thêm
MediaPlaybackTemplate
để hiển thị nội dung trong khi phát nội dung nghe nhìn trong Thư viện Ứng dụng cho Ô tô. (I3c10d) - Thêm API mới cho các ứng dụng để phát hiện xem hệ thống có hỗ trợ âm thanh nền khi đang lái xe hay không (I0f868)
Sửa lỗi
- Khắc phục một số trường hợp rò rỉ và gặp sự cố bộ nhớ trong mã ứng dụng CAL và trong Ứng dụng mẫu điều hướng CAL. (I55e04)
- Thay thế
requireNotNull instances
trong phương thứconDestroy
củaBaseCarAppActivity
bằng các lượt kiểm tra if-null để tránh sự cố. (Iec676)
Phiên bản 1.7.0-alpha02
Ngày 17 tháng 4 năm 2024
Phát hành androidx.car.app:app-*:1.7.0-alpha02
. Phiên bản 1.7.0-alpha02 bao gồm các thay đổi sau.
Tính năng mới
- Thêm các cờ không dùng nữa cho các mẫu dựa trên bản đồ mà mẫu
MapWithContent
sẽ hỗ trợ từ nay về sau.
Các thay đổi về API
- Ngừng sử dụng
MapTemplate
,RoutePreviewNavigationTemplate
,PlaceListNavigationTemplate
cũ và khuyến khích sử dụngMapWithContentTemplate
mới (Ib0a08)
Phiên bản 1.7.0-alpha01
Ngày 3 tháng 4 năm 2024
Phát hành androidx.car.app:app-*:1.7.0-alpha01
. Chúng tôi đã di chuyển lược đồ phiên bản thư viện để phù hợp với phiên bản CarApi đang hoạt động. Điều này nhằm giảm sự nhầm lẫn trong cách đặt tên dựa trên phản hồi của nhà phát triển. Do đó, chúng tôi sẽ bỏ qua các phiên bản 1.5 / 1.6 để chuyển trực tiếp sang 1.7 Phiên bản 1.7.0-alpha01 chứa các thay đổi này.
Tính năng mới
- Bản đồ có nội dung: Mẫu mới có tên là
MapWithContent
, hỗ trợ Danh sách / Lưới / Ngăn / Tin nhắn dưới dạng Nội dung bên trong bản đồ.RoutePreview
,PlaceListNavigation
, Mẫu bản đồ hiện không còn được dùng nữa.- Các ứng dụng mẫu đã được cập nhật để cho thấy chức năng của các mẫu không dùng nữa bằng cách sử dụng
MapWithContent
.
- Mục cuộc trò chuyện: Các API mới để hiển thị cuộc trò chuyện (IM, SMS) và tính năng đọc to của Trợ lý trên ô tô.
- Phương diện xe: API mới để truy xuất thông tin đo lường của xe (dữ liệu hiện tại trên AAOS).
Các thay đổi về API
- Đánh dấu loại hình ảnh hàng nhỏ bổ sung là thử nghiệm (I5184b)
- Thêm API
CarInfo#fetchExteriorDimensions
cho phép truy cập vào thông tin về kích thước bên ngoài xe, chẳng hạn như chiều cao, chiều rộng, v.v. (Ia40c5) - Xoá thẻ
ExperimentalAPI
khỏiMapWithContentTemplate
(I66db8) - Cập nhật tham số
GridItem#setTitle
để có giá trị rỗng. (I3d610) - API
GetHeader
không yêu cầu API 7 vì có khả năng tương thích ngược (I8c812) - Thêm hỗ trợ cho
Header
trongListTemplate
, không dùngheaderAction
,headerTitle
,actionStrip
(I7ae01) - Ngừng sử dụng
title
,headerAction
,actionStrip
trongGridTemplate
và thêm tính năng hỗ trợ choHeader
(I41a9c) - Xoá yêu cầu cấp 7 đối với các API thử nghiệm: Huy hiệu, kích thước mục
GridTemplate
và phương thức getter/setter hình dạng hình ảnh, các phương thứcGridItem
để nhận/cài đặt Huy hiệu. (Id71eb) - Ngừng sử dụng
title
,headerAction
,actionStrip
trongPaneTemplate
, thêm tuỳ chọn hỗ trợHeader
mới (I23154) - Thay đổi dữ liệu đo từ xa của Media Center từ
BroadcastReceiver
thành Duyệt qua thao tác tuỳ chỉnh. (I4185f) - Thêm tính năng hỗ trợ thuộc tính
Header
trongMessageTemplate
. Không còn hỗ trợ choActionStrip
,headerAction
vàtitle
. (Ie2de8) - Sửa đổi chế độ hiển thị hằng số của cảnh báo (Icf8a8)
- Xoá thuộc tính
isLoading
khỏi mẫu gốc (I651e6) - Thêm dữ liệu bổ sung để thông báo cho các ứng dụng đa phương tiện về các tham số chính trên giao diện người dùng (I85ca2)
- Thêm tính năng số liệu phân tích của trung tâm nội dung nghe nhìn vào
MediaExtensions
(I7ce28) - Đã thêm tuỳ chọn cho hình ảnh nhỏ bổ sung trên các hàng. (I72c03)
Sửa lỗi
- Cập nhật javadoc trên
ConversationItem
để cho biết rằng các thông báo nên được sắp xếp theo thứ tự từ cũ nhất đến mới nhất. (I77a2a) - Cập nhật logic cắt bớt
ListTemplate
để xoá các thông điệp cũ nhất khỏiConversationItem
(Ie0a61)
Phiên bản 1.4
Phiên bản 1.4.0
Ngày 29 tháng 5 năm 2024
Phát hành androidx.car.app:app-*:1.4.0
. Phiên bản 1.4.0 là khuyến mãi của 1.4.0-rc02.
Thay đổi quan trọng kể từ phiên bản 1.3.0
- Kết xuất bản đồ Cụm đo lường cho ứng dụng Điều hướng
- Mẫu thẻ mới giúp cải thiện bố cục / khả năng hữu dụng của ứng dụng
- Hỗ trợ giới hạn tác vụ của tính năng thích ứng
- Các thao tác phụ trên các phần tử của danh sách
Phiên bản 1.4.0-rc02
Ngày 13 tháng 12 năm 2023
Phát hành androidx.car.app:app-*:1.4.0-rc02
. Phiên bản 1.4.0-rc02 bao gồm các thay đổi sau.. Chỉ các bản sửa lỗi nhỏ
Sửa lỗi
- Cập nhật javadoc trên
ConversationItem
để cho biết rằng các thông báo phải được sắp xếp theo thứ tự từ cũ nhất đến mới nhất (I77a2a) - Cập nhật logic cắt bớt
ListTemplate
để xoá các thông điệp cũ nhất khỏiConversationItem
(Ie0a61)
Phiên bản 1.4.0-rc01
Ngày 1 tháng 11 năm 2023
Phát hành androidx.car.app:app-*:1.4.0-rc01
mà không có thay đổi đáng kể nào. Phiên bản 1.4.0-rc01 bao gồm các thay đổi sau..
Phiên bản 1.4.0-beta02
Ngày 20 tháng 9 năm 2023
Phát hành androidx.car.app:app-*:1.4.0-beta02
. Phiên bản 1.4.0-beta02 bao gồm các thay đổi sau.. Phiên bản này gần giống với phiên bản beta01, nhưng hạ yêu cầu về compileSdk
xuống còn 33.
Sửa lỗi
- Khắc phục lỗi màn hình tải trên Thẻ không hiển thị phù hợp. (cae860)
Phiên bản 1.4.0-beta01
Ngày 9 tháng 8 năm 2023
Phát hành androidx.car.app:app-*:1.4.0-beta01
. Phiên bản 1.4.0-beta01 bao gồm các thay đổi sau..
Lưu ý: 1.4-beta01 yêu cầu compileSdk34 vẫn đang ở trạng thái nhà phát triển. 1.4-beta02 sẽ khắc phục sự cố này. Ngoài ra, bạn có thể thêm
android.suppressUnsupportedCompileSdk=34
vào tệpsettings.gradle
của dự án để tạm thời chặn cảnh báo một cách an toàn.
Tính năng mới
- Kết xuất bản đồ Cluster đo lường cho ứng dụng Điều hướng
- Mẫu thẻ mới giúp cải thiện bố cục / khả năng hữu dụng của ứng dụng
- Hỗ trợ cho Giới hạn tác vụ thích ứng
- Các thao tác phụ trên các phần tử của danh sách
Các thay đổi về API
- Xem phiên bản alpha02
Phiên bản 1.4.0-alpha02
Ngày 26 tháng 7 năm 2023
Phát hành androidx.car.app:app-*:1.4.0-alpha02
. Phiên bản 1.4.0-alpha02 bao gồm các thay đổi sau.
- Bản phát hành Alpha02 nhằm mục đích chuẩn bị cho bản phát hành beta01 sắp tới.
Tính năng mới
- Kết xuất bản đồ trong tính năng hỗ trợ Cụm đo lường cho các ứng dụng chỉ đường
- Thêm các thẻ cho các ứng dụng để cải thiện trải nghiệm về bố cục
- Thêm tuỳ chọn hiển thị mẫu Danh sách / Lưới
- Thêm các danh mục mới cho Thời tiết và thông tin liên lạc
- Di chuyển một số API sang bản phát hành CarApi 7 tiếp theo
Các thay đổi về API
- Thêm các trường đa phương tiện vào
CarMessage
(I5aaf6) - Thêm các thao tác tuỳ chỉnh vào
ConversationItem
trong Thư viện Ứng dụng cho Ô tô (Ie5ed6) - Thêm dữ liệu bổ sung để cho biết một mục nội dung đa phương tiện được phát ở định dạng âm thanh sống động và hiển thị biểu trưng định dạng nội dung của mục đó (Icb5bb)
- Thêm Loại thao tác mới, API
ActionsConstraints
để hỗ trợ nút soạn thư. (I31661) - Tạo
set/getTemplate
dưới tênset/get ContentTemplate
(Ica036) - Thông số mẫu hiện sẽ là
@NonNull
. Cập nhật tài liệu về APIMapWithContentTemplate
(I0f8ed) - Xoá thẻ
@ExperimentalCarApi
cho Thao tác trongListTemplate
để khởi chạy trong CAL 1.4 (I2cfcb) - Xoá thẻ
@ExperimentalCarApi
choTabTemplate
(Ifcb82) - Xoá chú giải
@ExperimentalCarApi
khỏi Thành phần trang trí và thao tác phụ của Hàng (I8487e) - Thêm Content ID của thẻ đang hoạt động vào
TabTemplate
và ngừng sử dụng trạng thái đang hoạt động trên Thẻ (I96932) - Thêm thuộc tính
ItemImageShape
vàoGridTemplate
(Ibf431) - Thêm thuộc tính
ItemSize
vàoGridTemplate
để kiểm soát kích thước mục trong lưới theo các nhóm nhỏ, trung bình và lớn tương đối. (Icdb3b) - Mở quyền truy cập API để nhà phát triển lấy bản sao của ngăn xếp màn hình hiện tại. (I48107)
- Thêm danh mục cho các ứng dụng thời tiết vào Thư viện Ứng dụng cho Ô tô (I2be44)
- Thêm danh mục để gọi ứng dụng vào Thư viện Ứng dụng cho Ô tô (Icab33)
- Thay thế
GridItem.Builder#setBadge()
bằng các phương thứcsetImage()
quá tải (Id2000) - Thêm thuộc tính biểu tượng vào Huy hiệu (I629b2)
- Thêm phương thức để đặt màu nền huy hiệu dấu chấm (I6411c)
- Thêm thuộc tính Huy hiệu vào
GridItem
, cho phép hiển thị một huy hiệu trên hình ảnhGridItem
. (I95de7) - Thêm một đối tượng Huy hiệu thử nghiệm sẽ đại diện cho một huy hiệu xuất hiện trên hình ảnh. (I9878d)
Phiên bản 1.4.0-alpha01
Ngày 22 tháng 2 năm 2023
Phát hành androidx.car.app:app-*:1.4.0-alpha01
. Phiên bản 1.4.0-alpha01 bao gồm các thay đổi sau.
Các thay đổi về API
- Thêm các hành động cấp cao nhất vào
GridTemplate
trong Car App Library (Id0191) - Thêm các hành động cấp cao nhất vào
ListTemplate
trong Car App Library (I9efab) - Thêm ứng dụng khác để liên kết tiêu đề phụ của mục nội dung nghe nhìn hoặc phần mô tả của mục đó với các mục nội dung nghe nhìn khác (Ic84bf)
- Cập nhật cấp độ API cho hành động trong hàng thành cấp 6. (Ie0a69)
- Thêm lệnh gọi lại nhắn tin vào A4C (Ie3986)
Sửa lỗi
- Thêm tài liệu tham khảo về tài liệu Java bị thiếu cho
CarMessage
. (I5db1c) - Ghi đè
equals()
vàhashCode()
choConversationItem
vàCarMessage
(I6fd10) - Cải thiện khả năng xác thực
ConversationItem.mMessages
(yêu cầu không có giá trị null, không trống (Iafc51)) - Thêm chú giải
@Keep
vào các trườngConversationItem
(I5d250) - Cập nhật tài liệu Java cho việc trang trí Hàng và các hành động phụ. (I000b6)
Phiên bản 1.3
Phiên bản 1.3.0-rc01
Ngày 7 tháng 12 năm 2022
Phát hành androidx.car.app:app-*:1.3.0-rc01
. Phiên bản 1.3.0-rc01 bao gồm các thay đổi sau.
- Các bản sửa lỗi nhỏ trong phiên bản beta01. Không có thay đổi lớn.
Phiên bản 1.3.0-beta01
Ngày 7 tháng 9 năm 2022
Phát hành 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
và androidx.car.app:app-testing:1.3.0-beta01
. Phiên bản 1.3.0-beta01 bao gồm các thay đổi sau.
- Giờ đây, các ứng dụng dành cho ô tô được xây dựng dựa trên thư viện này có thể truy cập vào Cửa hàng Play bằng API cấp 5 (xem hướng dẫn phát triển của chúng tôi). Các tính năng được chú thích bằng API cấp 5 trở xuống sẽ tương thích với cả Android Auto 8.1 trở lên và Google Automotive App Host 1.4 trở lên.
Tính năng mới
Ngoài các tính năng được thêm vào Thư viện Car App (Ứng dụng dành cho ô tô) phiên bản 1.3.0-alpha01, các tính năng sau đã được thêm vào như một phần của phiên bản beta01 (Tất cả các tính năng ở đây chỉ liên quan đến những thay đổi phía máy chủ mà không có bất kỳ thay đổi nào về API):
- Thanh điều hướng nổi sẽ tiếp tục hiển thị ngay cả khi người dùng đang ở màn hình lựa chọn dựa trên bản đồ trong
PlaceListNavigationTemplate
,RoutePreviewNavigationTemplate
vàMapTemplate
. Bạn có thể thực hiện việc này bằng cách cập nhật thông tin điều hướng thông quaNavigationManager.updateTrip()
. - Kích hoạt nút hành động bằng
FLAG_DEFAULT
để có ảnh động theo thời gian chờ. Theo mặc định, nút này sẽ được nhấp sau khi hết thời gian chờ. ([API 5 - All Templates]
) - Văn bản phụ của
Row
không bị cắt bớt khi người dùng đã đỗ xe, nhưng sẽ bị cắt bớt thành 2 dòng trong lúc lái xe. ([API 5 - All Templates]
) - Hỗ trợ cho trạng thái tắt của
Action
,Toggle
,Row
([API 5 - All Templates]
)
Các thay đổi về API
- Nới lỏng các điều kiện ràng buộc trong danh sách
MapTemplate
để hỗ trợ danh sách có thể chọn (I961ed) - Xoá điều kiện ràng buộc cho các Hành động đối với tiêu đề để cho phép các biểu tượng tuỳ chỉnh. (Iad28f)
- Thêm một điều kiện ràng buộc
setOnClickListenerAllowed()
vàoActionsConstraints
. Trong trường hợp này,Action
được phép đặtOnClickDelegate()
thành các hành động ngoại trừ các loại biểu tượng chuẩn. (TYPE_APP_ICON
,TYPE_BACK
vàTYPE_PAN
) (I3c745)
Sửa lỗi
- Thêm khả năng tương thích cho Android Automotive Template Host 1.4 trở lên với màn hình cong (
[Host change]
)
Phiên bản 1.3.0-alpha01
Ngày 27 tháng 7 năm 2022
Phát hành 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
và androidx.car.app:app-testing:1.3.0-alpha01
. Phiên bản 1.3.0-alpha01 bao gồm các thay đổi sau.
Các tính năng được chú thích bằng API cấp 5 sẽ tương thích với Android Auto 7.9 trở lên.
Tính năng mới
- API cấp 5:
MapTemplate
mới có thể được ứng dụng điều hướng sử dụng để hiển thị ngăn hoặc liệt kê nội dung cùng với bản đồ (If5826, If44b8) - API cấp 5: API
CarAudioRecord
mới để cho phép ghi âm đầu vào qua micrô của xe máy chủ (I5e71a) - API cấp 5: API
SuggestionManager
mới để cho phép ứng dụng cung cấp đề xuất cho máy chủ (I5c103) - API cấp 5: API
Alert
mới để hiển thị trong thông báo theo ngữ cảnh trênNavigationTemplate
(I163a7, I5ad70) - API cấp 5: các thành phần
Header
vàMapController
mới để hỗ trợ sử dụng lại trên các mẫu (If5826) - Thêm
androidx.car.app.category.POI
làm danh mục để bật các ứng dụng POI (Địa điểm yêu thích) (và ngừng sử dụngandroidx.car.app.category.PARKING
cũng nhưandroidx.car.app.category.CHARGING
) (I59da1)
Các thay đổi về API
- API cấp 5: phương thức
onClick
mới trong giao diệnSurfaceCallback
để cho phép nhấn vào khả năng tương tác trên bản đồ (Ia9777) - API cấp 5: cờ
Action.FLAG_IS_PERSISTENT
mới vàAction.FLAG_DEFAULT
để mô tảAction
(I96318, I5ad70) - API cấp 5: trạng thái bật/tắt mới cho các thành phần
Action
,Row
vàToggle
(hỗ trợ máy chủ sắp có trong bản phát hành 1.3.0-beta01 của thư viện) (Id8a09) - API cấp 5: Ưu tiên thành phần
Header
mới quasetHeader
trênPlaceListNavigationTemplate.Builder
vàRoutePreviewNavigationTemplate.Builder
, không dùng đến các phương thứcsetTitle
vàsetHeaderAction
hiện có (I30e6a ) - API cấp 5: phương thức
setOnContentRefreshListner
mới trênPlaceListMapTemplate.Builder
vàPlaceListNavigationTemplate.Builder
để sử dụng với việc triển khai giao diệnOnContentRefreshListner
mới. - API cấp 5:
setTripText
vàsetTripIcon
mới trênTravelEstimate.Builder
để tuỳ chỉnh thẻ ước tính hành trình (Idcc6d, Ic620d) - Thêm hỗ trợ cho các
CarIconSpan
trong tiêu đề củaPaneTemplate
(Ia1ee0) - Thêm hình thức hỗ trợ cho các
CarIconSpan
trong tiêu đề và văn bản củaRow
(Ic1e3c) - Bản đồ
ActionStrip
hiện có thể có tối đa bốn hành động (If3522) - Cập nhật API ứng dụng xe hơi lên cấp 5 (I26b8e)
- Hiện tại, bạn không bắt buộc phải sử dụng các tiêu đề/đầu dòng cho
PlaceListMapTemplate
,PlaceListNavigationTemplate
,RoutePreviewNavigationTemplate
,GridTemplate
,ListTemplate
,LongMessageTemplate
,MessageTemplate
,PaneTemplate
vàSignInTemplate
(I2078d, Icadde)
Sửa lỗi
- Cập nhật các quy tắc định kích thước hình ảnh
PaneTemplate
thành hộp giới hạn hình vuông (Idd72e) - Khắc phục ngoại lệ xảy ra nếu ngăn xếp màn hình được sửa đổi sau khi
State.DESTROYED
. (I3c8eb) - Thêm tính năng kiểm tra giá trị rỗng để truy xuất biểu tượng ứng dụng (I3f710)
- Cập nhật API phần cứng ô tô để sử dụng
STATUS_UNKNOWN
thay vìSTATUS_UNAVAILABLE
theo mặc định (Ic9444) - Kiểm tra xem màn hình có tồn tại hay không trước khi tạo nền tảng (Ice027a)
- Sửa lỗi
CarValue.equals()
liên quan đếnSTATUS_UNIMPLEMENTED
(I24451)
Phiên bản 1.2
Phiên bản 1.2.0
Ngày 9 tháng 11 năm 2022
Phát hành androidx.car.app:app-*:1.2.0
. Phiên bản 1.2.0 bao gồm các thay đổi sau.
- Đây là bản phát hành ổn định và không có thay đổi nào so với phiên bản 1.2.0-rc01.
Phiên bản 1.2.0-rc01
Ngày 23 tháng 3 năm 2022
Phát hành androidx.car.app:app-*:1.2.0-rc01
. Phiên bản 1.2.0-rc01 bao gồm các thay đổi sau.
- Đây là bản phát hành ổn định và không có thay đổi nào về API so với
v1.2.0-beta02
. Các tính năng thử nghiệm mới (API cấp 5) đã được bổ sung dành cho các bản phát hành Android Auto và Android Automotive trong tương lai.
Sửa lỗi
- Khắc phục ngoại lệ xảy ra nếu ngăn xếp màn hình được sửa đổi sau khi
State.DESTROYED
. (I3c8eb) - Cập nhật API
CarSensors
để cho biết họ chưa triển khai API AAOS (Idd57b) - Cập nhật
PlaceListMapTempalte.Builder#setCurrentLocationEnabled
để cho biết ACCESS_COARSE_LOCATION sẽ đủ dùng cho tính năng này (I510c2) - Đặt số lần thoát tuỳ chọn cho các loại thao tác vòng tròn có góc (Ife7d1)
Phiên bản 1.2.0-beta02
Ngày 26 tháng 1 năm 2022
Phát hành androidx.car.app:app-*:1.2.0-beta02
. Phiên bản 1.2.0-beta02 bao gồm các thay đổi sau.
Car App (Ứng dụng dành cho ô tô) được xây dựng bằng phiên bản thư viện này nhắm tới mục tiêu nền tảng Android Automotive OS
hiện có thể được phát hành lên kênh kiểm thử công khai trên Cửa hàng Play. Tham khảo hướng dẫn phát triển để biết thêm thông tin chi tiết.
Các tính năng được chú thích bằng API cấp 4 trở xuống sẽ tương thích với cả Android Auto
7.2 trở lên và nền tảng Android Automotive OS
mới. Xem mục Known Issues
dưới đây để biết các cảnh báo.
Các thay đổi về API
- Thêm API
setOnContentRefreshListener
thử nghiệm vào mẫu POI (I6bf22)
Sửa lỗi
- Khắc phục sự cố rò rỉ bộ nhớ trong
CarAppService
khi máy chủ ô tô huỷ liên kết. (I5c9ca, b/203594731) - Cập nhật
CarAppActivity
javadoc để bao gồm cả các yêu cầu về chế độ khởi chạy singleTask (Id2f95) - Giảm bớt sự cố hình ảnh khi tiếp tục phát. (Iff7e0)
Vấn đề đã biết
- Bản đồ
ActionStrip
trongPlaceListNavigationTemplate
vàRoutePreviewNavigateTemplate
sẽ bắt đầu có sẵn trong bản phát hànhAndroid Auto
vàAndroid Automotive OS
tiếp theo.
Phiên bản 1.2.0-alpha02
Ngày 15 tháng 12 năm 2021
Phát hành androidx.car.app:app-*:1.2.0-alpha02
. Phiên bản 1.2.0-alpha02 bao gồm các thay đổi sau.
Các tính năng được chú thích bằng API cấp 4 đã được nâng cấp từ thử nghiệm tới ổn định, bao gồm bản đồ ActionStrip
trong PlaceListNavigationTemplate
và RoutePreviewNavigateTemplate
, hình ảnh CarIcon
trong Pane
, QRCodeSignInMethod
và khả năng đặt gợi ý hiển thị (ví dụ: cờ) trong Action
.
Tính năng mới
- Trong Android Auto 7.1 trở lên, hạn mức mục của
Pane
đã tăng từ 2 lên 4.
Các thay đổi về API
- Thêm phương thức
toString()
thử nghiệm vàoCarUnit
(I36a3b)
Sửa lỗi
- Khắc phục sự cố thoát ứng dụng đột ngột xảy ra trong
CarAppPermissionActivity
nếu lệnh gọi lại bị ngừng hoạt động (If9823) - Thay đổi hạn mức danh sách mặc định của
Pane
thành 4 (I0068b)
Phiên bản 1.2.0-alpha01
Ngày 3 tháng 11 năm 2021
Phát hành androidx.car.app:app-*:1.2.0-alpha01
. Phiên bản 1.2.0-alpha01 bao gồm các thay đổi sau.
Mọi tính năng mới của v1.2.0
(API 4 trở lên) hiện đang thử nghiệm nhắm đến các bản phát Android Auto và Android Automotive OS trong tương lai. Tham khảo hướng dẫn phát triển để biết thêm thông tin chi tiết.
Các thay đổi về API
- Thực hiện thử nghiệm API
AutomotiveCarInfo
. (Ia13e5) - Thêm API Thư viện Car App (Ứng dụng dành cho ô tô) cấp 4 (I2a2e7)
- API cấp 4: Thêm hỗ trợ cho việc đặt
CarIcon
trongPane
(Ifcc12) - API cấp 4: Thêm phương thức đăng nhập bằng mã QR (Ib623e)
- API cấp 4: Thêm set/getFlags vào
Action
(Ic03ab) - API cấp 4: Thêm hỗ trợ cho việc di chuyển và thu phóng trong
PlaceListNavigationTemplate
vàRoutePreviewNavigationTemplate
(I9d8a3)
Sửa lỗi
- API cấp 4: Thêm cơ chế để cho phép ứng dụng gửi thông tin cập nhật vị trí cho máy chủ ô tô (I3bad3)
- Khắc phục vấn đề về logic xác thực máy chủ lưu trữ không tìm thấy quyền TEMPLATE_RECORDER đúng cách (I62618)
Phiên bản 1.1.0
Phiên bản 1.1.0
Ngày 15 tháng 12 năm 2021
Phát hành androidx.car.app:app-*:1.1.0
. Phiên bản 1.1.0 bao gồm các thay đổi sau.
Đây là bản phát hành ổn định và không có thay đổi nào so với v1.1.0-rc01
. Đồng thời hãy xem ghi chú phát hành cho v1.2.0-alpha02
để biết thêm chi tiết về các tính năng mới dành cho thư viện Car App.
Thay đổi quan trọng kể từ phiên bản 1.0.0
- API cấp 2:
SignInTemplate
vàLongMessageTemplate
có thể được dùng cho các quy trình đăng nhập khi bạn đỗ xe - API cấp 2: hỗ trợ tương tác bản đồ trong
NavigationTemplate
- API cấp 2: hỗ trợ văn bản nhiều loại độ dài để cho phép ứng dụng cung cấp nhiều phiên bản chuỗi nhằm hiển thị tuỳ thuộc vào kích thước màn hình ô tô.
- API cấp 3:
CarHardwareManager
có thể dùng để truy vấn dữ liệu về phần cứng của xe, chẳng hạn như mẫu xe và hãng sản xuất, mức nhiên liệu và các cảm biến khác.
Phiên bản 1.1.0-rc01
Ngày 3 tháng 11 năm 2021
Phát hành androidx.car.app:app-*:1.1.0-rc01
. Phiên bản 1.1.0-rc01 bao gồm các thay đổi sau.
Đây là bản phát hành ổn định và không có thay đổi nào về API so với v1.1.0-beta01
. Các tính năng thử nghiệm mới (API cấp 4) dành cho các bản phát hành Android Auto trong tương lai đã được thêm vào. Xem ghi chú phát hành cho v1.2.0-alpha01
để biết thêm thông tin chi tiết về các API thử nghiệm.
Phiên bản 1.1.0-beta01
Ngày 1 tháng 9 năm 2021
Phát hành androidx.car.app:app-*:1.1.0-beta01
. Phiên bản 1.1.0-beta01 bao gồm các thay đổi sau.
Tất cả các tính năng của v1.1.0
(API 2 trở lên) đều tương thích hoàn toàn với Android Auto 6.7 trở lên. Tham khảo hướng dẫn phát triển để biết thêm thông tin chi tiết.
Các thay đổi về API
- Xoá
Manager
khỏi giao diện công khai (Ie381b) - Thêm khả năng đặt nền thương hiệu tuỳ chỉnh cho yêu cầu cấp quyền (I74b76)
- Thêm
ScreenManager.getStackSize
(I0b16a) - Xoá hàm khởi tạo
ScreenController
có ghi rõ làTestCarContext
(Iefebc)
Sửa lỗi
- Thêm bước kiểm tra cấp API khi tạo
CarHardwareManager
(I48f9b) - Thêm các lượt kiểm tra đối với trường hợp sử dụng
CarSpan
không hợp lệ trên API (I65ae6) - Sửa lỗi nếu một
Screen
được đánh dấu là đã hoàn thành trong quá trình tạo, thì sự kiện đó sẽ rời khỏi ngăn xếp ở trạng thái bị hỏng (I81b13) - Khắc phục sự cố trong đó
CarNotificationManager.notify
sẽ ghi lại lỗi cho AutomotiveOS nếu có các hành động với biểu tượng trongCarAppExtender
(I3633d) - Thêm phương thức bắt tay cho ứng dụng và máy chủ xe để thiết lập phiên bản API (I7d6f8)
Phiên bản 1.1.0-alpha02
Ngày 21 tháng 7 năm 2021
Phát hành androidx.car.app:app-*:1.1.0-alpha02
. Phiên bản 1.1.0-alpha02 bao gồm các thay đổi sau.
Tính năng mới
- API cấp 3: Thêm loại
CarHardwareManager
có thể dùng để truy vấn dữ liệu phần cứng của xe, chẳng hạn như mẫu xe và hãng sản xuất, mức nhiên liệu và các cảm biến khác. Hiện tại, tính năng này chỉ có trên Android Auto 6.7 trở lên trong kênh thử nghiệm công khai. Việc thử nghiệm tính năng này trong môi trường máy tính sẽ yêu cầu phiên bản mới củaDesktop Head Unit
. Phiên bản này sẽ được phát hành riêng biệt. Hãy theo dõi trang Kiểm thử ứng dụng Android dành cho ô tô để biết thông tin chi tiết về thời điểm có phiên bản mới. - Làm theo hướng dẫn phát triển và tham khảo thư viện để biết thêm thông tin chi tiết cũng như nguyên tắc thiết kế về cách sử dụng các tính năng này trong máy chủ ô tô tương thích với API cấp 3.
Các thay đổi về API
- Các phương thức vòng đời của
SessionController
vàScreenController
đã hợp nhất thành một phương thứcmoveToState
(I1ed00) - Thêm
CarContext#getHostInfo()
(I8977e) - Xoá các trường không còn dùng nữa. (I67168)
- Cập nhật
SessionController
vàScreenController
để hiển thị trực tiếp hàm khởi tạo (Iabf22) - Xoá
PinSignInMethod.Builder
vàProviderSignInMethod.Builder
(I9f0cb) - Thêm "setCarAppResult()" để cho phép sử dụng các ứng dụng theo mẫu "cho kết quả" trong AAOS (I37741)
- Chú thích giao diện
CarHardware
bằng@MainThread
. (Ib2f85) - Đổi tên
OnCarDataListener
thànhOnCarDataAvailableListener
(I518ca) - Cập nhật tên phương thức
CarInfo
,Speed
,Mileage
và javadoc. (I86672) - Đổi tên
Toll
thànhTollCard
. (I3e7c8) - Xoá
PinSignInMethod.getPin
không còn dùng nữa mà được thay thế bằngPinSignInMethod.getPinCode
(I996ce) - Xoá
OnInputCompletedListener
(được thay thế bằngInputCallback
). (Ib5be1) - Thay đổi
PinSignInMethod
thànhCharSequence
thay vìString
(I275d5)
Sửa lỗi
- Bản sửa lỗi Javadoc cho phần cứng của ô tô. (I2abbc)
Đóng góp bên ngoài
Vấn đề đã biết
- Trong
SignInTemplate
, việc sử dụngInputSignInMethod
có thể dẫn đến mộtNullPointerException
trong máy chủ ô tô. Điều này sẽ được giải quyết trong bản phát hành tiếp theo của thư viện. Để giải quyết vấn đề này, hãy chèn dòng này vào cấu hình Proguard của ứng dụng:-keep class androidx.car.app.model.signin.InputSignInMethod { *; }
Phiên bản 1.1.0-alpha01
16 tháng 6 năm 2021
Phát hành androidx.car.app:app:1.1.0-alpha01
, androidx.car.app:app-automotive:1.1.0-alpha01
và androidx.car.app:app-testing:1.1.0-alpha01
. Phiên bản 1.1.0-alpha01 bao gồm các thay đổi sau.
Tính năng mới
- API cấp 2:
SignInTemplate
vàLongMessageTemplate
mới có thể được sử dụng cho quy trình đăng nhập khi xe đang đỗ. - API cấp 2: hỗ trợ mới cho tương tác bản đồ trong
NavigationTemplate
- API cấp 2: hỗ trợ mới cho văn bản có nhiều loại độ dài để cho phép ứng dụng cung cấp nhiều phiên bản chuỗi nhằm hiển thị tuỳ thuộc vào kích thước màn hình ô tô.
- Làm theo hướng dẫn phát triển và thư viện Javadoc để biết thêm thông tin chi tiết cũng như nguyên tắc thiết kế về cách sử dụng các tính năng này trong những máy chủ ô tô tương thích với API cấp 2.
Các thay đổi về API
- Đặt mọi phương thức giao diện
*Callback
về mặc định và đổi tênOnRequestPermissionsCallback
thànhOnRequestPermissionsListener
(Ib3ec9) - Cập nhật các lớp
androidx.car.app.hardware
để xoá các trình tạo và lớp tham số không cần thiết. (I67beb) - Thêm các lớp
androidx.car.app.hardware
để truy cập vào dữ liệu cụ thể về ô tô như nhiên liệu, pin và tốc độ. (Iff3c9) - Thêm hỗ trợ
ActionStrip
trênMessageTemplate
(Ida657) - Thêm
setLoading
vàoMessageTemplate
(I2a4b5) - Đã đổi tên
ConnectionToCar
thànhCarConnection
(Ife9bd) - Thay đổi
NavigationTemplate
để trả lại mộtPanModeDelegate
rõ ràng (I13877) - Cập nhật thứ tự tham số cho
CarContext.requestPermissions
(Ib890a) - Cập nhật khoá siêu dữ liệu để xác định cấp độ API tối thiểu cho xe ô tô thành
androidx.car.api.minCarApiLevel
(Ib0d41) - Tạo một API cho phép quan sát trạng thái kết nối với ô tô (Ifc935)
- Thêm hỗ trợ cài đặt nút bật/tắt cho
Action
và thêm loại chế độ kéo choAction
(Ica6af) - Tạo
CarNotificationManager
để hỗ trợ gửi thông báo trong ô tô (I10d7a) - Thêm
ConstraintManager
để cung cấp hạn mức danh sách trong máy chủ (I8690e) - Thêm chế độ kéo và API dải hành động trên bản đồ trong
NavigationTemplate
(I77aa6) - Thêm API kéo và thu phóng trong
SurfaceCallback
cho các ứng dụng điều hướng (Id5e9d) - Cập nhật
CarAppApiLevel
thành 2 (Ic1540) - Thêm chức năng yêu cầu quyền từ
CarAppService
(I5421e) - Thêm chú thích
RequiresCarApi(2)
vào API nhiều văn bản (Iacb62) - Được phép sử dụng nhiều biến thể văn bản trong nửa danh sách tiêu đề mẫu (Ib8df7)
- Thêm
LongMessageTemplate
mới (cần có API Xe cấp 2) (Ic5cee)
Sửa lỗi
- Cập nhật yêu cầu về kích thước hình ảnh để phù hợp với màn hình ô tô lớn hơn (I116dc)
- Không cho phép thêm nhiều hơn 2 hành động trong phần nội dung mẫu (I32157)
- Đảm bảo mọi quá trình tạo
PendingIntent
trong thư viện Car App (Ứng dụng dành cho ô tô) đều được gắn cờ. (If84fe, b/186394900) - Cập nhật javadoc để cho phép
Row
những thay đổi văn bản dưới dạng làm mới (If3f9c ) androidx.activity:activity:1.2.0
hiện là phần phụ thuộc api (Id1cb9)- Tạo
SignInTemplate
vàLongMessageTemplate
để yêu cầu các hành động chỉ đỗ xe trong phần nội dung và cập nhật tài liệu để cho biết các hành động này sẽ chỉ hiển thị khi ô tô được đỗ (Iddaa9) - Khắc phục một trường hợp ngoại lệ xảy ra khi bật cửa sổ
Screen
lên khi bắt đầu (Ifcf40, b/184664896) - Cho phép màu văn bản tuỳ chỉnh trong
ForegroundCarColorSpan
(I69e59) - Khắc phục vấn đề về sự cố xảy ra với
ON_DESTROY
trênSession
sauON_DESTROY
củaScreen
(I52e01, b/183696617 ). - Cập nhật javadoc khi việc cài đặt thời gian còn lại của
TravelEstimate
thành thời gian không xác định được cho phép. (I99610, b/183632456) - Cập nhật
Action
để hỗ trợForegroundColorSpan
trong tiêu đề và mọi màu nền tuỳ chỉnh (I578e4) - Không thực thi
NavigationManagerCallback#onStopNavigation
nếu lệnh gọi lại bị xoá trước khi hàm thực thi chạy (I7fc5e, b/181143772) - Khắc phục sự cố yêu cầu ứng dụng phải rõ ràng phụ thuộc vào lifecycle-common-java8 (I8b8c8)
Vấn đề đã biết
- Trong
SignInTemplate
, bàn phím ảo sẽ cho thấy biểu tượng “tìm kiếm” thay vì biểu tượng “nhập” khi người dùng muốn xác nhận mục nhập. Để khắc phục vấn đề này, người dùng có thể truy cập vào bàn phím điện thoại được kích hoạt khi trường nhập dữ liệu nằm trong tiêu điểm. - Trong Android Auto phiên bản 6.5, tính năng gọi lại và thu phóng trong
SurfaceCallback
có thể được gọi không chính xác cho một số cử chỉ chạm.
Car App (Ứng dụng dành cho ô tô) phiên bản kiểm thử 1.0.0
Phiên bản 1.0.0-alpha01
Ngày 24 tháng 3 năm 2021
Phát hành androidx.car.app:app-testing:1.0.0-alpha01
. Phiên bản 1.0.0-alpha01 bao gồm các thay đổi sau.
Đây là bản phát hành Jetpack đầu tiên của thư viện thử nghiệm nguồn đã đóng trước đó. Tham khảo mẫu của chúng tôi về cách sử dụng thư viện này trong các thử nghiệm của bạn.
Tính năng mới
- Bộ điều khiển cho các lớp mô hình đã bị xoá. Phương thức getter mẫu hiện là một phần của giao diện API công khai cho phép xác thực các giá trị đã được đặt trong trình tạo.
CarAppServiceController
trước đó đã được thay thế bằngSessionController
mới để kiểm thử logic liên quan đến vòng đời kết nối với các điểm nóng.
Phiên bản 1.0.0
Phiên bản 1.0.0
Ngày 21 tháng 4 năm 2021
Phát hành androidx.car.app:app:1.0.0
. Phiên bản 1.0.0 bao gồm các thay đổi sau.
Các tính năng chính của phiên bản 1.0.0
- Đầu tháng 4, chúng tôi đã thông báo rằng ứng dụng có thể bắt đầu phát hành lên kênh phát hành công khai bằng
androidx.car.app:app:1.0.0-rc01
. Thư viện Car App (Ứng dụng dành cho ô tô) phiên bản 1.0.0 hiện đã ổn định và tương thích hoàn toàn với Android Auto 6.1 trở lên. - Làm theo hướng dẫn phát triển để biết thông tin chi tiết về cách xây dựng ứng dụng chỉ đường, đỗ xe và sạc pin cho Android Auto bằng thư viện.
Sửa lỗi
- Khắc phục trường hợp ngoại lệ xảy ra khi hiển thị
Screen
trong quá trình bắt đầu (70aae1, b/184664896) - Khắc phục sự cố trong đó
ON_DESTROY
trên mộtSession
xuất hiện sauON_DESTROY
củaScreen
(0ceecb, b/183696617).
Phiên bản 1.0.0-rc01
Ngày 24 tháng 3 năm 2021
Phát hành androidx.car.app:app:1.0.0-rc01
. Phiên bản 1.0.0-rc01 bao gồm các thay đổi sau.
Sửa lỗi
- Khắc phục lỗi điều kiện tranh đấu trong đó
NavigationManagerCallback#onStopNavigation
được gọi sau khi lệnh gọi lại bị xoá. Điều này xảy ra nếu lệnh gọi lại bị xoá trước khi lệnh thực thi lệnh gọi lại chạy (I7fc5e, b/181143772) - Khắc phục sự cố yêu cầu ứng dụng phải phụ thuộc rõ ràng vào
lifecycle-common-java8
(I8b8c8) - Khắc phục
NullPointerException
được thực hiện khi ứng dụng nhận cuộc gọistopNavigation
khi ứng dụng này xoá lệnh gọi lại (Ib8b89, b/181143772) - Những cải tiến đối với việc không gửi lệnh gọi đến ứng dụng nếu vòng đời của ứng dụng ít nhất không ở trạng thái
CREATED
(I86965, b/179800224, b/177921120) - Sửa lỗi tệp kê khai của một API tối thiểu không hợp lệ được chỉ định trong ứng dụng sẽ gửi, gây ra lỗi ANR trên máy chủ. (Nếu được cung cấp, b/174231592)
Phiên bản 1.0.0-beta01
Ngày 24 tháng 2 năm 2021
Phát hành androidx.car.app:app:1.0.0-beta01
. Phiên bản 1.0.0-beta01 bao gồm các thay đổi sau.
Đây là bản phát hành Jetpack đầu tiên của thư viện nguồn đã đóng trước đó và tương thích với Android Auto 6.1 trở lên. Làm theo hướng dẫn phát triển để biết thông tin chi tiết về cách tạo ứng dụng dành cho ô tô bằng thư viện.
Tính năng mới
- Đã giới thiệu
GridTemplate
mà ứng dụng của bạn có thể sử dụng để hiển thị danh sách các thành phần trên giao diện người dùng trong một bố cục lưới. - Đã giới thiệu phương thức
CarAppService.createHostValidator
để xác thực rằng kết nối máy chủ là từ một nguồn đáng tin cậy (ví dụ: Android Auto). - Thêm API
CarAppExtender.Builder.setColor
. (b/174231592)
Sửa lỗi
- Sửa lỗi
Screen
sai tiếp tục khi các màn hình tuần tự bật lên. (b/177590791)