Auf Geräten mit Android 15 oder höher unterstützt Android Auto die Ausführung von Apps in unterstützten App-Kategorien für geparkte Fahrzeuge direkt auf dem Infotainmentsystem. Weitere Informationen zur Nutzerfreundlichkeit von Apps für geparkte Autos unter Android Auto finden Sie unter Apps für geparkte Autos.
Android Auto-Unterstützung deklarieren
Wenn Sie deklarieren möchten, dass Ihre App Android Auto unterstützt, müssen Sie das folgende <category>-Element in den Intent-Filter einer Aktivität im Manifest Ihrer App einfügen:
<activity ...>
<intent-filter>
<action android:name="android.intent.action.MAIN" />
...
<category android:name="android.intent.category.CAR_LAUNCHER" />
</intent-filter>
</activity>
Im Allgemeinen kann das android.intent.category.CAR_LAUNCHER-Kategorieelement im selben Intent-Filter wie das android.intent.category.LAUNCHER-Element platziert werden. Es kann aber auch in einem anderen platziert werden.
Kategoriespezifische Manifesteinträge
Zusätzlich zu der vorherigen Anforderung gilt für Spiele eine weitere Anforderung. Weitere Informationen finden Sie unter App als Spiel markieren.
Gängige Android Auto-Bildschirmgrößen unterstützen
Für eine optimale Nutzererfahrung empfehlen wir, Ihre App vollständig anpassungsfähig an verschiedene Bildschirmgrößen zu gestalten. Um eine hohe Qualität auf den verschiedenen Autos zu gewährleisten, die Android Auto unterstützen, dürfen Apps auf Querformatbildschirmen nicht wesentlich im Letterbox-Format dargestellt werden. Dies wird durch die DO-2-Qualitätsrichtlinie für Auto-Apps abgedeckt.
Wenn eine App beispielsweise im Hochformat mit Pillarboxing auf einem Bildschirm im Querformat ausgeführt wird, wird sie bei der Überprüfung im Google Play Store abgelehnt. Eine App, die auf einem Bildschirm im Querformat mit minimalem Pillarboxing ausgeführt wird, ist ebenso akzeptabel wie eine App, die auf einem Bildschirm im Hochformat mit Letterboxing ausgeführt wird.
Mit kanonischen Bildschirmgrößen testen
Beim Erstellen und Testen Ihrer App für Android Auto können Sie die folgenden Konfigurationen des Desktop-Infotainmentsystems (Desktop Head Unit, DHU) verwenden, um zu prüfen, ob Ihre App die oben genannten Anforderungen erfüllt:
Kleine Landschaft
[general]
resolution = 800x480
dpi = 160
...
Breitbild-Landschaft
[general]
resolution = 1920x1080
dpi = 160
marginheight = 596
normalizedpi = true
cropmargins = true
...
Hochformat
[general]
resolution = 1920x1080
dpi = 160
marginwidth = 878
normalizedpi = true
cropmargins = true
...
Nutzung in Android Auto erkennen
Wenn Sie erkennen möchten, wann Ihre App über Android Auto verwendet wird (z. B. für Analysezwecke), können Sie zwei Signale prüfen:
- Der von der
CarConnectionAPI gemeldete Verbindungsstatus. Wenn Android Auto verbunden ist, wird hierCONNECTION_TYPE_PROJECTIONangezeigt. - Die Anzeige-ID der aktiven Anzeige. Wenn Ihre App auf einem anderen Display als einem integrierten Bildschirm ausgeführt wird, z. B. über Android Auto, ist dies ein anderer Wert als
DEFAULT_DISPLAY.
Das folgende Snippet zeigt, wie Sie diese Signale kombinieren, um die Nutzung über Android Auto zu erkennen:
val displayId = context.display?.displayId ?: DEFAULT_DISPLAY isRunningOnAndroidAuto = (connectionType == CONNECTION_TYPE_PROJECTION) && (displayId != DEFAULT_DISPLAY)