集成ObjectBox 1.6.0的Flutter安卓应用Release包在Android10+崩溃

问题现象 #

• Debug模式下应用运行完全正常
• Android 10（API 29）及以上系统的Release构建版本启动即崩溃，提示创建Store失败，应用卡在启动页

解决方案 #

1. 适配Android 10+分区存储（优先推荐）

Android 10及以上的分区存储限制了应用对外部存储的直接访问，ObjectBox默认的外部存储路径可能无法正常创建。改用应用内部存储即可绕过权限问题：
修改ObjectBox.create()方法，指定内部存储目录：

import 'package:path_provider/path_provider.dart';

class ObjectBox {
  late final Store store;
  
  ObjectBox._create(this.store) {}

  static Future<ObjectBox> create() async {
    // 获取应用专属内部存储目录
    final appDocDir = await getApplicationDocumentsDirectory();
    // 指定该目录作为ObjectBox存储路径
    final store = await openStore(directory: appDocDir.path);
    return ObjectBox._create(store);
  }
}

同时需要在pubspec.yaml中添加path_provider依赖：

dependencies:
  path_provider: ^2.0.15 # 可替换为最新稳定版

2. 添加R8/ProGuard混淆规则

Release模式下的R8混淆会误删ObjectBox的核心类，导致Store初始化失败。在android/app/proguard-rules.pro中添加以下规则：

# ObjectBox 混淆保护规则
-keep class io.objectbox.** { *; }
-keepclassmembers class * extends io.objectbox.Entity { *; }
-keepclassmembers class * implements io.objectbox.converter.PropertyConverter { *; }
-dontwarn io.objectbox.**

确保android/app/build.gradle的Release构建配置中启用了该规则：

buildTypes {
    release {
        minifyEnabled true
        proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
    }
}

3. 确保Native库完整打包

ObjectBox依赖Native库，Release模式下如果ABI过滤配置不当会导致部分架构缺失。检查android/app/build.gradle的NDK配置：

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

保留主流架构即可，无需额外删减。

4. 升级ObjectBox版本（可选）

ObjectBox 1.6.0版本较旧，可能存在Android 10+的适配遗留问题。升级到最新稳定版（如2.x系列）后，重新生成ObjectBox代码：

flutter pub run build_runner build

验证步骤 #

1. 完成上述修改后，执行flutter build apk --release生成Release安装包
2. 在Android 10+设备上安装测试，确认启动正常且Store创建成功

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