Flutter Windows桌面应用安装msix包后启动白屏无响应问题求助

1 修复CMake构建硬编码绝对路径问题 #

• 在项目windows/CMakeLists.txt文件的最顶部添加如下配置，明确赋值CMAKE_INSTALL_LOCAL_ONLY标识，避免构建脚本写入本地绝对路径：

set(CMAKE_INSTALL_LOCAL_ONLY ON CACHE BOOL "Disable local path hardcode" FORCE)

• 清理所有旧构建缓存，执行命令：
  flutter clean
  手动删除windows/build、windows/CMakeFiles目录下的全部残留文件，避免旧缓存影响新构建结果。
• 重新执行Release构建命令：
  flutter build windows --release
  构建完成后先直接打开build/windows/runner/Release目录下的exe文件，确认无构建环境的情况下也能正常启动，再进行后续打包操作。

2 排查业务代码及依赖的绝对路径问题 #

• 所有静态资源（图片、配置文件、静态数据等）统一通过Flutter asset机制访问，不要直接写磁盘路径，资源声明在pubspec.yaml中，运行时通过rootBundle或AssetImage读取。
• 所有运行时动态生成的文件路径，统一通过path_provider插件获取系统标准目录（应用文档目录、临时目录等）后拼接生成，禁止硬编码任何用户目录、系统盘路径。
• 检查项目依赖的所有原生Flutter插件，若插件的Windows端实现存在硬编码路径，升级到插件最新稳定版，或手动修改插件的CMake配置将路径改为相对路径。

3 最终打包验证 #

重新用msix工具生成安装包，拷贝到无Flutter开发环境的干净Windows设备安装测试，若能正常加载UI则问题修复。如果仍有白屏问题，可在应用启动逻辑中增加路径日志输出，定位剩余无效绝对路径的位置。

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