文档开发者中心
我的
|

ArkUI (方舟UI框架)

ArkWeb

HarmonyOS 6

应用媒体

HarmonyOS 5

如何让 App 中 ArkWeb 组件加载的 H5 页面里的微信公众号文章,跳转至微信 App 完成后续交互?【案例示例】

1、需不需要申请什么权限?

2、需不需要安装什么依赖?

点赞
收藏
回复
1
分享
举报
浏览1374 编辑于2025-12-14 05:54广东
全部评论
最多点赞
最新发布
最早发布

需要先准备以下前置工作:

  1. 在模块的module.json5文件中申请网络访问权限
    收起
    自动换行
    深色代码主题
    复制
      "requestPermissions": [
          {
            "name": "ohos.permission.INTERNET"
          }
        ],
  2. 安装微信 OpenSDK
    收起
    自动换行
    深色代码主题
    复制
    ohpm i @tencent/wechat_open_sdk
  3. 在模块的module.json5文件中配置querySchemes
    收起
    自动换行
    深色代码主题
    复制
      "querySchemes": [
          "weixin",
          "alipays"
        ],

实现原理:

  1. 在H5页面中通过https://mp.weixin.qq.com/s/xx的链接形式打开文章;
  2. 通过ArkWeb的onLoadIntercept接口对url进行拦截;
  3. 拦截到对应url后,通过Want的形式跳转至微信,微信自动解析url。

注意:本案例仅提供实现功能,具体使用以及路由栈管理请自行实现

效果展示:

实现步骤

1、H5页面加载微信公众号文章:

收起
自动换行
深色代码主题
复制
<!DOCTYPE html>
<html lang="zh-CN">
<body>
<button class="wechat-article-btn" id="cusBtn">
    打开公众号文章(微信内)
</button>

<script>
// 1. 通过ID获取元素(document.getElementById)
const element = document.getElementById('cusBtn');

function openWechatArticle() {
    //HTTPS公众号文章页  “入口”
    const originalArticleUrl = "https://mp.weixin.qq.com/s/vBVwXfzRAPbQCENCSYIMDw";
    try {
        window.location.href = originalArticleUrl;
    } catch (e) {
    }
}

 // 2. 绑定点击事件
element.addEventListener('click', openWechatArticle);
</script>
</body>
</html>

2、ArkWeb添加拦截事件:

  • weixin://dl/business 是微信自定义的私有 Scheme 协议链接,https://mp.weixin.qq.com/s/xx 是微信公众号文章的HTTPS 网页链接;

  • 二者的本质关系是:公众号文章网页(HTTPS 链接)在非微信环境下(如鸿蒙 ArkWeb)加载时,页面会触发跳转 / 重定向到 weixin://dl/business 这个微信 Scheme,目的是引导用户跳转到微信 App 内打开文章。

收起
自动换行
深色代码主题
复制
Web({src: $rawfile('WeChatArticle.html'), controller: this.webController,})
   .onLoadIntercept((event: OnLoadInterceptEvent) => {
      this.handleLoadIntercept(event)
      return false
})

handleLoadIntercept(event: OnLoadInterceptEvent) {
    let url = event?.data.getRequestUrl();
    //拦截微信跳转指令
    if (url.includes('weixin://dl/business')) {
      this.jumpToArticle(url)
    }
}

 3、使用want跳转至微信自动解析文章:

收起
自动换行
深色代码主题
复制
async jumpToArticle(url: string) {
    //使用want搭配startAbility进行跳转微信
    let want: Want = {
      uri: url,
      action: 'ohos.want.action.viewData',
    }
    try {
      this.context.startAbility(want)
    } catch (e) {
    }
  }

完整代码:

收起
自动换行
深色代码主题
复制
import { webview } from "@kit.ArkWeb";
import { OnLoadInterceptEvent, promptAction } from "@kit.ArkUI";
import { common, Want } from "@kit.AbilityKit";

@ComponentV2
export struct ArkWebJumpToWeChatArticle {
  webController: webview.WebviewController = new webview.WebviewController();
  private context: common.UIAbilityContext = this.getUIContext().getHostContext() as common.UIAbilityContext;

  build() {
    Column() {
      Web({
        src: $rawfile('WeChatArticle.html'), controller: this.webController,
      })
        .onLoadIntercept((event: OnLoadInterceptEvent) => {
          this.handleLoadIntercept(event)
          return false
        })
        .onControllerAttached(() => {
          this.webController.zoom(1)
        })
        .darkMode(WebDarkMode.Auto)
        .domStorageAccess(true)
        .javaScriptAccess(true)
        .height('100%')
    }.safeAreaPadding({ top: 30 })
    .width('100%')
  }

  handleLoadIntercept(event: OnLoadInterceptEvent) {
    let url = event?.data.getRequestUrl();
    if (url.includes('weixin://dl/business')) {
      this.jumpToArticle(url)
    }
  }

  async jumpToArticle(url: string) {
    //使用want搭配startAbility进行跳转微信
    let want: Want = {
      uri: url,
      action: 'ohos.want.action.viewData',
    }
    try {
      this.context.startAbility(want)
    } catch (e) {
    }
  }
}

 WeChatArticle.html

收起
自动换行
深色代码主题
复制
<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>唤起微信打开公众号文章</title>
    <style>
        * {
            margin: 0;
            padding: 0;
            box-sizing: border-box;
        }
        body {
            background-color: #f5f5f5;
            display: flex;
            justify-content: center;
            align-items: center;
            min-height: 100vh;
        }
        .wechat-article-btn {
            padding: 12px 30px;
            background-color: #07c160;
            color: #fff;
            border: none;
            border-radius: 30px;
            font-size: 16px;
            cursor: pointer;
            transition: all 0.3s ease;
            box-shadow: 0 2px 8px rgba(7, 193, 96, 0.3);
        }
    </style>
</head>
<body>
<button class="wechat-article-btn" id="cusBtn">
    打开公众号文章(微信内)
</button>

<script>
// 1. 通过ID获取元素(document.getElementById)
const element = document.getElementById('cusBtn');

/**
 * 转换公众号链接为微信协议,并唤起微信
 */
function openWechatArticle() {
    // 1. 原始公众号文章链接
    const originalArticleUrl = "https://mp.weixin.qq.com/s/vBVwXfzRAPbQCENCSYIMDw";
    try {
        // 4. 触发跳转(WebView中会唤起微信)
        window.location.href = originalArticleUrl;
    } catch (e) {
        console.error("转换失败原因:", e);
    }
}

 // 2. 绑定点击事件
element.addEventListener('click', openWechatArticle);
</script>
</body>
</html>
展开全部
1楼编辑于2025-12-14 06:37 来自广东
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。