2025 年 3 月 27 日より、AOSP のビルドとコントリビューションには aosp-main
ではなく android-latest-release
を使用することをおすすめします。詳細については、AOSP の変更をご覧ください。
概要
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
AppCard は、OEM によってスタイル設定が管理され、アプリから提供された情報で入力される UI 要素のグループです。AppCard は、アプリの最も関連性の高いデータと機能を、いつでもアクセスできる方法でユーザーに表示します。

図 1. AppCard コンポーネント。
サードパーティのデベロッパーは、AppCard を使用して次のことができます。
- 配達中のドライバーに、テイクアウト注文のステータスを表示します。
- 車内の乗客に写真を表示して、心地よい雰囲気を演出します。
- 投資家向けに暗号通貨の価格を追跡し、定期的に更新します。
次に例を示します。

図 2. AppCard の例。
AppCard
ソース: AppCard.kt
AppCard は、データを保持するオブジェクトです。2 つの状態を持つ ImageAppCard
がサポートされています。どのタイプの AppCard を定義する場合でも、各コンポーネントに一意の ID が必要です。
図 3. テキスト付きの画像。
|
図 4. 進行状況バーとテキスト付きのボタン。
|
AppCard ContentProvider
ソース: AppCardContentProvider.kt
アプリに存在するコンテンツ プロバイダは、AppCard を作成し、インスタンス化され、AppCardHost
と通信します。詳しくは、AppCardContentProviderExtension をご覧ください。
AppCard ホスト
ソース: AppCardHost.kt
AppCardContentProvider
に接続してアプリカードを表示、管理するシステムアプリ。詳細については、AppCard ホストを構成するをご覧ください。
AppCard コンテキスト
ソース: AppCardContext.kt
AppCardHost
が AppCard を表示する方法に関するヒントを AppCardContentProvider
に提供するオブジェクト。AppCardContext
には次の情報が含まれます。
この情報により、AppCard デベロッパーはホストに送信される情報を最適化できます。
このページのコンテンツやコードサンプルは、コンテンツ ライセンスに記載のライセンスに従います。Java および OpenJDK は Oracle および関連会社の商標または登録商標です。
最終更新日 2025-07-27 UTC。
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["必要な情報がない","missingTheInformationINeed","thumb-down"],["複雑すぎる / 手順が多すぎる","tooComplicatedTooManySteps","thumb-down"],["最新ではない","outOfDate","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["サンプル / コードに問題がある","samplesCodeIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 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."]]