Mulai menggunakan Keselamatan Display

Halaman ini memberikan ringkasan untuk mengakses, membangun, dan menjalankan komponen Display Safety, termasuk perender ketersediaan tinggi (HAR), DriverUI, dan pemantau keselamatan, di seluruh platform Software Defined Vehicle (SDV).

Akses kode

Bagian ini membahas cara mendapatkan akses ke codebase untuk komponen Display Safety HAR dan DriverUI.

Perender ketersediaan tinggi

Codebase untuk perender ketersediaan tinggi (HAR) tersedia sebagai bagian dari checkout repositori utama di packages/services/display_safety/.

Codebase untuk HAR disusun sebagai berikut:

  • Framework: Berisi antarmuka framework inti untuk platform, rendering, animasi, dan audio.
  • Referensi: Berisi implementasi khusus platform untuk antarmuka framework, serta kode untuk aplikasi referensi HAR, dan toolchain keselamatan (Design Compiler, monitor keselamatan).
  • Layanan: Layanan khusus Android untuk mengirim dan menerima data kendaraan antar-komponen, dan definisi untuk paket data APEX.
  • Prebuilts: Menyediakan wrapper untuk biner bawaan seperti library grafis Impeller.

Kode aplikasi referensi Harry terletak di packages/services/display_safety/reference/harry_app.

Untuk mengetahui struktur direktori HAR yang mendetail, lihat Struktur Kode Keamanan Tampilan

Pemantau keselamatan

Codebase untuk monitor keamanan tersedia sebagai bagian dari checkout repositori utama di packages/services/display_safety/reference/safety-monitor.

Kode pemantau keamanan disusun sebagai berikut:

  • main.rs: Mengambil artefak indikator, menginisialisasi server data kendaraan, dan loop pemantauan indikator. Informasi tentang visibilitas indikator dibandingkan dengan hasil pemeriksaan indikator, dengan hasil yang diberikan menggunakan log SDV.
  • Vehicle_data_server.rs: Server yang berlangganan data kendaraan, yang memperbarui visibilitas indikator untuk loop utama.
  • Telltale_monitoring.rs: Berjalan dalam loop, mengambil salinan screenbuffer menggunakan crate screencap, dan memeriksa region yang ditentukan untuk mencari indikator. Hasil pemeriksaan indikator kemudian dikirim ke loop utama.

DriverUI

DriverUI tersedia sebagai bagian dari codebase yang tidak dipaketkan, yang dapat Anda akses dari cabang ub-automotive-master.

mkdir ub-automotive-master && cd ub-automotive-master
repo init -u https://android.googlesource.com/platform/manifest -b ub-automotive-master
repo sync -cq

Untuk mengetahui informasi selengkapnya tentang sumber Google dan sumber yang tidak dipaketkan, lihat Mengintegrasikan aplikasi yang tidak dipaketkan.

Membuat dan menjalankan

Bagian ini menjelaskan proses kompilasi dan eksekusi target untuk HAR dalam Media SDV dan DriverUI dalam SDV In-Vehicle Infotainment (IVI) untuk mencapai solusi cluster lengkap dengan SDV.

VM Tamu

Gambar 1. Menampilkan struktur VM ganda Keselamatan.

Membangun target Media HAR dan SDV

  • Target media dasar: sdv_media_cf
    • Deskripsi: Target khusus untuk stack media SDV, yang memfasilitasi pengujian terisolasi dari berbagai framework media.
    • Lokasi direktori: device/google/sdv/
  • Target terintegrasi HAR: sdv_media_har_cf
    • Deskripsi: Target ini mengintegrasikan stack media dengan HAR, mengeksekusi Media SDV di Cuttlefish.
    • Lokasi direktori: device/google/sdv_display_safety/
    • Eksekusi build:
# In the root of the Android source
source build/envsetup.sh
lunch sdv_media_har_cf-aosp_current-userdebug
m -j

Membangun DriverUI

Dari cabang ub-automotive-master, Anda dapat mem-build aplikasi yang tidak dipaketkan menggunakan CommandLine atau AndroidStudio.

Di Android Studio, impor file Gradle: packages/apps/Car/libs/aaos-apps-gradle-project/build.gradle

Ini adalah project Gradle utama dengan semua aplikasi yang tidak dipaketkan, termasuk DriverUI. Bangun project menggunakan Gradle:

# To build only DriverUI module of aaos-apps-gradle-project use
./gradlew :driver-ui:assemble

Setelah build berhasil, APK DriverUI akan tersedia di out/aaos-apps-gradle-build/driver-ui/outputs/apk/default/debug/ driver-ui-default-debug.apk

Kode DriverUI tersedia di packages/apps/Car/DriverUI

Catatan: DriverUI adalah submodul dari project Gradle utama, sehingga semua tugas Gradle dijalankan menggunakan aaos-apps-gradle-project.

Membangun target IVI SDV dengan DriverUI

  • Target Dasar: sdv_ivi_cf
    • Deskripsi: Ini berfungsi sebagai target SDV dasar untuk IVI pada arsitektur x86-64.
    • Lokasi direktori: device/google/sdv/
  • Target Terintegrasi DriverUI: sdv_ivi_cf_ds

    • Deskripsi: Target ini memperluas konfigurasi IVI dasar untuk menyertakan komponen Keamanan Tampilan. Target ini sangat penting untuk validasi layanan dan interaksi Display Safety dalam instrument cluster.
    • Lokasi direktori: device/google/sdv_display_safety/
    • Menambahkan biner DriverUI: Salin DriverUI.apk ke packages/apps/Car/DriverUIPrebuilt bersama dengan file Android.bp Blueprint.

      # Create a blueprint file, contents of this file are shown in the next step
      touch /path/to/aosp_repo_root/packages/apps/Car/DriverUIPrebuilt/Android.bp
      # Copy DriverUI.apk built
      cp /path/to/ub-automotive-master/out/aaos-apps-gradle-build/driver-ui/outputs/apk/default/debug/driver-ui-default-debug.apk /path/to/aosp_repo_root/packages/apps/Car/DriverUIPrebuilt/DriverUI.apk
      

Android.bp harus disiapkan untuk menggunakan nama modul DriverUIPrebuilt dan mengganti DriverUIStubApp:

android_app_import {
    name: "DriverUIPrebuilt",
    overrides: ["DriverUIStubApp"],
    apk: "DriverUI.apk",
    privileged: true,
    product_specific: true,
    certificate: "platform",
    required: ["allowed_privapp_com.android.car.driverui"],

    optional_uses_libs: [
        "androidx.window.extensions",
        "androidx.window.sidecar",
    ],
    enforce_uses_libs: false,
    dex_preopt: {
        enabled: false,
    },
}
  • Eksekusi build:

    # In the root of the Android source
    source build/envsetup.sh
    lunch sdv_ivi_cf_ds-aosp_current-userdebug
    m -j
    

Target deployment

Setelah berhasil menyelesaikan proses build untuk kedua target, utilitas Cuttlefish membantu memulai target seperti yang dijelaskan di bagian ini.

Deployment Media SDV dan HAR

Target HAR dibuat menggunakan konfigurasi sdv-media-config.json yang telah ditetapkan, yang ditentukan dalam device/google/sdv_media_cf.mk.

Catatan: Media SDV dan IVI SDV diluncurkan dalam mode booting Unlocked untuk cluster Keamanan Layar. Untuk mengetahui informasi selengkapnya, lihat Mode Booting SDV.

# In the root of the Android source
source build/envsetup.sh
lunch sdv_media_har_cf-aosp_current-userdebug
cvd create --extra_bootconfig_args="androidboot.sdv.boot_mode=unlocked androidboot.sdv.instance_name=instance1 androidboot.virt.address=3"

Setelah dibuat, terminal akan menampilkan log untuk mengakses target di browser pada port localhost: Point your browser to https://localhost:8443 to interact with the device.

HAR di VM Media SDV

Gambar 2. Menampilkan VM Media SDV Safety dengan HAR.

Deployment SDV IVI dan DriverUI

Target DriverUI IVI SDV dimulai menggunakan sdv-ivi-config.json yang ada yang ditentukan di device/google/sdv_ivi_cf.mk. Anda juga dapat menentukan parameter konfigurasi booting tambahan dan dimensi tampilan yang sesuai untuk layar cluster.

# In the root of the Android source
source build/envsetup.sh
lunch sdv_ivi_cf_ds-aosp_current-userdebug
cvd create --extra_bootconfig_args="androidboot.sdv.boot_mode=unlocked androidboot.sdv.instance_name=instance2 androidboot.virt.address=4" --display1=width=1920,height=720

Setelah target dimulai, terminal akan menampilkan log untuk mengakses target di browser pada port localhost: Point your browser to https://localhost:8443 to interact with the device.

Deployment target SDV-IVI dan DriverUI menginisialisasi dua layar: satu untuk sistem SDV-IVI dan satu lagi untuk DriverUI. DriverUI beroperasi sebagai aplikasi cluster dengan hak istimewa, yang memanfaatkan class ClusterHomeManager (juga dikenal sebagai Cluster2).

DriverUI di VM SDV-IVI

Gambar 3. Menampilkan IVI SDV VM Keselamatan dengan DriverUI.

Deployment cluster VM ganda

Cuttlefish memberikan kemampuan untuk meluncurkan dua Virtual Machine (VM) menggunakan konfigurasi VM ganda untuk mencapai overlay tampilan.

Komposisi Tampilan

Gambar 4. Ringkasan komposisi tampilan Display Safety.

Anda dapat meluncurkan konfigurasi VM ganda menggunakan ds_toolkit yang tersedia di packages/services/display_safety/service/.

m ds_toolkit
ds_toolkit launch

Setelah konfigurasi diluncurkan, terminal akan menampilkan log untuk mengakses target di browser pada port localhost: Point your browser to https://localhost:8443 to interact with the device.

Tindakan ini akan meluncurkan kedua target Cuttlefish dalam cluster yang beroperasi penuh dengan kedua tampilan virtual machine yang dihamparkan.

Cluster lengkap Keselamatan Layar

Gambar 5. Menampilkan cluster lengkap Keselamatan dengan Media SDV dan VM IVI SDV.

Pemantau keamanan gedung

Pemantau keamanan dibuat secara default untuk salah satu target Media SDV:

# In the root of the Android source
source build/envsetup.sh
lunch sdv_media_har_cf-aosp_current-userdebug
m -j

Saat runtime, monitor keselamatan menggunakan kumpulan default artefak compiler yang dihasilkan dan dipaketkan ke dalam APEX untuk tampilan cluster referensi.

Artefak baru dapat dibuat dengan menjalankan har-design-compiler. Alat ini berjalan pada target untuk menghasilkan artefak dari desain. Sebaiknya jalankan alat, ambil artefak baru dari target, dan bangun ulang image. Alat ini di-build dan diinstal pada target secara default.

# Run the compiler on the target
adb shell har_design_compiler -c </path/to/artifacts> -o /data/local/tmp/
# Pull the artifacts to the local filesystem
adb pull data/local/tmp/artifacts services/harry-prebuilt/data/assets/
# Rebuild the image
m -j

Pemantau keselamatan melakukan inisialisasi saat target di-booting. Pemantau keselamatan akan berjalan terus-menerus dalam loop untuk memverifikasi elemen penting keselamatan di layar terhadap apa yang diharapkan dengan menganalisis buffer layar dan sinyal data kendaraan yang masuk.

Anda dapat melihat log pemantau keamanan kapan saja:

adb logcat | grep har-safety-monitor