Flutter应用Google Play下载后启动崩溃问题求助

问题详情 #

我的Flutter应用在模拟器上运行完全正常，但从Google Play下载安装后一启动就崩溃。

我已经尝试过以下排查措施：

• 在android/app/gradle中添加NDK配置
• 开启multiDexEnabled true
• 清除本地缓存并执行flutter clean
• 使用change_app_package_name包修改应用包名
• 将所有依赖包更新至最新版本

修改包名后，Google Play控制台报错指向com.example.appname.MainActivity.onCreate，核心错误信息为：

dlopen failed: library "libflutter.so" not found

我已准备好app/build.gradle、android/build.gradle、pubspec.yaml、AndroidManifest.xml等配置文件，MainActivity.kt存在相关提示信息。另外我是从android/app/release目录获取的.aab文件上传至Google Play，怀疑该文件可能与问题相关。已经耗时7天仍未解决，恳请帮助。

可能的解决方案 #

1. 检查ABI架构配置 #

Google Play会基于设备架构拆分AAB包，如果Flutter项目未正确声明支持的ABI，会导致部分设备缺失libflutter.so。在android/app/build.gradle的defaultConfig块中添加：

ndk {
    abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86_64'
}

同时确保release构建类型中启用ABI拆分：

buildTypes {
    release {
        // 其他配置...
        splits {
            abi {
                enable true
                reset()
                include 'armeabi-v7a', 'arm64-v8a', 'x86_64'
                universalApk false
            }
        }
    }
}

2. 规范AAB构建命令 #

生成发布版AAB时，使用标准Flutter构建命令，避免跳过资源打包步骤：

flutter build appbundle --release

不要随意添加可能干扰打包的参数，比如--no-tree-shake-icons（除非有明确需求）。

3. 确认包名修改后的配置一致性 #

使用change_app_package_name修改包名后，易出现配置残留问题，需逐一检查：

• AndroidManifest.xml中所有组件的package属性是否与新包名一致
• MainActivity.kt的包声明（顶部package xxx;）是否匹配新包名
• android/app/build.gradle中的applicationId是否与新包名完全一致

4. 验证本地AAB是否包含libflutter.so #

使用bundletool解压本地生成的AAB，检查对应架构的so文件是否存在：

bundletool build-apks --bundle=app-release.aab --output=app-release.apks
unzip app-release.apks -d apks

进入apks/splits目录，查看对应架构的APK文件内是否存在lib/[abi]/libflutter.so。如果本地AAB就缺失该文件，说明是本地打包流程问题；如果本地存在但Google Play安装后缺失，需检查Google Play的应用签名和发布设置。

5. 调整R8混淆规则 #

如果开启了R8代码混淆，可能误删libflutter.so相关依赖。在android/app/proguard-rules.pro中添加以下规则：

-keep class io.flutter.app.** { *; }
-keep class io.flutter.plugin.**  { *; }
-keep class io.flutter.util.**  { *; }
-keep class io.flutter.view.**  { *; }
-keep class io.flutter.**  { *; }
-keep class io.flutter.plugins.**  { *; }

确保android/app/build.gradle中minifyEnabled true时，混淆规则已正确应用。

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