Projekt einrichten

Auf dieser Seite wird beschrieben, wie Sie die Car App Library installieren und die Manifestdatei für Ihre App konfigurieren.

Car App Library installieren

Informationen zum Hinzufügen der Bibliothek zu Ihrer App finden Sie auf der Seite mit den Jetpack-Bibliotheksversionen.

Manifestdateien Ihrer App konfigurieren

Bevor Sie Ihre Auto-App erstellen können, müssen Sie die Manifestdateien Ihrer App konfigurieren.

CarAppService deklarieren

Der Host stellt über Ihre CarAppService-Implementierung eine Verbindung zu Ihrer App her. Sie deklarieren diesen Dienst in Ihrem Manifest, damit der Host Ihre App erkennen und eine Verbindung zu ihr herstellen kann.

Sie müssen die Kategorie Ihrer App auch im Element <category> des Intent-Filters Ihrer App deklarieren. Eine Liste der unterstützten App-Kategorien mit den zulässigen Werten für dieses Element finden Sie hier.

Das folgende Code-Snippet zeigt, wie Sie einen Car App Service für eine POI-App in Ihrem Manifest deklarieren:

<application>
    ...
   <service
       ...
        android:name=".MyCarAppService"
        android:exported="true">
      <intent-filter>
        <action android:name="androidx.car.app.CarAppService"/>
        <category android:name="androidx.car.app.category.POI"/>
      </intent-filter>
    </service>

    ...
<application>

Unterstützte App-Kategorien

Wenn Sie Ihren CarAppService wie unter CarAppService deklarieren beschrieben deklarieren, müssen Sie auch die Kategorie Ihrer App deklarieren, indem Sie dem Intent-Filter einen oder mehrere dieser Werte hinzufügen.

Ausführliche Beschreibungen der einzelnen Kategorien und der Kriterien, die für die Qualifizierung für eine Kategorie erforderlich sind, finden Sie unter Qualität von Android-Apps für Autos.

App-Name und ‑Symbol angeben

Damit Ihre App in der System-UI dargestellt werden kann, muss in carPermissionActivityLayout ein App-Name und ein Symbol für den Host angegeben werden. Verwenden Sie die Attribute label und icon Ihres CarAppService, um den App-Namen und das Symbol anzugeben, die vom Host zur Darstellung Ihrer App verwendet werden:

...
<service
   android:name=".MyCarAppService"
   android:exported="true"
   android:label="@string/my_app_name"
   android:icon="@drawable/my_app_icon">
   ...
</service>
...

Wenn Sie im Element <service> kein Label oder Symbol deklarieren, greift der Host auf die Werte zurück, die im Element <application> angegeben sind.

Benutzerdefiniertes Design festlegen

So legen Sie ein benutzerdefiniertes Design für Ihre Auto-App fest:

  1. Fügen Sie in Ihrer Manifestdatei ein <meta-data>-Element hinzu:

    <meta-data
    android:name="androidx.car.app.theme"
    android:resource="@style/MyCarAppTheme />

  2. Deklarieren Sie Ihre Stilressource, um die Attribute für Ihr benutzerdefiniertes Design für Auto-Apps festzulegen:

    <resources>
  <style name="MyCarAppTheme">
    <item name="carColorPrimary">@color/my_primary_car_color</item>
    <item name="carColorPrimaryDark">@color/my_primary_dark_car_color</item>
    <item name="carColorSecondary">@color/my_secondary_car_color</item>
    <item name="carColorSecondaryDark">@color/my_secondary_dark_car_color</item>
    <item name="carPermissionActivityLayout">@layout/my_custom_background</item>
  </style>
</resources>
Zurück
Car App Library installieren
Weiter
CarAppService und Sitzung erstellen