本文介绍如何在 Android 应用首次启动时自动插入初始数据到 SQLite 数据库，避免依赖安装前手动操作，确保用户打开应用即可见预置内容。核心方案是在 SQLiteOpenHelper.onCreate() 中批量插入数据，并配合标记机制防止重复写入。
本文介绍如何在 android 应用首次启动时自动插入初始数据到 sqlite 数据库，避免依赖安装前手动操作，确保用户打开应用即可见预置内容。核心方案是在 `sqliteopenhelper.oncreate()` 中批量插入数据，并配合标记机制防止重复写入。
在 Android 中，SQLite 数据库由应用上下文动态创建并存储于私有目录（如 /data/data/
正确的做法是：在 SQLiteOpenHelper.onCreate() 方法中执行初始化插入，该方法仅在数据库首次创建时调用（即 getWritableDatabase() 第一次被调用且数据库不存在时）。但需注意：onCreate() 仅负责建表，若在此处直接插入大量数据，可能因主线程阻塞导致 ANR（Application Not Responding）。因此推荐以下优化流程：
✅ 推荐实现步骤
- 在 onCreate() 中建表后，立即插入初始数据（适合少量静态数据）；
- 对插入状态做持久化标记（如使用 SharedPreferences 记录“已初始化”），避免升级或误触发重复插入；
- 如数据量较大（如 >100 条），改用 AsyncTask、Thread 或 WorkManager 异步执行，并在启动页（Splash Screen）展示加载状态。
以下是改进后的 DataHelper 示例（含初始化逻辑与防重机制）：
public class DataHelper extends SQLiteOpenHelper {
private static final String DB_NAME = "contacts.db";
private static final String TABLE_NAME = "CONTACTS";
private static final int DB_VERSION = 3;
private static final String PREFS_NAME = "db_init_prefs";
private static final String KEY_INIT_DONE = "init_done";
// 表字段定义（保持不变）
public static final String COLUMN_1 = "ID";
public static final String COLUMN_2 = "NMPENYAKIT";
public static final String COLUMN_3 = "DESKRIPSI";
public static final String COLUMN_4 = "GEJALA";
public static final String COLUMN_5 = "SOLUSI";
public static final String COLUMN_6 = "IMAGE";
private final Context mContext;
public DataHelper(Context context) {
super(context, DB_NAME, null, DB_VERSION);
this.mContext = context.getApplicationContext();
}
@Override
public void onCreate(SQLiteDatabase db) {
// 1. 创建表
String CREATE_TABLE = "CREATE TABLE " + TABLE_NAME + " ("
+ COLUMN_1 + " INTEGER PRIMARY KEY AUTOINCREMENT, "
+ COLUMN_2 + " TEXT, "
+ COLUMN_3 + " TEXT, "
+ COLUMN_4 + " TEXT, "
+ COLUMN_5 + " TEXT, "
+ COLUMN_6 + " TEXT)";
db.execSQL(CREATE_TABLE);
// 2. 插入初始数据（示例：3 条疾病记录）
ContentValues values = new ContentValues();
values.put(COLUMN_2, "Demam Berdarah");
values.put(COLUMN_3, "Infeksi virus dengue yang menyebabkan demam tinggi...");
values.put(COLUMN_4, "Demam tinggi, nyeri otot, ruam kulit, trombosit menurun");
values.put(COLUMN_5, "Istirahat cukup, hidrasi optimal, hindari obat NSAID");
values.put(COLUMN_6, "ic_dengue.png");
db.insert(TABLE_NAME, null, values);
values.clear();
values.put(COLUMN_2, "Malaria");
values.put(COLUMN_3, "Penyakit parasit yang ditularkan nyamuk Anopheles...");
values.put(COLUMN_4, "Demam menggigil, berkeringat, sakit kepala, anemia");
values.put(COLUMN_5, "Obat antimalaria seperti artemisinin kombinasi");
values.put(COLUMN_6, "ic_malaria.png");
db.insert(TABLE_NAME, null, values);
// 3. 标记初始化完成（使用 SharedPreferences）
SharedPreferences prefs = mContext.getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE);
prefs.edit().putBoolean(KEY_INIT_DONE, true).apply();
}
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
// 升级时保留旧数据（可选）或重建表
if (newVersion > oldVersion) {
db.execSQL("DROP TABLE IF EXISTS " + TABLE_NAME);
onCreate(db); // 重新建表并插入新版本初始数据
}
}
// 辅助方法：检查是否已完成初始化（供 Activity 启动时判断）
public boolean isInitialized() {
SharedPreferences prefs = mContext.getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE);
return prefs.getBoolean(KEY_INIT_DONE, false);
}
}
⚠️ 注意事项与最佳实践
- 避免在 onCreate() 中执行耗时 I/O 操作：若初始数据来自 JSON 文件或网络，务必异步处理（如 AsyncTask 已废弃，推荐 Coroutine 或 ExecutorService）；
- onUpgrade() 中谨慎处理数据迁移：简单场景可用 DROP + CREATE，但生产环境应支持增量更新，避免用户数据丢失；
- 测试首次启动行为：卸载应用后重新安装，验证数据是否正确出现；
- 考虑 Room 替代方案：对于新项目，建议使用 Jetpack Room，它原生支持预填充数据库（createFromAsset() / createFromFile()），更安全可控。
通过上述方式，你既能保证用户首次打开 App 即看到完整数据，又能兼顾性能与健壮性，是 Android SQLite 初始化的标准实践。
