Manifest dosyalarını yapılandırma

. keywords_public: Android Auto, Android Automotive OS, AAOS, Manifest, Media Browser Service, App Icons, Car UI, Manifest Configuration, Media App, Car Development

Uygulamanızın manifest dosyalarını Android Auto ve Android Automotive OS (AAOS) ile entegre olacak şekilde yapılandırın. Bu platformların keşif ve bağlantı özelliklerini etkinleştirmek için manifest dosyasında medya tarayıcı hizmetinizi bildirin. Medya kontrolleri gibi sistem kullanıcı arayüzü bileşenleri tarafından kullanılacak bir ilişkilendirme simgesi için başlatıcı simgesi de dahil olmak üzere gerekli uygulama simgelerini belirtin.

Manifest dosyaları hakkında daha fazla bilgi edinmek için Uygulama manifestine genel bakış başlıklı makaleyi inceleyin.

Medya tarayıcı hizmetinizi tanımlama

Android Auto ve AAOS, medya öğelerine göz atmak için medya tarayıcı hizmetiniz üzerinden uygulamanıza bağlanır. Android Auto ve AAOS'in hizmeti keşfedip uygulamanıza bağlanabilmesi için medya tarayıcı hizmetinizi manifestinizde bildirin.

Bu kod snippet'i, medya tarayıcı hizmetinizi manifestinizde nasıl bildireceğinizi gösterir. Bu kılavuzun bir sonraki bölümü olan Medya tarayıcı hizmeti oluşturma, hizmetin uygulanmasıyla ilgili ayrıntıları içerir.

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

Uygulama simgelerini belirtme

Uygulamanızı sistem kullanıcı arayüzünde temsil etmek için Android Auto ve AAOS'in kullanması gereken uygulama simgelerini belirtin. Şu iki simge gereklidir:

Başlatıcı simgesini tanımlama

Başlatıcı simgesi, uygulamanızı sistem kullanıcı arayüzünde (ör. başlatıcıda ve simge tepsisinde) temsil eder.

Varsayılan olarak, uygulamanızın android:icon özelliği başlatıcı simgesi olarak kullanılır: <application> öğesi:

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

Farklı bir simge kullanmak için medya tarayıcınızın android:icon özelliğini ayarlayın. servisinizin <service> öğesi:

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

İlişkilendirme simgesini tanımlama

Atıf simgesi, medya içeriğinin öncelikli olduğu yerlerde (ör. medya kartlarında) kullanılır. Bildirimler için kullanılan küçük simgeyi yeniden kullanabilirsiniz. Bu simge tek renkli olmalıdır. Bulanık simgeyi önlemek için vektör öğesi kullanmanızı önemle tavsiye ederiz.

Medya kartındaki ilişkilendirme simgesi

Şekil 1. Medya kartındaki ilişkilendirme simgesi.

Bu manifest bildirimini kullanarak uygulamanızı temsil etmek için kullanılan bir simge belirtebilirsiniz:

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

Uygulamanızın etiketini belirtme

Varsayılan olarak, uygulamanızın android:label özelliğinin değeri, uygulamanızın araba ekranındaki görünen adı olarak kullanılır.<application>

Farklı bir görünen ad kullanmak için veya uygulamanızda birden fazla medya tarayıcı hizmeti varsa medya tarayıcı hizmetinin android:label özelliğini <service> öğesi olarak ayarlayın.

Uygulamanızın vurgu rengini belirtme

Uygulamanızın vurgu rengi, Android Auto ve AAOS tarafından oynatma kontrollerini ve diğer kullanıcı arayüzü öğelerini stilize etmek için kullanılır.

Varsayılan olarak vurgu rengi, uygulamanızın <application> öğesinin android:theme stil kaynağının colorAccent öğesinden alınır.

Araç içi deneyiminizde farklı bir vurgu rengi kullanmak için colorAccent öğesini içeren farklı bir stil kaynağı için <meta-data> öğesini ekleyin:

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

Platforma özgü yapılandırma

Bu sayfada ayrıntılı olarak açıklanan yapılandırmaya ek olarak, platforma özel koşullar için aşağıdaki bölümlere bakın: