2025년 3월 27일부터 AOSP를 빌드하고 기여하려면 aosp-main
대신 android-latest-release
를 사용하는 것이 좋습니다. 자세한 내용은 AOSP 변경사항을 참고하세요.
개요
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
AppCard는 OEM에서 제어하는 스타일이 적용되고 앱에서 제공하는 정보로 채워진 UI 요소의 그룹입니다. 앱 카드는 액세스 가능하고 항상 사용할 수 있는 방식으로 사용자에게 앱과 가장 관련성 높은 데이터와 기능을 표시합니다.

그림 1. AppCard 구성요소
서드 파티 개발자는 AppCard를 사용하여 다음 작업을 할 수 있습니다.
- 운전자가 이동하는 동안 운전자에게 테이크아웃 음식 주문의 상태를 표시합니다.
- 차량의 승객에게 사진을 표시하여 쾌적한 분위기를 조성하세요.
- 투자자를 위해 암호화폐 가격을 추적하고 주기적으로 업데이트합니다.
예를 들면 다음과 같습니다.

그림 2. AppCard 예시
AppCard
소스: AppCard.kt
AppCard는 데이터를 보유하는 객체입니다. 두 상태가 있는 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 개발자는 호스트에 전송되는 정보를 최적화할 수 있습니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 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."]]