Visual Studio下SQLite数据库开发环境设置

由于我们介绍的内容都是基于微软的Visual Studio下开发的Win32平台所以下边我们介绍Visual Studio下SQLite数据库开发环境设置。具体而言我们有两种方式可以在Visual Studio中SQLite数据库使用SQLite源代码文件和使用Cocos2d-x提供的库文件。
1、使用SQLite源代码文件
SQLite是C编写的开源的数据库我们可以在http://www.sqlite.org/download.html网址下载最新的SQLite源代码如我下载的sqlite-amalgamation-3080401.zip文件解压这个文件后的内容包括shell.c、sqlite3.c、sqlite3.h和sqlite3ext.h。我们一般只需要sqlite3.c和sqlite3.h两个文件就可以了。
我们需要把这两个文件添加到工程中具体过程是拷贝它们到工程中Classes目录打开解决方案如图所示右键点击HelloWorld工程下Classes目录在右键菜单中选择“添加”→ “现有项”。然后在弹出对话框中选择sqlite3.c和sqlite3.h文件添加到工程中。

添加sqlite3.c和sqlite3.h文件到工程

2、使用Cocos2d-x提供的库文件
由于Cocos2d-x引擎其实已经带有为Win32下访问SQLite所需要的库Cocos2d-x 3.x中SQLite库文件所在位置是<工程目录>\cocos2d\external\sqlite3\libraries\win32目录中头文件在<工程目录>\cocos2d\external\sqlite3\include目录中。我们可以直接使用。
这种方式的优点是可以直接使用Cocos2d-x引擎为开发者编译好的库文件版本兼容性好。缺点是配置开发环境比较麻烦而且移植到其它平台时Win32库文件是不能使用的我们需要重新配置环境。下面我们就详细介绍一下这种方式。
首先我们需要配置头文件搜索路径选中HelloWorld工程打开菜单“项目”→ “属性”弹出工程属性对话框如下图所示选择“配置属性”→“C++” →“常规”在右边的“附加包含目录”中添加$(EngineRoot)external\sqlite3\include注意配置目之间需要用分号分隔开。

配置头文件搜索路径
接下来我们还需要将SQLite3的库文件配置到链接环境中选择“配置属性”→“链接器” →“输入” 如下图所示在右边的“附加依赖项”中添加$ $(EngineRoot)external\sqlite3\libraries\win32\sqlite3.lib注意配置目之间需要用分号分隔开。

配置链接环境

接下来我们还需要将SQLite3的库文件拷贝到运行环境中最简单的方式是手工将<工程目录>\cocos2d\external\sqlite3\libraries\win32目录中的sqlite3.dll和sqlite3.lib文件拷贝到可执行文件所在目录下如<工程目录>\proj.win32\Debug.win32目录。然后编译工程就可以了但是如果我们清除了Debug.win32目录这两个文件就会丢失。为了防止这种情况我们可以在工程编译的时候设置编译事件我们可以在这个事件中定义拷贝过程。打开工程属性对话框如下图所示选择“配置属性”→“生成事件” →“预链接事件”修改右边窗口的“命令行”内容如下
if not exist "$(OutDir)" mkdir "$(OutDir)"
xcopy /Y /Q "$(EngineRoot)external\websockets\prebuilt\win32\*.*" "$(OutDir)"
xcopy /Y /Q "$(EngineRoot)external\sqlite3\libraries\win32\*.*" "$(OutDir)"
其中后面一行是我们追加的原来工程模板只设置了拷贝websockets。这个会在我们工程编译的时候将$(EngineRoot)external\sqlite3\libraries\win32\目录下的所有文件拷贝到输出目录其中$(EngineRoot)宏代表<工程目录>\cocos2d\目录$(OutDir)宏是可执行文件的生成目录这里代表<工程目录>\proj.win32\Debug.win32目录。