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.

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.apkkepackages/apps/Car/DriverUIPrebuiltbersama dengan fileAndroid.bpBlueprint.# 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.

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

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.

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.

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