Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
4d24f4de
D
Docs
项目概览
OpenHarmony
/
Docs
1 年多 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
提交
4d24f4de
编写于
9月 24, 2021
作者:
Z
zhangyongzhi
提交者:
Gitee
9月 24, 2021
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update zh-cn/design/OpenHarmony-API-governance.md.
Signed-off-by:zhangyongzhi<zhangyongzhi@huawei.com>
上级
4cb0318a
变更
1
显示空白变更内容
内联
并排
Showing
1 changed file
with
5 addition
and
7 deletion
+5
-7
zh-cn/design/OpenHarmony-API-governance.md
zh-cn/design/OpenHarmony-API-governance.md
+5
-7
未找到文件。
zh-cn/design/OpenHarmony-API-governance.md
浏览文件 @
4d24f4de
...
...
@@ -21,10 +21,9 @@ OpenHarmony API按可授权使用方分类包括:
<p>
如无特别说明,本章程定义的条款同时适用于Public API、System API或Test API等三种OpenHarmony API。针对System API和Test API的额外要求或例外说明,通过特别说明方式加以补充说明。
</p>
OpenHarmony API按编程语言分类包括:
-
Java API:面向应用开放的Java编程语言接口。
-
JS API:面向应用开放的JavaScript编程语言接口。
-
Native API:面向应用开放的C/C++编程语言接口。
<p>
如无特别说明,本章程定义的条款同时适用于J
ava API、JS API和Native API等三种编程语言OpenHarmony
API。
</p>
<p>
如无特别说明,本章程定义的条款同时适用于J
S API和Native
API。
</p>
## API治理
...
...
@@ -65,7 +64,7 @@ API评审流程如下:
针对变更API,需要额外包含如下要素:
1.
针对老接口的处理方式(废弃、隐藏或彻底删除)以及对使用老SDK开发应用的兼容措施(必须);
2.
变更影响、替代接口和相应的应用适配方案(必须)。
3.
刷新ChangeLog(必须) 和 API-diff文档(涉及JS/Native API变更,必须
;Java API的差异报告可工具化生成,不需要人工提交
)。
3.
刷新ChangeLog(必须) 和 API-diff文档(涉及JS/Native API变更,必须)。
## API设计要求
### 一致性要求
...
...
@@ -90,10 +89,9 @@ API评审流程如下:
1.
作用域越大,命名应越精确。
1.
不用或少用缩写,业界通用术语遵从行业习惯允许使用缩写。
1.
包名/模块名/命名空间前缀约定:
1.
Java API 统一包名: package ohos.
\*
。
2.
JS API 统一模块名:@ohos.
\*
。
3.
Native API 统一命名空间:namespace OHOS.
\*
。
4.
引用外部开源代码的,可以保留原包名/模块名/命名空间,也可以按照上述规则对包名统一进行替换。
1.
JS API 统一模块名:@ohos.
\*
。
2.
Native API 统一命名空间:namespace OHOS.
\*
。
3.
引用外部开源代码的,可以保留原包名/模块名/命名空间,也可以按照上述规则对包名统一进行替换。
1.
包名/模块名/命名空间最短不少于2段,最长不超过4段;每一段建议使用一个单词,最长不超过2个单词。
1.
类名、方法名/函数名、成员变量、变量名最多不超过4个单词。
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录