修复 H5 来馆第三方导航构建边界
Some checks failed
CI / verify (push) Has been cancelled

This commit is contained in:
lyf
2026-07-12 00:30:18 +08:00
parent e99d713dd0
commit e006333c0a
13 changed files with 560 additions and 523 deletions

View File

@@ -1,14 +1,3 @@
import { openExternalNavigation } from '@/services/MapNavigationService'
import {
isEmbeddedInWechatMiniProgram,
isNativeWechatMiniProgram
} from '@/utils/hostEnvironment'
import {
buildWechatOpenLocationPageUrl,
validateWechatOpenLocationTarget,
type WechatOpenLocationTarget
} from '@/utils/wechatOpenLocationProtocol'
export type ThirdPartyMapProvider = 'amap' | 'baidu' | 'tencent'
export interface ThirdPartyMapSearchTarget {
@@ -16,29 +5,6 @@ export interface ThirdPartyMapSearchTarget {
region: string
}
export type WechatMiniProgramLocationTarget = WechatOpenLocationTarget
interface WechatMiniProgramBridge {
getEnv?: (callback: (result: { miniprogram?: boolean }) => void) => void
navigateTo?: (options: {
url: string
success?: () => void
fail?: (error: unknown) => void
}) => void
}
export type WechatMiniProgramLocationOpenResult =
| { status: 'opened' }
| { status: 'not-embedded' }
| { status: 'failed'; reason: 'invalid-target' | 'bridge-unavailable' | 'not-in-mini-program' | 'navigation-failed' }
const BRIDGE_WAIT_TIMEOUT = 2500
const BRIDGE_POLL_INTERVAL = 50
const SDK_SCRIPT_LOAD_TIMEOUT = 10000
const GET_ENV_TIMEOUT = 1500
const NAVIGATION_TIMEOUT = 3000
let miniProgramNavigationPromise: Promise<WechatMiniProgramLocationOpenResult> | null = null
export interface ThirdPartyMapProviderOption {
provider: ThirdPartyMapProvider
label: string
@@ -89,226 +55,3 @@ export const openThirdPartyMapSearch = (
icon: 'none'
})
}
export const buildWechatMiniProgramOpenLocationUrl = (
target: WechatMiniProgramLocationTarget
) => buildWechatOpenLocationPageUrl(target)
const getWechatMiniProgramBridge = (): WechatMiniProgramBridge | null => {
if (typeof window === 'undefined') return null
return (window as Window & {
wx?: {
miniProgram?: WechatMiniProgramBridge
}
}).wx?.miniProgram || null
}
const ensureWechatJsSdkScript = () => {
if (typeof document === 'undefined' || getWechatMiniProgramBridge()) return
const existingScript = document.querySelector<HTMLScriptElement>('script[data-wechat-js-sdk="true"]')
if (existingScript) {
const startedAt = Number(existingScript.dataset.wechatJsSdkStartedAt || 0)
const isExpiredLoading = existingScript.dataset.wechatJsSdkState === 'loading'
&& Date.now() - startedAt > SDK_SCRIPT_LOAD_TIMEOUT
if (existingScript.dataset.wechatJsSdkState !== 'error' && !isExpiredLoading) return
existingScript.remove()
}
const script = document.createElement('script')
script.src = 'https://res.wx.qq.com/open/js/jweixin-1.6.0.js'
script.async = true
script.dataset.wechatJsSdk = 'true'
script.dataset.wechatJsSdkState = 'loading'
script.dataset.wechatJsSdkStartedAt = String(Date.now())
script.onload = () => {
script.dataset.wechatJsSdkState = 'loaded'
}
script.onerror = () => {
script.dataset.wechatJsSdkState = 'error'
script.remove()
}
try {
document.head.appendChild(script)
} catch (error) {
console.error('加载微信 JS SDK 失败:', error)
}
}
const isWechatBrowser = () => (
typeof window !== 'undefined'
&& /MicroMessenger/i.test(window.navigator?.userAgent || '')
)
const wait = (duration: number) => new Promise<void>((resolve) => {
setTimeout(resolve, duration)
})
const waitForWechatMiniProgramBridge = async () => {
const immediateBridge = getWechatMiniProgramBridge()
if (immediateBridge) return immediateBridge
ensureWechatJsSdkScript()
const startedAt = Date.now()
while (Date.now() - startedAt < BRIDGE_WAIT_TIMEOUT) {
await wait(BRIDGE_POLL_INTERVAL)
const bridge = getWechatMiniProgramBridge()
if (bridge) return bridge
}
return null
}
const resolveMiniProgramWebViewEnvironment = (
miniProgram: WechatMiniProgramBridge
) => {
if (isEmbeddedInWechatMiniProgram()) return Promise.resolve(true)
const getEnv = miniProgram.getEnv
if (!getEnv) return Promise.resolve(false)
return new Promise<boolean>((resolve) => {
let settled = false
const finish = (isMiniProgram: boolean) => {
if (settled) return
settled = true
clearTimeout(timeout)
resolve(isMiniProgram)
}
const timeout = setTimeout(() => finish(isEmbeddedInWechatMiniProgram()), GET_ENV_TIMEOUT)
try {
getEnv((result) => finish(Boolean(result?.miniprogram) || isEmbeddedInWechatMiniProgram()))
} catch (error) {
console.error('识别小程序 web-view 环境失败:', error)
// 保留超时重检,让延迟注入的宿主环境标识仍有机会生效。
}
})
}
const navigateToMiniProgramLocationPage = (
miniProgram: WechatMiniProgramBridge,
target: WechatMiniProgramLocationTarget
) => new Promise<WechatMiniProgramLocationOpenResult>((resolve) => {
let settled = false
const finish = (result: WechatMiniProgramLocationOpenResult) => {
if (settled) return
settled = true
clearTimeout(timeout)
resolve(result)
}
const timeout = setTimeout(() => {
uni.showToast({
title: '宿主地图页响应超时',
icon: 'none'
})
finish({ status: 'failed', reason: 'navigation-failed' })
}, NAVIGATION_TIMEOUT)
if (!miniProgram.navigateTo) {
uni.showToast({
title: '宿主地图桥接不可用',
icon: 'none'
})
finish({ status: 'failed', reason: 'bridge-unavailable' })
return
}
try {
miniProgram.navigateTo({
url: buildWechatMiniProgramOpenLocationUrl(target),
success: () => finish({ status: 'opened' }),
fail: (error) => {
if (settled) return
console.error('跳转小程序地图页失败:', error)
const errorMessage = typeof error === 'object' && error && 'errMsg' in error
? String(error.errMsg)
: ''
uni.showToast({
title: /page.*not found|not found.*page/i.test(errorMessage)
? '宿主小程序未配置地图页'
: '宿主地图页跳转失败',
icon: 'none'
})
finish({ status: 'failed', reason: 'navigation-failed' })
}
})
} catch (error) {
console.error('调用小程序地图桥接失败:', error)
uni.showToast({
title: '宿主地图桥接调用失败',
icon: 'none'
})
finish({ status: 'failed', reason: 'navigation-failed' })
}
})
const openWechatMiniProgramLocationOnce = async (
target: WechatMiniProgramLocationTarget
): Promise<WechatMiniProgramLocationOpenResult> => {
const validation = validateWechatOpenLocationTarget(target)
if (!validation.ok) {
uni.showToast({
title: validation.message,
icon: 'none'
})
return { status: 'failed', reason: 'invalid-target' }
}
if (isNativeWechatMiniProgram()) {
try {
const opened = await openExternalNavigation(validation.value)
return opened
? { status: 'opened' }
: { status: 'failed', reason: 'navigation-failed' }
} catch (error) {
console.error('原生小程序地图能力调用失败:', error)
uni.showToast({
title: '无法打开微信地图',
icon: 'none'
})
return { status: 'failed', reason: 'navigation-failed' }
}
}
if (!isEmbeddedInWechatMiniProgram() && !isWechatBrowser()) {
return { status: 'not-embedded' }
}
const miniProgram = await waitForWechatMiniProgramBridge()
if (!miniProgram?.navigateTo) {
if (isEmbeddedInWechatMiniProgram()) {
uni.showToast({
title: '小程序地图桥接加载失败',
icon: 'none'
})
return { status: 'failed', reason: 'bridge-unavailable' }
}
return { status: 'not-embedded' }
}
const isMiniProgramWebView = await resolveMiniProgramWebViewEnvironment(miniProgram)
if (!isMiniProgramWebView) {
if (isEmbeddedInWechatMiniProgram()) {
uni.showToast({
title: '当前页面未连接宿主小程序',
icon: 'none'
})
return { status: 'failed', reason: 'not-in-mini-program' }
}
return { status: 'not-embedded' }
}
return navigateToMiniProgramLocationPage(miniProgram, validation.value)
}
export const openWechatMiniProgramLocation = (
target: WechatMiniProgramLocationTarget
) => {
if (miniProgramNavigationPromise) return miniProgramNavigationPromise
miniProgramNavigationPromise = openWechatMiniProgramLocationOnce(target)
.finally(() => {
miniProgramNavigationPromise = null
})
return miniProgramNavigationPromise
}