HTTPDNS:Integrasikan HarmonyOS SDK

Pendahuluan

SDK ini berbasis HarmonyOS API 12 dan memiliki compileSdkVersion 5.0.0(12).

Prasyarat

1. Pahami alur kerja Produk dan peroleh Account ID.

2. Persiapkan lingkungan pengembangan aplikasi HarmonyOS. Untuk informasi selengkapnya, lihat HarmonyOS Application Development Guide.

Langkah 1: Instal SDK

Anda dapat menjalankan perintah berikut di direktori root aplikasi HarmonyOS untuk menginstal SDK:

ohpm install @aliyun/httpdns

Untuk informasi selengkapnya tentang tool ohpm dan cara menginstal SDK pihak ketiga untuk OpenHarmony, lihat OpenHarmony Third-party Library Repository Guide.

Langkah 2: Konfigurasi SDK

Anda dapat menjalankan kode berikut dalam callback siklus hidup onCreate Ability untuk mengonfigurasi SDK:

import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
import { window } from '@kit.ArkUI';
import { httpdns } from '@aliyun/httpdns';

const ACCOUNT_ID = 'Ganti ini dengan Account ID dari Konsol HTTPDNS Alibaba Cloud'

export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    // ************* Mulai konfigurasi inisialisasi *************
    httpdns.configService(ACCOUNT_ID, {
      context: this.context,
      // Tetapkan node layanan startup. Anda harus secara eksplisit memilih wilayah target. Nilai yang valid adalah Region.SG, Region.HK, Region.US, dan Region.DE.
      region: Region.SG, 
      useHttps: true,
    });
    // ************* Akhir konfigurasi inisialisasi *************
  }

  // Kode lainnya dihilangkan
}

Variabel ACCOUNT_ID adalah Account ID yang Anda peroleh dalam alur kerja Produk.

Langkah 3: Gunakan SDK

import { http } from '@kit.NetworkKit';
import connection from '@ohos.net.connection';
import { httpdns, IpType, } from '@aliyun/httpdns';
import Url from '@ohos.url';

const ACCOUNT_ID = 'Ganti ini dengan Account ID dari Konsol HTTPDNS Alibaba Cloud'

export async function requestWithHttpDns(url: string, options: http.HttpRequestOptions): Promise<http.HttpResponse> {
  let urlObject = Url.URL.parseURL(url);
  const host = urlObject.hostname;
  // ************* Mulai resolusi HTTPDNS untuk mendapatkan nama domain *************
  const httpdnsService = await httpdns.getService(ACCOUNT_ID);
  const result = await httpdnsService.getHttpDnsResultAsync(host, IpType.Auto);
  // ************* Akhir resolusi HTTPDNS untuk mendapatkan nama domain *************
  // ************* Mulai menyetel aturan DNS menggunakan API sistem *************
  try {
    await connection.removeCustomDnsRule(host);
  } catch (ignored) {
  }
  
  const allIps: string[] = [];
  if (result.ipv4s && result.ipv4s.length > 0) {
    allIps.push(...result.ipv4s);
  }
  if (result.ipv6s && result.ipv6s.length > 0) {
    allIps.push(...result.ipv6s);
  }
  if (allIps.length > 0) {
    console.info(`request with ${allIps?.join(',')}`);
    await connection.addCustomDnsRule(host, allIps);
  } else {
    console.log(`HTTPDNS resolution returned no results. DNS rules are not set.`);
  }
  // ************* Akhir menyetel aturan DNS menggunakan API sistem *************
  // ************* Mulai mengirim permintaan jaringan menggunakan API sistem *************
  const httpRequest = http.createHttp();
  return httpRequest.request(url, options);
  // ************* Akhir mengirim permintaan jaringan menggunakan API sistem *************
}

import { httpdns, IpType } from '@aliyun/httpdns';
import { rcp } from '@kit.RemoteCommunicationKit';
import Url from '@ohos.url';

const ACCOUNT_ID = 'Ganti ini dengan Account ID dari Konsol HTTPDNS Alibaba Cloud';

export async function rcpWithHttpDns(url: string): Promise<rcp.Response> {
  let urlObject = Url.URL.parseURL(url);
  const host = urlObject.hostname;

  // ************* Mulai resolusi HTTPDNS untuk mendapatkan hasil IP *************
  const httpdnsService = await httpdns.getService(ACCOUNT_ID);
  const httpdnsResult = await httpdnsService.getHttpDnsResultAsync(host, IpType.Auto);
  let addresses: string[] = [];
  if (httpdnsResult.ipv4s) {
    addresses.push(...httpdnsResult.ipv4s)
  }
  if (httpdnsResult.ipv6s) {
    addresses.push(...httpdnsResult.ipv6s)
  }
  // ************* Akhir resolusi HTTPDNS untuk mendapatkan hasil IP *************

  const request = new rcp.Request(url, "GET");
  request.configuration = {
    dns: {
      // ************* Mulai menyetel alamat IP menggunakan dnsRules *************
      dnsRules: [{
        host,
        port: 80,
        ipAddresses: addresses
      }, {
        host,
        port: 443,
        ipAddresses: addresses
      }]
      // ************* Akhir menyetel alamat IP menggunakan dnsRules *************
    }
  }

  // ************* Mulai mengirim permintaan jaringan menggunakan API sistem *************
  const session = rcp.createSession();
  return session.fetch(request);
  // ************* Akhir mengirim permintaan jaringan menggunakan API sistem *************
}

Langkah selanjutnya

Untuk mengonfigurasi SDK dengan pengaturan yang lebih spesifik atau menggunakan fitur lain, seperti permintaan terautentikasi, lihat HarmonyOS SDK API.