更新记录

1.0.0（2026-06-18）

本插件适配 Android、iOS、HarmonyOS 三端，让您在 uni-app 中通过统一的 openBrowser 方法，调用设备默认浏览器打开指定网页。

平台兼容性

uni-app(5.0)

uni-app x(5.0)

uni-app UTS 插件：打开外部浏览器（zwb-openWeb）

本插件适配 Android、iOS、HarmonyOS 三端，让您在 uni-app 中通过统一的 openBrowser 方法，调用设备默认浏览器打开指定网页。

📦 插件信息

🚀 快速开始

1. 引入插件

在 uni_modules 目录下放入插件文件夹后，前端页面直接 import：

import { openBrowser } from '@/uni_modules/zwb-openWeb';

2. 调用方法

// 打开一个网页
openBrowser('https://www.example.com');

📖 API 说明

openBrowser(url: string): void

• 如果传入的 url 没有协议前缀，插件会自动补全 https://。
• 传入 null 或空字符串时，方法会静默返回，不会执行任何操作。
• 各平台均会调用系统默认浏览器打开链接，不会在应用内嵌 WebView。

📝 完整示例

<template>
  <view class="page">
    <button type="primary" @click="openInBrowser">打开百度</button>
  </view>
</template>

<script>
import { openBrowser } from '@/uni_modules/zwb-openWeb';

export default {
  methods: {
    openInBrowser() {
      openBrowser('https://www.baidu.com');
    }
  }
};
</script>

🛠️ 注意事项

📱 各平台要求

🔧 开发调试建议

• iOS 自定义基座：
  制作路径：HBuilderX 顶部菜单 → 运行 → 运行到手机或模拟器 → 制作自定义调试基座 → 勾选插件 zwb-openWeb → 打包。
• Android 编译警告：
  使用时可能看到 Identity equality for types 'Int' is deprecated 警告，不影响功能。我们已在插件内部使用 == 替代 ===，避免该警告。
• HarmonyOS 编译错误：
  若遇到 arkts-no-untyped-obj-literals 错误，已通过 Want 类型声明解决，无需额外处理。

❓ 常见问题

Q：iOS 运行时提示 undefined class: UTSSDKModules... 怎么办？
A：请使用自定义基座运行，标准基座不含插件代码。制作方法见上方“注意事项”。

Q：链接没有打开，或提示“设备上没有可用的浏览器”？
A：请检查设备是否安装了浏览器（Android 特别检查）。iOS 系统默认自带 Safari，一般不存在该问题。

Q：可以打开应用内页面（如 pages/index/index）吗？
A：不可以，本插件仅用于调起系统默认浏览器打开网页 URL，如需应用内跳转请使用 uni-app 的路由 API。

若您在使用过程中遇到其他问题，欢迎随时反馈！