Park edilmiş uygulamanıza Android Auto desteği ekleme
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Android Auto, Android 15 veya sonraki sürümleri çalıştıran cihazlarda desteklenen park edilmiş uygulama kategorilerindeki uygulamaları doğrudan ana birimde çalıştırmayı destekler. Android Auto'daki park edilmiş uygulama kullanıcı deneyimi hakkında daha fazla bilgi için Park edilmiş uygulamalar başlıklı makaleyi inceleyin.
Android Auto desteğini beyan etme
Uygulamanızın Android Auto'yu desteklediğini beyan etmek için uygulamanızın manifest dosyasında bir işlemin intent filtresine aşağıdaki <category> öğesini eklemeniz gerekir:
Genellikle android.intent.category.CAR_LAUNCHER kategori öğesi, android.intent.category.LAUNCHER öğesiyle aynı intent filtresine yerleştirilebilir ancak tercih edilirse farklı bir filtreye de yerleştirilebilir.
Sık kullanılan Android Auto ekran boyutlarını destekleme
En iyi kullanıcı deneyimi için uygulamanızı farklı ekran boyutlarına tam olarak uyarlanabilir hale getirmenizi öneririz. Android Auto'yu destekleyen çeşitli arabalarda yüksek kaliteli bir deneyim sağlamak için en azından, DO-2 araba uygulaması kalite yönergesinde belirtildiği gibi, uygulamalar yatay ekranlarda önemli ölçüde dikey kenarlıklı olmamalıdır.
Örneğin, yatay ekranda dikey en boy oranında dikey kenarlıklarla çalışan bir uygulama, Play Store incelemesi sırasında reddedilir. Yatay ekranda minimum dikey kenar çubuğuyla yatay en boy oranında çalışan bir uygulama ve dikey ekranda sinemaskopla yatay en boy oranında çalışan bir uygulama kabul edilir.
Resmi ekran boyutlarına göre test etme
Android Auto için uygulamanızı oluşturup test ederken, uygulamanızın yukarıdaki koşulları karşıladığını doğrulamak üzere aşağıdaki masaüstü ana birim (DHU) yapılandırmalarını kullanabilirsiniz:
Etkin ekranın görünen kimliği. Uygulamanız, Android Auto üzerinden kullanıldığında olduğu gibi yerleşik ekran dışında bir ekranda çalışırken bu değer DEFAULT_DISPLAY dışında bir değerdir.
Aşağıdaki snippet'te, Android Auto üzerinden kullanımı tespit etmek için bu sinyallerin nasıl birleştirileceği gösterilmektedir:
Bu sayfadaki içerik ve kod örnekleri, İçerik Lisansı sayfasında açıklanan lisanslara tabidir. Java ve OpenJDK, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-08 UTC.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 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."]]
