SDK接入配置
1、鸿蒙中心仓库接入
鸿蒙中心仓库接入
从ToBid广告SDK-HarmonyOS 1.3.1版本开始,支持远程仓库依赖,接入方式详见:
步骤一:添加仓库
项目根目录.ohpmrc配置仓库地址registry=https://ohpm.openharmony.cn/ohpm/,https://ohpm.sigmob.com/repos/ohpm
备注:
可以配置多个仓库地址,以英文逗号间隔,多个仓库地址的优先级按照配置顺序排序。 https://ohpm.sigmob.com/repos/ohpm为ToBid鸿蒙远程仓库。
步骤二:添加依赖
在工程主module的oh-package.json5文件中需要引入ToBid SDK的模块,以远程包形式引入: 在oh-package.json5添加依赖
"dependencies": {
"@tobid/adsdk": "${version}"
}
手动引入har包
步骤一:添加仓库
项目根目录.ohpmrc配置仓库地址registry=https://ohpm.openharmony.cn/ohpm/,https://ohpm.sigmob.com/repos/ohpm
备注:
可以配置多个仓库地址,以英文逗号间隔,多个仓库地址的优先级按照配置顺序排序。 https://ohpm.sigmob.com/repos/ohpm为ToBid鸿蒙远程仓库。
在oh-package.json5添加依赖
"dependencies": {
"@tobid/adsdk": "file:./libs/tobidad-{version}.har",
}
工程完成依赖接入后,执行 ohpm install 执行har包的安装,即可在工程中tobidadsdk了。
注意: 如果之前接入了har或者本次为替换har包更新版本,可先执行ohpm clean cache清除oh_modules目录,避免更新har包失败。
SDK默认构建字节码HAR,工程的工程级build-profile.json5的useNormalizedOHMUrl字段true
3、鸿蒙集成编译环境
在下述版本验证通过:
DevEco Studio 5.0.0 Release
构建版本:5.0.3.906
SDK: API12
4、添加权限
- 打开app模块的module.json5文件
- 添加以下权限:访问网络、获取网络状态(可选)、获取广告追踪标识(oaid)(可选)、获取位置信息(可选)
"requestPermissions": [
{
"name": "ohos.permission.INTERNET",
"reason": "$string:permission_reason",
},
{
"name": 'ohos.permission.APP_TRACKING_CONSENT',
"reason": '$string:permission_reason',
},
{
"name": 'ohos.permission.APPROXIMATELY_LOCATION',
"reason": '$string:permission_reason',
},
{
"name": 'ohos.permission.GET_WIFI_INFO',
"reason": '$string:permission_reason',
},
{
"name": 'ohos.permission.GET_NETWORK_INFO',
"reason": '$string:permission_reason',
}
]
权限名称 | 说明 | 必要性 |
---|---|---|
ohos.permission.APP_TRACKING_CONSENT | '允许应用读取开放匿名设备标识符',SDK用于获取oaid;可选,影响转化 | 可选 |
ohos.permission.INTERNET | '允许使用Internet网络',SDK用于网络请求; | 必选 |
ohos.permission.GET_WIFI_INFO | '允许应用获取Wi-Fi信息',SDK用于判断设备连接wifi状态 | 可选 |
ohos.permission.GET_NETWORK_INFO | '允许应用获取Network信息', SDK检查蜂窝数据业务是否启用 | 可选 |
ohos.permission.APPROXIMATELY_LOCATION | '允许应用获取设备模糊位置信息', SDK用于获取经纬度 | 可选 |