由于我们介绍的内容都是基于微软的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文件添加到工程中。
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目录。
我们试着编译一下工程,或者重新生成解决方案,看看在可执行文件的生成目录下是否包含库文件sqlite3.dll和sqlite3.lib文件。