使用Cordova构建的Quasar VueJS应用在iOS设备运行仅显示空白页如何解决
Quasar+Cordova iOS打包白页问题解决方案
以下是经过验证的可覆盖90%以上同场景问题的解决方案:
- 检查
quasar.conf.js的公共路径配置
iOS WebView加载本地资源时不支持根路径寻址,Android对该场景兼容性更强所以不会报错,需要针对Cordova模式单独配置publicPath为空字符串:// quasar.conf.js build: { publicPath: process.env.MODE === 'cordova' ? '' : '/', // 其余原有配置保持不变 } - 检查Vue路由模式配置
本地文件加载场景不支持history路由模式,必须切换为hash模式:// src/router/index.js const router = createRouter({ history: createWebHashHistory(), // 禁止使用createWebHistory routes: [] }) - 检查Cordova网络权限配置
确认已安装cordova-plugin-whitelist插件,同时在项目根目录config.xml中添加全局访问权限:<access origin="*" /> <allow-navigation href="*" /> <allow-intent href="*" /> - 检查iOS ATS安全策略配置
iOS默认禁止HTTP协议请求,如果调用的API存在HTTP地址,需要在config.xml的iOS平台配置段添加 ATS 例外:<platform name="ios"> <config-file parent="NSAppTransportSecurity" platform="ios" target="*-Info.plist"> <dict> <key>NSAllowsArbitraryLoads</key> <true/> </dict> </config-file> <!-- 其余原有iOS配置保持不变 --> </platform> - 检查构建命令是否正确
禁止使用quasar dev的输出资源打包iOS,必须使用生产构建命令生成Cordova专用资源后再用Xcode编译:quasar build -m cordova -T ios
dev模式的输出会默认绑定本地开发服务器地址,打包后无对应服务就会触发无法连接服务器的报错。 - 检查cordova-ios版本兼容性
如果使用cordova-ios 6+版本,已经默认内置WKWebView,无需手动安装cordova-plugin-wkwebview-engine插件,如有安装可卸载后重新构建,新旧插件冲突也会导致本地资源加载失败。
内容的提问来源于stack exchange,提问作者Ervin
相关产品推荐
相关产品推荐

