C++ 模块扩展

我们将以 TestModule 为例，从头扩展一个 Module，这个 Module 将展示前端如何调用终端能力，并且把结果返回给前端。

继承 ModuleBase

在 core/modules/ 下创建 test-module.h

  1. #ifndef CORE_MODULES_TEST_MODULE_H_
  2. #define CORE_MODULES_TEST_MODULE_H_
  4. #include "core/modules/module-base.h"
  5. #include "core/napi/callback-info.h"
  7. class TestModule : public ModuleBase {
  8.   public:
  9.     explicit TestModule(hippy::napi::napi_context context){};
  10.     void RetStr(const hippy::napi::CallbackInfo& info);
  11.     void Print(const hippy::napi::CallbackInfo& info);
  12. };
  14. #endif // CORE_MODULES_TEST_MODULE_H_

在 core/modules/ 下创建 test-module.cc

  1. #include "core/modules/module-register.h"
  2. #include "core/modules/test-module.h"
  3. #include "core/napi/js-native-api.h"
  4. #include "core/base/logging.h"
  5. REGISTER_MODULE(TestModule, RetStr)
  6. REGISTER_MODULE(TestModule, Print)
  8. void TestModule::RetStr(const hippy::napi::CallbackInfo& info) {
  9.   std::shared_ptr<Environment> env = info.GetEnv();
  10.   hippy::napi::napi_context context = env->getContext();
  11.   HIPPY_CHECK(context);
  13.   info.GetReturnValue()->Set(hippy::napi::napi_create_string(context, "hello world"));
  14. }
  16. void TestModule::Print(const hippy::napi::CallbackInfo& info) {
  17.   std::shared_ptr<Environment> env = info.GetEnv();
  18.   hippy::napi::napi_context context = env->getContext();
  19.   HIPPY_CHECK(context);
  20.   HIPPY_LOG(hippy::Debug, "hello world");
  22.   info.GetReturnValue()->SetUndefined();
  23. }

JS 桥接

双平台通用模块一般放在 core/js/global 下，我们在 global 下 增加 TestModule.js

  1. const TestModule = internalBinding('TestModule');
  3. global.TestModule = TestModule;

core/js/entry/ 下双平台 hippy.js 里增加

  1. require('../../global/TestModule.js');

在 Hippy 目录下运行 npm run buildcore，会生成对应双平台的 C++ 源代码：

重新编译 Core

无需做别的改动，重新编译终端 SDK 即可，终端 SDK 能够链接到 core 目录中的对应 C++ 代码，需要注意 Android 需要准备好 cmake、ndk 等等编译环境。

效果

  1. global.TestModule.Print();
  2. global.TestModule.RetStr();
  3. 2019-11-08 17:32:57.630 7004-7066/? D/HippyCore: hello world