如何在Android Studio中为Kotlin应用接入已填充的SQLite数据库

1. 可行性与合规性 #

• 完全可行：Room作为SQLite的官方封装库，原生支持预填充数据库方案，直接接入应用没有技术障碍。
• 合规性无问题：只要预填充的数据本身合法（无侵权、隐私违规等问题），应用商店不会因为使用离线预填充数据库拒绝上架，也不需要强制要求首次联网获取初始数据。

2. 具体接入步骤 #

方式一：直接导入预填充的SQLite数据库文件 #

• 将已填充好的.db数据库文件复制到项目的app/src/main/assets目录（若无assets目录，右键main文件夹→New→Folder→Assets Folder创建）。
• 在Room的Database类中，通过createFromAsset()指定预填充文件路径：

@Database(entities = [YourEntity::class], version = 1)
abstract class AppDatabase : RoomDatabase() {
    abstract fun yourDao(): YourDao

    companion object {
        @Volatile
        private var INSTANCE: AppDatabase? = null

        fun getDatabase(context: Context): AppDatabase {
            return INSTANCE ?: synchronized(this) {
                val instance = Room.databaseBuilder(
                    context.applicationContext,
                    AppDatabase::class.java,
                    "your-db-name"
                )
                    .createFromAsset("pre-filled-db.db") // 填写assets中的数据库文件名
                    .build()
                INSTANCE = instance
                instance
            }
        }
    }
}

• 注意：Room实体类结构、数据库版本号必须和预填充的.db文件完全一致，否则会初始化失败。

方式二：通过Room Callback动态预填充（适用于需调整数据的场景） #

如果需要在App启动时动态插入或调整预填充数据，可使用Room的回调机制：

val db = Room.databaseBuilder(context, AppDatabase::class.java, "your-db-name")
    .addCallback(object : RoomDatabase.Callback() {
        override fun onCreate(db: SupportSQLiteDatabase) {
            super.onCreate(db)
            // 数据库创建后，在IO线程执行数据插入操作
            CoroutineScope(Dispatchers.IO).launch {
                getDatabase(context).yourDao().insertAll(preFilledDataList)
            }
        }
    })
    .build()

3. 是否必须联网获取初始数据？ #

不需要。预填充数据库就是为了支持离线优先的应用场景，用户打开App即可直接使用本地数据，完全无需依赖网络或Retrofit获取初始数据。如果后续需要更新数据，可自行添加联网同步逻辑，但这并非强制要求。

内容的提问来源于stack exchange，提问作者Hooman Hooshyar