HarmonyOS鸿蒙Next中新建静态包（static Library），未选择Enable native

在鸿蒙开发中，若创建 Static Library 模块时未勾选 Enable native，可通过以下步骤手动启用 Native 支持，无需新建模块：

📌 手动配置 Native 支持步骤

1. 创建 Native 目录结构 在模块的 src/main/ 路径下新建 cpp 目录，用于存放 C++ 源码及头文件。

   your-module/
     └── src/main/
          ├── ets/     # 原有ArkTS代码
          └── cpp/     # 新建目录（需手动创建）
               ├── include/   # 存放对外暴露的头文件
               └── your_code.cpp  # C++源码文件
   

2. 添加 CMake 配置文件 在 cpp 目录下创建 CMakeLists.txt 文件，配置 Native 库的编译规则：

   cmake_minimum_required(VERSION 3.4.1)
   project(your_module_name)  # 替换为实际模块名
   add_library(${PROJECT_NAME} SHARED your_code.cpp)
   target_link_libraries(${PROJECT_NAME} PUBLIC libace_napi.z.so)
   

3. 修改 build-profile.json5 在模块根目录的 build-profile.json5 中添加 Native 配置：

   {
     "apiType": "stageModel",
     "buildOption": {
       "artifactType": "obfuscation"
     },
     "nativeLib": {  // 新增配置
       "debugSymbol": {
         "strip": true,
         "exclude": []
       },
       "headerPath": "src/main/cpp/include"  // 指向头文件目录
     }
   }
   

   关键项：

   • headerPath：声明对外暴露的头文件路径（参考）。

4. 配置模块依赖 在 oh-package.json5 中声明 Native 库依赖（若需调用其他模块）：

   {
     "dependencies": {
       "libyour_module.so": "file:./src/main/cpp/types/libyour_module",
       "other_native_module": "file:../other-module-path"
     }
   }
   

5. 同步工程配置 在 DevEco Studio 中执行 Sync Project（或 Make Module），触发 Native 编译链生效。

⚠️ 注意事项

1. 调试支持 若需源码调试，需在调试器中配置 .so 库路径（参考）：

   set solib-search-path path/to/module/lib
   

2. HAR 包兼容性 若模块将打包为 HAR，需确保：

   • Native 代码会编译为 .so 文件并自动放入 har/libs/cpp/ 目录（参考）。
   • 避免在 HAR 中引用本地模块，否则可能导致依赖安装失败。

3. 版本要求 以上配置适用于 HarmonyOS 5.0.0+ 及 Stage 模型（API 10+）。

💡 验证是否生效

1. 在 C++ 文件中编写测试函数（如 int add(int a, int b)）。
2. 在 ArkTS 中通过 import native from 'libyour_module.so' 调用该函数。
3. 若调用成功且可调试，则 Native 支持已启用。

此方案通过手动补齐 Native 模块所需的目录和配置文件，实现与新建时勾选 Enable native 相同的效果（参考）。