ตั้งค่าโปรเจ็กต์

หน้านี้จะอธิบายวิธีติดตั้งไลบรารีแอปในรถยนต์และวิธีกำหนดค่าไฟล์ Manifest สำหรับแอป

ติดตั้งไลบรารีแอปในรถ

หากต้องการเพิ่มไลบรารีลงในแอป โปรดดูหน้าเผยแพร่ของไลบรารี Jetpack

กำหนดค่าไฟล์ Manifest ของแอป

คุณต้องกำหนดค่าไฟล์ Manifest ของแอปก่อนจึงจะสร้างแอปในรถยนต์ได้

ประกาศ CarAppService

โฮสต์จะเชื่อมต่อกับแอปของคุณผ่านการติดตั้งใช้งาน CarAppService คุณประกาศบริการนี้ในไฟล์ Manifest เพื่อให้โฮสต์ค้นพบและเชื่อมต่อกับแอปของคุณได้

นอกจากนี้ คุณยังต้องประกาศหมวดหมู่ของแอปในองค์ประกอบ <category> ของตัวกรอง Intent ของแอปด้วย ดูรายการหมวดหมู่แอปที่รองรับสำหรับค่าที่อนุญาตสำหรับองค์ประกอบนี้

ข้อมูลโค้ดต่อไปนี้แสดงวิธีประกาศบริการแอปในรถยนต์สำหรับแอปจุดที่น่าสนใจในไฟล์ Manifest

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

หมวดหมู่แอปที่รองรับ

เมื่อประกาศ CarAppService ตามที่อธิบายไว้ใน ประกาศ CarAppService คุณต้องประกาศหมวดหมู่ของแอปด้วยโดย เพิ่มค่าเหล่านี้อย่างน้อย 1 ค่าในตัวกรอง Intent

• androidx.car.app.category.NAVIGATION: ให้คำแนะนำการนำทางแบบเลี้ยวต่อเลี้ยว ดูสร้างแอปนำทางสำหรับรถยนต์

• androidx.car.app.category.POI: มีฟังก์ชันที่เกี่ยวข้อง กับการค้นหาสถานที่น่าสนใจ เช่น จุดจอดรถ สถานีชาร์จ และ ปั๊มน้ำมัน ดูสร้างแอปจุดที่น่าสนใจสำหรับรถยนต์

• androidx.car.app.category.IOT: ช่วยให้ผู้ใช้ดำเนินการที่เกี่ยวข้องใน อุปกรณ์ที่เชื่อมต่อจากภายในรถยนต์ได้ ดูสร้างแอปอินเทอร์เน็ตของสรรพสิ่งสำหรับรถยนต์

• androidx.car.app.category.WEATHER: ช่วยให้ผู้ใช้เห็นข้อมูลสภาพอากาศที่เกี่ยวข้องกับตำแหน่งปัจจุบันหรือตามเส้นทาง ดูสร้างแอปสภาพอากาศสำหรับรถยนต์

• androidx.car.app.category.MEDIA: ช่วยให้ผู้ใช้เรียกดูและเปิดเพลง วิทยุ หนังสือเสียง และเนื้อหาเสียงอื่นๆ ในรถยนต์ ดูสร้างแอปสื่อที่ใช้เทมเพลตสำหรับรถยนต์

• androidx.car.app.category.MESSAGING: ช่วยให้ผู้ใช้สื่อสาร ด้วยข้อความสั้นๆ ดูสร้างประสบการณ์การรับส่งข้อความแบบเทมเพลตสำหรับ Android Auto

• androidx.car.app.category.CALLING: ช่วยให้ผู้ใช้สื่อสาร ด้วยการโทรด้วยเสียง ดูสร้างประสบการณ์การโทรสำหรับ Android Auto

ดูคำอธิบายโดยละเอียดของแต่ละหมวดหมู่และเกณฑ์ที่ต้องมีเพื่อให้มีสิทธิ์ อยู่ในหมวดหมู่ได้ที่คุณภาพแอป Android สำหรับรถยนต์

ระบุชื่อและไอคอนแอป

หากต้องการแสดงแอปใน UI ของระบบ carPermissionActivityLayoutต้อง ระบุชื่อแอปและไอคอนสำหรับโฮสต์ ใช้แอตทริบิวต์ label และ icon ของ CarAppService เพื่อระบุชื่อแอปและ ไอคอนที่โฮสต์ใช้เพื่อแสดงแอปของคุณ

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

หากคุณไม่ประกาศป้ายกำกับหรือไอคอนในองค์ประกอบ <service> โฮสต์จะกลับไปใช้ค่าที่ระบุโดยองค์ประกอบ <application>

ตั้งค่าธีมที่กำหนดเอง

วิธีตั้งค่าธีมที่กำหนดเองสำหรับแอปในรถ

1. เพิ่มองค์ประกอบ <meta-data> ในไฟล์ Manifest

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

2. ประกาศแหล่งข้อมูลสไตล์เพื่อตั้งค่าแอตทริบิวต์สำหรับธีม Car App ที่กำหนดเอง ดังนี้

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