Guia de migração do HIDL VHAL

Para migrar uma implementação de VHAL HIDL para uma VHAL AIDL, use a estrutura de implementação de referência da AIDL para implementar a interface IVehicleHardware.

Se a implementação atual de HIDL também seguir a implementação de referência de HIDL, o fornecedor implementou a classe VehicleHal. IVehicleHardware é muito semelhante a VehicleHal.

HIDL VHAL VHAL AIDL
getAllPropertyConfigs() Igual ao hotel VehicleHal.listProperties()
getValues(callback, requests) Pode chamar VehicleHal.get() para cada solicitação e pode chamar callbacks.
dump() Igual ao hotel VehicleHal.dump()
checkHealth() Pode devolver VehicleHal.get()
registerPropertyChangeCallback() Semelhante à configuração VehicleHal.mOnHalEvent

Diferenças entre os tipos na AIDL

Ao migrar da VHAL da HIDL para a VHAL da AIDL, considere essas diferenças.

  1. O HIDL gera um arquivo de cabeçalho (types.h) para todos os tipos gerados a partir de types.hal. O AIDL gera um arquivo de cabeçalho para cada tipo. Por exemplo, VehiclePropValue.h de VehiclePropValue.aidl.

    Como resultado, é necessário incluir todos os arquivos de cabeçalho dos tipos necessários. Um arquivo auxiliar, VehicleHalTypes.h na biblioteca VehicleHalUtils, contém a maioria dos tipos comuns.

    2. Em vez de ... Uso
    hidl_vec std::vector
    hidl_string std::string
    android::sp std::shared_ptr
    android::wp std::weak_ptr
  2. Todos os tipos definidos em types.hal são iguais no AIDL exceto:
    • SubscribeFlags foi removido porque não é usado, já que onPropertySet foi removido
    • UserFlags agora é definido em UserInfo.aidl e precisa ser definido como uma flag em vez de um tipo enumerado. Um campo de flag do usuário é um número inteiro que tem vários UserInfo.USER_FLAG_XXX bits-ou juntos.
    • RawValue em VehiclePropValue foi renomeado como RawPropValue
    • bytes em RawValue foi renomeado como byteValues.