开发环境
环境和工具名称 | 版本要求 | 说明 |
---|---|---|
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后实际未生效的问题, 请执行如下步骤:
- 客户需要替换项目中的SangforSDK.har包
- 删除项目中oh_modules文件夹
- 重新点击file菜单下的sync and refresh project