HIDL_interface_hashing

概述

l  每一个接口文件对应一个.hal文件

l  保护接口文件不被轻易修改。如果修改，编译就会报错，同时会生成一个修改后hashing值

l  确保接口变化得到充分审查

布局

      每一个包根目录下都有一个current.txt文件。例如android.hardware对应hardware/interfaces。

这个文件包含了发布的所有接口文件即.hal文件以及对应的hashing值。

Hashing产生

1.    手动添加hash到current.txt

.hal文件修改后，编译会报错同时生成修改后的hash值，可以手动添加到current.txt。

2.    hidl-gen 

注意：不要替换前一个已发布的接口hash值。如果修改的化，只需要在current.txt文件的末尾追加即可。

每一个接口都可以通过调用IBase::getHashChain 获取对应的hash。

hidl-gen在编译接口时，会在其对应的根目目录下检查current.txt

l  没有找到，接口不发布，编译跳过

l  Hash不匹配，编译终止，修改current.txt

1.    对于ABI允许的修改，可以修改current.txt。

2.    ABI不允许的修改，需要在接口的次版本号或主版本号更新中修改。

ABI stability

 

ABI: Application Binary Interface 。包含了二级制链接、函数调用约定等。如果ABI/API变化，那基于标准接口编译的system.img，可能无法使用该接口功能。

接口版本化和ABI 稳定性是必要的：

l  通过VTS

l  System 独立 OTA

l  作为OEM，提供一个容易使用和兼任的BSP版本

l  通过current.txt可以了解接口的发布历史记录

当在current.txt为一个存在的接口添加一个新的hash时，为了确保ABI stability，需要审查下面的修改类型：

对于已发布的接口，ABIstability列出了哪些修改允许哪些不允许，对于不允许的修改只能在接口的次版本号或主版本号更新中修改。