Ionic 1升级Cordova 6.2.0适配iOS14.5出现"不支持的URL"加载错误

升级Cordova 6.2.0时自动同步安装的cordova-plugin-ionic-webview v5+版本，对本地资源的加载逻辑做了完全不兼容旧Ionic1的改造：将原本的本地文件直读路径，重写为https://localhost的本地虚拟服务地址，和旧版Ionic1 ui-router通过$state.go拼接的原始文件路径完全不匹配，最终触发"unsupported URL"加载失败提示。控制台输出的RBS Background assertion报错是Web进程直接崩溃后的连带日志，并非权限或签名配置问题。

1. 替换为兼容Ionic1的WebView插件版本 #

卸载当前高版本不兼容的webview插件，安装适配旧代码的稳定版本：

• 执行插件操作命令：

  cordova plugin remove cordova-plugin-ionic-webview
  cordova plugin add cordova-plugin-ionic-webview@3.1.2
  

注意：该版本是最后一个不对本地文件路径做强制重写的版本，完全兼容旧Ionic1的路由跳转逻辑，不需要修改任何现有业务代码，是过渡期最省工作量的方案

2. 修正config.xml的冲突配置 #

当前配置中存在两条重复的全通配导航规则，会和WebView插件的内部路径校验逻辑冲突，直接删除冗余项：

• 删除<allow-navigation href="*" />和<allow-navigation href="*://*" />两条重复的全通配规则
• 补一条匹配WebView内部加载协议的导航规则：<allow-navigation href="ionic://localhost" />

3. 补全CSP规则的兼容覆盖 #

原有CSP规则没有覆盖旧WebView使用的本地加载源，会被内容安全策略拦截资源加载，将CSP替换为如下配置：

<meta http-equiv="Content-Security-Policy" content="default-src * 'self' ionic://localhost file: gap://ready; style-src 'self' 'unsafe-inline' ionic://localhost file:; script-src 'self' 'unsafe-inline' 'unsafe-eval' ionic://localhost file:;">

4. 关闭不必要的路径重写开关 #

在config.xml的iOS平台配置节点下，添加两项强制配置，避免插件自动重写本地文件路径：

<preference name="WKWebViewOnly" value="true" />
<preference name="NewCharacteristicFilePath" value="false" />

• 不要仅用模拟器测试，需打包release版本安装到iOS14.5及以上的真机验证，模拟器沙箱权限和真机存在差异，不会复现Web进程崩溃的场景
• 当WebView能正常加载页面后，控制台的RBS Background assertion报错会自动消失，无需额外配置App entitlements

内容的提问来源于stack exchange，提问作者nick364