目录

ASCF元服务分包组件加载白屏

问题现象

场景1: ASCF元服务冷启动加载白屏。

基于跨端框架(如Taro、uni-app等)开发的应用,转换为ASCF元服务后,在应用冷启动加载时呈现白屏状态。

场景2: ASCF元服务分包组件加载白屏。

在元服务运行过程中,动态加载复杂的分包业务或深层嵌套的自定义组件时,页面无法正常显示内容,出现局部或全局白屏。

解决方案

开启模板扁平化(模板提升)编译优化:在项目json配置文件中手动开启templateHoist选项。

打开项目中的ascf/ascf_src/ascf.config.json配置文件,在编译配置最外层添加参数:"templateHoist": true。开启此配置后,ASCF工具链会在编译阶段对视图依赖进行静态分析,将原本需要深度递归的自定义组件和节点进行“扁平化”提取,直接提升至顶层渲染。这大幅压缩了XML的嵌套层级,规避了引擎深度解析限制,从而解决加载白屏问题。

若配置templateHoist为true后,组件仍然未能成功加载,请参考官网文档,排查组件中是否使用了ASCF不支持的接口。