پشتیبانی از Android Auto را به برنامه پارک شده خود اضافه کنید
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
در دستگاه‌های دارای Android 15 یا بالاتر، Android Auto از اجرای برنامه‌ها در دسته‌های برنامه پارک شده پشتیبانی‌شده مستقیماً روی واحد اصلی پشتیبانی می‌کند. برای اطلاعات بیشتر درباره تجربه کاربری برنامه پارک شده در Android Auto، به برنامه‌های پارک شده مراجعه کنید.
پشتیبانی از Android Auto را اعلام کنید
برای اعلام اینکه برنامه شما از Android Auto پشتیبانی می‌کند، باید عنصر <category> زیر را در فیلتر هدف یک فعالیت در مانیفست برنامه خود قرار دهید:
به طور کلی، عنصر دسته android.intent.category.CAR_LAUNCHER را می توان در همان فیلتر هدف با عنصر android.intent.category.LAUNCHER قرار داد، اما در صورت تمایل می تواند در فیلتر دیگری قرار گیرد.
سایزهای معمول صفحه نمایش Android Auto را پشتیبانی کنید
برای بهترین تجربه کاربری، توصیه می کنیم برنامه خود را کاملاً با اندازه های مختلف صفحه نمایش تطبیق دهید . حداقل، برای اطمینان از تجربه با کیفیت بالا در انواع ماشین‌هایی که از Android Auto پشتیبانی می‌کنند، برنامه‌ها نباید به‌طور قابل توجهی روی صفحه‌نمایش‌های افقی ستون‌بندی شوند، همانطور که در دستورالعمل کیفیت برنامه ماشین DO-2 ثبت شده است.
برای مثال، اگر برنامه‌ای با نسبت ابعاد عمودی با ستون‌باکسینگ روی صفحه‌نمایش افقی اجرا شود، در طول بررسی فروشگاه Play رد می‌شود. برنامه‌ای که با نسبت ابعاد افقی اجرا می‌شود با حداقل ستون‌بوکسینگ روی صفحه‌نمایش افقی قابل قبول است، همانطور که برنامه‌ای که با نسبت ابعاد افقی اجرا می‌شود و جعبه نامه روی صفحه عمودی اجرا می‌شود.
تست در برابر اندازه صفحه نمایش متعارف
هنگام ساختن و آزمایش برنامه خود برای Android Auto، می‌توانید از پیکربندی‌های Desktop Head Unit (DHU) زیر استفاده کنید تا تأیید کنید که برنامه شما با شرایط قبلی مطابقت دارد:
شناسه نمایشگر نمایشگر فعال. وقتی برنامه شما روی نمایشگری غیر از صفحه داخلی اجرا می‌شود، مانند زمانی که از طریق Android Auto استفاده می‌شود، این مقداری غیر از DEFAULT_DISPLAY است.
قطعه زیر نحوه ترکیب این سیگنال ها را برای تشخیص استفاده از طریق Android Auto نشان می دهد:
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-08-08 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-08-08 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Add support for Android Auto to your parked app\n\nOn devices running Android 15 or higher, Android Auto supports running\napps in [supported parked app categories](/training/cars#parked) directly on the head unit. See\n[Parked apps](/training/cars/platforms/android-auto#parked-apps) for more information about the parked app user experience on\nAndroid Auto.\n\nDeclare Android Auto support\n----------------------------\n\nTo declare that your app supports Android Auto, you must include the following\n`\u003ccategory\u003e` element in the intent filter of an activity in your app's manifest: \n\n \u003cactivity ...\u003e\n \u003cintent-filter\u003e\n \u003caction android:name=\"android.intent.action.MAIN\" /\u003e\n ...\n \u003ccategory android:name=\"android.intent.category.CAR_LAUNCHER\" /\u003e\n \u003c/intent-filter\u003e\n \u003c/activity\u003e\n\nGenerally, the `android.intent.category.CAR_LAUNCHER` category element can\nbe placed in the same intent filter as the `android.intent.category.LAUNCHER`\nelement, but it can be in a different one if preferred.\n| **Caution:** Be careful not to promote builds that support Android Auto to track types other than those listed in [Supported app categories](/training/cars#parked), or your submission will be rejected [during review](/training/cars/distribute#understand-review).\n\n### Category-specific manifest entries\n\nIn addition to the preceding requirement, games have an additional requirement.\nSee [Mark your app as a game](/training/cars/parked/games#mark-game).\n| **Important:** Games are the only parked app category supported by Android Auto at this time.\n\nSupport common Android Auto screen sizes\n----------------------------------------\n\nFor the best user experience, we recommend making your app [fully adaptive](/develop/ui/compose/build-adaptive-apps)\nto different screen sizes. At the minimum, to ensure a high quality experience\nin the variety of cars that support Android Auto, apps **must not** be\nsignificantly pillarboxed on landscape screens, as captured by the [`DO-2`](/docs/quality-guidelines/car-app-quality#DO-2)\ncar app quality guideline.\n\nFor example, if an app runs in a portrait aspect ratio with pillarboxing on a\nlandscape screen, it will be rejected during Play Store review. An app running\nin a landscape aspect ratio with minimal pillarboxing on a landscape screen is\nacceptable, as is an app running in a landscape aspect ratio with letterboxing\non a portrait screen.\n| **Tip:** See [Support large screen resizability](/games/develop/multiplatform/support-large-screen-resizability) for game-specific guidance on adapting to different screen sizes.\n\n### Test against canonical screen sizes\n\nWhen building and testing your app for Android Auto, you can use the following\n[Desktop Head Unit (DHU) configurations](/training/cars/testing/dhu#configure-dhu) to verify that your app meets the\npreceding requirements: \n\n### Small Landscape\n\n [general]\n resolution = 800x480\n dpi = 160\n ...\n\n| **Tip:** This is the default configuration used when running the DHU, and represents the most common configuration for cars that support Android Auto.\n\n### Wide Landscape\n\n [general]\n resolution = 1920x1080\n dpi = 160\n marginheight = 596\n normalizedpi = true\n cropmargins = true\n ...\n\n### Portrait\n\n [general]\n resolution = 1920x1080\n dpi = 160\n marginwidth = 878\n normalizedpi = true\n cropmargins = true\n ...\n\nDetect usage on Android Auto\n----------------------------\n\nIf you'd like to detect when your app is being used through Android Auto (such\nas for analytics purposes), you can look at two signals:\n\n- The connection state reported by the [`CarConnection`](/training/cars/apps#car-connection) API. When Android Auto is connected, this will be [`CONNECTION_TYPE_PROJECTION`](/reference/androidx/car/app/connection/CarConnection#CONNECTION_TYPE_PROJECTION).\n- The display ID of the active display. When your app is running on a display other than a built-in screen, such as when used through Android Auto, this is a value other than [`DEFAULT_DISPLAY`](/reference/android/view/Display#DEFAULT_DISPLAY).\n\nThe following snippet shows how to combine these signals to detect usage through\nAndroid Auto: \n\n val connectionType = ...\n val displayId = context.display.displayId\n isRunningOnAndroidAuto = connectionType == CONNECTION_TYPE_PROJECTION and displayId != DEFAULT_DISPLAY\n\n| **Caution:** This method might not always be accurate. A device could be connected to both Android Auto and another display, and your app might be running on that other display."]]
