unity跨平台sqlite使用教程
前言
最近做的一个新项目，需要处理大量数据和动态图表展示。
并且结合跨平台使用的问题，考虑再三，计划使用Unity3D+SQLite进行开发。
因为跨平台的需求，先忽略UnityStore的收费SQLite插件。在GitHub上找到了“SQLiteUnityKit”。
SQLiteUnityKit 全平台支持，包括iOS, Android, MAC 还有 Windows。
亲测windows、MAC和Android都可正常使用。IOS目前没有开发账号，所以作罢。
android测试成功.jpg
准备工作
SQLite安装&创建测试用数据库
-
安装SQLite
可以只安装命令行环境，但是安装可视化客户端可以更方便的使用数据库。
下面是我推荐的客户端，DB Browser。轻巧、跨平台，使用方便。
下载好后正常安装即可。
-
创建数据库
打开DB Browser。
点击“新建数据库”按钮新建数据库，命名为test.db。
随后出现“编辑表定义”窗口。
表名称设为“example”
点击“添加字段”按钮三次，添加三个字段。
第一个：名称为“id”，类型为“INTEGER”，勾选PK（主键）和AI（自动增值）用作每个数据的唯一索引。
后面两个字段不勾选选框，只改名称和类型。
第二个：名称为“name”，类型为“TEXT”。
第三个：名称“dummy”，类型为“INTEGER”。
点击“OK”按钮完成“test.db”数据库的创建。
可以顺便给里面添加一两行数据作测试用。
或者直接命令行运行SQLite
创建文件
$sqlite3 test.db SQLite version 3.19.4.2 2017-08-18 19:28:12 Enter ".help" for usage hints. sqlite>表定义
CREATE TABLE `example` ( `id` INTEGER PRIMARY KEY AUTOINCREMENT, `name` TEXT, `dummy` INTEGER ); -
如果希望用其它方式安装SQLite和创建测试数据库，或者学习sqlite语法。可在网上查找，资料很多。
SQLiteUnityKit 下载
不过SQLiteUnityKit 并未添加windows支持的"SQLite3.dll"文件。
所以需要windows下使用则自己下一个：
请根据自己的unity是x64还是x86酌情下载对应dll。
准备好这些之后...
开工
流程
对unity的版本要求不高，直接用手头的2017.2。
-
新建Unity项目。
-
将之前下载的SQLiteUnityKit 解压放入项目的“Assets”文件夹内。
-
mac和ios不用进行额外操作，但是windows和android需要下面操作：
windows：
将之前下载的"SQLite3.dll"文件放入"Assets/Plugins“文件夹内即可。
android：
将SQLiteUnityKit 里面的"libsqlite3.so"文件拷贝到"Assets/Plugins/Android"文件夹内即可。
-
将之前创建的测试用数据库“test.db”放入“Assets/StreamingAssets”文件夹内。
-
创建脚本“SQLiteTest.cs”，写入下面代码：
using UnityEngine;
public class SQLiteTest : MonoBehaviour{
public SqliteDatabase sqlDB;
// Use this for initialization
void Start() {
//打开测试数据库
sqlDB = new SqliteDatabase("test.db");
//添加数据
sqlDB.ExecuteNonQuery("insert into example (name,dummy) values('test name', -123)");
print("添加数据完毕");
PrintAllData();
//根据id删除最后添加的数据
sqlDB.ExecuteNonQuery("DELETE FROM example WHERE id = (SELECT MAX(id) FROM example)");
print("删除数据完毕");
PrintAllData();
}
//控制台打印数据
void PrintAllData()
{
//读取example表中所有数据
DataTable dt = sqlDB.ExecuteQuery("SELECT * FROM example");
//提取每行数据，遍历打印
string name;
int dummy;
foreach (DataRow dr in dt.Rows)
{
name = (string)dr["name"];
dummy = (int)dr["dummy"];
print("name:" + name);
print("dummy:" + dummy);
//print("id:" + (int)dr["id"]);
}
}
}
将脚本附加在场景的camera中，运行后若在控制台看结果则成功。
发现的问题与解决
中文数据写入时报错:SqliteException: near "xxxx": syntax error
-
排查问题原因
上面代码，name字段中写入的是英文“test name”，没有问题。
但是如果写入中文，比如"中文测试"，结果却报错：
SqliteException: near "xxxx": syntax error经过排查，终于发现问题在SQLiteUnityKit的“SqliteDatabase.cs”脚本中。
其函数
IntPtr Prepare(string query)在调用SQLite的“sqlite3_prepare_v2”函数时出了错。”sqlite3_prepare_v2“第二个参数是query，第三个参数是query的长度。然而中文的string长度并不是真正的字节长度，一个中文字符根据编码不同，会占用2到4个字节。
因此SQLite获得的字符串长度不够，就会报错。
-
解决方法
让”sqlite3_prepare_v2“函数获得正确的字节长度。
SQLite默认的字符格式为UTF8，因此将传入的query用UTF8格式解析成为字节数组。字节数组的长度才是正确长度。
不过这样并未结束，由于unity的cs脚本默认并不是UTF8编码格式，因此需要将写入数据用的“DataTable.cs”脚本改为UTF8格式才能大功告成。
- 将
IntPtr Prepare(string query)函数替换：
- 将
private IntPtr Prepare (string query){
IntPtr stmHandle;
byte[] queryByts = System.Text.Encoding.UTF8.GetBytes(query);//正确字节长度
if (sqlite3_prepare_v2 (_connection, query, queryByts.Length, out stmHandle, IntPtr.Zero) != SQLITE_OK) {
IntPtr errorMsg = sqlite3_errmsg (_connection);
throw new SqliteException (Marshal.PtrToStringAnsi (errorMsg));
}
return stmHandle;
}
2.将“DataTable.cs”脚本的编码改为UTF8格式：
在VisualStudio和MnnoBehaviour的文件菜单都有“脚本另存为”选项。
点开另存为后选择UTF8编码，覆盖原脚本保存即可。
项目分享
为方便在座（或，在站、在趟、在蹲）各位，不才 将示例项目给大家分享：
链接：https://pan.baidu.com/s/1K52P1qW6SI5t6hlkYExwwg 密码：y12a
有任何疑问、交流或者请客吃饭玩游戏或者等等都可找我。
