הוספת תמיכה ב-Android Auto לאפליקציה שמוגדרת במצב 'חניה'
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
במכשירים עם Android מגרסה 15 ואילך, ב-Android Auto יש תמיכה בהפעלת אפליקציות מקטגוריות נתמכות של אפליקציות במצב 'חניה' ישירות ביחידה הראשית. מידע נוסף על חוויית המשתמש של אפליקציות שמושהות ב-Android Auto זמין במאמר אפליקציות שמושהות.
הצהרה על תמיכה ב-Android Auto
כדי להצהיר שהאפליקציה תומכת ב-Android Auto, צריך לכלול את הרכיב <category> הבא במסנן ה-Intent של פעילות במניפסט של האפליקציה:
באופן כללי, אפשר להוסיף את רכיב הקטגוריה android.intent.category.CAR_LAUNCHER לאותו מסנן כוונה כמו רכיב android.intent.category.LAUNCHER, אבל אפשר להוסיף אותו גם למסנן אחר אם רוצים.
כדי ליהנות מחוויית משתמש מיטבית, מומלץ להפוך את האפליקציה למתאימת באופן מלא לגודלי מסך שונים. לפחות, כדי להבטיח חוויית שימוש באיכות גבוהה במגוון המכוניות שתומכות ב-Android Auto, אסור שהאפליקציות יהיו בפורמט pillarbox משמעותי במסכים בכיוון לרוחב, כפי שמתואר בהנחיה DO-2 בנושא איכות האפליקציות למכוניות.
לדוגמה, אם אפליקציה פועלת ביחס גובה-רוחב לאורך עם פס שחור בצדדים במסך לרוחב, היא תידחה במהלך הבדיקה בחנות Play. מותר להציג אפליקציה ביחס גובה-רוחב לרוחב עם פס צד מינימלי במסך לרוחב, וגם אפליקציה ביחס גובה-רוחב לרוחב עם פס צד במסך לאורך.
בדיקה של גדלי מסך קנוניקליים
כשאתם מפתחים ובודקים את האפליקציה ל-Android Auto, אתם יכולים להשתמש בהגדרות של יחידת ראש (DHU) למחשב כדי לוודא שהאפליקציה עומדת בדרישות שלמעלה:
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-08 (שעון 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-08-08 (שעון UTC)."],[],[],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."]]
