Android SQLite数据库版本升级（分逐级升级和跨版本升级）_Jay Ng_android sqlite数据库升级

未知 02-07 6301

参考：Android Sqlite数据库跨版本升级保存之前数据

本文说的数据库升级是基于Android原生APISQLiteOpenHelper实现的逻辑，不涉及第三方库。其实如果使用官方推荐的Room库的话，可以利用RoomDatabase.Builder.addMigrations()方法配合Migration类灵活的设置迁移（升级）路径，根本不需要自己来实现其中的逻辑。

首先，关于SQLiteOpenHelper类我们需要知道几点：onCreate()方法只在第一次创建数据库的时候调用，onUpgrade()方法只在数据库版本升级时调用，并且也只调用一次。

逐级升级

顾名思义，就是一级级的往上升。比如，当前版本为1，最新版本是3，你必须得先升到2才行。

我们来看具体实现：

最新版本为1时，也就是最初版本： private static final int VERSION = 1; @Override public void onCreate(SQLiteDatabase db) { // 实现最初版本数据库模式(schema) }

直接在onCreate()中实现你的需求就行了。

最新版本为2时： private static final int VERSION = 2; @Override public void onCreate(SQLiteDatabase db) { // 直接改为版本2的数据库模式 } @Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { // 版本1到版本2的升级操作 }

这里得区分两种情况：用户首次安装最新版和用户在第1版的基础上升级到最新版。前者需要我们重新实现onCreate()方法，照着最新的模式实现就行。如果是后者，我们需要实现onUpgrade()方法，在这里保证不丢失数据的情况下升级数据库到最新模式。

最新版本为3时： private static final int VERSION = 3; @Override public void onCreate(SQLiteDatabase db) { // 直接改为版本3的数据库模式 } @Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { switch (oldVersion) { case 1: // 版本1到版本2的升级操作 case 2: // 版本2到版本3的升级操作 default: break; } }

对于新用户和上面一样修改onCreate()就行。但对于老用户，这时我们不能只实现相对于上个版本的升级逻辑了，因为用户可能是从安装以来就没升过级，现在从版本1直接升级到版本3，所以我需要先实现1到2的逻辑，再实现2到3的逻辑，代码如上。注意不要加break语句。

依次类推，数据库版本每升一级就在switch语句中增加一个case分支，并写上相应的升级操作。这样不管用户当前版本是多少，都会从当前版本一路升级到最新版本。

很明显，这样实现很方便开发人员维护，但是有时候不够效率。试想一个极端情况：现在第4版来了，数据库模式要改回最初版，这时应该怎么实现呢？当然我们可以像上面一样，在switch中加上基于第3版的升级逻辑，无论用户现在是什么版本，都逐级升级。这样好像也可以，但效率却可想而知，尤其是使用第1版的用户，明明和第4版一摸一样，却要绕一大圈再回到起点，是不是有点多次一举。如果我们能直接升级到第4版该多好。由此，就引出了跨版本升级的必要性。

跨版本升级

如上节讨论的，怎样实现从第一版到第4版的直接升级呢，看代码：

@Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { {if (oldVersion == 1) { // 版本1到版本4的升级操作 oldVersion = 4; } if (oldVersion == 2) { // 版本2到版本3的升级操作 oldVersion++; } if (oldVersion == 3) { // 版本3到版本4的升级操作 oldVersion++; } }

这样设计好像也没什么特别的，但我们再升级一个版本看看：

可以看到，从版本1到版本5（甚至后续版本），我们可以先跨到版本4，再逐级升级。通过修改oldVersion我们可以很方便的跨到任意版本，再通过程序原本的顺序执行流程，我们又可以在跨到目标版本后再逐级升级，甚至可以再跨再逐级，跨版本和逐级随意组合，非常灵活。

顶部的参考文章对于逐级升级的描述更为详细生动，本来打算只是收藏，但想到了跨版本升级的这种写法，怕遗忘就做了个笔记。逐级升级的写法应该很普遍了，应该不至于有什么问题，而跨版本升级我只是思想上验证了下，没有写代码去测试，如果有什么问题欢迎指正。