uniapp wkwebview ios打包配置具体步骤和注意事项

在 UniApp 中配置 iOS 平台的 WKWebView 涉及以下步骤和注意事项，确保应用在 iOS 上使用更现代的 WebView 引擎提升性能。

配置步骤

1. 修改 manifest.json 文件
   在 UniApp 项目的 manifest.json 中，添加或修改 iOS 配置，指定使用 WKWebView：

   {
     "app-plus": {
       "ios": {
         "webView": "WKWebView"
       }
     }
   }
   

   这确保打包时 iOS 应用默认使用 WKWebView 而非 UIWebView（已废弃）。

2. 检查 UniApp 版本
   确保使用 HBuilderX 3.0+ 或更高版本，旧版本可能不支持 WKWebView 配置。

3. 打包生成 IPA

   • 在 HBuilderX 中，选择“发行” -> “原生App-云打包”。
   • 勾选 iOS 平台，选择证书（需苹果开发者账号），然后打包。
   • 云打包服务会自动应用 manifest 配置，生成使用 WKWebView 的 IPA 文件。

注意事项

• 兼容性问题：
  WKWebView 与 UIWebView 行为有差异，例如：
  • 跨域请求更严格，需确保服务器配置 CORS 头（如 Access-Control-Allow-Origin）。
  • 本地文件访问受限，避免使用 file:// 协议加载资源；改用相对路径或 Base64 内联。
• JS-Native 交互：
  WKWebView 中，uni.webView API 可能需调整。若使用原生插件，确认其兼容 WKWebView。
• Xcode 项目自定义：
  如需离线打包，在 Xcode 项目中手动设置 WebView 类型为 WKWebView，并处理权限（如相机、定位）。
• 测试验证：
  在真机上测试功能，特别是涉及 Cookie、本地存储和导航的行为，确保无异常。

总结

通过简单配置 manifest.json 并注意兼容性，可顺利在 iOS 应用中使用 WKWebView。如有复杂需求，参考 UniApp 官方文档或社区资源。