Cómo agregar compatibilidad con Android Auto a tu app para usar en el vehículo estacionado

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

En dispositivos con Android 15 o versiones posteriores, Android Auto admite la ejecución de apps en categorías de apps para usar con el automóvil estacionado compatibles directamente en la unidad principal. Consulta Apps para usar con el automóvil estacionado para obtener más información sobre la experiencia del usuario de las apps para usar con el automóvil estacionado en Android Auto.

Declara la compatibilidad con Android Auto

Para declarar que tu app es compatible con Android Auto, debes incluir el siguiente elemento <category> en el filtro de intents de una actividad en el manifiesto de tu app:

<activity ...>
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        ...
        <category android:name="android.intent.category.CAR_LAUNCHER" />
    </intent-filter>
</activity>

Por lo general, el elemento de categoría android.intent.category.CAR_LAUNCHER se puede colocar en el mismo filtro de intents que el elemento android.intent.category.LAUNCHER, pero puede estar en uno diferente si lo prefieres.

Entradas de manifiesto específicas de la categoría

Además del requisito anterior, los juegos tienen un requisito adicional. Consulta Cómo marcar tu app como un juego.

Compatibilidad con tamaños de pantalla comunes de Android Auto

Para obtener la mejor experiencia del usuario, te recomendamos que tu app sea completamente adaptable a diferentes tamaños de pantalla. Como mínimo, para garantizar una experiencia de alta calidad en la variedad de vehículos compatibles con Android Auto, las apps no deben tener un formato pillarbox significativo en pantallas horizontales, como se indica en el lineamiento de calidad de apps para vehículos DO-2.

Por ejemplo, si una app se ejecuta en una relación de aspecto vertical con formato letterbox en una pantalla horizontal, se rechazará durante la revisión de Play Store. Se acepta que una app se ejecute en una relación de aspecto horizontal con formato pillarbox mínimo en una pantalla horizontal, al igual que una app que se ejecute en una relación de aspecto horizontal con formato letterbox en una pantalla vertical.

Cómo realizar pruebas en tamaños de pantalla canónicos

Cuando compilas y pruebas tu app para Android Auto, puedes usar las siguientes configuraciones de la consola central de escritorio (DHU) para verificar que tu app cumpla con los requisitos anteriores:

[general]
resolution = 800x480
dpi = 160
...

[general]
resolution = 1920x1080
dpi = 160
marginheight = 596
normalizedpi = true
cropmargins = true
...

[general]
resolution = 1920x1080
dpi = 160
marginwidth = 878
normalizedpi = true
cropmargins = true
...

Cómo detectar el uso en Android Auto

Si deseas detectar cuándo se usa tu app a través de Android Auto (por ejemplo, con fines de estadísticas), puedes observar dos indicadores:

• Es el estado de conexión que informa la API de CarConnection. Cuando Android Auto esté conectado, será CONNECTION_TYPE_PROJECTION.
• Es el ID de la pantalla activa. Cuando tu app se ejecuta en una pantalla que no es integrada, como cuando se usa a través de Android Auto, este es un valor diferente de DEFAULT_DISPLAY.

En el siguiente fragmento, se muestra cómo combinar estos indicadores para detectar el uso a través de Android Auto:

val connectionType = ...
val displayId = context.display.displayId
isRunningOnAndroidAuto = connectionType == CONNECTION_TYPE_PROJECTION and displayId != DEFAULT_DISPLAY