Konfigurowanie plików manifestu

Skonfiguruj pliki manifestu aplikacji, aby zintegrować ją z Androidem Auto i Androidem Automotive OS (AAOS). Aby umożliwić tym platformom wykrywanie i nawiązywanie połączenia, zadeklaruj usługę przeglądarki multimediów w pliku manifestu. Określ wymagane ikony aplikacji, w tym ikonę programu uruchamiającego i ikonę atrybucji do użycia przez komponenty interfejsu systemu, takie jak elementy sterujące multimediami.

Więcej informacji o plikach manifestu znajdziesz w artykule Omówienie manifestu aplikacji.

Zadeklaruj usługę przeglądarki multimediów

Android Auto i AAOS łączą się z aplikacją za pomocą usługi przeglądarki multimediów, aby przeglądać elementy multimedialne. Zadeklaruj usługę przeglądarki multimediów w pliku manifestu, aby Android Auto i AAOS mogły ją wykryć i połączyć się z Twoją aplikacją.

Ten fragment kodu pokazuje, jak zadeklarować usługę przeglądarki multimediów w pliku manifestu. W następnej sekcji tego przewodnika, Tworzenie usługi przeglądarki multimediów, znajdziesz szczegółowe informacje o procesie wdrażania usługi.

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

Określ ikony aplikacji

Aby reprezentować aplikację w interfejsie systemu, określ ikony aplikacji, których powinny używać Android Auto i AAOS. Wymagane są te 2 ikony:

Określanie ikony programu uruchamiającego

Ikona programu uruchamiającego reprezentuje aplikację w interfejsie systemu, np. w programie uruchamiającym i w zasobniku ikon.

Domyślnie jako ikona programu uruchamiającego jest używany atrybut android:icon elementu <application> aplikacji:

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

Aby użyć innej ikony, ustaw atrybut android:icon elementu <service> usługi przeglądarki multimediów:

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

Określanie ikony atrybucji

Ikona atrybucji jest używana w miejscach, w których treść multimedialna ma większe znaczenie, np. na kartach multimediów. Rozważ ponowne użycie małej ikony używanej w powiadomieniach. Ikona musi być monochromatyczna.

Ikona atrybucji na karcie multimediów

Rysunek 1. Ikona atrybucji na karcie multimediów.

Za pomocą tej deklaracji w pliku manifestu możesz określić ikonę, która będzie reprezentować Twoją aplikację:

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

Określanie etykiety aplikacji

Domyślnie wartość atrybutu android:label elementu <application> aplikacji jest używana jako wyświetlana nazwa aplikacji na ekranie samochodu.

Aby użyć innej nazwy wyświetlanej lub jeśli aplikacja ma wiele usług przeglądarki multimediów, ustaw atrybut android:label elementu <service> usługi przeglądarki multimediów.

Określanie koloru uzupełniającego aplikacji

Kolor akcentu aplikacji jest używany przez Androida Auto i AAOS do stylizowania elementów sterujących odtwarzaniem i innych elementów interfejsu.

Domyślnie kolor uzupełniający jest pobierany z elementu colorAccent zasobu stylu android:theme elementu <application> aplikacji.

Aby użyć innego koloru akcentu w samochodzie, dodaj element <meta-data> dla innego zasobu stylu zawierającego element colorAccent:

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

Konfiguracja specyficzna dla platformy

Oprócz konfiguracji opisanej na tej stronie zapoznaj się z wymaganiami dotyczącymi poszczególnych platform w tych sekcjach: