在主Android应用中集成AAR库内ObjectBox 4.0.2实体的问题求助

针对ObjectBox 4.0.2版本，以下是AAR库（AndroidCore）实体集成到主应用（MyApp）的正确配置方案：

一、修改AndroidCore库模块配置 #

库模块需要开启模型导出，确保编译生成的AAR包含ObjectBox模型文件，供主应用合并。在AndroidCore/build.gradle中添加ObjectBox扩展配置：

plugins {
    id 'com.android.library'
    id 'io.objectbox' version '4.0.2'
}

// 新增：开启模型导出，将模型文件打包进AAR
objectbox {
    exportModel = true
}

dependencies {
    implementation 'io.objectbox:objectbox-android:4.0.2'
}

重新编译生成AAR后，可解压AAR文件确认assets/objectbox-models/default.json是否存在，这是主应用识别实体的关键模型文件。

二、主应用MyApp配置调整 #

主应用无需使用已废弃的includes或modelFiles属性，只需保持以下配置即可：

plugins {
    id 'com.android.application'
    id 'io.objectbox' version '4.0.2'
}

dependencies {
    implementation 'io.objectbox:objectbox-android:4.0.2'
    implementation files('libs/AndroidCore.aar')
}

ObjectBox 4.x的Gradle插件会自动扫描依赖AAR中的objectbox-models目录，将库模块的模型合并到主应用的模型中。

三、代码层面的正确用法 #

主应用无需手动调用.entityClasses()或.entity()方法添加实体，直接使用自动生成的MyObjectBox构建BoxStore即可：

BoxStore boxStore = MyObjectBox.builder().androidContext(this).build();

手动添加实体类会导致EntityInfo类型不兼容的问题，因为4.x版本的Builder默认已包含所有合并后的实体。

四、疑问解答 #

1. 正确集成方式：库模块开启exportModel = true导出模型，主应用正常依赖AAR，插件自动完成模型合并，无需额外配置。
2. 模块特定配置：仅库模块需要添加exportModel配置，主应用保持基础配置即可，核心是确保两者ObjectBox版本完全一致。
3. 4.0.2最佳实践：旧版的includes/modelFiles已被移除，官方改用自动模型导出+合并机制，这是当前版本的标准方案。

五、排查步骤 #

如果仍存在实体未识别的问题，按以下顺序排查：

• 执行./gradlew clean清理项目缓存，重新编译
• 确认AAR文件中存在assets/objectbox-models/default.json
• 检查主应用与库模块的ObjectBox版本完全一致（无任何版本差异）
• 确保库模块的实体类为public且正确标注@Entity注解

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