คู่มือการรวมโฮสต์ AOSP

โฮสต์แอปยานยนต์ของโครงการโอเพ่นซอร์ส Android (AOSP) เป็นส่วนหนึ่งของคลังแอปรถยนต์ที่นักพัฒนาบุคคลที่สาม (3P) ใช้เพื่อเปิดใช้แอปสำหรับ Android Automotive App Host เป็นแอประบบที่อนุญาตให้แอปรถยนต์ 3P แสดงผลส่วนประกอบอินเทอร์เฟซผู้ใช้ (UI) สไตล์ OEM ในนามของแอป

หากต้องการเรียกใช้แอป 3P ต้องติดตั้งทั้งแอป 3P และ AOSP Automotive App Host:

• Automotive App Host มอบชุดเทมเพลต UI และส่วนประกอบต่างๆ ให้กับแอป 3P ซึ่งได้รับการปรับให้เหมาะกับยานพาหนะ รวมถึงความสามารถต่างๆ เช่น การใช้งานและความปลอดภัย
• OEM สามารถจัดรูปแบบเทมเพลตและส่วนประกอบ UI เหล่านี้ได้
• ผลลัพธ์? แอป 3P ได้รับการผสานรวมเข้ากับระบบสาระบันเทิงของ OEM เป็นอย่างดี

หน้านี้อธิบายวิธีสร้าง AOSP Automotive App Host จากโครงการ Gradle ในสาขา ub-automotive และวิธีการรวม AOSP Automotive App Host เข้ากับเป้าหมายรถยนต์

ตรวจสอบรหัส

หากต้องการตรวจสอบโค้ดที่ไม่ได้รวมกลุ่ม:

1. รันคำสั่งต่อไปนี้:

   repo init -u https://android.googlesource.com/platform/manifest -b ub-automotive-master
   repo sync -j4
   

2. หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับการทำงานกับซอร์สโค้ด AOSP โปรดดู ที่ เริ่มต้นไคลเอนต์ Repo

3. ติดตั้ง Android Studio

สร้าง APK โฮสต์ AOSP

1. ตรวจสอบ ub-automotive แล้วเปิดโครงการ Gradle ภายใต้ packages/apps/Car/Templates/Host
2. หากต้องการกำหนดค่าโปรเจ็กต์ด้วย Android SDK ให้กำหนดค่าไฟล์ local.properties ของโปรเจ็กต์ของคุณ คุณสามารถค้นหาเส้นทางได้ภายใต้การตั้งค่า Android SDK ใน Android Studio

   sdk.dir=${path_to_android_sdk_location}
   

3. สร้าง APK ของโฮสต์เป็นโปรเจ็กต์ Gradle ทั่วไป ตัวอย่างเช่น รันคำสั่ง gradle :

   ./gradlew :app:assembleDebug
   

   ไฟล์ APK อยู่ใน:

   packages/apps/Car/Templates/Host/app/build/outputs/apk/debug/app-debug.apk

ฝังโฮสต์ AOSP

1. สร้างไฟล์ Android.mk ใหม่เพื่อรวมเนื้อหาต่อไปนี้:

   LOCAL_PATH := $(my-dir)
   ################## Start of AOSPHost target ##################
   include $(CLEAR_VARS)
   LOCAL_MODULE := CarAOSPHost
   LOCAL_LICENSE_KINDS := legacy_notice
   LOCAL_LICENSE_CONDITIONS := notice
   LOCAL_MODULE_OWNER := google
   LOCAL_SRC_FILES := AOSPHost.apk
   LOCAL_MODULE_CLASS := APPS
   LOCAL_MODULE_TAGS := optional
   LOCAL_MODULE_SUFFIX := $(COMMON_ANDROID_PACKAGE_SUFFIX)
   LOCAL_BUILT_MODULE_STEM := package.apk
   LOCAL_CERTIFICATE := PRESIGNED
   LOCAL_PRIVILEGED_MODULE := true
   LOCAL_PRODUCT_MODULE := true
   LOCAL_DEX_PREOPT := false
   include $(BUILD_PREBUILT)
   

2. เปลี่ยนชื่อ app-debug.apk เป็น AOSPHost.apk และใส่ APK ไว้ในโฟลเดอร์เดียวกับ Android.mk
3. เพิ่มโมดูล CarAOSPHost ให้กับเป้าหมายของคุณเป็น PRODUCT_PACKAGES :

   PRODUCT_PACKAGES += \
      CarAOSPHost \
   

เพิ่มการกำหนดค่าการอนุญาต

1. สร้างไฟล์ชื่อ com.android.car.templates.host.xml เพื่อให้มีสิ่งต่อไปนี้:

   <permissions>
       <!-- Rename the package to com.android.car.templates.host -->
       <privapp-permissions package="com.android.car.templates.host">
           <!-- To be able to display activities in the cluster -->
           <permission name="android.car.permission.CAR_DISPLAY_IN_CLUSTER" />
   
           <!-- To be able to show navigation state (turn by turn directions) in the cluster.-->
           <permission name="android.car.permission.CAR_NAVIGATION_MANAGER" />
   
           <!-- To be considered a system-approved host -->
           <permission name="android.car.permission.TEMPLATE_RENDERER" />
       </privapp-permissions>
   
       <!-- Declare support for templated applications. -->
       <feature name="android.software.car.templates_host" />
   </permissions>
   

2. ในเป้าหมายของคุณ ให้เพิ่มไฟล์ปรับแต่งไปยังเป้าหมายของคุณ:

   PRODUCT_COPY_FILES += \
       <the file root>/com.android.car.templates.host.xml:$(TARGET_COPY_OUT_VENDOR)/etc/permissions/com.android.car.templates.host.xml
   

สร้างเป้าหมาย

เมื่อคุณสร้างเป้าหมาย โฮสต์จะถูกติดตั้งและได้รับสิทธิ์:

      …
      android.car.permission.CAR_NAVIGATION_MANAGER: granted=true
      android.car.permission.CAR_DISPLAY_IN_CLUSTER: granted=true
      android.car.permission.TEMPLATE_RENDERER: granted=true
      …

ทดสอบการรวมระบบ

หากต้องการสร้างและติดตั้งตัวอย่าง โปรดดูโปรเจ็กต์ GitHub car-samples/car_app_library