Flet项目构建APK/AAB时Google Play安装白屏问题解析

问题现象

在使用Flet框架构建Android应用时，开发者遇到了一个典型问题：通过flet build命令生成的APK和AAB文件在本地设备上运行正常，但通过Google Play商店安装后却出现白屏现象。这个问题尤其出现在使用签名AAB文件发布到Google Play时，而未签名的AAB文件通过内部测试渠道分发则能正常运行。

问题根源分析

经过开发者社区的讨论和验证，发现该问题主要由两个关键因素导致：

1. 签名配置问题：签名后的AAB在Google Play分发时，Android系统对原生库的处理方式发生了变化，导致应用无法正常加载必要的组件。

2. 打包选项缺失：默认的构建模板缺少对第三方依赖包(如flet_lottie和flet_video)的完整支持，导致这些组件在发布版本中无法正常工作。

解决方案

1. 解决白屏问题

在项目的build.gradle文件中添加以下配置可解决签名AAB的白屏问题：

packagingOptions {
    jniLibs {
        useLegacyPackaging true
    }
}

这个配置强制使用传统的原生库打包方式，确保在Google Play分发的版本中也能正确加载必要的库文件。

2. 确保依赖包包含

对于需要额外包含的依赖包(如flet_lottie和flet_video)，开发者需要注意：

1. 在构建命令中明确指定--include-packages参数
2. 检查这些依赖是否在最终的AAB文件中正确打包

构建最佳实践

1. 清理缓存：在每次构建前清理Cookiecutter缓存可以避免一些潜在问题

   • Windows: rd /s /q %USERPROFILE%\.cookiecutters
   • Mac/Linux: rm -rf ~/.cookiecutters

2. 签名配置：确保使用正确的签名配置，包括：

   • 创建key.properties文件
   • 在build.gradle中正确配置signingConfigs

3. 版本管理：使用合理的构建版本号和版本名称，便于问题追踪

后续验证

开发者验证了修改后的构建模板确实解决了白屏问题，但发现视频组件仍然无法正常工作，这表明某些依赖包可能没有被正确包含在最终构建中。这提示我们需要进一步检查构建过程中依赖包的处理逻辑。

总结

Flet框架在构建Android应用时，特别是生成签名AAB文件时，需要注意特殊的打包配置和依赖管理。通过合理的gradle配置和构建参数，可以确保应用在各种分发渠道下都能正常运行。开发者应特别注意签名版本和未签名版本在行为上的差异，并针对Google Play的特殊要求进行适配。