android mysql移植_迁移 Room 数据库

当您在应用中添加和更改功能时，需要修改 Room 实体类以反映这些更改。但是，如果应用更新更改了数据库架构，那么保留设备内置数据库中已有的用户数据就非常重要。

Room 持久性库支持通过 Migration 类进行增量迁移以满足此需求。每个 Migration 子类通过替换 Migration.migrate() 方法定义 startVersion 和 endVersion 之间的迁移路径。当应用更新需要升级数据库版本时，Room 会从一个或多个 Migration 子类运行 migrate() 方法，以在运行时将数据库迁移到最新版本：

Kotlin

val MIGRATION_1_2 = object : Migration(1, 2) {

override fun migrate(database: SupportSQLiteDatabase) {

database.execSQL("CREATE TABLE `Fruit` (`id` INTEGER, `name` TEXT, " +

"PRIMARY KEY(`id`))")

}

}

val MIGRATION_2_3 = object : Migration(2, 3) {

override fun migrate(database: SupportSQLiteDatabase) {

database.execSQL("ALTER TABLE Book ADD COLUMN pub_year INTEGER")

}

}

Room.databaseBuilder(applicationContext, MyDb::class.java, "database-name")

.addMigrations(MIGRATION_1_2, MIGRATION_2_3).build()Java

static final Migration MIGRATION_1_2 = new Migration(1, 2) {

@Override

public void migrate(SupportSQLiteDatabase database) {

database.execSQL("CREATE TABLE `Fruit` (`id` INTEGER, "

+ "`name` TEXT, PRIMARY KEY(`id`))");

}

};

static final Migration MIGRATION_2_3 = new Migration(2, 3) {

@Override

public void migrate(SupportSQLiteDatabase database) {

database.execSQL("ALTER TABLE Book "

+ " ADD COLUMN pub_year INTEGER");

}

};

Room.databaseBuilder(getApplicationContext(), MyDb.class, "database-name")

.addMigrations(MIGRATION_1_2, MIGRATION_2_3).build();

注意：为使迁移逻辑正常工作，请使用完整查询，而不要引用表示查询的常量。

迁移过程完成后，Room 会验证架构以确保迁移成功完成。如果 Room 发现问题，就会抛出包含不匹配信息的异常。

如需了解详情，请参阅 GitHub 上的 Room 迁移示例。

测试迁移

迁移通常十分复杂，迁移定义错误可能会导致应用崩溃。为了保持应用的稳定性，您应测试迁移。Room 提供了一个 room-testing Maven 工件来协助完成此测试过程。不过，为使此工件正常工作，您必须先导出数据库的架构。

导出架构

Room 可以在编译时将数据库的架构信息导出为 JSON 文件。如需导出架构，请在 app/build.gradle 文件中设置 room.schemaLocation 注释处理器属性：

build.gradle

android {

...

defaultConfig {

...

javaCompileOptions {

annotationProcessorOptions {

arguments += ["room.schemaLocation":

"$projectDir/schemas".toString()]

}

}

}

}

导出的 JSON