如何在MAUI .NET应用中打包现有SQLite数据库？或实现首次安装初始化？

一、打包已有SQLite数据库的实现方法 #

• 第一步：将现有数据库文件加入项目
  把你的SQLite数据库文件（比如app_data.db）放到项目的某个目录下（比如Resources/Databases），在Visual Studio中选中该文件后设置：

  • 生成操作：选择Embedded resource
  • 复制到输出目录：选择如果较新则复制

• 第二步：启动时复制嵌入数据库到可写目录
  嵌入式资源是只读的，必须复制到应用的可写路径才能进行读写操作。在应用初始化时（比如App.xaml.cs的OnStart方法）执行以下逻辑：

  var dbFileName = "app_data.db";
  var targetPath = Path.Combine(FileSystem.AppDataDirectory, dbFileName);
  
  if (!File.Exists(targetPath))
  {
      // 资源名称格式：项目名.目录路径.文件名（注意目录层级用点分隔）
      var resourceName = "YourMauiProjectName.Resources.Databases.app_data.db";
      using var stream = Assembly.GetExecutingAssembly().GetManifestResourceStream(resourceName);
      using var fileStream = new FileStream(targetPath, FileMode.Create);
      stream.CopyTo(fileStream);
  }
  

  之后直接用targetPath作为数据库路径创建SQLite连接即可。

二、首次安装创建并填充数据库的方案 #

如果暂时不想打包现有数据库，可通过标记初始化状态实现首次启动时创建并填充数据：

核心逻辑 #

通过检查数据库文件是否存在，或用本地存储标记初始化状态，确保初始化操作仅执行一次。

代码示例 #

var dbPath = Path.Combine(FileSystem.AppDataDirectory, "new_app_db.db");
var isDbInitialized = Preferences.Get("IsDatabaseInitialized", false);

if (!isDbInitialized)
{
    using var conn = new SQLiteConnection(dbPath);
    // 创建数据表（替换为你自己的实体类）
    conn.CreateTable<User>();
    
    // 插入初始数据
    conn.InsertAll(new List<User>
    {
        new User { Username = "admin", Email = "admin@example.com" },
        new User { Username = "guest", Email = "guest@example.com" }
    });
    
    // 标记初始化完成，避免重复执行
    Preferences.Set("IsDatabaseInitialized", true);
}

可将这段逻辑放在App.xaml.cs的OnStart方法，或专门的数据库初始化类中，保证仅在首次启动时运行。

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