Panduan migrasi HIDL VHAL

Untuk memigrasikan implementasi VHAL HIDL yang ada ke VHAL AIDL, gunakan struktur implementasi referensi AIDL untuk mengimplementasikan antarmuka IVehicleHardware.

Jika implementasi HIDL yang ada juga mengikuti implementasi referensi HIDL, vendor telah mengimplementasikan class VehicleHal. IVehicleHardware sangat mirip dengan VehicleHal.

HIDL VHAL	AIDL VHAL
getAllPropertyConfigs()	Sama seperti VehicleHal.listProperties()
getValues(callback, requests)	Dapat memanggil VehicleHal.get() untuk setiap permintaan dan dapat memanggil callback.
dump()	Sama seperti VehicleHal.dump()
checkHealth()	Dapat menampilkan VehicleHal.get()
registerPropertyChangeCallback()	Mirip dengan menetapkan VehicleHal.mOnHalEvent

Perbedaan jenis di AIDL

Saat bermigrasi dari HIDL VHAL ke AIDL VHAL, pertimbangkan perbedaan berikut.

1. HIDL menghasilkan satu file header (types.h) untuk semua jenis yang dihasilkan dari types.hal. AIDL menghasilkan satu file header untuk setiap jenis. Misalnya, VehiclePropValue.h dari VehiclePropValue.aidl.

   Oleh karena itu, Anda harus menyertakan semua file header untuk jenis yang Anda butuhkan. File helper, VehicleHalTypes.h di library VehicleHalUtils berisi sebagian besar jenis umum.

Jangan gunakan ...	Gunakan
hidl_vec	std::vector
hidl_string	std::string
android::sp	std::shared_ptr
android::wp	std::weak_ptr

2. Semua jenis yang ditentukan dalam types.hal sama di AIDL kecuali untuk:
   • SubscribeFlags dihapus karena tidak digunakan karena onPropertySet dihapus
   • UserFlags kini ditentukan dalam UserInfo.aidl dan harus ditentukan sebagai flag, bukan enum. Kolom flag pengguna adalah bilangan bulat yang memiliki beberapa UserInfo.USER_FLAG_XXX bit-or bersama-sama.
   • RawValue di VehiclePropValue diganti namanya menjadi RawPropValue
   • bytes di RawValue diganti namanya menjadi byteValues