Room数据库自动升级

以前在安卓端使用数据库存储数据时,总是不可避免地后期涉及到数据库升级的问题,在早期Room版本中,需要编写对应的sql文件来处理对应版本升级的问题,这样很容易出现问题,比如少写了某些字段的处理,这些问题造成的后果就是APP崩溃闪退

private static Migration migration1_2 = new Migration(1, 2) {

    @Override

    public void migrate(@NonNull SupportSQLiteDatabase database) {

        database.execSQL("ALTER TABLE Repo"

                + " ADD COLUMN age INTEGER ");

     

    }

};           

private static RepoDatabase create(final Context context) {
    return Room.databaseBuilder(
            context,
            RepoDatabase.class,
            DB_NAME)
            .addMigrations(migration1_2)
            .build();
}
// 修改版本号
@Database(entities = Repo.class, version = 2)           

可能大多数人都遇到过,我就在线上环境出现过这种问题,结果就不用说了,哈哈

后来,在2.4.0版本开始,room加入了一项重要功能------自动迁移,专门用于简化数据库升级的问题,最大程度避免了数据库升级过程中存在的各种问题,简直不要太好用

具体使用步骤:

1. 首先,你需要把room版本升级为至少2.4.0

//Room数据库: https://developer.android.google.cn/jetpack/androidx/releases/room
    def room_version = "2.4.0"
    implementation "androidx.room:room-runtime:$room_version"
    kapt "androidx.room:room-compiler:$room_version"
    implementation  "androidx.room:room-ktx:$room_version"           

2. 增加schemas文件输出配置,这个是用来生成每个数据库版本对应的数据库结构文件,在自动迁移数据库的时候就是根据这个结构的差异,来进行自动迁移处理的,配置完之后,运行项目,会在对应的目录下生成对应数据库版本的文件,这些记得保存,不要改动(千万不要改动)

defaultConfig {


        ......


        javaCompileOptions {
            annotationProcessorOptions {
                arguments = ["room.schemaLocation": "$projectDir/schemas".toString()]
            }
        }
    }           

3. 如果有数据库结构变动,则修改对应的数据库版本,并添加自动升级配置,比如从1升级到2,那就把version改为2,并添加 AutoMigration(from = 1, to = 2)

@Database(entities = [Inspiration::class, Daiban::class, SportClass::class, SportLog::class], version = 3, autoMigrations = [
    AutoMigration(from = 1, to = 2),
    AutoMigration(from = 2, to = 3),
])
abstract class AppDataBase : RoomDatabase() {


    abstract fun inspirationDao(): InspirationDao


    abstract fun daibanDao(): DaibanDao


    abstract fun sportDao(): SportDao


}           

至此自动化迁移工作就完成了,就是这么简单,装个数据库版本为1的app,然后用新版本覆盖,数据库就会自动完成迁移配置

可能遇到的问题是:

在开发过程中因为会频繁修改数据库,所以,如果出现数据库字段迁移问题的话,就直接卸载重新安装就可以了,不用频繁修改version,但是在上线前一定要检查数据库自动迁移是否正常,避免把问题暴露在生产环境中,具体验证方式就是手机上先安装前一个版本的上线包,然后运行即将上线的新版本代码覆盖旧版本,检查数据库文件是否正常迁移,如果存在问题则针对具体的问题进行修复

最后,提供一个走投无路的操作,如果数据不是特别重要的话,可以开启破坏性重建fallbackToDestructiveMigration,避免APP崩溃至于具体作用,大家就看文档注释吧,这是一个下下策,慎用

Room.databaseBuilder(context, AppDataBase::class.java, "Record_Things_db")
                .fallbackToDestructiveMigration()
                .build()