Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
ee051075
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看板
未验证
提交
ee051075
编写于
6月 03, 2023
作者:
H
hhj
提交者:
Gitee
6月 03, 2023
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update zh-cn/application-dev/reference/native-api-intro.md.
Signed-off-by:
N
hhj
<
huanghuijin@huawei.com
>
上级
1ce54d60
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
16 addition
and
16 deletion
+16
-16
zh-cn/application-dev/reference/native-api-intro.md
zh-cn/application-dev/reference/native-api-intro.md
+16
-16
未找到文件。
zh-cn/application-dev/reference/native-api-intro.md
浏览文件 @
ee051075
# Native API(NDK)入门
Native API是OpenHarmony SDK上提供的一组native开发接口与工具集合(也称为NDK),方便开发者使用C或者C++语言实现应用的关键功能。Native API只覆盖了O
penHarmony基础的一些底层能力,如libc,图形库,窗口系统,多媒体,压缩库等,并没有完全提供类似于JS API上的完整的OpenHarmony
平台能力。在应用中使用Native API会编译成动态库打包到应用中。
Native API是OpenHarmony SDK上提供的一组native开发接口与工具集合(也称为NDK),方便开发者使用C或者C++语言实现应用的关键功能。Native API只覆盖了O
HOS基础的一些底层能力,如libc,图形库,窗口系统,多媒体,压缩库等,并没有完全提供类似于JS API上的完整的OHOS
平台能力。在应用中使用Native API会编译成动态库打包到应用中。
## 名词概念
|名词|名词解释|
|--|--|
|Native API|O
penHarmony
SDK里面native包提供的,面向三方应用开发的Native 接口以及相应编译脚本,编译工具链。包括C运行时基础库libc,3D图形库opengl,面向JS与C跨语言的接口Node-API等,具体内容详见下表。|
|NDK|Native Develop Kit的缩写,在O
penHarmony
上就是Native API;Native API是官方名字,NDK指代相同意思。|
|SDK CAPI|O
penHarmony Native API中的C语言接口,以及工具链部分,当前OpenHarmony
的Native API里面只包含C语言接口,因此Native API与CAPI意思一样,建议交流的时候使用CAPI,防止Native API与napi缩写混用。|
|Node-API|曾用名napi,是O
penHarmony
中提供JS与C跨语言调用的接口,是Native API接口中的一部分. 该接口在Node.js提供的Node-API基础上扩展而来,但不完全与Node.js中的Node-API完全兼容。 |
|napi|Node-API的曾用名,当前Node-API头文件中的接口仍然以napi_开头,
在OpenHarmony中统一用Node-API替换napi
。|
|Native API|O
HOS
SDK里面native包提供的,面向三方应用开发的Native 接口以及相应编译脚本,编译工具链。包括C运行时基础库libc,3D图形库opengl,面向JS与C跨语言的接口Node-API等,具体内容详见下表。|
|NDK|Native Develop Kit的缩写,在O
HOS
上就是Native API;Native API是官方名字,NDK指代相同意思。|
|SDK CAPI|O
HOS Native API中的C语言接口,以及工具链部分,当前OHOS
的Native API里面只包含C语言接口,因此Native API与CAPI意思一样,建议交流的时候使用CAPI,防止Native API与napi缩写混用。|
|Node-API|曾用名napi,是O
HOS
中提供JS与C跨语言调用的接口,是Native API接口中的一部分. 该接口在Node.js提供的Node-API基础上扩展而来,但不完全与Node.js中的Node-API完全兼容。 |
|napi|Node-API的曾用名,当前Node-API头文件中的接口仍然以napi_开头,
但是为了防止与Native API误用,不建议使用
。|
## Native API构成介绍
### Native API目录结构
...
...
@@ -18,18 +18,18 @@ Native API在SDK包的位置为$(SDK_ROOT)/native目录,主要有以下几个
|目录|功能说明|
|--|--|
|build|应用中编译动态库的toolchain cmake脚本;这个目录下ohos.toolchain.cmake文件定义了给O
penHarmony
交叉编译选项|
|build|应用中编译动态库的toolchain cmake脚本;这个目录下ohos.toolchain.cmake文件定义了给O
HOS
交叉编译选项|
|build-tools|放置编译构建的工具,如cmake|
|docs|Native API接口参考文档,通过doxgen从头文件中提取出来|
|llvm|支持O
penHarmony
ABI的llvm交叉编译器|
|llvm|支持O
HOS
ABI的llvm交叉编译器|
|sysroot|放置编译链接的依赖文件目录,包含头文件,动态库等|
### Native API接口
|接口分类|接口功能|引入版本|
|--|--|--|
|
标准C库
|以musl为基础提供的标准c库接口,当前提供了1500+的接口|8|
|
标准C++库
|c++运行时库libc++_shared,此库在打包的时候需要打包或者静态链接到应用中|8|
|
[
标准C库
](
third_party_libc/musl.md
)
|以musl为基础提供的标准c库接口,当前提供了1500+的接口|8|
|
[
标准C++库
](
third_party_libc/cpp.md
)
|c++运行时库libc++_shared,此库在打包的时候需要打包或者静态链接到应用中|8|
|日志|打印日志到系统的hilog接口|8|
|Node-API|ArkUI提供的,方便应用开发接入JS应用环境的一组类Node-API(也叫napi),是属于Native API的一部分|8|
|XComponent|ArkUI XComponent组件中的surface与触屏事件接口,方便开发者开发高性能图形应用|8|
...
...
@@ -47,7 +47,7 @@ Native API在SDK包的位置为$(SDK_ROOT)/native目录,主要有以下几个
*
《
[
Native API参考手册
](
./native-apis/Readme-CN.md
)
》,介绍各个API参考手册
*
《
[
Native API中支持的标准库
](
../reference/native-lib/Readme-CN.md
)
》,介绍Native API支持的开源标准库
*
《
[
Native API开发指南
](
../napi/Readme-CN.md
)
》,结合具体的例子,场景介绍各类接口的使用
*
《
[
使用NDK编译一个C
Make C/C++工程文档
](
../quick-start/howto-migrate-cmake-with-ohosndk.md
)
》,介绍如何使用使用Native API开发一个CM
ake工程
*
《
[
使用NDK编译一个C
make C/C++工程文档
](
../quick-start/howto-migrate-cmake-with-ohosndk.md
)
》,介绍如何使用使用Native API开发一个Cm
ake工程
*
《
[
Node-API在应用工程中的使用指导
](
../napi/napi-guidelines.md
)
》, 如何使用Node-API接口
...
...
@@ -63,10 +63,10 @@ Native API在SDK包的位置为$(SDK_ROOT)/native目录,主要有以下几个
### 不建议使用Native API的场景
1.
写一个纯native的的O
penHarmony
应用
2.
希望在尽可能多的O
penHarmony
设备上保持兼容的应用
1.
写一个纯native的的O
HOS
应用
2.
希望在尽可能多的O
HOS
设备上保持兼容的应用
##
调试
能力
##
维测
能力
1.
O
penHarmony
官方提供lldb remote方式代码调试,详细参看《
[
lldb参考手册
](
https://gitee.com/openharmony/third_party_llvm-project/blob/master/lldb/README_zh.md
)
》
2.
musl库的log维测能力,请参看
[
libc库
](
./native-lib/third_party_libc/musl.md
)
调试能力
章节
1.
O
HOS
官方提供lldb remote方式代码调试,详细参看《
[
lldb参考手册
](
https://gitee.com/openharmony/third_party_llvm-project/blob/master/lldb/README_zh.md
)
》
2.
musl库的log维测能力,请参看
[
libc库
](
./native-lib/third_party_libc/musl.md
)
维测
章节
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录