Android HIDL 编程规范

目录

命名规范

目录结构和文件命名

软件包名称

版本

导入

完全限定名称 (FQN)

完全限定名称的自动推理

接口名称

函数

结构体/联合字段名称

类型名称

枚举值

备注

文件备注

TODO 备注

接口/函数备注（文档字符串）

格式

软件包声明

函数声明

注释

枚举声明

结构体声明

数组声明

矢量

---

HIDL 代码样式类似于 Android 框架中的 C++ 代码，缩进 4 个空格，并且采用混用大小写的文件名。软件包声明、导入和文档字符串与 Java 中的类似，只有些微差别。

下面针对 IFoo.hal 和 types.hal 的示例展示了 HIDL 代码样式，并提供了指向每种样式（IFooClientCallback.hal、IBar.hal 和 IBaz.hal 已省略）详细信息的快速链接。

hardware/interfaces/foo/1.0/IFoo.hal

/*
 * (License Notice)
 */

package android.hardware.foo@1.0;

import android.hardware.bar@1.0::IBar;

import IBaz;
import IFooClientCallback;

/**
 * IFoo is an interface that…
 */
interface IFoo {

    /**
     * This is a multiline docstring.
     * @return result 0 if successful, nonzero otherwise.
     */
     foo() generates (FooStatus result);

    /**
     * Restart controller by power cycle.
     * @param bar callback interface that…
     * @retu