Gunakan perender ketersediaan tinggi (HAR) untuk menampilkan informasi kendaraan yang tidak dapat ditampilkan Android. Hal ini dapat terjadi karena masalah seperti startup, ketersediaan, keamanan, atau peraturan. HAR adalah aplikasi bawaan portabel yang ditulis dalam Rust.
HAR, yang juga disebut framework HAR, menyertakan kode yang Anda gunakan untuk mem-build aplikasi. Aplikasi
yang dibuat dengan HAR adalah aplikasi berbasis HAR. Framework HAR memiliki bagian kode untuk
berbagai platform. Misalnya, di sistem Linux, Anda menggunakan library seperti
tinyalsa untuk suara. QNX memiliki library audio uniknya sendiri.
Platform mencakup hardware, sistem operasi, library sistem, dan faktor lainnya. Kode khusus platform memiliki bagian yang disebut subsistem. Setiap subsistem menangani satu fitur platform, seperti audio, kamera EVS, atau data kendaraan. Untuk mendukung platform, framework HAR memerlukan semua subsistemnya diimplementasikan.
Kode subsistem khusus platform dapat berjalan dalam proses yang sama dengan aplikasi berbasis HAR atau dalam proses terpisah. Jika terpisah, kode ini menangani komunikasi antar-proses (IPC) untuk membantu memverifikasi bahwa platform mendukung aplikasi. Mekanisme IPC yang kompleks harus menjadi bagian dari kode khusus platform.
Suite pengujian HAR menjalankan pengujian pada semua subsistem yang diimplementasikan untuk platform. Gunakan suite ini untuk memeriksa apakah platform memenuhi persyaratan HAR dan untuk menemukan masalah baru.
Terminologi
Persyaratan ini ada di halaman ini:
- Aplikasi berbasis HAR
- Aplikasi OEM atau khusus fungsi yang dibuat dengan framework HAR. Aplikasi berbeda menurut status aplikasi dan aspek lain yang dapat disesuaikan.
- Framework HAR
- Menyediakan serangkaian alat inti yang digunakan untuk mem-build aplikasi.
- Abstraksi platform HAR
- Bagian dari framework HAR yang menyediakan API yang diketahui dan harus diimplementasikan oleh semua platform target.
- Suite pengujian HAR
- Serangkaian pengujian umum pada implementasi platform, yang membantu memverifikasi bahwa implementasi platform mendukung framework HAR di platform tertentu.
Di luar cakupan
HAR tidak membahas:
Implementasi individual untuk semua target platform: Implementasi untuk platform target. Sebagai gantinya, halaman ini menjelaskan antarmuka yang harus dipenuhi oleh implementasi platform dan suite pengujian.
Kasus pengujian: Kasus pengujian spesifik untuk semua antarmuka. Sebagai gantinya, halaman ini menjelaskan fungsi individual untuk antarmuka, termasuk argumen, nilai yang ditampilkan, perilaku yang diharapkan, dan efek samping yang diharapkan. Halaman ini menjelaskan suite pengujian tempat Anda dapat menerapkan dan menjalankan kasus pengujian.
Struktur crate tingkat tinggi abstraksi platform
Project Rust terdiri dari crate. Gambar 1 menunjukkan struktur crate untuk lapisan abstraksi platform HAR. Lapisan abstraksi platform memengaruhi dua crate Rust atau lebih:
Abstraksi (deskripsi
traitRust) ada di crate framework HAR.Implementasi untuk platform dilakukan oleh crate
har-platform-xterpisah. Misalnya,har-platform-linuxatauhar-platform-android.
Anda tidak dapat mem-build atau menguji crate HAR tanpa implementasi platform yang ditentukan. Hal ini disengaja karena framework HAR adalah sebuah framework.
Aplikasi yang menentukan platform harus di-build dengan framework ini agar dapat berfungsi dan diuji. Hubungan antara framework HAR dan platform ada dalam diagram ini:
Gambar 1. Peti HAR.
Struktur umum dalam display-safety
Desain ini menambahkan serangkaian crate baru ke repositori display_safety, seperti
yang diilustrasikan dalam Gambar 2:
Gambar 2. Modul abstraksi.
Suite pengujian secara struktural mirip dengan aplikasi, tetapi hanya mengandalkan crate implementasi platform tertentu. Suite pengujian harus merujuk ke karakteristik dan struktur yang ditentukan dalam framework HAR, tetapi tidak boleh merujuk ke implementasi yang lebih kompleks.
Deskripsi tingkat tinggi lapisan abstraksi platform
Tabel ini menjelaskan subsistem khusus platform yang ditentukan oleh lapisan abstraksi platform HAR.
| Nama abstraksi | Fungsi terkait | Deskripsi | Catatan |
|---|---|---|---|
OpenGL |
Rendering 2D | Menyediakan kemampuan rendering OpenGLES 2.0/3.0 ke crate framework HAR. | |
Audio |
Rendering audio | Menyediakan antarmuka seperti Android SoundPool untuk mengelola dan memutar audio sistem. | |
Camera |
Tampilan kamera kendaraan | Menyediakan antarmuka seperti HAL EVS untuk mengelola dan menampilkan informasi kamera kendaraan. | |
Looper |
Loop utama aplikasi dan konfigurasi tampilan | Menyediakan antarmuka seperti Android Looper untuk mengelola loop utama aplikasi dan konfigurasi tampilan khusus platform. | |
UserInput |
Sentuhan, keyboard, setir atau tombol putar, dan input khusus platform lainnya | Menyediakan antarmuka untuk menyediakan input sentuh dan keyboard ke aplikasi berbasis HAR. Implementasi referensi berdasarkan Linux evdev di
har-user-input-evdev. |
|
VehicleData |
Input status kendaraan | Menyediakan antarmuka untuk menyediakan aplikasi berbasis HAR dengan aliran data kendaraan arbitrer seperti yang disediakan oleh Android VHAL atau bus CAN. | |
ResourceManager |
Dokumen desain yang di-cache khusus aplikasi | Menyediakan cache dalam memori untuk resource yang diperlukan untuk memulai HAR, seperti gambar yang di-cache dan dokumen desain. Belum ada cache disk yang diterapkan. | |
Logging |
Logging dan telemetri sistem | Memberikan dukungan logging khusus platform menggunakan sistem pelacakan. Tindakan ini akan mengaktifkan pengumpulan telemetri seperti yang diperlukan oleh platform. | |
Tracing |
Pelacakan sistem | Menyediakan abstraksi untuk berintegrasi dengan sistem pelacakan dan pembuatan profil. | |
Monitoring |
Pemantauan sistem | Toolkit untuk memantau performa dan latensi dalam framework HAR. | |
Commlib |
Data kendaraan | Implementasi referensi yang menggunakan serialisasi protobuf.
Tidak digunakan lagi: Gunakan API yang ditentukan di reference/harry-control-api dan
implementasi harry-grpcio-server dan
harry-tonic-server (implementasi referensi). |
|
TestSupport |
Menguji hook dukungan | Mendukung pembuatan dan penghapusan kasus pengujian, pembuatan peristiwa pengujian, dan pembuatan artefak pengujian. Misalnya, membuat peristiwa sentuh
simulasi untuk menguji UserInput dan membuat screenshot untuk
analisis. |
Fitur ini dikunci oleh Rust untuk mencegah penyertaan dalam build produksi. |
Konvensi penamaan dan struktur framework
Tabel ini menampilkan nama dan struktur tersebut:
Instance
traitsubsistem yang diharapkan disediakan oleh framework HAR. Setiaptraitmewakili subsistem khusus platform yang harus diimplementasikan.Nama yang diharapkan dari implementasi subsistem khusus platform di crate platform apa pun. Aplikasi berbasis HAR mengharapkan nama spesifik ini diterapkan.
Instance
enumdanstructframework HAR terkait biasanya digunakan untuk meneruskan informasi dari implementasi terkait platform ke framework HAR.
| Nama karakteristik | Nama penerapan | Enum dan struct framework HAR |
|---|---|---|
GlContextFactory |
OpenGL |
trait harry::Rendererharry::DisplayRotation |
AudioApiFactory |
Audio |
harry::AudioApiharry::AudioDeviceharry::VolumeMillibel |
ICameraManager |
Camera |
harry::ICameraDeviceharry::CameraDescriptor |
Looper |
Looper |
harry::LooperMessageharry::LooperOptionsharry::DisplayId |
PlatformVehicleData |
VehicleData |
harry::VehicleDataTypeharry::VehicleDataListener |
ResourceManager (Struct) |
ResourceManager |
harry::ResourceManagerMessageharry::ResourceTokenharry::RawImageData |
PlatformTracing |
Tracing |
T/A |
HarPerformanceMonitor |
Monitoring |
harry::Rendererharry::ResolveLatencyToken |
PlatformTestSupport |
TestSupport |
harry::TestConfigharry::TestDisplayConfig |
Penanganan error dan kesalahan
API yang diusulkan menggunakan jenis Result<> Rust. Rust mengharuskan Anda memeriksa jenis Result yang membawa error. Jika tidak, compiler akan menghasilkan peringatan atau error. Pemeriksaan waktu build menerapkan pemeriksaan error dari kode khusus platform.
Error yang ditampilkan oleh implementasi platform adalah jenis
harry::error::Error. Untuk memastikan bahwa jenis error platform tidak bocor ke kode
aplikasi, gunakan jenis error standar yang disediakan oleh framework HAR.
Jenis harry::error::Error diperluas untuk menyertakan error tertentu untuk semua subsistem:
// This is Rust
pub enum Error {
Msg(String), // A generic message string
// Legacy error type, likely to be removed or merged into Msg
Audio(String),
}
Error yang tidak dapat dipulihkan terutama ditampilkan melalui antarmuka dan callback yang ditentukan.
Desain mendetail suite pengujian
Bagian ini menjelaskan desain suite pengujian, yang memverifikasi implementasi abstraksi khusus platform.
Membangun pengujian suite pengujian
Untuk build Soong (ditentukan oleh file Android.bp), pengujian dikompilasi sebagai bagian
dari sistem build platform Android, dan eksekusinya dikelola oleh atest.
Menjalankan suite pengujian
Untuk menguji setiap platform, gunakan perintah atest dengan target pengujian yang relevan (misalnya, atest <module_name>). Perintah ini men-deploy dan menjalankan pengujian di perangkat atau emulator yang didukung Android.