以前在安卓端使用数据库存储数据时,总是不可避免地后期涉及到数据库升级的问题,在早期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)
可能大多数人都遇到过,我就在线上环境出现过这种问题,结果就不用说了,哈哈
image.png
后来,在2.4.0版本开始,room加入了一项重要功能------自动迁移,专门用于简化数据库升级的问题,最大程度避免了数据库升级过程中存在的各种问题,简直不要太好用
image.png
具体使用步骤:
- 首先,你需要把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"
- 增加schemas文件输出配置,这个是用来生成每个数据库版本对应的数据库结构文件,在自动迁移数据库的时候就是根据这个结构的差异,来进行自动迁移处理的,配置完之后,运行项目,会在对应的目录下生成对应数据库版本的文件,这些记得保存,不要改动(千万不要改动)
defaultConfig {
......
javaCompileOptions {
annotationProcessorOptions {
arguments = ["room.schemaLocation": "$projectDir/schemas".toString()]
}
}
}
image.png
- 如果有数据库结构变动,则修改对应的数据库版本,并添加自动升级配置,比如从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()
image.png