【Unity基础】Unity中跨平台使用SQLite

一、概述

游戏中数据存储方案众多，在进行选择时，除了要考虑数据类型外，还要考虑对于跨平台的支持。

对于数据存储方案将在单独文章里介绍，下面只是总结了不同方案的特点。

方法	跨平台支持	读写能力	适合场景	特点
Resources	优秀	只读	小型项目，静态资源加载	简单方便，Unity 自动管理
StreamingAssets	中等	只读	大型文件（音频、视频、配置文件等）	保留原始文件格式，路径平台相关
PersistentDataPath	优秀	读写	用户数据、存档、设置	持久化存储，适合存档和用户数据
ScriptableObject	优秀	只读	配置数据、静态游戏数据	Unity 原生支持，内存优化
SQLite/数据库	中等	读写	大量结构化数据管理，复杂查询	强大数据管理功能，需第三方支持
REST API / 云存储	优秀	读写

本系列文章将重点介绍如何在跨平台项目中使用SQLite做为数据存储方案。

这里的跨平台指的是Windows, Mac, Linux, iOS, Android，WebGL，基本上覆盖主流平台。

在查找过程中，AssetStore上有一些支持SQLite的插件，但都是收费的，而许多文章里提到的SQLite4Unity3d，SQLiteUnityKit， sqlite-unity-plugin等已经许多年不更新维护了。

现在在Github上找到最新的一个插件是unity-sqlite-net，这是一位巴西的游戏开发者在维护。

本系列文章就是基于这个插件进行介绍的。

这个插件支持的平台包括Windows, Linux, macOS, iOS, tvOS, visionOS, Android 和WebGL。

二、安装Unity-sqlite-net插件

安装方法有多种：

使用openupm 注册表并使用openupm-cli安装此包：

openupm add com.gilzoide.sqlite-net

使用Unity 包管理器进行安装，网址如下：

https://github.com/gilzoide/unity-sqlite-net.git#1.0.1

Assets克隆此存储库或直接在项目或文件夹中下载它的快照Packages。

https://github.com/gilzoide/unity-sqlite-net

三、运行示例代码

在Unity项目中添加下面的脚本，并在场景中创建一个空对象并挂载这个脚本，运行后可以通过Log查看运行记录。

using SQLite;
using UnityEngine;// 该库包含一些简单的属性，您可以使用它们来控制表的构造，ORM 样式
public class Player
{[PrimaryKey, AutoIncrement]public int Id { get; set; }public string Name { get; set; }
}public class TestSQLite : MonoBehaviour
{void Start(){// 1. 创建与数据库的连接。// 特殊的“:memory:”内存数据库// 还支持“file:///somefile”等 URIvar db = new SQLiteConnection($"{Application.persistentDataPath}/MyDb.db");// 2. 定义实体后，您可以通过调用 CreateTable 自动在数据库中生成表db.CreateTable<Player>();// 3. 您可以使用 Insert 在数据库中插入行// Insert 调用填充 Id，该 Id 标记为 [AutoIncremented]var newPlayer = new Player{Name = "gilzoide",};db.Insert(newPlayer);Debug.Log($"Player new ID: {newPlayer.Id}");// 对于更新和删除也存在类似的方法。// 4.a 查询数据的最直接方法// 是使用 Table 方法。这可以使用谓词// 通过 WHERE 子句进行约束和/或添加 ORDER BY 子句var query = db.Table<Player>().Where(p => p.Name.StartsWith("g"));foreach (Player player in query){Debug.Log($"Found player named {player.Name} with ID {player.Id}");}// 4.b 您还可以使用 Query 方法进行低级查询var players = db.Query<Player>("SELECT * FROM Player WHERE Id = ?", 1);foreach (Player player in players){Debug.Log($"Player with ID 1 is called {player.Name}");}// 5. 您可以使用 Execute方法对数据库执行低级更新，例如运行 PRAGMA 或 VACUUMdb.Execute("VACUUM");}
}

这段示例代码展示了如何在Unity中使用SQLite进行简单的数据库操作。具体来说：