Manifestdateien konfigurieren

Konfigurieren Sie die Manifestdateien Ihrer App für die Integration mit Android Auto und Android Automotive OS (AAOS). Damit diese Plattformen Ihre App erkennen und eine Verbindung herstellen können, deklarieren Sie Ihren Medienbrowserdienst im Manifest. Geben Sie die erforderlichen App-Symbole an, einschließlich eines Launcher-Symbols für ein Attributionssymbol, das von System-UI-Komponenten wie den Mediensteuerelementen verwendet wird.

Weitere Informationen zu Manifestdateien finden Sie unter Übersicht über App-Manifeste.

Medienbrowserdienst deklarieren

Android Auto und AAOS stellen über Ihren Medienbrowserdienst eine Verbindung zu Ihrer App her, um Medienelemente zu durchsuchen. Deklarieren Sie Ihren Medienbrowserdienst im Manifest, damit Android Auto und AAOS den Dienst erkennen und eine Verbindung zu Ihrer App herstellen können.

In diesem Code-Snippet wird gezeigt, wie Sie Ihren Medienbrowserdienst im Manifest deklarieren. Im nächsten Abschnitt dieses Leitfadens, Medienbrowserdienst erstellen, wird der Prozess der Implementierung des Dienstes beschrieben.

<application>
    ...
    <service android:name=".MyMediaBrowserService"
             android:exported="true">
        <intent-filter>
            <action android:name="android.media.browse.MediaBrowserService"/>
        </intent-filter>
    </service>
    ...
</application>

App-Symbole angeben

Geben Sie die App-Symbole an, die von Android Auto und AAOS verwendet werden sollen, um Ihre App in der System-UI darzustellen. Diese beiden Symbole sind erforderlich:

Launcher-Symbol definieren

Das Launcher-Symbol stellt Ihre App in der System-UI dar, z. B. im Launcher und in der Symbolleiste.

Standardmäßig wird das android:icon Attribut des <application> Elements Ihrer App als Launcher-Symbol verwendet:

<application
    ...
    android:icon="@mipmap/ic_launcher"
>

Wenn Sie ein anderes Symbol verwenden möchten, legen Sie das Attribut android:icon Ihres Medienbrowser dienstes <service> fest:

<application>
    ...
    <service
        ...
        android:icon="@mipmap/ic_car_launcher"/>
</application>

Attributionssymbol definieren

Das Attributionssymbol wird an Stellen verwendet, an denen Medieninhalte Vorrang haben, z. B. auf Medienkarten. Sie können das kleine Symbol für Benachrichtigungen wiederverwenden. Dieses Symbol muss einfarbig sein. Wir empfehlen dringend, ein Vektor-Asset zu verwenden, um ein unscharfes Symbol zu vermeiden.

Attributionssymbol auf der Medienkarte

Abbildung 1 : Attributionssymbol auf einer Medienkarte.

Mit dieser Manifestdeklaration können Sie ein Symbol angeben, das zur Darstellung Ihrer App verwendet wird:

<application>
    ...
    <meta-data
        android:name="androidx.car.app.TintableAttributionIcon"
        android:resource="@drawable/ic_status_icon" />
    ...
</application>

Label Ihrer App angeben

Standardmäßig wird der Wert des Att0ributs android:label des <application>-Elements Ihrer App als Anzeigename für Ihre App auf dem Auto bildschirm verwendet.

Wenn Sie einen anderen Anzeigenamen verwenden möchten oder Ihre App mehrere Medienbrowser dienste hat, legen Sie das Attribut android:label des Medienbrowserdienstes <service> Elements fest.

Akzentfarbe Ihrer App angeben

Die Akzentfarbe Ihrer App wird von Android Auto und AAOS verwendet, um Wiedergabesteuerelemente und andere UI-Elemente zu gestalten.

Standardmäßig wird die Akzentfarbe aus dem colorAccent Element der android:theme Stilressource des <application> Elements Ihrer App übernommen.

Wenn Sie eine andere Akzentfarbe für die Nutzung im Auto verwenden möchten, fügen Sie ein <meta-data>-Element für eine andere Stilressource hinzu, die ein colorAccent-Element enthält:

<application>
    ...
    <meta-data
        android:name="com.google.android.gms.car.application.theme"
        android:resource="@style/THEME_NAME"/>
    ...
</application>

Plattformspezifische Konfiguration

Zusätzlich zu der auf dieser Seite beschriebenen Konfiguration finden Sie in den folgenden Abschnitten plattformspezifische Anforderungen: