wx-h5-demo: 新增场景3 分享深链验证(正确宿主页 + 复现首页 bug 的反面页),README 补验证步骤 (demo v26091001)

This commit is contained in:
2026-09-17 21:34:27 +08:00
parent 138f14e6de
commit f4610db21b
6 changed files with 275 additions and 3 deletions

View File

@@ -0,0 +1,22 @@
// 场景3-反面(❌ 复现线上 bug):写死分享首页
// 路径:/pages/demo/home.js
// ------------------------------------------------------------
// 用途:扮演「小程序首页」。H5 点「❌ 复现旧 bug」会 postMessage + navigateBack,
// 退回本页;此时用户点右上角「···」转发,触发的是本页的 onShareAppMessage。
// 本页故意写死 path: '/pages/demo/home' 且忽略 options.webViewUrl ——
// 接收者点开卡片就落到本页(= 线上「分享后跳首页」的现象)。
Page({
data: {},
goWebview() {
wx.navigateTo({ url: '/pages/demo/share-webview' });
},
// ❌ 反面:写死首页、不带 H5 地址(旧版 pages/index/index.vue 的写法)
onShareAppMessage() {
return {
title: '兜爸心选 · 首页(bug 复现)',
path: '/pages/demo/home'
};
}
});

View File

@@ -0,0 +1,27 @@
<!-- 场景3-反面(❌):「小程序首页」(复现 bug 用)
路径:/pages/demo/home
用法:把本页并入小程序并在 app.json 注册(路径 /pages/demo/home),
作为进入 demo 的起点(也可临时当成首页)。
验证:
本页「进入 H5 web-view」→ H5 点 ③「复现旧 bug」→ 立刻退回本页 →
点右上角「···」转发 → 接收者落到本页,而不是那个 H5 页面。
对照:把 H5 里改点 ②「正确分享」并重新走一遍,接收者就应落到 H5 页面。 -->
<view style="padding:48rpx 40rpx;text-align:center">
<view style="font-size:36rpx;font-weight:700;color:#2B2320">兜爸心选 · 首页</view>
<view style="font-size:26rpx;color:#6B615B;line-height:1.7;margin-top:16rpx">
本页是 bug 复现用的「首页」:<br/>
<text style="color:#C4553A">onShareAppMessage 写死 path: '/pages/demo/home'</text><br/>
并忽略回调里的 webViewUrl(旧版实现)。
</view>
<button style="margin-top:40rpx;background:#F4593C;color:#fff;border-radius:14rpx" bindtap="goWebview">
进入 H5 web-view(场景3)
</button>
<view style="font-size:24rpx;color:#A79C95;line-height:1.7;margin-top:32rpx;text-align:left">
操作步骤:<br/>
1. 点上面按钮进入 web-view(加载 wx-h5-demo);<br/>
2. H5 里点 ③「❌ 复现旧 bug:postMessage + navigateBack」;<br/>
3. 会立刻退回本页 —— 点右上角「···」转发;<br/>
4. 接收者打开卡片会落到本页(bug 现象)。<br/>
5. 改点 ②「✅ 正确分享」重走一遍,接收者应打开 H5 页面。
</view>
</view>

View File

@@ -0,0 +1,84 @@
// 场景3(✅ 正确实现):web-view 承载 H5 + 分享深链
// 路径:/pages/demo/share-webview.js
// ------------------------------------------------------------
// 关键点:web-view 里的 H5 不能自己拉起分享面板,卡片只能由本页的
// onShareAppMessage 产出。深链必须取微信回调参数
// options.webViewUrl(= 当前 web-view 的真实地址,含 H5 的 hash / SPA 路由),
// 再拼回本页 ?url=...,接收者打开的就是「发送者当时那一页」,而不是首页。
//
// ❌ 反面写法(复现 bug):scenario3-home-bug.js —— 写死 path、忽略 webViewUrl。
// 线上真实实现见 CRMEB:pages/annex/web_view/index.vue、pages/index/index.vue。
const H5_BASE = 'https://mp.yizhezhe.com/wx-h5-demo/';
// 剥掉分享链接里的身份/缓存参数:不能把发送者的 openid 带给接收者,
// 接收者身份由宿主页/容器按自己的 openid 重新注入。
const SHARE_DROP_KEYS = ['openid', 'unionid', 't', '_v', 'phone', 'nickname', 'avatar'];
function dropKeyValuePairs(str, keys) {
return String(str || '')
.split('&')
.filter(p => !!p && keys.indexOf(p.split('=')[0]) === -1)
.join('&');
}
function stripAuthParams(url) {
let out = String(url || '');
const hashIdx = out.indexOf('#');
let base = hashIdx >= 0 ? out.slice(0, hashIdx) : out;
let hash = hashIdx >= 0 ? out.slice(hashIdx + 1) : '';
const qIdx = base.indexOf('?');
let query = qIdx >= 0 ? base.slice(qIdx + 1) : '';
base = qIdx >= 0 ? base.slice(0, qIdx) : base;
query = dropKeyValuePairs(query, SHARE_DROP_KEYS);
hash = dropKeyValuePairs(hash, SHARE_DROP_KEYS);
return base + (query ? '?' + query : '') + (hash ? '#' + hash : '');
}
Page({
data: { url: '', shareTitle: '', shareImageUrl: '' },
onLoad(options) {
// 开启「转发给好友 / 分享到朋友圈」两项菜单
wx.showShareMenu({ menus: ['shareAppMessage', 'shareTimeline'] });
// 被分享卡片打开时带 ?url=<encoded 当前 H5 地址>;否则加载默认 H5
let target = H5_BASE;
if (options && options.url) {
try { target = decodeURIComponent(options.url); } catch (e) { target = options.url; }
}
console.log('[scenario3] 加载 H5:', target);
this.setData({ url: target });
},
// H5 点「分享」→ postMessage(action:'share') → 这里只缓存标题/图;
// 链接以 options.webViewUrl 为准(postMessage 投递有延迟,不能当深链来源)。
onMessage(e) {
const data = (e.detail && e.detail.data) || [];
(Array.isArray(data) ? data : [data]).forEach((m) => {
if (!m || m.action !== 'share') return;
console.log('[scenario3] H5 请求分享:', JSON.stringify(m));
if (m.title) this.setData({ shareTitle: m.title });
if (m.imageUrl) this.setData({ shareImageUrl: m.imageUrl });
wx.showToast({ title: '点击右上角 ··· 分享给好友', icon: 'none', duration: 2500 });
});
},
// ✅ 关键:用 options.webViewUrl 拼深链
onShareAppMessage(options) {
const target = (options && options.webViewUrl) || this.data.url;
const path = '/pages/demo/share-webview?url=' + encodeURIComponent(stripAuthParams(target));
console.log('[scenario3] onShareAppMessage → path=' + path);
return {
title: this.data.shareTitle || 'wx-h5-demo · 分享深链验证',
path: path,
imageUrl: this.data.shareImageUrl || ''
};
},
// onShareTimeline 没有回调参数(拿不到 webViewUrl),也不能自定义 path;
// 只能把目标 H5 放进 query,由本页 onLoad 读 ?url= 落地。
onShareTimeline() {
return {
title: this.data.shareTitle || 'wx-h5-demo · 分享深链验证',
query: 'url=' + encodeURIComponent(stripAuthParams(this.data.url))
};
}
});

View File

@@ -0,0 +1,11 @@
<!-- 场景3(✅ 正确):web-view 承载 H5 + 分享深链
路径:/pages/demo/share-webview
用法:把本页并入小程序并在 app.json 注册(路径 /pages/demo/share-webview)。
验证:
小程序「首页」→ 进本页 → H5 点 ②「正确分享」→ 停留本页 →
点右上角「···」转发 → 接收者打开的是同一个 H5 地址(含 hash 标记),不是首页。
说明:深链在 scenario3-share-webview.js 的 onShareAppMessage(options) 里
用 options.webViewUrl 拼出;H5 只负责 postMessage 标题/图。 -->
<web-view wx:if="{{url}}" src="{{url}}" bindmessage="onMessage"></web-view>
<view wx:else style="padding:40rpx;text-align:center;color:#A79C95">正在加载 H5…</view>