Skip to content

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添加依赖

json
"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添加依赖

json
"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、添加权限

  1. 打开app模块的module.json5文件
  2. 添加以下权限:访问网络、获取网络状态(可选)、获取广告追踪标识(oaid)(可选)、获取位置信息(可选)
json
"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用于获取经纬度可选