Qt IF Android车辆属性库是Qt Android Automotive车辆模块的一部分。这些自动生成的库基于相似的Qt IF车辆功能。

访问车辆属性的接口由一个QFace配置文件定义，它覆盖了Android Automotive 车辆属性。该接口描述用于生成各种前端和后端，这些前端和后端可以用于访问车辆数据或进行开发中的模拟。该解决方案基于来自Qt接口框架生成器的模板以及我们在Qt Android Automotive车辆模块中实现的自己的Qt IF生成器扩展。

工作原理

生成的后端之一，Qt for Android Automotive JNI后端促进了直接访问Android Automotive车辆属性。生成一个C++前端以访问多个后端访问车辆数据。还生成一个Qt Quick插件，通过使用QML语言实现相同的功能。

可用的车辆属性集合，这些属性按功能组件分组，由QFace配置文件以及一个YAML注释文件（YAML注释）定义。这两个文件反映了在AOSP源代码（VHAL v2.0）中定义的Android车辆属性，并定义了属性ID映射以及区域配置。因此，修改此接口需要反映在提到的文件中，然后从源代码重新构建这些库。

模块结构

车辆属性包括以下组件

• 车辆属性前端：一个包含QFace格式中定义的接口功能的库。
• 车辆属性QML插件：负责在Qt Quick应用程序和Qt IF车辆属性前端之间进行接口操作。
• 车辆属性JNI后端：一个专门实现能与后端服务（直接访问Android汽车API的那个）交互的实现。

车辆属性按以下组件分组

如何使用它

前端库可以通过直接与C++代码交互或使用QML插件来使用。要在C++代码级别使用插件，请遵循Qt IF车辆功能模块中描述的步骤。（请注意，C++代码是在默认的Qt命名空间下生成的，如在Qt在命名空间内。）使用QML插件的示例由车辆属性浏览器示例展示。通过以下步骤将此库集成到您的项目中

1. 如果使用qmake，请将Qt IF Android车辆属性前端依赖项添加到您的qmake项目文件（*.pro）中

   QT += ifandroidvehicleproperties interfaceframework

   如果使用CMake

   find_package(Qt6 COMPONENTS InterfaceFramework)
   find_package(Qt6 COMPONENTS IfAndroidVehicleProperties)
   
   target_link_libraries(my_target PUBLIC
       Qt::InterfaceFramework
       Qt::IfAndroidVehicleProperties
   )

2. 将android运行时环境补充依赖库的路径添加到CMake中。对于qmake使用以下代码

   ANDROID_PACKAGE_SOURCE_DIR = $$PWD/android

   对于CMake使用以下代码

   set_property(TARGET my_target PROPERTY QT_ANDROID_PACKAGE_SOURCE_DIR
                ${CMAKE_CURRENT_SOURCE_DIR}/android)

   注意：为了在Android上设置目标属性，请按CMake手册中的finalization所述使用MANUAL_FINALIZATION。

3. 在AndroidManifest.xml文件中添加访问VHAL属性的适当权限（例如，对于HVAC将是CONTROL_CAR_CLIMATE）

   <uses-permission android:name="android.car.permission.CONTROL_CAR_CLIMATE"/>

4. 在QML文件中添加此插件的导入语句

   import QtIf.Android.VehicleProperties

5. 在QML中定义所需组件的实例（例如，HVAC）

   HVAC { id: climateControl }

6. 与车辆属性的交互与任何其他典型Qt属性相同

   onClicked: {
       climateControl.setHvacAcOn(!climateControl.hvacAcOn)
   }
   text: climateControl.hvacAcOn ? "AC ON" : "AC OFF"

7. 如果车辆有区域接口，则与属性的交互需要指向特定区域（请参阅区域HVAC控制）。

与此库相关的示例

• 车辆属性浏览器

已知问题和限制

1. 目前，为了部署使用本模块的应用程序，需要采取额外措施以满足依赖关系
   1. 通过在gradle.properties文件中添加android.useAndroidX=true来启用AndroidX
   2. 将android.car.jar包添加到APK中

   有关更多信息，请参阅在Android上部署应用程序。

2. Android构建必须与本模块使用的车辆接口定义保持一致，并且必须与APK一起提供适当的android.car.jar包，如车辆属性浏览器示例中所示。
3. 此库的当前版本使用JNI后端来访问Android Car服务。要使用Qt Remote Objects后端，库需要对源代码进行调整。
4. 属性fuelDoorOpen在Android 10上是只读的，但从Android 11开始可以写入。
5. 静态车辆属性在模拟器中不会对更改做出反应。静态属性应在生产期间由汽车制造商一次性设置，因此Android Automotive不会广播其更改。这些属性包括
   1. QIfCarInfo.infoModelYear (INFO_MODEL_YEAR)
   2. QIfCarInfo.infoFuelCapacity (INFO_FUEL_CAPACITY)
   3. QIfCarInfo.infoEvBatteryCapacity (INFO_EV_BATTERY_CAPACITY)
   4. QIfCarInfo.infoFuelDoorLocation (INFO_FUEL_DOOR_LOCATION)
   5. QIfCarInfo.infoEvPortLocation (INFO_EV_PORT_LOCATION)
   6. QIfCarInfo.infoDriverSeat (INFO_DRIVER_SEAT)

   Android Automotive静态属性的全列表可在以下AOSP：车辆属性源代码中找到AOSP: 车辆属性源代码。