Manifestdateien konfigurieren

Konfigurieren Sie die Manifestdateien Ihrer App für die Integration mit Android Auto und Android Automotive OS (AAOS). Damit diese Plattformen die Verbindung herstellen können, müssen Sie Ihren Media-Browser-Dienst im Manifest deklarieren. Geben Sie die erforderlichen App-Symbole an, einschließlich eines Startsymbols und eines Attributionssymbols für die Verwendung durch System-UI-Komponenten wie die Mediensteuerung.

Weitere Informationen zu Manifestdateien

Medienbrowser-Dienst deklarieren

Android Auto und AAOS stellen über Ihren Media-Browser-Dienst eine Verbindung zu Ihrer App her, um Medieninhalte zu durchsuchen. Deklarieren Sie Ihren MediaBrowser-Dienst in Ihrem Manifest, damit Android Auto und AAOS den Dienst erkennen und eine Verbindung zu Ihrer App herstellen können.

In diesem Code-Snippet sehen Sie, wie Sie Ihren Media-Browser-Dienst in Ihrem Manifest deklarieren. Im nächsten Abschnitt dieses Leitfadens, Media-Browser-Dienst 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

Damit Ihre App in der System-UI dargestellt werden kann, müssen Sie die App-Symbole angeben, die von Android Auto und AAOS verwendet werden sollen. Diese beiden Symbole sind erforderlich:

Launcher-Symbol definieren

Das Launcher-Symbol repräsentiert Ihre App in der System-UI, z. B. im Launcher und in der Symbolleiste.

Standardmäßig wird das Attribut android:icon des Elements <application> 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 des <service>-Elements Ihres Media-Browser-Dienstes 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, das für Benachrichtigungen verwendet wird, wiederverwenden. Dieses Symbol muss einfarbig sein.

Attributionssymbol auf der Medienkarte

Abbildung 1: Symbol für die Quellenangabe auf der 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 für Ihre App angeben

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

Wenn Sie einen anderen Anzeigenamen verwenden möchten oder Ihre App mehrere Media Browser-Dienste hat, legen Sie das Attribut android:label des <service>-Elements des Media Browser-Dienstes 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 Element colorAccent der Stilressource android:theme des <application>-Elements Ihrer App abgerufen.

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 mit einem colorAccent-Element ein:

<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: