ArkTS调用Native函数的方法_cannot get sourcemap info, dump raw stack

框架介绍

1.新建Native C++工程，选中Stage模型

项目创建完成后，工程目录结构如下，

很明显，在entry/src/main目录下，与ets目录同级有一个cpp目录，这个目录就包含了native部分的代码，包括功能实现和编译脚本。这个工程是可以直接运行的，不过运行效果只是一个HelloWorld，需要点击这个组件才会执行native调用，结果显示在标签log中。

预览器不支持native调用的预览，会报错

09-11 11:32:40.806 12536-15828 E C03900/Ace: [Engine Log]Lifetime: 0.000000s
09-11 11:32:40.806 12536-15828 E C03900/Ace: [Engine Log]Js-Engine: ark
09-11 11:32:40.806 12536-15828 E C03900/Ace: [Engine Log]page: pages
09-11 11:32:40.806 12536-15828 E C03900/Ace: [Engine Log]Error message: Cannot read property add of undefined
09-11 11:32:40.806 12536-15828 E C03900/Ace: [Engine Log]Cannot get SourceMap info, dump raw stack:
09-11 11:32:40.806 12536-15828 E C03900/Ace: [Engine Log]Stacktrace:
09-11 11:32:40.806 12536-15828 E C03900/Ace: [Engine Log]    at anonymous (entry

我们通过模拟器运行一下，

点击这个文本标签，会在log窗口打印如下日志，

演示不够直观，操作繁琐，看log也不方便，我们改一下，让调用结果直接显示在界面上。

import hilog from '@ohos.hilog';
import testNapi from 'libentry.so'
 
@Entry
@Component
struct Index {
  @State message: string = 'Result of Native call:'
 
  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(30)
          .fontWeight(FontWeight.Bold)
          .onClick(() => {
            hilog.info(0x0000, 'testTag', 'Test NAPI 2 + 3 = %{public}d', testNapi.add(2, 3));
          })
 
        Text(testNapi.add(2, 3).toString())
          .fontSize(50)
          .fontColor(Color.Red)
      }
      .width('100%')
      .height('100%')
      .justifyContent(FlexAlign.Center)
    }
    .height('100%')
  }
}

现在的运行结果是这样的，

现在已经证实了项目是完整的可以正常运行，下面分析一下具体的项目结构。

▍基本项目结构

1.Entry/src/main/cpp/types/libentry/index.d.ts

export const add: (a: number, b: number) => number;

接口描述文件，描述C++接口的方法名、入参、返回参数等信息，用来暴露lib库相关的声明。

2.Entry/src/main/cpp/types/libentry/oh-package.json5

{
  "name": "libentry.so",
  "types": "./index.d.ts",
  "version": "",
  "description": "Please describe the basic information."
}

native库的配置文件。

3.Entry/src/main/cpp/types/CMakeLists.txt

# the minimum version of CMake.
cmake_minimum_required(VERSION 3.4.1)
project(MyNativeApp)
 
set(NATIVERENDER_ROOT_PATH ${CMAKE_CURRENT_SOURCE_DIR})
 
include_directories(${NATIVERENDER_ROOT_PATH}
                    ${NATIVERENDER_ROOT_PATH}/include)
 
add_library(entry SHARED hello.cpp)
target_link_libraries(entry PUBLIC libace_napi.z.so)

编译脚本

cmake_minimum_required用于设定需要的最低版本的CMake

project指定工程名为MyNativeApp 

Set 设置变量，指定NATIVERENDER_ROOT_PATH的位置

include_directories命令用于在构建(build)中添加包含目录

add_library 使用指定的代码向项目中增加一个库。

target_link_libraries指定链接给定目标和/或其依赖项时要使用的库或标志。将传播链接库目标的使用要求。目标依赖项的使用要求会影响其自身源的编译。

4.Entry/src/main/cpp/types/hello.cpp

#include "napi/native_api.h"
 
static napi_value Add(napi_env env, napi_callback_info info)
{
    size_t requireArgc = 2;
    size_t argc = 2;
    napi_value args[2] = {nullptr};
 
    napi_get_cb_info(env, info, &argc, args , nullptr, nullptr);
 
    napi_valuetype valuetype0;
    napi_typeof(env, args[0], &valuetype0);
 
    napi_valuetype valuetype1;
    napi_typeof(env, args[1], &valuetype1);
 
    double value0;
    napi_get_value_double(env, args[0], &value0);
 
    double value1;
    napi_get_value_double(env, args[1], &value1);
 
    napi_value sum;
    napi_create_double(env, value0 + value1, &sum);
 
    return sum;
 
}
 
EXTERN_C_START
static napi_value Init(napi_env env, napi_value exports)
{
    napi_property_descriptor desc[] = {
        { "add", nullptr, Add, nullptr, nullptr, nullptr, napi_default, nullptr }
    };
    napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc);
    return exports;
}
EXTERN_C_END
 
static napi_module demoModule = {
    .nm_version =1,
    .nm_flags = 0,
    .nm_filename = nullptr,
    .nm_register_func = Init,
    .nm_modname = "entry",
    .nm_priv = ((void*)0),
    .reserved = { 0 },
};
 
extern "C" __attribute__((constructor)) void RegisterEntryModule(void)
{
    napi_module_register(&demoModule);
}

功能具体实现的源文件。

napi_module_register进行模块注册，nm_modname指的是模块名称，nm_register_func是模块对外接口注册函数。

5.Entry/build-profile.json5

{
  "apiType": 'stageMode',
  "buildOption": {
    "externalNativeOptions": {
      "path": "./src/main/cpp/CMakeLists.txt",
      "arguments": "",
      "cppFlags": "",
    }
  },
  "targets": [
    {
      "name": "default",
      "runtimeOS": "HarmonyOS"
    },
    {
      "name": "ohosTest",
    }
  ]
}

当前的模块信息、编译信息配置项，包括buildOption、targets配置等。

buildOption中的externalNativeOptions代表cpp相关编译的一些配置信息，里面的参数简介如下 

• Path:CMake配置文件，提供CMake构建脚本

• Arguments:传递给CMake的可选编译参数

• cppFlags:设置C++编译器的可选参数

6.Entry/oh-package.json5

{
  "name": "entry",
  "version": "1.0.0",
  "description": "Please describe the basic information.",
  "main": "",
  "author": "",
  "license": "",
  "dependencies": {},
  "devDependencies": {
    "@types/libentry.so": "file:./src/main/cpp/types/libentry"
  }
}

应用/服务支持通过ohpm来安装、共享、分发代码，管理项目的依赖关系，这里的devDependencies参数指的是开发时的需要依赖，用于本地环境开发时候所需要的依赖包，

新增功能

新增一个计算平方根的功能，输入数字，实时计算该数的平方根。

修改页面布局文件entry/src/ets/pages/Index.ets

import hilog from '@ohos.hilog';
import testNapi from 'libentry.so'
 
@Entry
@Component
struct Index {
  @State message: string = 'Test NAPI 2 + 3 = '
  @State numX: number = 0.0;
  private textInputControllerX: TextInputController = new TextInputController();
 
  build() {
    Column() {
      Row() {
        Text(this.message)
          .fontSize(30)
          .fontWeight(FontWeight.Bold)
          .onClick(() => {
            hilog.info(0x0000, 'testTag', 'Test NAPI 2 + 3 = %{public}d', testNapi.add(2, 3));
          })
 
        Text(testNapi.add(2, 3).toString())
          .fontSize(40)
          .fontColor(Color.Red)
      }
      .width('100%')
      .justifyContent(FlexAlign.Center)
 
 
      Column() {
        Row() {
          TextInput({ controller: this.textInputControllerX })
            .width(100)
            .type(InputType.Number)
            .onChange(value => {
              let temp = parseFloat(value);
              this.numX = testNapi.sqrt(temp);
            })
          Text("的平方根=")
            .fontSize(40)
          Text(this.numX.toString())
            .fontSize(40)
            .fontColor(Color.Green)
 
        }
        .width('100%')
        .justifyContent(FlexAlign.Center)
      }
      .width('100%')
      .justifyContent(FlexAlign.Center)
      .margin({ top: 100 })
 
    }
    .height('100%')
    .justifyContent(FlexAlign.Center)
  }
}

修改底层库实现文件Entry/src/main/cpp/types/hello.cpp

#include "napi/native_api.h"
#include "math.h"
 
static napi_value Add(napi_env env, napi_callback_info info)
{
    size_t requireArgc = 2;
    size_t argc = 2;
    napi_value args[2] = {nullptr};
 
    napi_get_cb_info(env, info, &argc, args , nullptr, nullptr);
 
    napi_valuetype valuetype0;
    napi_typeof(env, args[0], &valuetype0);
 
    napi_valuetype valuetype1;
    napi_typeof(env, args[1], &valuetype1);
 
    double value0;
    napi_get_value_double(env, args[0], &value0);
 
    double value1;
    napi_get_value_double(env, args[1], &value1);
 
    napi_value sum;
    napi_create_double(env, value0 + value1, &sum);
 
    return sum;
 
}
 
static napi_value Sqrt(napi_env env, napi_callback_info info) 
{
    size_t requireArgc = 1;
    size_t argc = 1;
    napi_value args[1] = {nullptr};
 
    napi_get_cb_info(env, info, &argc, args , nullptr, nullptr);
 
    napi_valuetype valuetype0;
    napi_typeof(env, args[0], &valuetype0);
 
 
    double value0;
    napi_get_value_double(env, args[0], &value0);
 
    napi_value result;
    napi_create_double(env, sqrt(value0), &result);
 
    return result;
}
 
EXTERN_C_START
static napi_value Init(napi_env env, napi_value exports)
{
    napi_property_descriptor desc[] = {
        { "add", nullptr, Add, nullptr, nullptr, nullptr, napi_default, nullptr },
        { "sqrt", nullptr, Sqrt, nullptr, nullptr, nullptr, napi_default, nullptr }
    };
    napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc);
    return exports;
}
EXTERN_C_END
 
static napi_module demoModule = {
    .nm_version =1,
    .nm_flags = 0,
    .nm_filename = nullptr,
    .nm_register_func = Init,
    .nm_modname = "entry",
    .nm_priv = ((void*)0),
    .reserved = { 0 },
};
 
extern "C" __attribute__((constructor)) void RegisterEntryModule(void)
{
    napi_module_register(&demoModule);
}

在模拟器上查看一下效果，

总结

通过这次学习，简单了解了ArkTS调用native函数的方法，虽然了解的不是很深入，但对大体框架有了一定的掌握，为以后更复杂的native调用开发奠定了基础。

最后，有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（Harmony NEXT）资料用来跟着学习是非常有必要的。 

这份鸿蒙（Harmony NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

如果你是一名有经验的资深Android移动开发、Java开发、前端开发、对鸿蒙感兴趣以及转行人员，可以直接领取这份资料

 获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙（Harmony NEXT）最新学习路线

•  HarmonOS基础技能

• HarmonOS就业必备技能 
•  HarmonOS多媒体技术

• 鸿蒙NaPi组件进阶

• HarmonOS高级技能

• 初识HarmonOS内核 
• 实战就业级设备开发

 有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

《鸿蒙 (OpenHarmony)开发入门教学视频》

《鸿蒙生态应用开发V2.0白皮书》

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

 《鸿蒙开发基础》

• ArkTS语言
• 安装DevEco Studio
• 运用你的第一个ArkTS应用
• ArkUI声明式UI开发
• .……

 《鸿蒙开发进阶》

• Stage模型入门
• 网络管理
• 数据管理
• 电话服务
• 分布式应用开发
• 通知与窗口管理
• 多媒体技术
• 安全技能
• 任务管理
• WebGL
• 国际化开发
• 应用测试
• DFX面向未来设计
• 鸿蒙系统移植和裁剪定制
• ……

《鸿蒙进阶实战》

• ArkTS实践
• UIAbility应用
• 网络案例
• ……

 获取以上完整鸿蒙HarmonyOS学习资料，请点击→纯血版全套鸿蒙HarmonyOS学习资料

总结

总的来说，华为鸿蒙不再兼容安卓，对中年程序员来说是一个挑战，也是一个机会。只有积极应对变化，不断学习和提升自己，他们才能在这个变革的时代中立于不败之地。