Thiết lập dự án

Trang này mô tả cách cài đặt Thư viện ứng dụng trên ô tô và cách định cấu hình tệp kê khai cho ứng dụng của bạn.

Cài đặt Thư viện ứng dụng cho ô tô

Để thêm thư viện này vào ứng dụng của bạn, hãy xem trang phát hành thư viện Jetpack.

Định cấu hình tệp kê khai của ứng dụng

Trước khi có thể tạo ứng dụng cho ô tô, bạn phải định cấu hình tệp kê khai của ứng dụng.

Khai báo CarAppService

Máy chủ lưu trữ kết nối với ứng dụng của bạn thông qua quá trình triển khai CarAppService. Bạn khai báo dịch vụ này trong tệp kê khai của mình để cho phép máy chủ lưu trữ khám phá và kết nối với ứng dụng của bạn.

Bạn cũng cần khai báo danh mục ứng dụng của mình trong phần tử <category> của bộ lọc ý định của ứng dụng. Xem danh sách các danh mục ứng dụng được hỗ trợ để biết các giá trị được phép cho phần tử này.

Đoạn mã sau đây cho biết cách khai báo dịch vụ ứng dụng ô tô cho ứng dụng địa điểm yêu thích trong tệp kê khai của bạn:

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

Danh mục ứng dụng được hỗ trợ

Khi khai báo CarAppService như mô tả trong phần Khai báo CarAppService, bạn cũng phải khai báo danh mục ứng dụng của mình bằng cách thêm một hoặc nhiều giá trị trong số này vào bộ lọc ý định.

Để biết nội dung mô tả chi tiết của từng danh mục và các tiêu chí cần đáp ứng để đủ điều kiện thuộc một danh mục, hãy xem phần Chất lượng ứng dụng Android dành cho ô tô.

Chỉ định tên và biểu tượng ứng dụng

Để biểu thị ứng dụng của bạn trong giao diện người dùng hệ thống, carPermissionActivityLayout phải chỉ định tên và biểu tượng ứng dụng cho máy chủ lưu trữ. Sử dụng thuộc tính label và icon của CarAppService để chỉ định tên và biểu tượng ứng dụng mà máy chủ lưu trữ dùng để biểu thị ứng dụng của bạn:

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

Nếu bạn không khai báo nhãn hoặc biểu tượng trong phần tử <service>, máy chủ lưu trữ sẽ quay lại dùng các giá trị do phần tử <application> chỉ định.

Đặt giao diện tuỳ chỉnh

Cách đặt giao diện tuỳ chỉnh cho ứng dụng dành cho ô tô:

  1. Thêm phần tử <meta-data> vào tệp kê khai:

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

  2. Khai báo tài nguyên kiểu để đặt các thuộc tính cho giao diện tuỳ chỉnh của ứng dụng dành cho ô tô:

    <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>
Trước
Cài đặt Thư viện ứng dụng cho ô tô
Tiếp
Tạo CarAppService và phiên của bạn