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

  下载好后正常安装即可。

• 创建数据库

  打开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下载

GitHub对应页面

不过SQLiteUnityKit 并未添加windows支持的"SQLite3.dll"文件。

所以需要windows下使用则自己下一个：

windows平台SQLite3.dll下载地址

请根据自己的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格式才能大功告成。

  1. 将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

有任何疑问、交流或者请客吃饭玩游戏或者等等都可找我。