用途:在用户要求设计 ArkUI API、添加组件属性、创建 Modifier 方法、审查 ArkUI API 或废弃 API 时提供指导,帮助产出符合 OpenHarmony 应用 TypeScript/JavaScript 编码规范的组件 API。
主要能力:遵循命名与类型安全等编码标准;同步静态接口(arkui/component/.static.d.ets)与动态接口(@internal/component/ets/.d.ts),新增或修改属性时两者都要更新,并分别使用 @since X static 与 @since X dynamic 标签;判断哪些可配置属性需要支持 Resource 类型,新 API(API 13+)使用 ResourceStr,既有 API(API 12 及更早)保持 string | Resource 以兼容;在 JSDOC 中说明 undefined/null 行为、取值范围、单位与截断规则;长度默认使用 vp;评估公共属性对跨组件的影响;区分事件回调与属性设置方法的措辞,仅事件回调和生命周期方法使用 Called when;只修改 interface/ 目录内文件,不改 ace_engine/ 等框架实现。
使用方式:按设计 API、创建静态接口、创建动态接口、验证类型安全、构建 SDK、验证输出的流程操作;具体构建命令资料未提供。
适用场景:ArkUI 组件 API 的新增、修改、废弃与审查。
限制:资料未提供具体构建命令、版本号细节与完整示例;不得修改框架实现代码。