HIDL最全编译流程

最新推荐文章于 2023-08-06 07:53:38 发布

weixin_43957839

最新推荐文章于 2023-08-06 07:53:38 发布

阅读量966

点赞数 1

分类专栏： Android

原文链接：https://blog.csdn.net/u013357557/article/details/84561652

版权

Android 专栏收录该内容

6 篇文章 2 订阅

订阅专栏

想了解HIDL介绍的可以参考《HIDL概述》，本篇文章主要介绍HIDL的详细编译流程及简单的客户端应用（C++跟Android客户端的应用）。

一、准备工作

整一套源码，Android O或者Android P的
保证全套代码已经全编译，原生代码全编译命令

source build/envset.sh
lunch
make

3、hidl-gen工具已经安装，安装命令

make hidl-gen

二、hidl-gen工具介绍

系统定义的所有的.hal接口，都是通过hidl-gen工具转换成对应的代码。hidl-gen源码路径：system/tools/hidl，是在ubuntu上可执行的二进制文件。

使用方法：hidl-gen -o output-path -L language (-r interface-root) fqname

例子：

hidl-gen -o hardware/interfaces/gunder/1.0/default/ -Lc++-impl -randroid.hardware:hardware/interfaces -randroid.hidl:system/libhidl/transport android.hardware.gunder@1.0

参数说明：

-L：语言类型，包括c++, c++-headers, c++-sources, export-header, c++-impl, java, java-constants, vts, makefile, androidbp, androidbp-impl, hash等。hidl-gen可根据传入的语言类型产生不同的文件。
fqname：完全限定名称的输入文件。比如本例中android.hardware.gunder@1.0，要求在源码目录下必须有hardware/interfaces/ gunder /1.0/目录。对于单个文件来说，格式如下：package@version::fileName，比如android.hardware. gunder @1.0::types.Feature。对于目录来说。格式如下package@version，比如android.hardware. gunder @1.0。
-r：格式package:path，可选，对fqname对应的文件来说，用来指定包名和文件所在的目录到Android系统源码根目录的路径。如果没有制定，前缀默认是：android.hardware，目录是Android源码的根目录。
-o：存放hidl-gen产生的中间文件的路径。

可以使用hidl-gen 查看帮助，如图1：

图1 hidl-gen的帮助信息

三、项目实例

1、在hardware/interfaces/目录下新建gunder/1.0目录，并在1.0目录中创建接口IGunder.hal。目录结构如下：

gunder@ubuntu-MX8:~ /IMX8_b0beta2/hardware/interfaces/gunder$ tree

└── 1.0

└── IGunder.hal

IGunder.hal文件里面只有一个接口IGunder和一个方法helloWorld(string name)，具体实现如下：


    
    
      
      
       
       
      
      
      
      
       
       
        
        package android.hardware.gunder@
        
        1.0;
       
       
      
      

      
      
       
       
      
      
      
      
       
        
       
       
      
      

      
      
       
       
      
      
      
      
       
       
        
        interface IGunder{
       
       
      
      

      
      
       
       
      
      
      
      
       
       
        
        	helloWorld(
        
        string name) generates (
        
        string result);
       
       
      
      

      
      
       
       
      
      
      
      
       
       
        
        };

2、执行下面三条命令会自动生成对应的c++文件；

PACKAGE=android.hardware.gunder@1.0
LOC=hardware/interfaces/gunder/1.0/default/
hidl-gen -o $LOC -Lc++-impl -randroid.hardware:hardware/interfaces -randroid.hidl:system/libhidl/transport $PACKAGE

执行命令后的目录结构如下：

gunder@ubuntu-MX8:~ /IMX8_b0beta2$ PACKAGE=android.hardware.gunder@1.0

gunder@ubuntu-MX8:~ /IMX8_b0beta2$ LOC=hardware/interfaces/gunder/1.0/default/

gunder@ubuntu-MX8:~ /IMX8_b0beta2$ hidl-gen -o $LOC -Lc++-impl -randroid.hardware:hardware/interfaces -randroid.hidl:system/libhidl/transport $PACKAGE

gunder@ubuntu-MX8:~ /IMX8_b0beta2/hardware/interfaces/gunder$ tree

└── 1.0

├── default

│ ├── Gunder.cpp

│ └── Gunder.h

└── IGunder.hal

default 是新生成的目录，Gunder.cpp和Gunder.h是新生成的两个文件，打开Gunder.h文件，去掉// extern "C" IGunder* HIDL_FETCH_IGunder(const char* name);前面的注释，使用直通式HAL（Passthrough 模式）来通信。Gunder.h文件修改后如图2：

图2 Gunder.h修改后的内容

Gunder.cpp文件也要进行对应的修改，修改后如如图3：

图3 Gunder.cpp修改后的内容

3、执行下面命令

hidl-gen -o $LOC -Landroidbp-impl -randroid.hardware:hardware/interfaces -randroid.hidl:system/libhidl/transport $PACKAGE

会在hardware/interfaces/gunder/1.0/default目录生成Android.bp文件。

gunder@ubuntu-MX8:~ /IMX8_b0beta2/hardware/interfaces/gunder$ tree

└── 1.0

├── default

│ ├── Android.bp

│ ├── Gunder.cpp

│ └── Gunder.h

└── IGunder.hal

4、然后使用脚本update-makefiles.sh来更新Makefile，自动在hardware/interfaces/gunder/1.0目录生成Android,mk和 Android.bp，hardware/interfaces/gunder目录生成Android.bp。命令如下

./hardware/interfaces/update-makefiles.sh

执行完命令后目录结构如下：

gunder@ubuntu-MX8:~/IMX8_b0beta2$ ./hardware/interfaces/update-makefiles.sh

gunder@ubuntu-MX8:~/IMX8_b0beta2/hardware/interfaces/gunder$ tree

├── 1.0

│ ├── Android.bp

│ ├── Android.mk

│ ├── default

│ │ ├── Android.bp

│ │ ├── Gunder.cpp

│ │ └── Gunder.h

│ └── IGunder.hal

└── Android.bp

5、在hardware/interfaces/gunder/1.0/default目录下新建service.cpp跟android.hardware.gunder@1.0-service.rc，其中android.hardware.gunder@1.0-service.rc是程序的入口函数。新的目录结构如下：

├── 1.0

│ ├── Android.bp

│ ├── Android.mk

│ ├── default

│ │ ├── Android.bp

│ │ ├── android.hardware.gunder@1.0-service.rc

│ │ ├── Gunder.cpp

│ │ ├── Gunder.h

│ │ └── service.cpp

│ └── IGunder.hal

└── Android.bp

android.hardware.gunder@1.0-service.rc的实现如图：

service.cpp的实现如图：

打开hardware/interfaces/gunder/1.0/default目录下的Android.bp，添加编译service.cpp成为可执行文件的代码。具体添加内容如下：

到此跟HAL相关的代码就实现完了。

6、编译生成服务端跟客户端要用各种库文件。首先执行下面两条命令

./hardware/interfaces/update-makefiles.sh
mmm hardware/interfaces/gunder/1.0/

执行后会生成下面的文件：

out/target/product/mek_8q/system/lib64/android.hardware.gunder@1.0.so

out/target/product/mek_8q/vendor/lib64/hw/android.hardware.gunder@1.0-impl.so

out/target/product/mek_8q/vendor/etc/init/android.hardware.gunder@1.0-service.rc

7、在manifest文件里添加vendor接口的定义编译device/fsl/mek_8q/manifest.xml文件（不同厂家路径可能不一样），添加以下内容，不然在client端是没法拿到service的。如下：

8、使用C++实现客户端调用

在hardware/interfaces/gunder/1.0目录下新建test目录，并且在test目录下新建Android.bp跟GunderTest.cpp文件，这两个文件的内容如下：

GunderTest.cpp：

Android.bp：

执行以下命令：

./hardware/interfaces/update-makefiles.sh
mmm hardware/interfaces/gunder/1.0/

执行第一条命令是为了更新hardware/interfaces/gunder/目录下的Android.bp文件，如下：

执行第二条命令会生成可执行文件：

out/target/product/mek_8q/vendor/bin/hw/gunder_client

9、使用JAVA实现客户端调用

为了方便eclipse或者Android Studio调用接口函数，需要编译出classes.jar包。但是jack编译出来的文件是classes.jack。如图：

为了编译出classes.jar，需要打开hardware/interfaces/gunder/1.0目录的Android.mk，在include $(CLEAR_VARS)下面添加LOCAL_JACK_ENABLED := disabled。这样编译的时候就不走jack编译了。如下：

执行下面命令

mmm hardware/interfaces/gunder/1.0/

执行完后生成了classes.jar。如图：

新建Android项目HIDLdemo，将classes.jar导入项目，MainActivity代码实现如下：

添加Android.mk文件，然后将项目放到packages/apps/进行编译。Android.mk文件内容如下：

执行命令

mmm packages/apps/HIDLdemo

会生成out/target/product/mek_8q/system/app/HIDLdemo/HIDLdemo.apk

10、测试客户端程序

执行下列命令：

adb push X:\IMX8_b0beta2\out\target\product\mek_8q\vendor\lib64\hw\android.hardware.gunder@1.0-impl.so /vendor/lib64/hw
adb push X:\IMX8_b0beta2\out\target\product\mek_8q\system\lib64\android.hardware.gunder@1.0.so /system/lib64
adb push X:\IMX8_b0beta2\out\target\product\mek_8q\vendor\bin\hw\gunder_client /vendor/bin/hw
adb push X:\IMX8_b0beta2\out\target\product\mek_8q\vendor\bin\hw\android.hardware.gunder@1.0-service /vendor/bin/hw
adb push X:\IMX8_b0beta2\device\fsl\evk_8mq\manifest.xml /vendor
adb install -r X:\IMX8_b0beta2\out\target\product\ mek_8q \system\app\HIDLdemo\HIDLdemo.apk

上面的命令是将需要的文件push到系统，方便调试。

C++客户端调试：

先启动./android.hardware.gunder@1.0-service服务，然后启动gunder_client程序，执行结果如下：