Kể từ ngày 27 tháng 3 năm 2025, bạn nên sử dụng android-latest-release
thay vì aosp-main
để xây dựng và đóng góp cho AOSP. Để biết thêm thông tin, hãy xem phần Thay đổi đối với AOSP.
Tổng quan
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
AppCard là một nhóm các phần tử giao diện người dùng có kiểu dáng do OEM kiểm soát và được điền sẵn thông tin do các ứng dụng cung cấp. AppCard hiển thị dữ liệu và chức năng phù hợp nhất của một ứng dụng cho người dùng theo cách dễ tiếp cận và luôn có sẵn.

Hình 1. Thành phần AppCard.
Nhà phát triển bên thứ ba có thể sử dụng Thẻ ứng dụng để:
- Hiển thị trạng thái của đơn đặt hàng mang đi cho tài xế trong khi họ đang trên đường.
- Hiển thị ảnh cho hành khách trên xe để tạo không gian dễ chịu.
- Theo dõi và định kỳ cập nhật giá của các đồng tiền mã hoá cho nhà đầu tư.
Ví dụ:

Hình 2. Ví dụ về AppCard.
AppCard
Nguồn: AppCard.kt
AppCard là một đối tượng lưu trữ dữ liệu. Chúng tôi hỗ trợ ImageAppCard
có 2 trạng thái. Khi xác định bất kỳ loại AppCard nào, mỗi thành phần phải có một mã nhận dạng duy nhất.
Hình 3. Hình ảnh có văn bản.
|
Hình 4. Thanh tiến trình và các nút có văn bản.
|
AppCard ContentProvider
Nguồn: AppCardContentProvider.kt
Một trình cung cấp nội dung có trong ứng dụng, tạo AppCard, được khởi tạo và giao tiếp với AppCardHost
. Để tìm hiểu thêm, hãy xem AppCardContentProviderExtension.
AppCard Host
Nguồn: AppCardHost.kt
Một ứng dụng hệ thống kết nối với(các) AppCardContentProvider
để hiển thị và quản lý Thẻ ứng dụng. Để tìm hiểu thêm, hãy xem phần Định cấu hình một máy chủ AppCard.
Ngữ cảnh AppCard
Nguồn: AppCardContext.kt
Một đối tượng cung cấp gợi ý cho AppCardContentProvider
về cách AppCardHost
có thể hiển thị AppCard. AppCardContext
chứa thông tin sau:
- Cấp độ API
Khoảng thời gian làm mới cho:
- Hoàn tất quá trình cập nhật AppCard
- Các thành phần AppCard được gắn thẻ bằng
EnforceFastUpdateRate
Máy chủ lưu trữ có hỗ trợ các hoạt động tương tác với AppCard không?
Kích thước hình ảnh tối đa:
- Hình ảnh ở giữa
- Hình ảnh nút
- Hình ảnh tiêu đề
Số lượng nút tối thiểu dự kiến sẽ hiển thị.
Thông tin này cho phép nhà phát triển AppCard tối ưu hoá thông tin được gửi đến các máy chủ lưu trữ.
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2025-07-27 UTC.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-07-27 UTC."],[],[],null,["# Overview\n\nAn *AppCard* is a grouping of UI elements with styling controlled by the OEM,\nand populated with information provided by apps. AppCards display an app's most\nrelevant data and functionality to users in a way that is accessible and always\navailable.\n\n**Figure 1.** AppCard components.\n\nThird-party developers can use AppCards to:\n\n- Display the status of a takeout food order to a driver while en route.\n- Show photos to passengers in vehicles to form a pleasant ambiance.\n- Track and periodically update the price of crypto coins for investors.\n\nExamples include:\n\n**Figure 2.** AppCard examples.\n\nAppCard\n-------\n\n**Source:** [`AppCard.kt`](https://android.googlesource.com/platform/packages/apps/Car/libs/+/refs/tags/ub-automotive-master-20250418/car-app-card-lib/app-card/src/main/java/com/android/car/appcard/AppCard.kt)\n\nAn AppCard is an object that holds data. We support an `ImageAppCard`, that has\ntwo states. When defining any type of AppCard, each component must have a\nunique ID.\n\n|--------------------------------|---------------------------------------------------|\n| **Figure 3.** Image with text. | **Figure 4.** Progress bar and buttons with text. |\n\nAppCard ContentProvider\n-----------------------\n\n**Source:** [`AppCardContentProvider.kt`](https://android.googlesource.com/platform/packages/apps/Car/libs/+/refs/tags/ub-automotive-master-20250418/car-app-card-lib/app-card/src/main/java/com/android/car/appcard/AppCardContentProvider.kt)\n\nA content provider that exists in an app, creates AppCards, and is instantiated\nand communicates with `AppCardHost`. To learn more, see\n[AppCardContentProviderExtension](/docs/automotive/unbundled_apps/appcards/appcard#override).\n\nAppCard Host\n------------\n\n**Source:** [`AppCardHost.kt`](https://android.googlesource.com/platform/packages/apps/Car/libs/+/refs/tags/ub-automotive-master-20250418/car-app-card-host-lib/app-card-host/src/main/java/com/android/car/appcard/host/AppCardHost.kt)\n\nA system app that connects to `AppCardContentProvider`(s) to display and manage\nApp Cards. To learn more, see [Configure an AppCard host](/docs/automotive/unbundled_apps/appcards/host).\n\nAppCard Context\n---------------\n\n**Source:** [`AppCardContext.kt`](https://android.googlesource.com/platform/packages/apps/Car/libs/+/refs/tags/ub-automotive-master-20250418/car-app-card-lib/app-card/src/main/java/com/android/car/appcard/AppCardContext.kt)\n\nAn object that provides hints to an `AppCardContentProvider` about how an\n`AppCardHost` might display an AppCard. `AppCardContext` contains this\ninformation:\n\n- API level\n- Refresh period for:\n\n - Complete AppCard updates\n - AppCard components tagged with `EnforceFastUpdateRate`\n- Is the host to support interactions with AppCard?\n\n- Maximum image size:\n\n - Center image\n - Button image\n - Header image\n- Minimum number of buttons expected to be displayed.\n\nThis information allows AppCard developers to optimize the information sent to\nhosts."]]