1# OpenMP应用构建和运行指南 2 3OpenHarmony NDK中提供了OpenMP的动态库和静态库文件，支持开发者在Native应用中使用OpenMP。本文用于指导开发者在[DevEco Studio](https://developer.huawei.com/consumer/cn/deveco-studio/)中调用库文件使用OpenMP的并行化能力，更详细的使用示例和API标准请查看官方文档[clang-OpenMPSupport](https://clang.llvm.org/docs/OpenMPSupport.html)。 4 5## 开发步骤 6 7### 1. 创建Native C++工程 8[创建NDK工程](./create-with-ndk.md) 9 10### 2. 添加依赖 11 12OpenMP库的引入有静态链接和动态链接两种方式。 13 14> **注意：** 15> 16> [OMPT(OpenMP Tools Interface)](https://www.openmp.org/spec-html/5.0/openmpsu15.html#x25-240001.5.1)工具目前仅支持静态链接时使用。 17> 18 19#### 静态链接 20 21（1）打开entry/src/main/cpp/CMakeLists.txt，在target\_link\_libraries依赖中添加静态库libomp.a以及日志依赖libhilog\_ndk.z.so。 22 23```makelists 24target_link_libraries(entry PUBLIC libomp.a libace_napi.z.so libhilog_ndk.z.so) 25``` 26 27（2）打开entry/build-profile.json5，在buildOption->externalNativeOptions->cppFlags下添加编译参数"-static-openmp -fopenmp"。 28 29``` 30"buildOption": { 31 "externalNativeOptions": { 32 "path": "./src/main/cpp/CMakeLists.txt", 33 "arguments": "", 34 "cppFlags": "-static-openmp -fopenmp", 35 } 36 } 37``` 38 39#### 动态链接 40 41（1）打开entry/src/main/cpp/CMakeLists.txt，在target\_link\_libraries依赖中添加动态库libomp.so以及日志依赖libhilog\_ndk.z.so。 42 43```makelists 44target_link_libraries(entry PUBLIC libomp.so libace_napi.z.so libhilog_ndk.z.so) 45``` 46 47（2）打开entry/build-profile.json5，在buildOption->externalNativeOptions->cppFlags下添加编译参数"-fopenmp"。 48 49``` 50"buildOption": { 51 "externalNativeOptions": { 52 "path": "./src/main/cpp/CMakeLists.txt", 53 "arguments": "", 54 "cppFlags": "-fopenmp", 55 } 56 } 57``` 58 59（3）打开Sdk安装目录，在“{Sdk安装目录}\{版本号}\openharmony\native\llvm\lib\aarch64-linux-ohos”目录下找到libomp.so动态库文件，并将其拷贝到工程目录entry/libs/arm64-v8a文件夹。 60 61### 3. 修改源文件 62 63（1）修改entry/src/main/cpp/napi_init.cpp，引入omp.h头文件，并添加OmpTest函数。 64 65```cpp 66#include "napi/native_api.h" 67#include "omp.h" 68#include "hilog/log.h" 69 70#undef LOG_DOMAIN 71#undef LOG_TAG 72#define LOG_DOMAIN 0x3200 // 全局domain宏，标识业务领域 73#define LOG_TAG "MY_TAG" // 全局tag宏，标识模块日志tag 74 75static napi_value OmpTest(napi_env env, napi_callback_info info) 76{ 77 78 OH_LOG_INFO(LOG_APP, "=================Hello OpenMP test.===================="); 79 #pragma omp parallel 80 { 81 OH_LOG_INFO(LOG_APP, "Hello OpenMP!"); 82 } 83 return nullptr; 84} 85 86EXTERN_C_START 87static napi_value Init(napi_env env, napi_value exports) 88{ 89 napi_property_descriptor desc[] = { 90 { "ompTest", nullptr, OmpTest, nullptr, nullptr, nullptr, napi_default, nullptr } 91 }; 92 napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc); 93 return exports; 94} 95EXTERN_C_END 96 97static napi_module demoModule = { 98 .nm_version = 1, 99 .nm_flags = 0, 100 .nm_filename = nullptr, 101 .nm_register_func = Init, 102 .nm_modname = "entry", 103 .nm_priv = ((void*)0), 104 .reserved = { 0 }, 105}; 106 107extern "C" __attribute__((constructor)) void RegisterEntryModule(void) 108{ 109 napi_module_register(&demoModule); 110} 111 112``` 113 114（2）修改entry/src/main/cpp/types/libentry/Index.d.ts，导出ompTest函数。 115 116```TS 117export const ompTest: () => null; 118``` 119 120（3）Ts侧调用，修改entry/src/main/ets/pages/Index.ets，调用ompTest函数。 121 122```TS 123import testNapi from 'libentry.so'; 124 125@Entry 126@Component 127struct Index { 128 @State message: string = 'Hello OpenMP'; 129 130 build() { 131 Row() { 132 Column() { 133 Text(this.message) 134 .fontSize(50) 135 .fontWeight(FontWeight.Bold) 136 .onClick(() => { 137 testNapi.ompTest(); 138 }) 139 } 140 .width('100%') 141 } 142 .height('100%') 143 } 144} 145``` 146 147### 4. 运行并校验结果 148 149运行前请检查设备连接并配置好[Signature](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/ide-signing-V5)信息。直接点击右上角运行按钮，应用启动后设备进入“Hello OpenMP”界面，点击“Hello OpenMP”标签，打开Dev Eco下方“Log”查看页面，即可看到并行打印的“Hello OpenMP！”消息。 150 151 152 153> **注意：** 154> 155> OpenMP程序运行时，Hilog中会输出“dlopen_impl load library header failed for libarcher.so”的报错信息（如下图）。该报错信息中提到的libarcher.so，在OpenMP程序开启Tsan检测时才需要使用。目前OpenHarmony未支持OpenMP程序的Tsan检测能力，因此该错误信息可忽略，不影响程序正常运行。 156> 157>  158
