1# ArkTSNode-API使用场景 2 3### 介绍 4 5开发者通过pthread_create创建新线程后，可以通过napi_create_ark_runtime来创建一个新的ArkTS基础运行时环境，并通过该运行时环境加载ArkTS模块。当使用结束后，开发者需要通过napi_destroy_ark_runtime来销毁所创建的ArkTS基础运行时环境。 6 7napi_create_threadsafe_function是Node-API接口之一，用于创建一个线程安全的JavaScript函数。主要用于在多个线程之间共享和调用，而不会出现竞争条件或死锁。例如异步计算、数据共享、多线程编程场景。 8 9Node-API中的napi_call_threadsafe_function_with_priority接口的功能是从异步线程向ArkTS线程投递任务，底层队列会根据任务的优先级和入队方式来处理任务。 10 11在自己创建的ArkTS运行环境中调用异步的ArkTS接口时，可以通过使用Node-API中的扩展接口napi_run_event_loop和napi_stop_event_loop来运行和停止ArkTS实例中的事件循环，该工程中展示的代码详细描述可查如下链接。 12 13- [使用Node-API接口创建ArkTS运行时环境](https://docs.openharmony.cn/pages/v5.0/zh-cn/application-dev/napi/use-napi-ark-runtime.md) 14- [使用Node-API接口进行线程安全开发](https://docs.openharmony.cn/pages/v5.0/zh-cn/application-dev/napi/use-napi-thread-safety.md) 15- [使用Node-API接口从异步线程向ArkTS线程投递指定优先级和入队方式的的任务](https://docs.openharmony.cn/pages/v5.0/zh-cn/application-dev/napi/use-call-threadsafe-function-with-priority.md) 16- [使用扩展的Node-API接口在异步线程中运行和停止事件循环](https://docs.openharmony.cn/pages/v5.0/zh-cn/application-dev/napi/use-napi-event-loop.md) 17 18### 效果预览 19 20| 首页 | 执行结果图 | 21| ------------------------------------------------------------ | ------------------------------------------------------------ | 22| <img src="./screenshots/NodeApiApplicationScenario1.png" style="zoom: 50%;" /> | <img src="./screenshots/NodeApiApplicationScenario2.png" style="zoom: 50%;" /> | 23 24### 使用说明 25 261. 运行Index主界面。 272. 页面呈现上述首页效果，分别点击button组件可以执行对应文本内容的Node-API接口并将文本NodeAPI改为执行成功结果。 283. 运行测试用例NodeApiApplicationScenario.test.ets文件对页面代码进行测试可以全部通过。 29 30### 工程目录 31 32``` 33entry/src/ 34 ├── main 35 │ ├── cpp 36 │ │ ├── types 37 │ │ ├── libentry 38 │ │ ├── Index.d.ts 39 │ │ ├── oh-package.json5 40 │ │ ├── libentry1 41 │ │ ├── Index.d.ts 42 │ │ ├── oh-package.json5 43 │ │ ├── CMakeLists.txt 44 │ │ ├── napi_init.cpp 45 │ │ ├── thread_safety.cpp 46 │ ├── ets 47 │ │ ├── entryability 48 │ │ ├── entrybackupability 49 │ │ ├── pages 50 │ │ ├── Index.ets // Node-API使用场景 51 │ ├── module.json5 52 │ └── resources 53 ├── ohosTest 54 │ ├── ets 55 │ │ └── test 56 │ │ ├── Ability.test.ets 57 │ │ ├── NodeApiApplicationScenario.test.ets // 自动化测试代码 58 │ │ └── List.test.ets 59``` 60 61### 相关权限 62 63不涉及。 64 65### 依赖 66 67不涉及。 68 69### 约束与限制 70 711.本示例仅支持标准系统上运行, 支持设备：RK3568。 72 732.本示例为Stage模型，支持API14版本SDK，版本号：5.0.2.57，镜像版本号：OpenHarmony_5.0.2.58。 74 753.本示例需要使用DevEco Studio 5.0.1 Release (Build Version: 5.0.5.306, built on December 6, 2024)及以上版本才可编译运行。 76 77### 下载 78 79如需单独下载本工程，执行如下命令： 80 81```` 82git init 83git config core.sparsecheckout true 84echo code/DocsSample/ArkTs/NodeAPI/NodeApiClassicUseCases/NodeApiApplicationScenario > .git/info/sparse-checkout 85git remote add origin https://gitee.com/openharmony/applications_app_samples.git 86git pull origin master 87````
