HarmonyOS 鸿蒙Next开发拉起系统浏览器

HarmonyOS 鸿蒙Next开发拉起系统浏览器

import { window } from '@kit.ArkUI'; // 导入ArkUI的window模块
import { common, Want } from '@kit.AbilityKit'; // 导入AbilityKit的common模块

export class AppUtil {
  private static windowStage: window.WindowStage; // 静态变量，用于存储窗口管理器
  private static context: common.UIAbilityContext; // 静态变量，用于存储UIAbility的上下文信息

  /**
   * 获取上下文，common.UIAbilityContext
   * @returns
   */
  static getContext(): common.UIAbilityContext {
    if (!AppUtil.context) {
      AppUtil.context = getContext() as common.UIAbilityContext; //兜底
      console.error("context为空，请在UIAbility的onWindowStageCreate方法中调用AppUtil的init方法初始化！");
    }
    return AppUtil.context;
  }
  /**
   * 拉起系统浏览器
   * @param url 要打开的网页地址
   * @returns 返回一个Promise，该Promise解析为void
   */
  static async toWebBrowser(url: string): Promise<void> {
    // 获取当前应用的UIAbility上下文
    let context = AppUtil.getContext();
    // 创建一个Want对象，用于描述启动系统浏览器的意图
    let want: Want = {
      // 指定动作类型，这里使用的是查看数据的动作
      action: 'ohos.want.action.viewData',
      // 指定实体类型，这里表示可浏览的实体
      entities: ['entity.system.browsable'],
      // 设置要打开的网页地址
      uri: url,
      // 设置额外的参数，这里包含了拉起方应用的包名
      parameters: {
        // 应用包名，用于标识拉起方应用
        bundleName: context.abilityInfo.bundleName,
        // 传递给浏览器的参数，这里同样使用了应用包名
        pushParams: context.abilityInfo.bundleName,
      }
    };
    // 使用UIAbility上下文启动系统浏览器，传入之前创建的Want对象
    return await context.startAbility(want);
  }
}