开发环境

环境和工具名称 版本要求 说明
DevEco Studio版本 建议使用最新稳定版本
是否支持模拟器? 不支持模拟器 建议使用真机调试
支持的鸿蒙Next系统版本 所有版本

导入SDK到工程

1.拷贝SDK压缩包中的aar文件到项目的libs路径

// har文件路径
HarmonySDK/Lib/SangforSDK.har

// har文件拷贝到工程的目标目录,以SDKDemo工程为例
SDKDemo/entry/libs/SangforSDK.har

2.添加SDK依赖

在需要引入SDK的模块下的oh-package.json5里面添加如下依赖:

dependencies {
    "SangforSDK": 'file:./libs/SangforSDK.har'
}

同步和刷新项目, 将SDK包安装到oh_modules目录

点击file目录下的sync and refresh project

3. 设置useNormalizedOHMUrl 鸿蒙集成字节码模式的har必须指定工程的工程级build-profile.json5中的useNormalizedOHMUrl值为true

{
  "app": {
    "products": [
      {
         "buildOption": {
           "strictMode": {
             "useNormalizedOHMUrl": true
           }
         }
      }
    ]
  }
}

如果工程级build-profile.json5文件的useNormalizedOHMUrl字段为true,则oh-package.json5中依赖的包使用的别名需要和依赖包的oh-package.json5的name保持一致,否则编译会报错。 指示图 将oh-package.json5中依赖的包使用的别名,修改为依赖包的oh-package.json5中的name。 useNormalizedOHMUrl官方适配指导

4. 更换新SDK注意事项

由于鸿蒙开发环境DevEco存在缓存, 更新SDK时, 避免出现替换SDK后实际未生效的问题, 请执行如下步骤:

  1. 客户需要替换项目中的SangforSDK.har包
  2. 删除项目中oh_modules文件夹
  3. 重新点击file菜单下的sync and refresh project

results matching ""

    No results matching ""