templates/openharmony/native/engine/doc/如何在 HarmonyOS 平台上使用 JavaScript 直接调用 ArkTs 方法.md · lestelhw/engine-native_1

# 如何在 HarmonyOS 平台上使用 JavaScript 直接调用 ArkTs 方法<a name="ZH-CN_TOPIC_0000001618730648"></a>

使用 Cocos Creator 2.4.14及以上 打包的鸿蒙原生应用中，我们可以通过反射机制直接在 JavaScript 中调用 ArkTs 的静态方法。它的使用方法很简单：

>![](public_sys-resources/icon-note.gif) **示例：** 
- isSyn 是否是同步方法
- clsPath 脚本路径 示例：entry/src/main/ets/test
- methodName 模块名称/静态方法名称 示例：entry/test(模块名称可省略，省略为clsPath第一个字符串)
- paramStr 方法入参 示例：json字符串
>let result = jsb.reflection.callStaticMethod(isSyn, clsPath, methodName, paramStr);

在 callStaticMethod 方法中，我们通过传入 arkTs 是否同步，模块路径或者依赖包名或者远程库名，方法名，参数就可以直接调用 arkTs 的静态方法，并且可以获得 arkTs 方法的返回值。

使用场景
| 场景 | 详细分类 | 说明 |
| --- | --- | --- |
| 本地工程模块 | HAP加载模块内文件路径 | 要求路径以moduleName开头 |
| 本地工程模块 | HAP加载HAR模块名 | - |
| 远程包 | HAP加载远程HAR模块名 | - |
| 远程包 | HAP加载ohpm包名 | - |
| API | HAP加载@ohos.或 @system. | - |
| 模块Native库 | HAP加载libNativeLibrary.so | - |

>本文示范了本地工程模块的两种场景，其他场景可参阅详细说明使用
>![](public_sys-resources/icon-tip.gif)
>[底层实现](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/use-napi-load-module-with-info-V5#napi_load_module_with_info%E6%94%AF%E6%8C%81%E7%9A%84%E5%9C%BA%E6%99%AF)

## 使用示例
### HAP加载模块内文件路径
1.当加载文件中的模块时，如以下ArkTS代码：
```
function test(param: string): string {
  console.log("param::", param);
  return param;
}

function syncTest(param: string, cb: Function): void {
  console.log("param::", param);
  setTimeout(() => {
    cb(param);
  }, 1000)
}

export { test, syncTest };
```
2.需要在模块的build-profile.json5文件中进行以下配置
```
"buildOption": {
  "arkOptions": {
    "runtimeOnly": {
      "sources": [
        "./src/main/ets/test.ts"
      ]
    }
  }
}
```
3.游戏中调用
```
let param = {
    a:1,
    b:2
}
let o1 = jsb.reflection.callStaticMethod(true,"entry/src/main/ets/test","entry/test",JSON.stringify(param));
console.log("result::", o1, typeof o1, JSON.parse(o1).a);

let o2 =jsb.reflection.callStaticMethod(false,"entry/src/main/ets/test","entry/syncTest",JSON.stringify(param));
console.log("result::", o2, typeof o2, JSON.parse(o2).a);
```
### HAP加载HAR模块名
1.HAR包Index.ets文件如下
```
function test(param: string): string {
  console.log("param::", param);
  return param;
}

function syncTest(param: string, cb: Function): void {
  console.log("param::", param);
  setTimeout(() => {
    cb(param);
  }, 1000)
}

export { test, syncTest };
```
2.在加载本地HAR包时，首先需要在oh-package.json5文件中配置dependencies项
```
{
    "dependencies": {
        "library": "file:../library"
    }
}
```
3.其次，还需要在build-profile.json5中进行配置
```
"buildOption": {
  "arkOptions": {
    "runtimeOnly": {
      "packages": [
        "library"
      ]
    }
  }
}
```
4.游戏中调用
```
let param = {
    a:1,
    b:2
}
let o1 = jsb.reflection.callStaticMethod(true,"library","entry/test",JSON.stringify(param));
console.log("result::", o1, typeof o1, JSON.parse(o1).a);

let o2 =jsb.reflection.callStaticMethod(false,"library","entry/syncTest",JSON.stringify(param));
console.log("result::", o2, typeof o2, JSON.parse(o2).a);
```

lestelhw/engine-native_1

About

Releases

Contributors

Activities