daoqi/youle_app_ios_v2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Compare commits

base: daoqi/youle_app_ios_v2:8a7d543cdc7e99106b8db3b4b1a5df0bc25472e9
Branches Tags
daoqi/youle_app_ios_v2:master
...
compare: daoqi/youle_app_ios_v2:1203957924056a275269181c6faad378a78bf079
Branches Tags
daoqi/youle_app_ios_v2:master
2 Commits
8a7d543cdc ... 1203957924
Author SHA1 Message Date
joywayer 1203957924 修复定位的回调问题 2026-08-07 12:18:44 +08:00
joywayerandClaude Opus 5 3f8b382ad3 加桥/定位边界诊断日志，排查子游戏收不到 getlocationinfo 
现象：大厅 H5 能正确拿到定位，子游戏拿不到。已静态排除「子游戏未注册
handler」与「回调错发给大厅」两个猜测（BridgeBus 是 per-WebView 实例、
handlers 是实例状态，反向 call 捕获各自的 bridge，物理上不可能串台；
下载真实子游戏 zip 比对后确认 H5 侧大厅/子游戏逻辑完全对称）。

为定位真正的失败层，在各组件边界加日志（纯诊断，不改任何行为）：
- BridgeBus 加 label（lobby / subGame）区分来源，记录 ← H5 调用、
  → H5 反向 call、native handler 未注册、evaluateJavaScript 失败
- sendToJS 改为返回 'ok'/'no-bridge'，H5 侧 bridge 未就绪导致的静默丢包
  现在会打错误日志（原实现 `if (window.X)` 直接丢弃，完全不可见）
- LocationService 记录 requestOnce 序号 / shared manager id /
  requestLocation 的 BOOL 返回值 / completionBlock 是否回来 / stop() 调用
  —— 高德文档明确 requestLocation 返回 NO 时 completionBlock 永不调用，
  当前代码忽略该返回值会让 continuation 永挂，H5 连 errorCode 12 都收不到
- H5ErrorRelay 补 console.warn 中继，让 WVJB「H5 侧无对应 handler」的
  warn 能出现在 Xcode console

契约影响：无。仅新增日志与可选 label 参数，桥接接口名 / 字段名 / 数据结构
均未变动（docs/H5-Native-Contract.md §3.1［20］/ §3.2［6］不变）。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UMPCLfsuxvwgMotzsb67QH
 2026-08-07 01:54:18 +08:00
13 changed files with 696 additions and 161 deletions
Expand all files Collapse all files
docs/H5-Native-Contract.md
+51 -2
View File
@@ -616,13 +616,14 @@ H5 端无需任何改动：仍然按照"收到 `gameui_stop_voice(user)` 就停
**表 B — `getlocationinfo`** （成功）：
```jsonc
{
"errorCode": 0, // ⚠️ 新外壳补齐项，msext 遗漏，见下方说明
"address": "<完整地址>",
"city": "<市>",
"cityCode": "<城市编码>",
"country": "<国>",
"district": "<区>",
"latitude": "30.567890", // ⚠️ string，原生 stringWithFormat:@"%f"，不是 double
"longitude": "104.123456", // ⚠️ string
"latitude": 30.567890, // ⚠️ 数字（非字符串），6 位小数。新外壳修正项，见下方说明
"longitude": 104.123456, // ⚠️ 数字（非字符串），6 位小数
"province": "<省>", // ⚠️ 小写 p，与 sharelogin 的 "Province" 大写形成不一致，沿用历史
"street": "<街道>"
}
@@ -632,6 +633,54 @@ H5 端无需任何改动：仍然按照"收到 `gameui_stop_voice(user)` 就停
{ "errorCode": 12, "errorMsg": "缺少定位权限" } // errorCode 是 NSNumber，JSON 看是数字 12
```
**`errorCode: 0`（成功状态码）—— 唯一一处有意偏离 msext 的定位字段**
msext 全工程（`grep -rn errorCode msext/Class/`）只在**失败**分支发 `errorCode: 12`
（`gameController.m:2507` / `NewRootVC.m:2113` / 老 UIWebView 路径
`RootVC.m:1976` / `fourviewVC.m:1518`），成功分支的 9 个字段里**没有** errorCode。
**这是原工程的遗漏**，不是刻意设计。
H5 侧以 `errorCode == 0` 作为"这份定位数据有效"的判据。证据（2026-08-07 从真机沙盒
取回的现网 H5 逐字核对）：
| H5 包 | `05_Func.js` 日期 | 全文 `errorCode` |
|---|---|---|
| 子游戏 `jinxianmahjong` | 2026-07-19 | 有 2 处 —— `Func.startlocation` / `Func.getlocation` 的 `catch` 兜底桩自造定位对象时带 `"errorCode":0` |
| 大厅 `gamehall` | 2026-02-04 | **0 处** |
即：较新的子游戏 H5 依赖成功包里的 `errorCode`，较老的大厅 H5 不依赖。这正是
「大厅定位正常、子游戏拿不到定位」这一现象的成因 —— 原生成功包缺 `errorCode`
时子游戏 H5 不认这份数据。
因此新外壳在成功包里补 `errorCode: 0`（JSON 数字，与失败包的 `12` 同类型）。
对不检查该字段的大厅 H5 是多一个无害字段，不改变其行为。
**`latitude` / `longitude` 是数字，不是字符串 —— 第二处修正**
msext 的两条路径自己就不一致：
| msext 路径 | 代码 | JSON 形态 |
|---|---|---|
| WVJB / WKWebView（`gameController.m:2528`、`NewRootVC.m:2132`）| `[NSString stringWithFormat:@"%f", …]` 放进 `@{}` | **字符串** `"28.636486"` |
| 老 UIWebView / JSContext（`RootVC.m:1998`、`fourviewVC.m:1541`）| 手拼 `\"latitude\":%f` | **数字** `28.636486` |
现网子游戏 H5（`jinxianmahjong` `05_Func.js:2029-2031`）兜底桩自造的定位对象写的是
`"latitude":28.623546` —— **数字**形态。与 `errorCode` 是同一类问题：WVJB 路径当年
把它字符串化了。新外壳按数字发。
实现细节：用 `BridgeData.decimal(Decimal)`（不是 `.number(Double)`）。原因是
`JSONSerialization` 写 `Double` 会输出 17 位有效数字，`28.636486` 变成
`28.636486000000001`；虽然 JS `JSON.parse` 出来是同一个 IEEE754 double、H5 不可分辨，
但 JSON 文本与原工程不一致。`Decimal` 由 `String(format: "%f", …)` 构造，序列化成
`NSDecimalNumber` → 文本 `28.636486`，与老路径 `%f` 拼串逐字节一致。
**这两处（`errorCode: 0`、经纬度数字）是定位链路上唯一有意偏离 msext WVJB 路径的地方**，
其余（9 个字段名、`cityCode` 大写 C、`province` 小写 p、`street` 不带 `路` 后缀、
失败包 `{errorCode:12, errorMsg:"缺少定位权限"}`、error 与 success 两段式发送顺序、
任一逆地理字段为 nil 时整条不发）全部严格对齐。
实现：`Source/Bridge/Handlers/StartLocationHandler.swift`、`Source/Location/LocationService.swift`。
**表 C — `sharelogin`**：
```jsonc
{
ylgamehall/Resources/ChannelConfig.plist
+3 -3
View File
@@ -5,9 +5,9 @@
<key>gameid</key>
<string>G2hw0ubng0zcoI0r4mx3H2yr4GejidwO</string>
<key>channel</key>
<string>FtJf073aa0d6rI1xD8J1Y42fINTm0ziK</string>
<string>frdt0C1GG0t91P0McFo0rbA1he5yurbS</string>
<key>gamedir</key>
<string>FtJf073aa0d6rI1xD8J1Y42fINTm0ziK</string>
<string>frdt0C1GG0t91P0McFo0rbA1he5yurbS</string>
<key>gamestart</key>
<string>gamehall</string>
<key>gameconfig</key>
@@ -15,7 +15,7 @@
<key>market</key>
<string>2</string>
<key>agent</key>
<string>veRa0qrBf0df2K1G4de2tgfmVxB2jxpv</string>
<string>00bA05haB0d9ZC0fwGD09Q2OA30insbQ</string>
<key>appversion</key>
<string>44</string>
<key>other</key>
ylgamehall/Resources/JS/WebViewJavascriptBridge.js
+126 -72
View File
@@ -4,8 +4,26 @@
* H5 端桥协议代码，与 Native BridgeBus（@MainActor BridgeProtocol 实现）
* 一一对应。详见 docs/H5-Native-Implementation-Design.md §3.2 / §3.3。
*
* 在 BridgedWebView 构造时通过 WKUserScript（.atDocumentStart）注入到所有
* 加载的 H5 页面。H5 业务代码运行时，window.WebViewJavascriptBridge 已就绪。
* ⚠️ 本文件的**语义**必须与原工程 msext 的 `WebViewJavascriptBridge_JS.m`
* （marcuswestin 原版，daoqi/msext/Class/WebViewJavascriptBridge/）保持一致。
* 传输层可以现代化（msext 用 iframe + _fetchQueue 拉取，我们用
* WKScriptMessageHandler 直推），但**派发时机与消息字段必须逐项对齐**，
* 否则 H5 侧同一份代码在两个壳里的执行顺序不同 → 行为不一致。
*
* 已对齐的 msext 语义（每一条都曾经不一致，是排查「子游戏定位拿不到」时发现的）：
*
* 1. **异步派发**：msext `dispatchMessagesWithTimeoutSafety = true`，且
* `disableJavscriptAlertBoxSafetyTimeout` 在整个 msext 工程里**从未被调用**，
* 所以 Native → H5 的每一条消息都走 `setTimeout(_doDispatch)`，在**新的
* macrotask** 上执行。早前本文件是同步派发（在 evaluateJavaScript 内直接
* 调 handler），H5 handler 相对自身 pending 脚本/微任务的顺序与 msext 不同。
* 2. **WVJBCallbacks 用 `setTimeout(..., 0)` flush**（msext `_callWVJBCallbacks`），
* 不是同步 flush —— 决定 H5 的 `registerHandler` 何时生效。
* 3. **H5 → Native 的 response 消息带 `handlerName`**（msext `_doSend({handlerName,
* responseId, responseData})`）。
* 4. `_disableJavascriptAlertBoxSafetyTimeout` 作为 H5 侧 handler 注册（msext 有）。
* 5. 缺省安装 `window.onerror`（msext 在 H5 未装时兜底装一个）。
* 6. 「收到 Native 消息但没有对应 handler」用 `console.log`（msext 原文），不是 warn。
*
* 协议（Native ↔ H5 双向 JSON 消息）：
* - H5 → Native：window.webkit.messageHandlers.WVJBHandler.postMessage({...})
@@ -18,18 +36,26 @@
;(function () {
if (window.WebViewJavascriptBridge) { return; }
// msext 同款：H5 没装 onerror 时兜底装一个
if (!window.onerror) {
window.onerror = function (msg, url, line) {
console.log("WebViewJavascriptBridge: ERROR:" + msg + "@" + url + ":" + line);
};
}
// ── 内部状态 ─────────────────────────────────────────────
var messageHandlers = {}; // H5 注册的 handler：name → fn(data, responseCallback)
var responseCallbacks = {}; // 等待 Native 响应的 JS 回调：callbackId → fn(responseData)
var nextCallbackId = 1;
// msext `dispatchMessagesWithTimeoutSafety`：默认 true，仅在 Native 下发
// `_disableJavascriptAlertBoxSafetyTimeout` 时置 false（msext 从不下发）。
var dispatchMessagesWithTimeoutSafety = true;
// ── 对外 API ─────────────────────────────────────────────
var bridge = window.WebViewJavascriptBridge = {
/**
* H5 注册 handler，等待 Native 主动 callHandler。重名覆盖。
* @param {string} handlerName
* @param {function(data, responseCallback)} handler
*/
registerHandler: function (handlerName, handler) {
messageHandlers[handlerName] = handler;
@@ -37,39 +63,31 @@
/**
* H5 主动调 Native handler。
* @param {string} handlerName
* @param {*} data 任意 JSON 可序列化值
* @param {function(responseData)} [responseCallback]
* msext `callHandler` 支持 2 参形式（第二个参数是函数时视为 responseCallback）。
*/
callHandler: function (handlerName, data, responseCallback) {
var callbackId = null;
if (typeof responseCallback === 'function') {
callbackId = 'cb_' + (nextCallbackId++) + '_' + Date.now();
responseCallbacks[callbackId] = responseCallback;
if (arguments.length === 2 && typeof data === 'function') {
responseCallback = data;
data = null;
}
var message = { handlerName: handlerName };
if (data !== undefined && data !== null) {
message.data = data;
}
if (callbackId) {
message.callbackId = callbackId;
}
_postMessageToNative(message);
_doSend({ handlerName: handlerName, data: data }, responseCallback);
},
disableJavscriptAlertBoxSafetyTimeout: function () {
dispatchMessagesWithTimeoutSafety = false;
},
/**
* Native → H5 入口。BridgeBus.sendToJS 会注入：
* window.WebViewJavascriptBridge._handleMessageFromObjC('<base64of JSON>')
* base64 包装是为了避免 JSON 内容里的单引号 / 反斜杠扰乱 evaluateJavaScript 的字符串字面量。
* base64 包装是为了避免 JSON 内容里的单引号 / 反斜杠扰乱 evaluateJavaScript
* 的字符串字面量（msext 走的是逐个 escape，等价）。
*
* ⚠️ 无返回值：msext 的派发是 setTimeout 异步的，拿不到「H5 有没有跑到
* handler」的同步结果。原生侧不要依赖它的返回值做诊断。
*/
_handleMessageFromObjC: function (base64String) {
try {
var json = _decodeBase64UTF8(base64String);
var message = JSON.parse(json);
_dispatchFromNative(message);
} catch (e) {
console.error('[WVJB] handle message from native failed:', e);
}
_dispatchMessageFromObjC(base64String);
}
};
@@ -79,42 +97,77 @@
try {
window.webkit.messageHandlers.WVJBHandler.postMessage(message);
} catch (e) {
console.error('[WVJB] post to native failed (WVJBHandler 通道未注册?):', e);
console.log('[WVJB] post to native failed (WVJBHandler 通道未注册?):', e);
}
}
function _dispatchFromNative(message) {
// Native 响应 H5 早前 callHandler
if (message.responseId) {
var cb = responseCallbacks[message.responseId];
if (cb) {
delete responseCallbacks[message.responseId];
try { cb(message.responseData); }
catch (e) { console.error('[WVJB] response callback threw:', e); }
function _doSend(message, responseCallback) {
if (typeof responseCallback === 'function') {
var callbackId = 'cb_' + (nextCallbackId++) + '_' + new Date().getTime();
responseCallbacks[callbackId] = responseCallback;
message['callbackId'] = callbackId;
}
_postMessageToNative(message);
}
/// msext `_dispatchMessageFromObjC` 逐句等价：默认走 setTimeout（新 macrotask）。
function _dispatchMessageFromObjC(base64String) {
if (dispatchMessagesWithTimeoutSafety) {
setTimeout(_doDispatchMessageFromObjC);
} else {
_doDispatchMessageFromObjC();
}
function _doDispatchMessageFromObjC() {
var message;
try {
message = JSON.parse(_decodeBase64UTF8(base64String));
} catch (e) {
console.log('[WVJB] handle message from native failed:', e);
return;
}
return;
}
// Native 主动调用 H5 handler
var handler = messageHandlers[message.handlerName];
if (!handler) {
console.warn('[WVJB] no H5 handler registered for:', message.handlerName);
return;
}
var responseCallback;
var responseCallback;
if (message.callbackId) {
var responseId = message.callbackId;
responseCallback = function (responseData) {
if (message.responseId) {
responseCallback = responseCallbacks[message.responseId];
if (!responseCallback) { return; }
responseCallback(message.responseData);
delete responseCallbacks[message.responseId];
return;
}
if (message.callbackId) {
var callbackResponseId = message.callbackId;
responseCallback = function (responseData) {
// msext 同款：response 消息里**带 handlerName**
_doSend({
handlerName: message.handlerName,
responseId: callbackResponseId,
responseData: responseData
});
};
}
var handler = messageHandlers[message.handlerName];
if (!handler) {
console.log("WebViewJavascriptBridge: WARNING: no handler for message from ObjC:", message);
// 诊断上报（不改 msext 语义，只是额外往自家通道发一条原生侧忽略的消息）
_postMessageToNative({ diagDispatched: message.handlerName, hadHandler: false });
} else {
var threw = null;
try { handler(message.data, responseCallback); }
catch (e) { threw = String(e); }
_postMessageToNative({
responseId: responseId,
responseData: responseData
diagDispatched: message.handlerName,
hadHandler: true,
threw: threw
});
};
// msext 不吞异常（handler 抛错会冒到 setTimeout 的全局 onerror）；
// 这里把它原样重抛，保持行为一致，只是先记录了一笔。
if (threw !== null) { throw new Error(threw); }
}
}
try { handler(message.data, responseCallback); }
catch (e) { console.error('[WVJB] H5 handler "' + message.handlerName + '" threw:', e); }
}
/**
@@ -127,25 +180,26 @@
}).join(''));
}
// msext 同款：把 Native 可下发的 safety-timeout 开关注册成 H5 侧 handler
bridge.registerHandler("_disableJavascriptAlertBoxSafetyTimeout",
bridge.disableJavscriptAlertBoxSafetyTimeout);
// ── 告知原生「桥已就绪」──────────────────────────────────
// 等价 msext 的 `__bridge_loaded__` iframe 回调 → `injectJavascriptFile` →
// flush `startupMessageQueue`。原生在收到本消息前发出的 callHandler 必须排队，
// 不能丢（msext 有 startupMessageQueue，早前我们是直接丢弃）。
_postMessageToNative({ bridgeReady: true });
// ── marcuswestin 旧式握手兼容 ─────────────────────────────
// 部分 H5 代码这样初始化 bridge：
// function setupWebViewJavascriptBridge(callback) {
// if (window.WebViewJavascriptBridge) return callback(WebViewJavascriptBridge);
// if (window.WVJBCallbacks) return window.WVJBCallbacks.push(callback);
// window.WVJBCallbacks = [callback];
// /* iframe trick - WKWebView 模式不需要 */
// }
// setupWebViewJavascriptBridge(function (bridge) { bridge.registerHandler(...) });
//
// 我们在 documentStart 就注入 bridge，正常路径下 H5 拿到的 window.WebViewJavascriptBridge
// 已存在，会立即同步 callback(bridge)。但若 H5 代码本身用了 WVJBCallbacks 队列模式
// (Array.push 在 bridge 之前)，需要在此处 flush 一次。
if (Array.isArray(window.WVJBCallbacks)) {
var pending = window.WVJBCallbacks;
// msext `_callWVJBCallbacks` 用 setTimeout(..., 0)，**不是同步 flush**：
// 这决定 H5 的 registerHandler 相对页面其它顶层脚本的生效时机。
setTimeout(function () {
var callbacks = window.WVJBCallbacks;
if (!callbacks) { return; }
delete window.WVJBCallbacks;
for (var i = 0; i < pending.length; i++) {
try { pending[i](bridge); }
catch (e) { console.error('[WVJB] pending WVJBCallback threw:', e); }
for (var i = 0; i < callbacks.length; i++) {
try { callbacks[i](bridge); }
catch (e) { console.log('[WVJB] pending WVJBCallback threw:', e); }
}
}
}, 0);
})();
ylgamehall/Source/Bridge/BridgeBus.swift
+156 -7
View File
@@ -8,6 +8,75 @@
import Foundation
import WebKit
import os.log
/// 桥诊断日志。文件级 `let`（Logger 是 Sendable）以便在 evaluateJavaScript
/// 完成回调等非 MainActor 上下文里也能直接用。
private let bridgeLog = Logger(subsystem: "ylgamehall", category: "Bridge")
/// ── 临时诊断输出（排查「子游戏收不到 getlocationinfo」，结束后整体移除）──
///
/// 真机上 `Logger.debug` 会被系统日志级别过滤掉：devicectl console / Xcode
/// console 都只能看到 `.error` 及以上。`print` 直写 stderr 必达，所以诊断期
/// 统一走这里；带毫秒时间戳以便与 CoreLocation 的 os_log 行对齐时序。
/// 同时落盘到 `Documents/diag.log`：用 Xcode 跑真机时 print 只进 Xcode console，
/// 外部拿不到；落盘后可用
/// xcrun devicectl device copy from --domain-type appDataContainer \
/// --domain-identifier com.skyapp.ylgamehall --source Documents/diag.log ...
/// 把整轮日志取出来分析。
nonisolated func diagLog(_ message: String) {
let line = "[DIAG \(diagTimestamp())] \(message)"
print(line)
diagFileSink.append(line)
}
private nonisolated let diagFormatter: DateFormatter = {
let f = DateFormatter()
f.dateFormat = "HH:mm:ss.SSS"
return f
}()
private nonisolated func diagTimestamp() -> String {
diagFormatter.string(from: Date())
}
/// 串行写入 `Documents/diag.log`。每个进程首次写入前插一行 session 分隔，
/// 便于区分多次启动。纯诊断设施，排查结束随 diagLog 一并移除。
// 工程默认 SWIFT_DEFAULT_ACTOR_ISOLATION = MainActor，需显式 nonisolated 才能在
// @Sendable 桥回调 / evaluateJavaScript 完成块里同步调用。
private nonisolated final class DiagFileSink: @unchecked Sendable {
private let queue = DispatchQueue(label: "ylgamehall.diag.log")
private let url: URL
private var wroteHeader = false
init() {
let dir = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)[0]
url = dir.appendingPathComponent("diag.log")
}
func append(_ line: String) {
queue.async { [self] in
var text = line + "\n"
if !wroteHeader {
wroteHeader = true
let stamp = ISO8601DateFormatter().string(from: Date())
text = "\n===== session \(stamp) pid=\(ProcessInfo.processInfo.processIdentifier) =====\n" + text
}
guard let data = text.data(using: .utf8) else { return }
let fm = FileManager.default
if !fm.fileExists(atPath: url.path) {
fm.createFile(atPath: url.path, contents: nil)
}
guard let handle = try? FileHandle(forWritingTo: url) else { return }
handle.seekToEndOfFile()
handle.write(data)
try? handle.close()
}
}
}
private nonisolated let diagFileSink = DiagFileSink()
/// H5 ↔ Native 消息总线。
///
@@ -24,14 +93,33 @@ public final class BridgeBus: NSObject, BridgeProtocol, WKScriptMessageHandler {
/// JS 端注入的全局桥对象名（约定 `window.WebViewJavascriptBridge`）。
public static let jsBridgeName = "WebViewJavascriptBridge"
/// 容器标识（`lobby` / `subGame` / …），仅用于诊断日志区分是哪个 WebView 的桥。
/// 不参与任何契约行为。
public let label: String
private weak var webView: WKWebView?
private var handlers: [String: BridgeHandler] = [:]
private var pendingCallbacks: [String: BridgeCallback] = [:]
private var nativeCallbackCounter: UInt64 = 0
/// 桥就绪前的消息暂存队列。等价 msext `WebViewJavascriptBridgeBase.startupMessageQueue`：
/// `_queueMessage` 在 bridge 尚未 loaded 时入队，`injectJavascriptFile` 时按序 flush。
///
/// 早前的实现在 `window.WebViewJavascriptBridge` 不存在时**直接丢弃**消息 ——
/// 真机日志里每次启动都有一条 `sendToJS 'getnetwork' 未送达 H5：no-bridge`，
/// msext 里这条是会补发到 H5 的。子游戏 WebView 是全新建的、H5 很早就调
/// `startlocation`，反向 `getlocationinfo` 落在这个窗口里就会被静默吞掉。
private var startupMessageQueue: [[String: Any]] = []
/// H5 侧 WVJB.js 初始化完成后会 postMessage `{bridgeReady:true}`，收到即置 true 并 flush。
private var bridgeReady = false
/// 构造时绑定 WebView + 用户内容控制器，自动注册 `WVJBHandler` 消息处理器。
public init(webView: WKWebView, controller: WKUserContentController) {
public init(webView: WKWebView,
controller: WKUserContentController,
label: String = "webview") {
self.webView = webView
self.label = label
super.init()
controller.add(self, name: Self.scriptMessageHandlerName)
}
@@ -40,6 +128,7 @@ public final class BridgeBus: NSObject, BridgeProtocol, WKScriptMessageHandler {
public func register(_ name: String, handler: @escaping BridgeHandler) {
handlers[name] = handler
diagLog("[\(self.label)] register handler '\(name)'")
}
public func call(_ name: String, data: BridgeData?, callback: BridgeCallback?) {
@@ -53,6 +142,10 @@ public final class BridgeBus: NSObject, BridgeProtocol, WKScriptMessageHandler {
pendingCallbacks[cbId] = callback
payload["callbackId"] = cbId
}
// 诊断：打出实际序列化后的字节，确认字段集合 / 类型 / 引号与 msext 一致
let wire = (try? JSONSerialization.data(withJSONObject: payload, options: [.sortedKeys]))
.flatMap { String(data: $0, encoding: .utf8) } ?? "<encode-failed>"
diagLog("[\(self.label)] → H5 callHandler '\(name)' wire=\(wire)")
sendToJS(payload: payload)
}
@@ -73,6 +166,27 @@ public final class BridgeBus: NSObject, BridgeProtocol, WKScriptMessageHandler {
// MARK: - 私有
private func handleIncoming(_ msg: [String: Any]) {
// H5 侧 WVJB.js 初始化完成信号（等价 msext 的 `__bridge_loaded__`）。
// 每次导航都会重新注入 user script，因此会重复收到；每次都要重新 flush。
if msg["bridgeReady"] as? Bool == true {
bridgeReady = true
let queued = startupMessageQueue
startupMessageQueue.removeAll()
if !queued.isEmpty {
diagLog("[\(self.label)] 桥就绪，flush \(queued.count) 条暂存消息")
}
for payload in queued { dispatchToJS(payload: payload) }
return
}
// 诊断上报：H5 侧派发结果（有没有对应 handler、handler 有没有抛错）
if let dispatched = msg["diagDispatched"] as? String {
let had = msg["hadHandler"] as? Bool ?? false
let threw = msg["threw"] as? String
diagLog("[\(self.label)] H5 派发 '\(dispatched)'：hadHandler=\(had) threw=\(threw ?? "nil")")
return
}
// 优先判 responseId（JS 响应 Native 早前的 callHandler）
if let responseId = msg["responseId"] as? String {
let respData = msg["responseData"].flatMap { BridgeData(jsonObject: $0) }
@@ -95,9 +209,19 @@ public final class BridgeBus: NSObject, BridgeProtocol, WKScriptMessageHandler {
// 构造一个回调闭包，handler 调用即把 responseData 异步派回 JS
let responseCallback: BridgeCallback? = makeResponseCallback(for: callbackId)
diagLog("[\(self.label)] ← H5 call '\(name)' data=\(String(describing: msg["data"]))")
guard let handler = handlers[name] else {
print("[BridgeBus] no handler registered for '\(name)'")
responseCallback?(nil)
// msext `WebViewJavascriptBridgeBase.flushMessageQueue`：
// if (!handler) { NSLog(@"WVJBNoHandlerException, ..."); continue; }
// `continue` 意味着 **responseCallback 一次都不会被调用**。
//
// 早前这里调了 `responseCallback?(nil)`，会给 H5 回一条 {responseId:...}。
// 现网 H5 的 `Func.getlocation()` 就是带 callback 调 `getlocationinfo` 的
// （`bridge.callHandler('getlocationinfo',"",function(resp){})`，而
// `getlocationinfo` 两边都没有对应的原生 handler），于是这条在原工程里
// 永不触发的 JS 回调在我们这儿会被触发一次 —— 链条不一致。改为不回。
diagLog("[\(self.label)] no NATIVE handler registered for '\(name)'（msext 同款：不回 responseCallback）")
return
}
@@ -124,17 +248,42 @@ public final class BridgeBus: NSObject, BridgeProtocol, WKScriptMessageHandler {
sendToJS(payload: payload)
}
/// 等价 msext `WebViewJavascriptBridgeBase._queueMessage:`：
/// 桥未就绪则入 `startupMessageQueue`，就绪则直接派发。
private func sendToJS(payload: [String: Any]) {
guard let webView else { return }
guard bridgeReady else {
let what = (payload["handlerName"] as? String) ?? (payload["responseId"] as? String) ?? "?"
diagLog("[\(self.label)] '\(what)' 桥未就绪 → 入队（msext startupMessageQueue 等价，队列长 \(startupMessageQueue.count + 1)）")
startupMessageQueue.append(payload)
return
}
dispatchToJS(payload: payload)
}
/// 等价 msext `_dispatchMessage:`：序列化 → 注入 `_handleMessageFromObjC`。
/// H5 侧派发是 `setTimeout` 异步的（msext dispatchMessagesWithTimeoutSafety=true），
/// 因此 evaluateJavaScript 的返回值**不代表** H5 handler 是否执行，不要据此判断送达。
private func dispatchToJS(payload: [String: Any]) {
guard let webView else {
diagLog("[\(self.label)] dispatchToJS 丢弃：webView 已释放")
return
}
guard let data = try? JSONSerialization.data(withJSONObject: payload),
let json = String(data: data, encoding: .utf8)
else {
print("[BridgeBus] JSON encode failed for payload: \(payload)")
diagLog("[\(self.label)] JSON encode failed for payload: \(String(describing: payload))")
return
}
// base64 包装避免 JSON 内单引号 / 反斜杠扰乱 JS 字符串字面量
// （msext 是逐个 escape 反斜杠/引号/换行/U+2028/U+2029，等价）
let base64 = Data(json.utf8).base64EncodedString()
let js = "if (window.\(Self.jsBridgeName)) window.\(Self.jsBridgeName)._handleMessageFromObjC('\(base64)');"
webView.evaluateJavaScript(js, completionHandler: nil)
let js = "window.\(Self.jsBridgeName)._handleMessageFromObjC('\(base64)');"
let tag = label
let what = (payload["handlerName"] as? String) ?? (payload["responseId"] as? String) ?? "?"
webView.evaluateJavaScript(js) { _, error in
if let error {
diagLog("[\(tag)] dispatchToJS '\(what)' evaluateJavaScript 失败: \(error.localizedDescription)")
}
}
}
}
ylgamehall/Source/Bridge/BridgeProtocol.swift
+15 -2
View File
@@ -43,6 +43,14 @@ public typealias BridgeCallback = @Sendable (BridgeData?) -> Void
public enum BridgeData: Sendable {
case string(String)
case number(Double)
/// 定点小数。序列化成 JSON **数字**，但保留给定的小数位数文本。
///
/// 为什么不用 `.number(Double)`：`JSONSerialization` 写 Double 会输出 17 位有效
/// 数字，`28.636486` 变成 `28.636486000000001`。虽然 JS `JSON.parse` 出来是同一个
/// IEEE754 double（H5 侧不可分辨），但 JSON **文本**与原工程不一致。
/// `getlocationinfo` 的经纬度要求与 msext 老 UIWebView 路径
/// （`RootVC.m:1998` 拼 `\"latitude\":%f`）的字面文本对齐，故走这条。
case decimal(Decimal)
case bool(Bool)
case null
case array([BridgeData])
@@ -89,6 +97,7 @@ extension BridgeData {
switch self {
case .string(let s): return s
case .number(let d): return d
case .decimal(let d): return d as NSDecimalNumber
case .bool(let b): return b
case .null: return NSNull()
case .array(let arr): return arr.map { $0.jsonObject }
@@ -124,6 +133,7 @@ extension BridgeData {
return String(Int(d))
}
return String(d)
case .decimal(let d): return "\(d)"
case .bool(let b): return b ? "true" : "false"
case .null: return nil
case .array, .object: return nil
@@ -131,8 +141,11 @@ extension BridgeData {
}
nonisolated public var asDouble: Double? {
if case .number(let d) = self { return d }
return nil
switch self {
case .number(let d): return d
case .decimal(let d): return (d as NSDecimalNumber).doubleValue
default: return nil
}
}
nonisolated public var asInt: Int? {
ylgamehall/Source/Bridge/H5ErrorRelay.swift
+18 -4
View File
@@ -47,20 +47,25 @@ public final class H5ErrorRelay: NSObject {
switch kind {
case "console.error":
let args = (dict["args"] as? [String]) ?? []
print("[H5 console.error]", args.joined(separator: " "))
diagLog("[H5 console.error] " + args.joined(separator: " "))
case "console.warn":
// 桥诊断需要：WebViewJavascriptBridge.js 在「Native 发来的 handlerName
// H5 侧没注册」时走 console.warn，之前不上报导致这类丢包完全不可见。
let args = (dict["args"] as? [String]) ?? []
diagLog("[H5 console.warn] " + args.joined(separator: " "))
case "onerror":
let msg = (dict["msg"] as? String) ?? ""
let src = (dict["src"] as? String) ?? ""
let line = (dict["line"] as? Int) ?? 0
let col = (dict["col"] as? Int) ?? 0
let stack = dict["stack"] as? String
print("[H5 onerror] \(msg) at \(src):\(line):\(col)" + (stack.map { "\n\($0)" } ?? ""))
diagLog("[H5 onerror] \(msg) at \(src):\(line):\(col)" + (stack.map { "\n\($0)" } ?? ""))
case "unhandledrejection":
let reason = (dict["reason"] as? String) ?? ""
let stack = dict["stack"] as? String
print("[H5 unhandledrejection]", reason + (stack.map { "\n\($0)" } ?? ""))
diagLog("[H5 unhandledrejection] " + reason + (stack.map { "\n\($0)" } ?? ""))
default:
print("[H5 unknown error]", dict)
diagLog("[H5 unknown error] \(dict)")
}
}
@@ -80,6 +85,15 @@ public final class H5ErrorRelay: NSObject {
} catch(e){}
if (origErr) { origErr.apply(console, arguments); }
};
var origWarn = console.warn;
console.warn = function(){
try {
var args = [];
for (var i=0; i<arguments.length; i++) { args.push(String(arguments[i])); }
send({ kind:'console.warn', args: args });
} catch(e){}
if (origWarn) { origWarn.apply(console, arguments); }
};
window.addEventListener('error', function(ev){
send({
kind:'onerror',
ylgamehall/Source/Bridge/Handlers/BackGameDataHandler.swift
+5 -3
View File
@@ -21,7 +21,7 @@
//
// ✅ Phase 4.E 微信：新版 SDK（2.x）无 static delegate API，逐次调用 handleOpenURL/sendAuthReq
// 时传入并被 SDK 弱引用；WeChatManager singleton 长生命周期，子游戏 pop 不析构，无需清理
// ✅ Phase 5 高德定位：`LocationService.shared.stop()`（已加，canImport 守卫，
// ✅ Phase 5 高德定位：`location.stop()`（子游戏私有实例，canImport 守卫，
// Xcode Embed AMapLocationKit 后激活）
// ⏳ Phase 3.B/C/D 录音 / 七牛上传：`AudioRecorder.shared.cancel()` 待 opencore-amr
// 接入后取消注释；`QiniuUploader.cancelInFlight()` 依赖 Task.cancel 传播无需显式调
@@ -34,7 +34,9 @@ import Foundation
public enum BackGameDataHandler {
public static func register(on bridge: any BridgeProtocol) {
/// - Parameter location: **子游戏自己的** LocationService（msext cleanUpAction
/// 只停 gameController 那一个 manager，不影响大厅）。
public static func register(on bridge: any BridgeProtocol, location: LocationService) {
// 【18】backgameData
// 入参 data（字符串，子游戏 H5 自定义透传给大厅 getWebdata）
// cb: "backgameData"
@@ -57,7 +59,7 @@ public enum BackGameDataHandler {
#if canImport(AMapLocationKit)
// msext gameController.m:2473-2478 cleanUpAction 等价
LocationService.shared.stop()
location.stop(caller: "backgameData")
#endif
// Phase 3.C 录音 / Phase 3.B 七牛上传 清理（QiniuUploader.cancelInFlight 当前
ylgamehall/Source/Bridge/Handlers/StartLocationHandler.swift
+68 -29
View File
@@ -17,43 +17,82 @@
//
import Foundation
import os.log
// 工程默认 SWIFT_DEFAULT_ACTOR_ISOLATION = MainActor，全局 let 也会被 MainActor 隔离；
// handler 闭包是 @Sendable 非隔离上下文，故显式 nonisolated（Logger 本身 Sendable，安全）。
private nonisolated let startLocLog = Logger(subsystem: "ylgamehall", category: "Location")
public enum StartLocationHandler {
public static func register(on bridge: any BridgeProtocol) {
bridge.register("startlocation") { _, callback in
/// - Parameters:
/// - label: 容器标识（`lobby` / `subGame`），仅用于诊断日志。
/// - location: **本容器私有**的 LocationService。msext 大厅 / 子游戏各持一个
/// `AMapLocationManager`，不可共用（见 LocationService.init 注释）。
public static func register(on bridge: any BridgeProtocol,
label: String = "?",
location: LocationService) {
bridge.register("startlocation") { data, callback in
// 与 msext 行为一致：先回 cb 字面，不等定位完成
callback?(.string("startlocation"))
diagLog("[\(label)] ← startlocation 入参 type=\(data?.asLooseString ?? "nil")")
#if canImport(AMapLocationKit)
// SDK 已链接：拉起一次性定位 → 反向 callback 9 字段
// （持续定位 data == 1 暂未实现，业务实际只调一次性 — Phase 5.4 再扩展）
// msext NewRootVC.m:411-421 / gameController.m:533-543 的分支逐字等价：
// int tempinfo = [data intValue];
// if (tempinfo == 1) [self.locationManager startUpdatingLocation]; // 持续
// else [self reGeocodeAction]; // 单次
// 现网两个 H5 包（gamehall / jinxianmahjong）实测入参恒为 2，持续定位分支
// 是死代码；但 msext 有、我们缺就是原生侧的行为不一致，按 msext 补齐。
let isContinuous = Int(data?.asLooseString ?? "") == 1
Task { @MainActor in
do {
let payload = try await LocationService.shared.requestOnce()
bridge.call("getlocationinfo", data: .object([
"address": .string(payload.address),
"city": .string(payload.city),
"cityCode": .string(payload.cityCode),
"country": .string(payload.country),
"district": .string(payload.district),
"latitude": .string(payload.latitude), // ← string
"longitude": .string(payload.longitude), // ← string
"province": .string(payload.province), // ← 小写 p
"street": .string(payload.street)
]), callback: nil)
} catch LocationError.authorizationDenied {
// 契约失败回包（msext gameController.m:2507 等价）
bridge.call("getlocationinfo", data: .object([
"errorCode": .number(12),
"errorMsg": .string("缺少定位权限")
]), callback: nil)
} catch {
// 其它失败也归一到 12（msext 行为）
bridge.call("getlocationinfo", data: .object([
"errorCode": .number(12),
"errorMsg": .string("缺少定位权限")
]), callback: nil)
// 单次路径下一次请求可能产出两条 outcome（msext completionBlock 的原始
// 控制流）；持续路径下每次定位更新都会回一条 .success。
let dispatch: @MainActor (LocationOutcome) -> Void = { outcome in
switch outcome {
case .failure:
// msext gameController.m:2507 等价
diagLog("[\(label)] → getlocationinfo errorCode=12")
bridge.call("getlocationinfo", data: .object([
"errorCode": .number(12),
"errorMsg": .string("缺少定位权限")
]), callback: nil)
case .success(let payload):
// msext gameController.m:2528 的 9 字段 + `errorCode: 0`。
//
// ⚠️ 契约影响（docs/H5-Native-Contract.md §3.2 表 B）：
// msext 全工程只在**失败**分支发 `errorCode: 12`，成功分支
// 9 个字段里**没有** errorCode —— 这是原工程的遗漏。
// H5 侧以 `errorCode == 0` 作为"定位数据有效"的判据：
// 子游戏 jinxianmahjong 的 05_Func.js（2026-07-19）在
// `Func.startlocation` / `Func.getlocation` 的兜底桩里
// 自造的定位对象就带 `"errorCode":0`；而大厅 gamehall 的
// 05_Func.js（2026-02-04）整份文件都没有 errorCode。
// 这正是"大厅定位正常、子游戏拿不到"的原生侧成因：成功包缺
// errorCode 时子游戏 H5 不认这份数据。
// 按项目方决定补齐（此处是**有意偏离** msext 的一处，其余
// 定位链路仍严格对齐）。
diagLog("[\(label)] → getlocationinfo 成功 city=\(payload.city) province=\(payload.province)")
bridge.call("getlocationinfo", data: .object([
"errorCode": .number(0),
"address": .string(payload.address),
"city": .string(payload.city),
"cityCode": .string(payload.cityCode),
"country": .string(payload.country),
"district": .string(payload.district),
"latitude": .decimal(payload.latitude), // ← 数字（非字符串），6 位小数
"longitude": .decimal(payload.longitude), // ← 数字（非字符串），6 位小数
"province": .string(payload.province), // ← 小写 p
"street": .string(payload.street)
]), callback: nil)
}
}
if isContinuous {
location.startContinuous(caller: label, emit: dispatch)
} else {
location.requestOnce(caller: label, emit: dispatch)
}
}
#endif
ylgamehall/Source/Coordinator/AppCoordinator.swift
+2
View File
@@ -90,6 +90,7 @@ public final class AppCoordinator {
AudioPlayer.shared.stopAllBackground()
let subGame = SubGameViewController(request: request)
diagLog("[coordinator] push 子游戏（栈深 \(nav.viewControllers.count) → \(nav.viewControllers.count + 1)）")
nav.pushViewController(subGame, animated: true)
return true
}
@@ -97,6 +98,7 @@ public final class AppCoordinator {
/// 子游戏 pop 回大厅。data 是 H5 调 backgameData 时传入的字符串，
/// 通过通知派发给大厅 WebContainer，由大厅触发 `getWebdata` 反向 callback。
public func popSubGame(returningData data: String) {
diagLog("[coordinator] pop 子游戏回大厅")
navigationController?.popViewController(animated: true)
NotificationCenter.default.post(
name: .subGameDidReturn,
ylgamehall/Source/Location/LocationService.swift
+234 -32
View File
@@ -11,6 +11,10 @@
import Foundation
import CoreLocation
import os.log
/// 定位诊断日志（文件级 let，Logger 是 Sendable，便于在 AMap 回调闭包内直接用）。
private let locLog = Logger(subsystem: "ylgamehall", category: "Location")
#if canImport(AMapLocationKit)
import AMapLocationKit
@@ -28,78 +32,276 @@ public struct LocationPayload: Sendable {
public let cityCode: String
public let country: String
public let district: String
public let latitude: String
public let longitude: String
/// ⚠️ **JSON 数字**（不是字符串），且保留 `%f` 的 6 位小数文本。
/// 用 `Decimal` 而不是 `Double`，见下方 init 注释与契约 §3.2 表 B。
public let latitude: Decimal
public let longitude: Decimal
public let province: String
public let street: String
}
public enum LocationError: Error, Sendable {
case sdkNotLinked
case authorizationDenied
case timeout
case underlying(any Error)
#if canImport(AMapLocationKit)
extension LocationPayload {
/// 严格照搬 msext 的 `@{...}` 字面量语义。
///
/// msext：
/// ```objc
/// @try{ [_bridge callHandler:@"getlocationinfo" data:@{
/// @"address":regeocode.formattedAddress, @"city":regeocode.city, ... }]; }
/// @catch (NSException * e) { NSLog(...); }
/// ```
/// `@{}` 字面量里**任何一个 value 为 nil 都会抛 NSException**（这正是它包
/// `@try/@catch` 的原因），净效果是：只要 9 个字段里有一个是 nil，
/// **整条 getlocationinfo 都不会发给 H5**。
///
/// 早前我们对每个字段做 `?? ""` 兜底，于是会发出一个带空串的包 —— 数据格式
/// 与原工程不一致（H5 会收到 msext 里根本收不到的消息）。这里改为任一字段
/// 为 nil 就返回 nil，由调用方跳过发送。
nonisolated init?(location: CLLocation, reGeocode: AMapLocationReGeocode) {
guard let address = reGeocode.formattedAddress,
let city = reGeocode.city,
let cityCode = reGeocode.citycode,
let country = reGeocode.country,
let district = reGeocode.district,
let province = reGeocode.province,
let street = reGeocode.street
else { return nil }
self.address = address
self.city = city
self.cityCode = cityCode
self.country = country
self.district = district
// 经纬度是 **数字**，保留 `%f` 的 6 位小数精度。
//
// ⚠️ 契约影响（docs/H5-Native-Contract.md §3.2 表 B）：msext 的 WVJB 路径
// （`gameController.m:2528` / `NewRootVC.m:2132`）用
// `[NSString stringWithFormat:@"%f", ...]` 把经纬度发成**字符串**；但老
// UIWebView / JSContext 路径（`RootVC.m:1998` / `fourviewVC.m:1541`）拼的是
// `\"latitude\":%f` —— **不带引号，是 JSON 数字**。现网子游戏 H5
// （jinxianmahjong 05_Func.js:2029-2031）自造定位对象时也写
// `"latitude":28.623546` 数字形式。与 `errorCode` 是同一类问题：WVJB 路径
// 当年把它字符串化了。按项目方决定改回数字。
//
// 用 `%f` 文本构造 `Decimal`：既保住 6 位小数的舍入行为，又让
// JSONSerialization 输出 `28.636486` 而不是 Double 的 17 位有效数字
// `28.636486000000001`（两者 JS parse 后是同一个 IEEE754 double，H5 不可分辨，
// 但 JSON 文本要与原工程一致）。
let latText = String(format: "%f", location.coordinate.latitude)
let lonText = String(format: "%f", location.coordinate.longitude)
self.latitude = Decimal(string: latText) ?? Decimal(location.coordinate.latitude)
self.longitude = Decimal(string: lonText) ?? Decimal(location.coordinate.longitude)
self.province = province
self.street = street
}
}
#endif
/// 一次定位请求可能产出的事件。**一次请求可以产出两条**（先 failure 再 success），
/// 这是 msext `completionBlock` 的原始控制流，不是笔误 —— 详见 requestOnce 注释。
public enum LocationOutcome: Sendable {
/// → H5 `getlocationinfo({errorCode:12, errorMsg:"缺少定位权限"})`
case failure
/// → H5 `getlocationinfo(<9 字段>)`
case success(LocationPayload)
}
@MainActor
public final class LocationService {
public static let shared = LocationService()
/// 容器标识（`lobby` / `subGame`），仅用于诊断日志。
private let owner: String
public init() {}
/// **每个容器必须持有自己的实例**（不要做成单例）。
/// msext `NewRootVC.m:1568` / `gameController.m:1230` 各自
/// `[[AMapLocationManager alloc] init]`，两套 manager + completionBlock +
/// delegate 完全独立。共用一个 manager 会引入三个原生侧故障：
/// 1. `requestLocationWithReGeocode:completionBlock:` 同一时刻只保留一个
/// 单次定位请求，两个容器并发请求会互相顶掉，被顶掉的一侧
/// completionBlock 永不触发 → continuation 永挂 → H5 什么都收不到；
/// 2. `stopUpdatingLocation`「会 cancel 掉所有的单次定位请求」，子游戏
/// `backgameData` 会连带取消大厅在飞的定位；
/// 3. `delegate = nil` 作用在共享 manager 上是**进程级永久**副作用。
public init(owner: String = "?") {
self.owner = owner
#if canImport(AMapLocationKit)
// msext `configLocationManager` 里 `setDelegate:self` 是**无条件**装上的，
// 不只服务持续定位：`amapLocationManager:doRequireLocationAuth:` 也走 delegate。
// 所以这里在 init 就把 shim 挂上，而不是等持续定位分支才 lazy 触发。
_ = delegateShim
#endif
}
#if canImport(AMapLocationKit)
/// msext `configLocationManager` 逐项等价。
private let manager: AMapLocationManager = {
let m = AMapLocationManager()
m.desiredAccuracy = kCLLocationAccuracyHundredMeters
m.pausesLocationUpdatesAutomatically = false
m.locationTimeout = 6
m.reGeocodeTimeout = 3
m.locatingWithReGeocode = true
return m
}()
/// 持续定位（`startlocation` type == 1）的 delegate 承接器。
/// msext `configLocationManager` 里 `setDelegate:self` 由 VC 自己承担，
/// 这里用独立对象持有，避免 LocationService 被迫继承 NSObject。
private lazy var delegateShim: LocationDelegateShim = {
let shim = LocationDelegateShim(owner: owner)
manager.delegate = shim
return shim
}()
#endif
/// 一次性定位 + 逆地理（msext locAction + completionBlock 等价）
public func requestOnce() async throws -> LocationPayload {
/// 诊断用：requestOnce 调用序号，日志里可对上「谁发起、谁回来」。
private var requestSeq: UInt64 = 0
/// 一次性定位 + 逆地理。**逐行等价 msext `initCompleteBlock` 的 completionBlock**
/// （`gameController.m:2493-2545` / `NewRootVC.m:2099-2150`）：
///
/// ```objc
/// if (error) {
/// callHandler getlocationinfo {errorCode:12,...} // ①
/// if (error.code == AMapLocationErrorLocateFailed) return;
/// }
/// if (location) { if (regeocode) {
/// if (regeocode.formattedAddress != nil)
/// callHandler getlocationinfo <9 字段> // ②
/// }}
/// ```
///
/// 注意 ① 之后**没有 return**（除 locateFailed）：高德在「拿到了 CLLocation 但
/// 逆地理超时/网络出错」时会带着 error **和** location 一起回调，msext 会先发一条
/// errorCode 12、再把真实定位补发出去，H5 最终拿到的是真实定位。
///
/// 早前的实现用 `async throws -> LocationPayload` 表达，单个返回值天然只能二选一，
/// 于是在 error 分支直接 return，②永远不会发 —— H5 只收到 errorCode 12，
/// `C_Player.SetLocationInfo({errorCode:12})` 还会把已有的 addr 覆盖掉。子游戏
/// 进房瞬间网络/CPU 最忙、逆地理最容易超时，所以这个分叉在子游戏侧暴露得多。
/// 因此改成回调式：一次请求可以按 msext 的顺序产出两条 outcome。
///
/// - Parameter emit: 在 MainActor 上调用，可能被调用 0 / 1 / 2 次。
public func requestOnce(caller: String = "?",
emit: @escaping @MainActor (LocationOutcome) -> Void) {
#if canImport(AMapLocationKit)
return try await withCheckedThrowingContinuation { (cont: CheckedContinuation<LocationPayload, Error>) in
manager.requestLocation(withReGeocode: true) { loc, regeo, err in
requestSeq += 1
let seq = requestSeq
diagLog("[\(caller)] requestOnce #\(seq) 发起（owner=\(owner) manager=\(UInt(bitPattern: ObjectIdentifier(self.manager).hashValue))）")
let t0 = Date()
// 高德的 completionBlock 在主线程回调；这里保持与 msext 同样的同步语义。
let accepted = manager.requestLocation(withReGeocode: true) { loc, regeo, err in
let ms = Int(Date().timeIntervalSince(t0) * 1000)
diagLog("[\(caller)] requestOnce #\(seq) completionBlock 回来（耗时 \(ms)ms）：loc=\(loc != nil) regeo=\(regeo != nil) err=\(err?.localizedDescription ?? "nil")")
MainActor.assumeIsolated {
if let err = err as NSError? {
// msext 行为：权限相关错误归一到 12 errorCode（handler 转字段）
emit(.failure) // ①
if err.code == AMapLocationErrorCode.locateFailed.rawValue {
cont.resume(throwing: LocationError.authorizationDenied)
} else {
cont.resume(throwing: LocationError.underlying(err))
diagLog("[\(caller)] requestOnce #\(seq) locateFailed，按 msext 就此结束")
return
}
diagLog("[\(caller)] requestOnce #\(seq) 有 error 但非 locateFailed，按 msext 继续尝试补发真实定位")
}
// msext 要求 location / regeocode / formattedAddress 三者都在才发 ②
guard let loc, let regeo, regeo.formattedAddress != nil else {
diagLog("[\(caller)] requestOnce #\(seq) 无可用逆地理（loc=\(loc != nil) regeo=\(regeo != nil)），按 msext 不发 9 字段")
return
}
guard let loc, let regeo else {
cont.resume(throwing: LocationError.timeout)
guard let payload = LocationPayload(location: loc, reGeocode: regeo) else {
diagLog("[\(caller)] requestOnce #\(seq) 逆地理有 nil 字段，按 msext（@{} 抛 NSException）整条不发")
return
}
cont.resume(returning: LocationPayload(
address: regeo.formattedAddress ?? "",
city: regeo.city ?? "",
cityCode: regeo.citycode ?? "",
country: regeo.country ?? "",
district: regeo.district ?? "",
latitude: String(format: "%f", loc.coordinate.latitude),
longitude: String(format: "%f", loc.coordinate.longitude),
province: regeo.province ?? "",
street: regeo.street ?? ""
))
emit(.success(payload)) // ②
}
}
// AMapLocationManager.h：返回值是「是否成功添加单次定位Request」。msext 忽略它，
// 效果就是什么都不发给 H5；回调式实现天然等价（不再有 continuation 可挂死），
// 这里只留一条日志便于排查。
if !accepted {
diagLog("[\(caller)] requestOnce #\(seq) requestLocation 返回 NO（未挂上请求），按 msext 静默")
}
#else
throw LocationError.sdkNotLinked
diagLog("[\(caller)] requestOnce: AMapLocationKit 未链接，按 msext 无 SDK 场景不回 H5")
#endif
}
/// 持续定位（`startlocation` type == 1）。
/// msext `NewRootVC.m:414` / `gameController.m:537`：
/// `if (tempinfo == 1) [self.locationManager startUpdatingLocation];`
/// 结果通过 delegate `amapLocationManager:didUpdateLocation:reGeocode:` 逐次推
/// `getlocationinfo`（msext `gameController.m:2551-2560`），只在 `reGeocode` 与
/// `formattedAddress` 都非空时发；`didFailWithError` msext 只 NSLog、不通知 H5。
///
/// - Parameter emit: 每次定位更新都会调用（不是一次性）。
public func startContinuous(caller: String = "?",
emit: @escaping @MainActor (LocationOutcome) -> Void) {
#if canImport(AMapLocationKit)
diagLog("[\(caller)] startContinuous 发起（owner=\(owner)）")
delegateShim.onUpdate = emit
delegateShim.caller = caller
manager.startUpdatingLocation()
#else
diagLog("[\(caller)] startContinuous: AMapLocationKit 未链接，按 msext 无 SDK 场景不回 H5")
#endif
}
/// 停止：msext gameController.m:2473-2478 cleanUpAction 等价
public func stop() {
public func stop(caller: String = "?") {
#if canImport(AMapLocationKit)
// `stopUpdatingLocation` 会 cancel 掉本 manager 上所有单次定位请求。因为
// manager 是本容器私有的（每容器一个实例），影响范围仅限本容器 —— 与 msext
// cleanUpAction 只动自己那个 manager 一致。
diagLog("[\(caller)] stop()：stopUpdatingLocation + delegate=nil（owner=\(owner)）")
manager.stopUpdatingLocation()
manager.delegate = nil
#endif
}
}
#if canImport(AMapLocationKit)
/// `AMapLocationManagerDelegate` 承接器（仅持续定位路径用到）。
/// msext 里这些方法直接实现在 NewRootVC / gameController 上；新外壳把它独立出来，
/// 每个 LocationService 一个，生命周期随宿主容器。
@MainActor
private final class LocationDelegateShim: NSObject, AMapLocationManagerDelegate {
var onUpdate: (@MainActor (LocationOutcome) -> Void)?
var caller: String = "?"
private let owner: String
init(owner: String) {
self.owner = owner
super.init()
}
/// msext `gameController.m:2551-2560` 等价：仅 reGeocode 与 formattedAddress
/// 都非空时推 9 字段，其余情况什么都不发。
nonisolated func amapLocationManager(_ manager: AMapLocationManager!,
didUpdate location: CLLocation!,
reGeocode: AMapLocationReGeocode!) {
// 先在当前上下文把 AMap 的非 Sendable 对象拆成纯值，只把 Sendable 的
// LocationPayload 送进 MainActor（否则 Swift 6 判定 reGeocode 跨隔离域有数据竞争）。
guard let location, let reGeocode, reGeocode.formattedAddress != nil else {
diagLog("[持续定位] 更新但无可用逆地理，按 msext 不发")
return
}
guard let payload = LocationPayload(location: location, reGeocode: reGeocode) else {
diagLog("[持续定位] 逆地理有 nil 字段，按 msext（@{} 抛 NSException）整条不发")
return
}
MainActor.assumeIsolated {
diagLog("[\(caller)] 持续定位 → getlocationinfo city=\(payload.city)")
onUpdate?(.success(payload))
}
}
/// msext `gameController.m:2547` 等价：**只打日志，不通知 H5**。
nonisolated func amapLocationManager(_ manager: AMapLocationManager!,
didFailWithError error: (any Error)!) {
diagLog("[持续定位 owner=\(owner)] didFailWithError: \(error?.localizedDescription ?? "nil")（msext 同款：不通知 H5）")
}
}
#endif
ylgamehall/Source/WebView/BridgedWebView.swift
+5 -2
View File
@@ -17,7 +17,9 @@ public final class BridgedWebView: UIView {
public let webView: WKWebView
public let bridge: BridgeBus
public init() {
/// - Parameter label: 容器标识（`lobby` / `subGame`），仅用于桥诊断日志区分来源，
/// 不参与任何契约行为。
public init(label: String = "webview") {
// ── WKWebViewConfiguration（契约 §4.1）─────────────────
let configuration = WKWebViewConfiguration()
configuration.defaultWebpagePreferences.allowsContentJavaScript = true
@@ -71,7 +73,8 @@ public final class BridgedWebView: UIView {
}
#endif
let bridge = BridgeBus(webView: webView,
controller: configuration.userContentController)
controller: configuration.userContentController,
label: label)
self.webView = webView
self.bridge = bridge
ylgamehall/Source/WebView/SubGameViewController.swift
+7 -3
View File
@@ -33,7 +33,11 @@ public final class SubGameViewController: UIViewController {
// MARK: - UI
private let bridgedWebView = BridgedWebView()
private let bridgedWebView = BridgedWebView(label: "subGame")
/// 子游戏私有的定位服务（msext gameController.m:1230 `configLocationManager`
/// 每次进子游戏都 alloc 一个自己的 AMapLocationManager）。随本 VC 一起析构。
private let locationService = LocationService(owner: "subGame")
private let splash = SplashOverlay()
// MARK: - Handlers
@@ -88,7 +92,7 @@ public final class SubGameViewController: UIViewController {
DeviceInfoHandler.register(on: bridge)
BrowserHandler.register(on: bridge)
OpenSaomaHandler.register(on: bridge)
StartLocationHandler.register(on: bridge)
StartLocationHandler.register(on: bridge, label: "subGame", location: locationService)
// assetsRoot 闭包 = 子游戏 H5 根目录（msext gameController.m:364 等价）。
// 用 closure 是因为 effectiveGameDir 在 boot pipeline 升级路径下会变化，
@@ -118,7 +122,7 @@ public final class SubGameViewController: UIViewController {
OpenurlTitleDataHandler.register(on: bridge)
// 子游戏专属：backgameData（退出回大厅 + 反向 callback getWebdata）
BackGameDataHandler.register(on: bridge)
BackGameDataHandler.register(on: bridge, location: locationService)
// 视频房间 3 件套 stub（业务暂未启用，仅维持桥契约不让 H5 报 "no handler"）
// 未来接 Agora 时把 VideoRoomHandlers 内 3 个 stub 展开实现，注册点不变。
ylgamehall/Source/WebView/WebContainerViewController.swift
+6 -2
View File
@@ -15,7 +15,11 @@ public final class WebContainerViewController: UIViewController {
// MARK: - UI
private let bridgedWebView = BridgedWebView()
private let bridgedWebView = BridgedWebView(label: "lobby")
/// 大厅私有的定位服务（msext NewRootVC.m:1568 `configLocationManager` 等价）。
/// 与子游戏那一个互不影响 —— 这是 msext 的原始结构，不可再合并成单例。
private let locationService = LocationService(owner: "lobby")
private let splash = SplashOverlay()
// MARK: - Handlers (有状态的 handler 注册器持有，无状态的走 enum 静态 register)
@@ -77,7 +81,7 @@ public final class WebContainerViewController: UIViewController {
DeviceInfoHandler.register(on: bridge) // §3.1 ［21］ + §3.2 ［1］
BrowserHandler.register(on: bridge) // §3.1 ［16］
OpenSaomaHandler.register(on: bridge) // §3.1 ［22］空 stub
StartLocationHandler.register(on: bridge) // §3.1 ［20］Phase 5 完整实现，Phase 2 stub
StartLocationHandler.register(on: bridge, label: "lobby", location: locationService) // §3.1 ［20］Phase 5 完整实现，Phase 2 stub
// Phase 3.A 本地音频 + 3.C/3.D stub
// assetsRoot 闭包 = 大厅 H5 根目录（lobbyIndex 父目录），lobby 不做升级