本文说的数据库升级是基于Android原生API SQLiteOpenHelper实现的逻辑，不涉及第三方库。其实如果使用官方推荐的Room库的话，可以利用 RoomDatabase.Builder.addMigrations()方法配合 Migration类灵活的设置迁移（升级）路径，根本不需要自己来实现其中的逻辑。
首先，关于 SQLiteOpenHelper类我们需要知道几点： onCreate()方法只在第一次创建数据库的时候调用， onUpgrade()方法只在数据库版本升级时调用，并且也只调用一次。
顾名思义，就是一级级的往上升。比如，当前版本为1，最新版本是3，你必须得先升到2才行。
我们来看具体实现：
private static final int VERSION = 1;
@Override
public void onCreate(SQLiteDatabase db) {
}
直接在 onCreate()中实现你的需求就行了。
private static final int VERSION = 2;
@Override
public void onCreate(SQLiteDatabase db) {
}
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
}
这里得区分两种情况：用户首次安装最新版和用户在第1版的基础上升级到最新版。
前者需要我们重新实现 onCreate()方法，照着最新的模式实现就行。
如果是后者，我们需要实现 onUpgrade()方法，在这里保证不丢失数据的情况下升级数据库到最新模式。
private static final int VERSION = 3;
@Override
public void onCreate(SQLiteDatabase db) {
}
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
switch (oldVersion) {
case 1:
case 2:
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) {
oldVersion = 4;
}
if (oldVersion == 2) {
oldVersion++;
}
if (oldVersion == 3) {
oldVersion++;
}
}
这样设计好像也没什么特别的，但我们再升级一个版本看看：
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
{if (oldVersion == 1) {
oldVersion = 4;
}
if (oldVersion == 2) {
oldVersion++;
}
if (oldVersion == 3) {
oldVersion++;
}
if (oldVersion == 4) {
oldVersion++;
}
}
可以看到，从版本1到版本5（甚至后续版本），我们可以先跨到版本4，再逐级升级。通过修改 oldVersion我们可以很方便的跨到任意版本，再通过程序原本的顺序执行流程，我们又可以在跨到目标版本后再逐级升级，甚至可以再跨再逐级，跨版本和逐级随意组合，非常灵活。
顶部的参考文章对于逐级升级的描述更为详细生动，本来打算只是收藏，但想到了跨版本升级的这种写法，怕遗忘就做了个笔记。逐级升级的写法应该很普遍了，应该不至于有什么问题，而跨版本升级我只是思想上验证了下，没有写代码去测试，如果有什么问题欢迎指正。
Original: https://blog.csdn.net/wj7788387/article/details/117357511
Author: Jay Ng
Title: Android SQLite数据库版本升级（分逐级升级和跨版本升级）
原创文章受到原创版权保护。转载请注明出处：https://www.johngo689.com/816764/
转载文章受原作者版权保护。转载请注明原作者出处！