当前位置：首页 > 行业动态 > 正文

安卓开发手动更新数据库

手动更新数据库的核心思路

在安卓开发中，当数据库结构发生变化（如新增表、修改字段类型）时，若不想依赖框架的自动迁移功能，需手动处理数据迁移，核心思路是：备份旧数据 → 创建新结构 → 迁移数据 → 清理旧数据。

具体实现步骤

备份旧数据库

在更新前备份旧数据库文件,防止迁移失败导致数据丢失。

// 获取旧数据库路径
File oldDbFile = context.getDatabasePath(DATABASE_NAME);
// 复制到临时文件
File backupFile = new File(context.getExternalFilesDir(null), "backup.db");
SQLiteDatabase.copyDatabase(new File(oldDbFile.getAbsolutePath()), backupFile);

检查当前数据库版本

通过 SQLiteDatabase 的 getVersion() 方法获取当前数据库版本,判断是否需要迁移。

安卓开发手动更新数据库 第1张

SQLiteDatabase db = SQLiteDatabase.openDatabase(oldDbFile.getAbsolutePath(), null, SQLiteDatabase.OPEN_READONLY);
int currentVersion = db.getVersion();
db.close();

执行迁移逻辑

根据目标版本号，分步骤执行迁移操作,例如从版本1升级到版本2：

if (currentVersion == 1) {
    // 1. 创建新版本数据库
    SQLiteDatabase newDb = SQLiteDatabase.openOrCreateDatabase(oldDbFile, null, SQLiteDatabase.CREATE_IF_NECESSARY);
    newDb.setVersion(2); // 设置新版本号
    // 2. 创建新表结构
    newDb.execSQL("ALTER TABLE users ADD COLUMN age INTEGER"); // 示例：新增字段
    // 3. 迁移数据（如需复杂操作）
    // 将旧表数据复制到新表
    // newDb.execSQL("INSERT INTO new_table SELECT  FROM old_table");
    // 4. 删除旧表（谨慎操作）
    // newDb.execSQL("DROP TABLE old_table");
    newDb.close();
}

验证迁移结果

通过日志或工具（如 SQLiteBrowser）检查新数据库结构和数据完整性。

关键注意事项

注意事项 说明
事务管理 使用 beginTransaction() 和 setTransactionSuccessful() 保证操作原子性
兼容性处理 低版本设备可能不支持某些 SQL 语法（如 ALTER TABLE 在某些版本不可用）
数据完整性 迁移后需校验关键字段（如主键、外键）是否完整
逆向兼容 考虑从高版本回滚到低版本时的数据兼容性（如字段删除）

测试方法

  1. 模拟器/真机测试

    • 安装旧版本 APK,插入测试数据。
    • 升级 APK 版本,触发数据库更新逻辑。
    • 检查新数据库结构和数据是否符合预期。

  2. 覆盖安装测试

    • 卸载应用后重新安装，验证 onUpgrade() 是否被调用。
    • 使用 adb 命令直接替换 APK 文件,模拟用户覆盖安装场景。

常见问题与解答

问题1：迁移后数据丢失怎么办？

解答：

  • 优先检查备份文件是否存在,尝试回滚到旧数据库。
  • 确认迁移逻辑中是否遗漏字段复制（如未处理 ALTER TABLE 后的默认值）。
  • 使用工具（如 SQLite Browser）直接打开数据库文件,检查表结构是否完整。

问题2：手动更新和 Room 自动迁移有什么区别？

解答：
| 对比项 | 手动更新 | Room 自动迁移 |
|—————-|—————————————|————————————-|
| 灵活性 | 需手动处理所有细节（如数据复制、字段映射） | 通过注解自动生成迁移代码 |
| 风险 | 易出错（如遗漏字段导致数据丢失） | 依赖框架稳定性，复杂迁移仍需手动补充 |
| 适用场景 | 简单结构变更或对框架不信任的场景 | 常规版本迭代（如新增表、修改字段类型） |
| 性能 | 可优化迁移逻辑（如分批次处理数据） | 依赖框架默认实现，可能效率较低 |

代码示例：完整迁移流程

public void migrateDatabase(Context context) {
    File dbFile = context.getDatabasePath(DATABASE_NAME);
    if (!dbFile.exists()) return; // 数据库不存在，无需迁移
    // 1. 备份旧数据库
    File backupFile = new File(context.getExternalFilesDir(null), "backup.db");
    try {
        SQLiteDatabase.copyDatabase(new File(dbFile.getAbsolutePath()), backupFile);
    } catch (IOException e) {
        e.printStackTrace();
        return; // 备份失败，终止迁移
    }
    // 2. 打开数据库并检查版本
    SQLiteDatabase db = SQLiteDatabase.openDatabase(dbFile.getAbsolutePath(), null, SQLiteDatabase.OPEN_READWRITE);
    int version = db.getVersion();
    db.close();
    // 3. 根据版本执行迁移
    if (version == 1) {
        // 示例：版本1 → 版本2
        SQLiteDatabase newDb = SQLiteDatabase.openOrCreateDatabase(dbFile, null, SQLiteDatabase.CREATE_IF_NECESSARY);
        newDb.beginTransaction();
        try {
            newDb.setVersion(2); // 设置新版本号
            newDb.execSQL("ALTER TABLE users ADD COLUMN age INTEGER DEFAULT 0"); // 新增字段
            newDb.execSQL("CREATE TABLE logs (id INTEGER PRIMARY KEY, message TEXT)"); // 新增表
            newDb.setTransactionSuccessful();
        } catch (SQLException e) {
            e.printStackTrace();
        } finally {
            newDb.endTransaction();
            newDb.close();
        }
    }
    // 4. 清理备份文件（可选）
    backupFile.delete();
}
0

相关文章