Flutter应用发布Play Store后出现libflutter.so缺失错误求助

• 检查Google Play Console的APK拆分设置
  若上传的是App Bundle，进入Play Console的「发布管理」->「应用签名」，确认是否开启了「Google Play应用签名」，同时检查「发布设置」中是否针对ABI进行了过度拆分。可以尝试关闭自动拆分，或确保Flutter构建时包含所有必要的ABI架构。

• 完善build.gradle的NDK与打包配置
  在app/build.gradle的defaultConfig块中明确指定支持的ABI：

  defaultConfig {
      // 其他配置
      ndk {
          abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
      }
  }
  

  同时添加打包选项防止.so文件被剥离：

  android {
      // 其他配置
      packagingOptions {
          doNotStrip '*/armeabi-v7a/*.so'
          doNotStrip '*/arm64-v8a/*.so'
          doNotStrip '*/x86/*.so'
          doNotStrip '*/x86_64/*.so'
      }
  }
  

• 修正R8/ProGuard混淆规则
  如果开启了代码混淆，在proguard-rules.pro中添加规则保留Flutter相关文件：

  -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.**  { *; }
  

  并确保在build.gradle中关闭对Flutter库的不必要混淆：

  buildTypes {
      release {
          minifyEnabled true
          shrinkResources true
          proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
          exclude 'META-INF/*.kotlin_module'
      }
  }
  

• 清理构建缓存并重新构建
  执行以下命令清理缓存后重新生成发布包：

  flutter clean
  flutter pub get
  flutter build appbundle --release
  

• 用bundletool验证App Bundle
  使用Google的bundletool工具生成可安装的APK包，测试是否能正常运行：

  bundletool build-apks --bundle=app/build/outputs/bundle/release/app-release.aab --output=app.apks --ks=your-keystore.jks --ks-key-alias=your-key-alias
  bundletool install-apks --apks=app.apks
  

  如果此步骤安装后仍然报错，说明问题出在构建环节而非Play Store的拆分。

• 排查第三方插件兼容性
  部分第三方插件可能仅支持特定ABI，导致打包时部分架构的.so文件缺失。尝试暂时移除所有第三方插件，构建发布包后测试，若问题消失，再逐个添加插件排查出冲突的插件，更换替代方案或联系插件作者修复。

• 确认设备架构支持
  Flutter从1.12版本开始不再默认支持armeabi架构，若用户的设备为该架构，需手动添加支持：
  在app/build.gradle中添加：

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

  同时在pubspec.yaml中补充对应资源声明：

  flutter:
    # 其他配置
    assets:
      - lib/armeabi/libflutter.so
  

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