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

修复定位的回调问题

Browse Source
This commit is contained in:
joywayer
2026-08-07 12:18:44 +08:00
parent 3f8b382ad3
commit 1203957924
12 changed files with 637 additions and 180 deletions
Download Patch File Download Diff File Expand all files Collapse all files
ylgamehall/Source/Bridge/BridgeBus.swift
+134 -16
View File
@@ -14,6 +14,70 @@ import os.log
/// 完成回调等非 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 消息总线。
///
/// **运行时约束**：必须挂在 WKWebView 上、@MainActor 单线程访问。
@@ -38,6 +102,18 @@ public final class BridgeBus: NSObject, BridgeProtocol, WKScriptMessageHandler {
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,
@@ -52,7 +128,7 @@ public final class BridgeBus: NSObject, BridgeProtocol, WKScriptMessageHandler {
public func register(_ name: String, handler: @escaping BridgeHandler) {
handlers[name] = handler
bridgeLog.debug("[\(self.label, privacy: .public)] register handler '\(name, privacy: .public)'")
diagLog("[\(self.label)] register handler '\(name)'")
}
public func call(_ name: String, data: BridgeData?, callback: BridgeCallback?) {
@@ -66,7 +142,10 @@ public final class BridgeBus: NSObject, BridgeProtocol, WKScriptMessageHandler {
pendingCallbacks[cbId] = callback
payload["callbackId"] = cbId
}
bridgeLog.debug("[\(self.label, privacy: .public)] → H5 callHandler '\(name, privacy: .public)'")
// 诊断：打出实际序列化后的字节，确认字段集合 / 类型 / 引号与 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)
}
@@ -87,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) }
@@ -109,11 +209,19 @@ public final class BridgeBus: NSObject, BridgeProtocol, WKScriptMessageHandler {
// 构造一个回调闭包，handler 调用即把 responseData 异步派回 JS
let responseCallback: BridgeCallback? = makeResponseCallback(for: callbackId)
bridgeLog.debug("[\(self.label, privacy: .public)] ← H5 call '\(name, privacy: .public)' data=\(String(describing: msg["data"]), privacy: .public)")
diagLog("[\(self.label)] ← H5 call '\(name)' data=\(String(describing: msg["data"]))")
guard let handler = handlers[name] else {
bridgeLog.error("[\(self.label, privacy: .public)] no NATIVE handler registered for '\(name, privacy: .public)'")
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
}
@@ -140,31 +248,41 @@ public final class BridgeBus: NSObject, BridgeProtocol, WKScriptMessageHandler {
sendToJS(payload: payload)
}
/// 等价 msext `WebViewJavascriptBridgeBase._queueMessage:`：
/// 桥未就绪则入 `startupMessageQueue`，就绪则直接派发。
private func sendToJS(payload: [String: Any]) {
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 {
bridgeLog.error("[\(self.label, privacy: .public)] sendToJS 丢弃：webView 已释放")
diagLog("[\(self.label)] dispatchToJS 丢弃：webView 已释放")
return
}
guard let data = try? JSONSerialization.data(withJSONObject: payload),
let json = String(data: data, encoding: .utf8)
else {
bridgeLog.error("[\(self.label, privacy: .public)] JSON encode failed for payload: \(String(describing: payload), privacy: .public)")
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()
// 返回 'ok' / 'no-bridge' 以便诊断「消息被静默丢弃」（H5 侧 bridge 未就绪）
let js = """
(function(){ if (!window.\(Self.jsBridgeName)) { return 'no-bridge'; } \
window.\(Self.jsBridgeName)._handleMessageFromObjC('\(base64)'); return 'ok'; })()
"""
let js = "window.\(Self.jsBridgeName)._handleMessageFromObjC('\(base64)');"
let tag = label
let what = (payload["handlerName"] as? String) ?? (payload["responseId"] as? String) ?? "?"
webView.evaluateJavaScript(js) { result, error in
webView.evaluateJavaScript(js) { _, error in
if let error {
bridgeLog.error("[\(tag, privacy: .public)] sendToJS '\(what, privacy: .public)' evaluateJavaScript 失败: \(error.localizedDescription, privacy: .public)")
} else if (result as? String) != "ok" {
bridgeLog.error("[\(tag, privacy: .public)] sendToJS '\(what, privacy: .public)' 被丢弃：H5 侧 window.\(Self.jsBridgeName) 不存在")
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
+5 -5
View File
@@ -47,25 +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]) ?? []
print("[H5 console.warn]", args.joined(separator: " "))
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)")
}
}
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(caller: "backgameData")
location.stop(caller: "backgameData")
#endif
// Phase 3.C 录音 / Phase 3.B 七牛上传 清理（QiniuUploader.cancelInFlight 当前
ylgamehall/Source/Bridge/Handlers/StartLocationHandler.swift
+61 -33
View File
@@ -25,46 +25,74 @@ private nonisolated let startLocLog = Logger(subsystem: "ylgamehall", category:
public enum StartLocationHandler {
/// - Parameter label: 容器标识（`lobby` / `subGame`），仅用于诊断日志。
public static func register(on bridge: any BridgeProtocol, label: String = "?") {
/// - 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"))
startLocLog.debug("[\(label, privacy: .public)] ← startlocation 入参 type=\(data?.asLooseString ?? "nil", privacy: .public)")
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(caller: label)
startLocLog.debug("[\(label, privacy: .public)] → getlocationinfo 成功 city=\(payload.city, privacy: .public) province=\(payload.province, privacy: .public)")
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 等价）
startLocLog.error("[\(label, privacy: .public)] → getlocationinfo 失败：authorizationDenied")
bridge.call("getlocationinfo", data: .object([
"errorCode": .number(12),
"errorMsg": .string("缺少定位权限")
]), callback: nil)
} catch {
// 其它失败也归一到 12（msext 行为）
startLocLog.error("[\(label, privacy: .public)] → getlocationinfo 失败：\(String(describing: error), privacy: .public)")
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
+224 -41
View File
@@ -32,93 +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
/// 诊断用：requestOnce 调用序号，日志里可对上「谁发起、谁回来」。
private var requestSeq: UInt64 = 0
/// 一次性定位 + 逆地理（msext locAction + completionBlock 等价）
public func requestOnce(caller: String = "?") async throws -> LocationPayload {
/// 一次性定位 + 逆地理。**逐行等价 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)
requestSeq += 1
let seq = requestSeq
locLog.debug("[\(caller, privacy: .public)] requestOnce #\(seq, privacy: .public) 发起（shared manager id=\(String(describing: ObjectIdentifier(self.manager)), privacy: .public)）")
return try await withCheckedThrowingContinuation { (cont: CheckedContinuation<LocationPayload, Error>) in
let accepted = manager.requestLocation(withReGeocode: true) { loc, regeo, err in
locLog.debug("[\(caller, privacy: .public)] requestOnce #\(seq, privacy: .public) completionBlock 回来：loc=\(loc != nil, privacy: .public) regeo=\(regeo != nil, privacy: .public) err=\(err?.localizedDescription ?? "nil", privacy: .public)")
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」。返回 NO 时
// completionBlock 永远不会被调用 → continuation 永挂 → H5 收不到任何
// getlocationinfo（连 errorCode 12 都没有）。诊断阶段先只记录。
locLog.debug("[\(caller, privacy: .public)] requestOnce #\(seq, privacy: .public) requestLocation 返回 accepted=\(accepted, privacy: .public)")
}
// AMapLocationManager.h：返回值是「是否成功添加单次定位Request」。msext 忽略它，
// 效果就是什么都不发给 H5；回调式实现天然等价（不再有 continuation 可挂死），
// 这里只留一条日志便于排查。
if !accepted {
diagLog("[\(caller)] requestOnce #\(seq) requestLocation 返回 NO（未挂上请求），按 msext 静默")
}
#else
locLog.error("[\(caller, privacy: .public)] requestOnce: AMapLocationKit 未链接，抛 sdkNotLinked")
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(caller: String = "?") {
#if canImport(AMapLocationKit)
// ⚠️ AMapLocationManager.h：stopUpdatingLocation「会 cancel 掉所有的单次定位请求」。
// 本类是 shared 单例、manager 唯一，因此这里会连带取消**其它容器**在飞的单次定位。
locLog.debug("[\(caller, privacy: .public)] stop()：stopUpdatingLocation + delegate=nil（会取消所有在飞的单次定位）")
// `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/SubGameViewController.swift
+6 -2
View File
@@ -34,6 +34,10 @@ public final class SubGameViewController: UIViewController {
// MARK: - UI
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, label: "subGame")
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
+5 -1
View File
@@ -16,6 +16,10 @@ public final class WebContainerViewController: UIViewController {
// MARK: - UI
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, label: "lobby") // §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 不做升级