更新记录

1.0.2（2026-10-13） 下载此版本

Android / iOS / 鸿蒙）、H5

1.0.1（2026-10-13） 下载此版本

打开系统浏览器鸿蒙

1.0.0（2026-10-13） 下载此版本

• 系统浏览器打开外部链接统一 API openBrowser(url)：调用方一行、全平台通用（平台差异全部封装在方法内部）：
  • Android：Intent.ACTION_VIEW + CATEGORY_BROWSABLE（等价 plus.runtime.openURL）
  • iOS：UIApplication.openURL（等价 plus.runtime.openURL）
  • HarmonyOS：@kit.AbilityKit startAbility 隐式 Want（action=ohos.want.action.viewData + entity.system.browsable）
  • H5：window.open(url, "_blank")
  • 小程序：返回 false（无系统浏览器概念，可降级为复制链接）
• 说明：UTS 插件在 App 端编译为原生代码（Kotlin / Swift / ArkTS），原生环境不存在 JS 引擎注入的 plus 全局对象，因此 App 端使用 plus.runtime.openURL 的底层等价实现，行为一致。

平台兼容性

uni-app(4.45)

uni-app x(4.0)

其他

jq-open-url（系统浏览器打开链接 · 全平台统一）

一处调用、全平台通用：openBrowser(url) —— 调用方只写一行，平台差异全部封装在插件内部。

🌐 平台实现（两层结构）

为什么分两层？ plus 是 uni-app JS 引擎注入的全局对象，只能在 JS 层使用；UTS 代码在 App 端会被编译为原生代码（ArkTS / Kotlin / Swift），原生环境不存在 plus（写 plus.runtime.openURL 会编译报错）。 因此「其他端」（Android / iOS / H5）统一用 JS 封装在 index.js，鸿蒙用 UTS 实现原生拉起。

💻 调用（一行，全平台通用）

import { openBrowser } from "@/uni_modules/jq-open-url";

// 任何平台都只要这一行，无需条件编译
openBrowser("https://www.example.com");

🔧 API

openBrowser(url)

用系统浏览器打开外部链接（全平台统一入口）。

返回值：Promise<boolean>

• true：已成功发起打开
• false：参数为空、平台不支持（小程序）或打开失败

⚠️ 注意事项

• 插件包含 UTS 原生代码（鸿蒙端编译为 ArkTS），鸿蒙真机调试需制作自定义基座或使用正式包；
• H5 端 window.open 需在用户交互（点击）中调用，否则可能被浏览器拦截弹窗；
• 小程序无系统浏览器概念，openBrowser 返回 false，可自行降级为复制链接。

📄 更新记录

见 changelog.md