iOS原生App嵌入HTML5页面需用WKWebView安全加载本地或远程资源，正确配置allowingReadAccessTo、使用loadFileURL、规范JS与原生通信机制，并确保资源路径与权限匹配。
iOS 原生 App 调用 HTML5 页面，本质是让 WKWebView 加载本地或远程 HTML 资源，不是“调用”而是“嵌入显示”。关键不在“怎么打开”，而在“怎么安全、可控、可通信地加载并交互”。
用 WKWebView 替代已废弃的 UIWebView
iOS 12+ 必须用 WKWebView；UIWebView 已被 App Store 拒绝。它性能更好、支持现代 Web 标准，且提供 JS 与原生双向通信能力。
-
WKWebView需要显式配置WKWebViewConfiguration，尤其注意websiteDataStore和allowsInlineMediaPlayback等开关 - 加载本地 HTML 时，必须用
loadFileURL(_:allowingReadAccessTo:)，不能直接用loadRequest+file://URL，否则 JS 无法读取同目录下 CSS/JS（CORS 限制） - 若 HTML 里有
fetch或XMLHttpRequest请求本地 JSON 文件，需把该文件放在Bundle Resources并通过bundle.url(forResource:withExtension:)构造可读路径，再传给allowingReadAccessTo:
本地 HTML 页面资源如何组织与加载
HTML、CSS、JS、图片等应统一放在 Xcode 工程的 Bundle 内（如 www/ 文件夹），并确保在 Target → Build Phases → Copy Bundle Resources 中可见。
- 获取根路径：
Bundle.main.bundleURL.appendingPathComponent("www") - 加载入口 HTML：
webView.loadFileURL(indexURL, allowingReadAccessTo: wwwRootURL) - 不要用
stringByEvaluatingJavaScriptFromString（已废弃），改用evaluateJavaScript(_:completionHandler:) - 若 HTML 引用了相对路径的
./js/app.js，只要allowingReadAccessTo:指向www目录，就能正常加载
原生与 HTML5 页面如何安全通信
靠 WKScriptMessageHandler 实现 JS 调原生，靠 evaluateJavaScript 实现原生调 JS —— 二者不能混用同一消息名，且 JS 端需先注册 window.webkit.messageHandlers.xxx.postMessage()。
立即学习“前端免费学习笔记（深入）”；
- 注册 handler 时，name 必须全小写、无下划线（如
"nativebridge"），否则 JS 端访问不到window.webkit.messageHandlers.nativebridge - JS 向原生传数据，只能传 JSON-serializable 对象（
String/Number/Boolean/null/Array/Object），不支持Function或Date - 原生调 JS 的
evaluateJavaScript是异步的，务必带completionHandler处理返回值或错误，例如 JS 返回Promise时需显式await并resolve
常见报错与绕过方式
最典型的是白屏、JS 报 SecurityError: The operation is insecure、点击无响应、messageHandlers undefined —— 这些基本都指向加载方式或权限配置错误。
-
Failed to load resource: Frame load interrupted：通常是loadFileURL的allowingReadAccessTo:路径没设对，或 HTML 里写了绝对file://路径 -
TypeError: window.webkit is undefined：JS 在WKWebView加载完成前就执行了，加document.readyState === "complete"判断，或用WKNavigationDelegate的webView(_:didFinish:)触发初始化 - HTTPS 页面里加载本地
file://资源会失败：不允许混合内容，必须全部走本地 bundle 或全部走服务器
真正难的不是“怎么显示一个 HTML 页面”，而是让 JS 能稳定读取本地资源、能和原生交换结构化数据、能在离线状态下保持功能完整——这些细节一旦漏掉一环，页面就只是个静态快照。
