deveco突然不能预览了

【背景知识】

• 界面预览概述：DevEco Studio为开发者提供了UI界面预览功能，可以查看UI界面效果，方便开发者随时调整界面UI布局。预览器支持界面代码的实时预览，只需要将开发的源代码进行保存，就可以通过预览器实时查看组件/界面运行效果，方便开发者随时调整代码。

【解决方案】

• 出现无法预览和报错问题时，依次排查以下各场景：

  • 检查是否使用了@prop，@Consume，@Link，@ObjectLink未明确初始化变量的装饰器。因为这些装饰器需要从父组件获取参数，直接预览子组件无法打通数据传递链路，所以预览失败，只有对外层组件没有参数诉求的组件才能预览。这种场景可以自定义一个父容器（并通过父容器传递合适的数据）来预览。详情参考预览数据模拟。

  • 检查PreviewerLog中是否有报错信息，如果有，排查修改后再重新预览。

  • 如果是Inspector双向预览场景，检查要预览的组件是被@Entry还是@Preview修饰，@Entry支持inspector，@Preview不支持。观察是否能正常生成组件树，如果可以正常生成组件树，说明渲染正常；否则就需要收集预览器日志（Help -> Compress Logs and Show In Explorer）进一步分析渲染失败的原因。

  • 是否引用了HSP。引用了HSP的模块不支持预览，需要直接在HSP内预览或模拟HSP，参考为HSP设置Mock实现。

  • 检查是否被系统杀毒软件或安全软件识别为病毒程序。尝试关闭系统杀毒/安全软件，或将IDE加入系统杀毒/安全软件的白名单中。

  • 清除缓存（File->Invalidate Caches…），重启IDE。

  • 检查预览器是否使用了不支持的API：支持使用预览器的API清单，项目是否需要请求网络，是否使用自定义弹窗。预览器暂不支持这些场景，建议使用模拟器/真机调试。