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

安卓开发如何用数据库更新版本

admin
行业动态
2025-04-22
6

数据库版本更新原理

在安卓开发中,SQLite数据库的版本更新通过SQLiteOpenHelper的onUpgrade()方法实现，当应用的数据库版本号（DATABASE_VERSION）增加时，系统会触发onUpgrade()方法，开发者需在此方法中定义数据库结构的变更逻辑（如新增表、修改字段等）。

实现步骤

创建`SQLiteOpenHelper`子类

public class DatabaseHelper extends SQLiteOpenHelper {
    private static final int DATABASE_VERSION = 3; // 当前版本号
    private static final String DATABASE_NAME = "app.db";
    public DatabaseHelper(Context context) {
        super(context, DATABASE_NAME, null, DATABASE_VERSION);
    }
    @Override
    public void onCreate(SQLiteDatabase db) {
        // 首次创建数据库时的逻辑（如初始化表结构）
        db.execSQL("CREATE TABLE user (id INTEGER PRIMARY KEY, name TEXT)");
    }
    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        // 根据版本号差异执行迁移逻辑
        if (oldVersion == 1 && newVersion == 2) {
            // 版本1→2：新增字段
            db.execSQL("ALTER TABLE user ADD COLUMN age INTEGER");
        } else if (oldVersion == 2 && newVersion == 3) {
            // 版本2→3：创建新表
            db.execSQL("CREATE TABLE orders (id INTEGER PRIMARY KEY, userId INTEGER)");
        }
        // 其他版本迁移逻辑...
    }
}

触发数据库升级

当应用运行时,若数据库版本低于DATABASE_VERSION，系统会自动调用onUpgrade()。

安卓开发如何用数据库更新版本第1张

DatabaseHelper helper = new DatabaseHelper(context);
SQLiteDatabase db = helper.getWritableDatabase(); // 触发onUpgrade()

数据迁移策略

迁移场景	解决方案
新增字段	使用`ALTER TABLE`添加字段，并为旧数据设置默认值。
修改字段类型	创建临时表→复制数据→删除旧表→重命名新表。
删除表	需先备份数据，迁移到新表结构后删除旧表。
复杂逻辑	使用事务保证原子性，或拆分为多个版本升级步骤。

测试数据库升级

模拟旧版数据库：手动修改DATABASE_VERSION为旧版本号，运行应用生成旧数据库文件。
升级版本号：将DATABASE_VERSION改回新版本号，运行应用触发onUpgrade()。
验证数据：检查数据库结构是否符合预期，数据是否完整。

常见问题

问题1：onUpgrade()未执行
原因：未更新DATABASE_VERSION或未调用getWritableDatabase()。
解决：确保版本号递增，并在应用启动时获取数据库实例。
问题2：数据丢失
原因：直接删除表或未处理旧数据。
解决：优先使用ALTER TABLE，必要时备份数据并逐步迁移。