HBuilderX2.3.8+版本开始已经废弃“自定义组件模式”概念,使用低版本HBuilderX需更新
HBuilderX1.9.0及以上版本uni-app项目启用“自定义组件模式”,运行为APP时做了底层性能优化,可能出现兼容性问题引起白屏现象。
HBuilderX1.9.4及以上版本会自动检查基座环境是否支持启用“自定义组件模式”,如果不支持则会弹出以下提示框
弹出以上提示框说明需要重新生成自定义基座
如果出现白屏现象,请按以下步骤检查。
云端打包自定义基座真机运行
如果使用低版本HBuilderX时提交云端打包生成了自定义基座安装包,更新HBuilderX后真机运行会继续使用老版本自定义基座,但不包含启用“自定义组件模式”的模块。
这时需要重新提交云端打包生成新的自定义基座。
本地(离线)打包自定义基座真机运行
Android平台
启用“自定义组件模式”,必须引用uniapp-release.aar。
uni-app离线打包更多细节请参考uni-app离线打包Android平台注意事项
iOS平台
启用“自定义组件模式”,必须引用liblibWeex.a库 和 weex-main-jsfm.js文件
uni-app离线打包更多细节请参考uni-app离线打包iOS平台注意事项
云端打包
提交云端打包不应该弹出此提示框。
已知iOS平台在20190429 14:00之前uni-app设置"usingComponents":false后云端打包弹出此提示框,请重新提交云端打包
如果提交云端打包还出现此提示框,请留言提供应用的appid(manifest.json的id字段值),说明是iOS还是Android平台,我们会尽快排查修复