From dc630b96b95ff7821bb8f309800e4512bf2e7913 Mon Sep 17 00:00:00 2001 From: ningning <3248127340@qq.com> Date: Thu, 8 Jun 2023 18:05:49 +0800 Subject: [PATCH] update docs Signed-off-by: ningning <3248127340@qq.com> --- zh-cn/application-dev/Readme-CN.md | 1 + zh-cn/application-dev/napi/Readme-CN.md | 1 - zh-cn/application-dev/napi/introduction.md | 52 ---------------------- zh-cn/application-dev/website.md | 7 +++ 4 files changed, 8 insertions(+), 53 deletions(-) delete mode 100644 zh-cn/application-dev/napi/introduction.md diff --git a/zh-cn/application-dev/Readme-CN.md b/zh-cn/application-dev/Readme-CN.md index f7066040be..405f097148 100644 --- a/zh-cn/application-dev/Readme-CN.md +++ b/zh-cn/application-dev/Readme-CN.md @@ -97,6 +97,7 @@ - [应用测试](application-test/Readme-CN.md) - [一次开发，多端部署](key-features/multi-device-app-dev/Readme-CN.md) - [IDL工具规格及使用说明书](IDL/idl-guidelines.md) + - [Native API的相关指导](napi/Readme-CN.md) - 工具 - [DevEco Studio（OpenHarmony）使用指南](quick-start/deveco-studio-user-guide-for-openharmony.md) - [调试工具](tools/Readme-CN.md) diff --git a/zh-cn/application-dev/napi/Readme-CN.md b/zh-cn/application-dev/napi/Readme-CN.md index 9af3ee7711..752a456fca 100644 --- a/zh-cn/application-dev/napi/Readme-CN.md +++ b/zh-cn/application-dev/napi/Readme-CN.md @@ -1,6 +1,5 @@ # Native API的相关指导 -- [Native API介绍](introduction.md) - [Native API在应用工程中的使用指导](napi-guidelines.md) - [Drawing开发指导](drawing-guidelines.md) - [Rawfile开发指导](rawfile-guidelines.md) diff --git a/zh-cn/application-dev/napi/introduction.md b/zh-cn/application-dev/napi/introduction.md deleted file mode 100644 index 4603c8fd58..0000000000 --- a/zh-cn/application-dev/napi/introduction.md +++ /dev/null @@ -1,52 +0,0 @@ -# Native API介绍 - -Native API是OHOS SDK上提供的一组native开发接口与工具集合，方便开发者使用C或者C++语言实现应用的关键功能。Native API只覆盖了OHOS基础的一些底层能力，如libc，图形库，窗口系统，多媒体，压缩库等，并没有完全提供类似于JS API上的完整的OHOS 平台能力。在应用中使用Native API会编译成动态库打包到应用中。 - -## Native API构成介绍 - -### Native API目录结构 - -Native API在SDK包的位置为$(SDK_ROOT)/native目录，主要有以下几个部分组成 - -|目录|功能说明| -|--|--| -|build|应用中编译动态库的toolchain cmake脚本；这个目录下ohos.toolchain.cmake文件定义了给OHOS交叉编译选项| -|build-tools|放置编译构建的工具，如cmake| -|docs|Native API接口参考文档，通过doxgen从头文件中提取出来| -|llvm|支持OHOS ABI的llvm交叉编译器| -|sysroot|放置编译链接的依赖文件目录，包含头文件，动态库等| - -### Native API接口 - -|接口分类|接口功能|引入版本| -|--|--|--| -|标准C库|以musl为基础提供的标准c库接口，当前提供了1500+的接口|8| -|标准C++库|c++运行时库libc++_shared，此库在打包的时候需要打包或者静态链接到应用中|8| -|日志|打印日志到系统的hilog接口|8| -|napi|ArkUI提供的，方便应用开发接入JS应用环境的一组类Node-API，是属于Native API的一部分|8| -|XComponent|ArkUI XComponent组件中的surface与触屏事件接口，方便开发者开发高性能图形应用|8| -|libuv|ArkUI集成的三方的异步IO库|8| -|libz|zlib库，提供基本的压缩，解压接口|8| -|Drawing|系统提供的2D图形库，可以在surface进行绘制|8| -|OpenGL|系统提供的openglv3接口|8| -|Rawfile|应用资源访问接口，可以读取应用中打包的各种资源|8| -|OpenSLES|用于2D，3D音频加速的接口库|8| -|Mindspore|AI模型接口库|9| -|包管理|包服务接口，方便查询应用包信息|8| - -Native API中有一部分接口采用开源标准，详细列表见《[Native API中支持的标准库](../reference/native-lib/third_party_libc/musl.md)》《[Node_API](../reference/native-lib/third_party_napi/napi.md)》 - -## 使用介绍 - -### 建议使用Native API的场景 - -主要有如下一些 - -1. 应用性能敏感代码，比如游戏，物理模拟等计算密集型场景 -2. 需要复用已有的C或C++库 -3. 需要针对CPU特性进行专项定制的库，如neon加速 - -### 不建议使用Native API的场景 - -1. 写一个纯native的的OHOS应用 -2. 希望在尽可能多的OHOS设备上保持兼容的应用 diff --git a/zh-cn/application-dev/website.md b/zh-cn/application-dev/website.md index 3a911b8660..136ac25003 100644 --- a/zh-cn/application-dev/website.md +++ b/zh-cn/application-dev/website.md @@ -653,6 +653,13 @@ - [案例应用](key-features/multi-device-app-dev/case.md) - [常见问题](key-features/multi-device-app-dev/faq.md) - [IDL工具规格及使用说明书](IDL/idl-guidelines.md) + - Native API的相关指导 + - [Native API在应用工程中的使用指导](napi/napi-guidelines.md) + - [Drawing开发指导](napi/drawing-guidelines.md) + - [Rawfile开发指导](napi/rawfile-guidelines.md) + - [NativeWindow开发指导](napi/native-window-guidelines.md) + - [使用MindSpore Lite引擎进行模型推理](napi/mindspore-lite-guidelines.md) + - [Neural Network Runtime对接AI推理框架开发指导](napi/neural-network-runtime-guidelines.md) - 工具 - [DevEco Studio（OpenHarmony）使用指南](quick-start/deveco-studio-user-guide-for-openharmony.md) - 调试工具 -- GitLab