公共DNS鸿蒙版SDK接入手册

2.1 引用本地HAR包方式集成SDK

在工程的oh-package.json5中设置三方包依赖。以HAR包在工程根目录下为例，配置示例如下（实际配置时请以HAR包实际目录为准）：

"dependencies": {
    "library": "file:alidns_doh_harmony_sdk-0.0.1.har"
 }

依赖设置完成后，需要执行ohpm install命令安装依赖包，依赖包会存储在工程的oh_modules目录下。

ohpm install

2.2 如何使用SDK

• 引入头文件

import { setAccessKey, setEnableSafeMode, getALIDoH } from 'alidohlibrary'

• 设置鉴权模式

推荐开启鉴权模式，以保障用户身份安全，不被第三方未授权者盗用，该参数默认开启，用户在Alibity onCreate生命周期回调中执行以下代码配置SDK：

import { setAccessKey, setEnableSafeMode } from 'alidohlibrary'

const AccessKeID = '这里需要替换为您在控制台“接入配置”创建的密钥的 AccessKey ID';
const AccessKeySecret = '这里需要替换为您在控制台“接入配置”创建的密钥的 AccessKey Secret';

export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    // ************* 阿里DoH（鉴权）配置 begin *************
    setEnableSafeMode(true);
    setAccessKey(AccessKeID,AccessKeySecret);
    // ************* 阿里DoH（鉴权）配置 end *************
  }

  // 省略其它代码
}

• 设置非鉴权模式

对于不需要严格身份验证的应用或测试环境，用户在Alibity onCreate生命周期回调中执行以下代码配置SDK：

import { setAccessKey, setEnableSafeMode } from 'alidohlibrary'

export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    // ************* 阿里DoH（非鉴权）配置 begin *************
    setEnableSafeMode(false);
    // ************* 阿里DoH（非鉴权）配置 end *************
  }

  // 省略其它代码
}

• 网络请求中使用方式

通过getALIDoH()获取DOH服务URL，然后在HTTP请求配置中使用它作为dnsOverHttps参数。

let httpRequest = http.createHttp();
httpRequest.request(
  "https://www.aliyun.com",
  {
    dnsOverHttps: await getALIDoH(),
    method: http.RequestMethod.GET, 
    header: [{
      'Content-Type': 'application/json'
    }],
    expectDataType: http.HttpDataType.STRING, 
    usingCache: false,
    priority: 1, 
    connectTimeout: 3000, 
    readTimeout: 3000,
    usingProxy: false, 
  }, (err: BusinessError, data: http.HttpResponse) => {
 
  }
);

• webview中的使用方式

通过web_webview.WebviewController.setHttpDns方法，设置Webview使用的安全DNS模式为自动，并传入通过getALIDoH()获取的DOH URL。

web_webview.WebviewController.setHttpDns(web_webview.SecureDnsMode.SECURE_ONLY, await getALIDoH())