SDK 接入配置

1. 概述

1.1 简介

1.2 说明

本文档旨在帮助 Harmony 应用开发者在程序中快速接入优加 SDK 提供广告填充，为媒体提供变现途径，作为应用开发者，您只需要进行简单配置，就可以在您的应用中显示定制的广告。关于 SDK 的具体使用方法，请仔细阅读下面的文档。

2. 开发环境

2.1 基础配置要求

• 确保您的开发及部署环境符合以下标准：
• 开发工具：推荐 NEXT Developer Beta3 及以上版本
• 部署目标：鸿蒙 Next 及以上版本
• SDK 版本：HarmonyOS 12 及以上版本

2.2 部署 SDK

Harmony SDK 支持通过 ohpm（OpenHarmony Package Manager） 工具实现自动化部署，该方式可确保依赖管理的标准化与高效性。以下为详细操作指引，更多关于 ohpm 的使用细节可查阅
查阅官方文档

2.2.1 具体部署步骤

方式一：通过 ohpm install 命令导入

1、准备工作
将目标 SDK 文件（如 AMPSSDK_5.3.0.har）存放至本地已知路径（例如 D:\ 目录）。

2、执行命令
打开命令行工具，切换至项目根目录（示例路径：D:\BeiziAdDemo）。
在创建的项目目录下，进入命令行输入：ohpm install SDK地址
输入以下命令安装依赖：

D:\BeiziAdDemo> ohpm install  D:\AMPSSDK_5.3.0.0.har

方式二：通过 oh-package.json5 依赖同步

1、文件放置
在项目 entry 目录下创建 libs 文件夹，将 AMPSSDK_5.3.0.har 复制到该目录中。

2、配置依赖
编辑项目根目录的 oh-package.json5 文件，在 dependencies 字段中添加以下配置：

{
  //...
  "dependencies": {
    "biz.beizi.adn": "file:./libs/AMPSSDK_5.3.0.0.har"
  }
}

至此依赖 Harmony SDK 完成。

3. 配置权限说明

添加权限
注意:SDK不强制获取可选权限, 即使没有获取可选权限SDK也能正常运行; 获取可选权限将帮助SDK优化投放广告精准度和用户的交互体验, 提高eCPM.
注意:SDK本身不会发起动态权限申请.

3.1 SDK内部已有权限

SDK内部已经配置添加了【开放权限（系统授权）】、网络权限、加速度权限、陀螺仪权限，SDK内部必要权限。开发者不用自己声明添加，这里进行说明。

注意 : 这三种权限均为系统授权（system_grant）的开放权限，面向所有应用开放。应用申请了system_grant权限后，系统将在用户安装应用时，自动把相应权限授予给应用。

//SDK内置权限
"requestPermissions": [
    {
      "name": "ohos.permission.INTERNET",
      "reason": "$string:net_work"
    },
    {
      "name": "ohos.permission.ACCELEROMETER",
      "reason": "$string:sensor"
    },
    {
      "name": "ohos.permission.GYROSCOPE",
      "reason": "$string:sensor"
    }
]

3.2 开发者可选权限

开发者可选权限有，获取设备模糊位置信息权限、跨应用关联权限。获取可选权限将帮助SDK优化投放广告精准度和用户的交互体验, 提高eCPM。如果开发者配置，可以选择在module.json5文件中声明

//可选权限
"requestPermissions": [
      {
        "name": "ohos.permission.APPROXIMATELY_LOCATION",//获取设备模糊位置信息权限
        "reason": "$string:location_reason",
        "usedScene": {"abilities": ["entry"]}
      },
      {
        "name": "ohos.permission.APP_TRACKING_CONSENT",//获取OAID所需权限，需要动态申请
        "reason": "$string:trancking_reason",
        "usedScene": {
          "abilities": [
            "entry"
          ]
        }
      }
    ]

权限说明