SQLite第二课 下载编译

文件说明
下载源码包两个：
sqlite-dll-win32-x86-3081101.zip，里面提供了导出sqlite3的函数的文件sqlite3.def
主要用于生成LIB文件，确定链接使用
sqlite-preprocessed-3081101.zip，提供了源码文件，但是删除shell.c和tclsqlite3.c文件
shell.c：提供了main函数入口，可生成sqlite.exe的可执行程序，生成的控制台操作SQLite数据库
tclsqlite.c：提供了在Linux系统下，进行测试SQLite的TCL脚本
 
这两个文件对于编译环境是windows，只是将SQLite编译进程序中都不需要，添加源代码的时候，需要进行剔除。
sqlite3.h：提供了对外使用的所有接口
sqlite3ext.h:该文件暂时不了解
** This header file defines the SQLiteinterface for use by
** shared libraries that want to beimported as extensions into
** an SQLite instance.  Shared libraries that intend to be loaded
** as extensions by SQLite should #includethis file instead of
** sqlite3.h.
2 编译选项说明
必选编译选项：
SQLITE_CORE
FTS1有一个设计的缺陷，会导致数据库错误（databasecorruption）.强烈推荐废弃该模块，改用fts3或者更高的模块。如果你相信fts1的使用是安全的，可以通过添加DSQLITE_ENABLE_BROKEN_FTS1=1到编译选项。
FTS1模块将会作为一个扩展模块而被编译（当SQLITE_CORE没有被定义的情况下）。
另外如果SQLITE_ENABLE_FTS1被定义，FTS1也会被编译进SQLite内核。
 
可选编译选项：
SQLITE_ENABLE_RTREE
将Rtree模块编译进SQLite内核，本研究针对二维空间的POI进行存储，
所以必须开启Rtree模块，稍后会进行源码剖析。
 
 
SQLITE_ENABLE_COLUMN_METADATA
作用：可以调用如下的函数
SQLITE_API const char *SQLITE_STDCALL sqlite3_column_database_name(sqlite3_stmt*,int);
SQLITE_API
const void *SQLITE_STDCALL sqlite3_column_database_name16(sqlite3_stmt*,int);
SQLITE_API const
char *SQLITE_STDCALL sqlite3_column_table_name(sqlite3_stmt*,int);
SQLITE_API const void
*SQLITE_STDCALL sqlite3_column_table_name16(sqlite3_stmt*,int);
SQLITE_API const char
*SQLITE_STDCALL sqlite3_column_origin_name(sqlite3_stmt*,int);
SQLITE_API const void
*SQLITE_STDCALL sqlite3_column_origin_name16(sqlite3_stmt*,int);
这些函数主要是获取数据库的库名，表名，列名
调用条件：必须在[sqlite3_step()]之后，[sqlite3_finalize()]之前调用。

1.新建win32控制台程序，名称sqlite3
 
2.选择生成DLL
 
3.解压压缩包，将sqlite-preprocessed-3081101的文件复制到工程文件夹下（除了shell.c以及tclsqlite.c)。
 
4.通过添加存在文件，将源码添加到编译项目中
 
5设置模块定义文件sqlite3.def，否则生成的dll没有对应的lib
指定函数的导出文件：sqlite3.defs
属性>>链接器>>输入>>模块定义文件（sqlite3.def），请注意这种情况下，sqlite3.def文件和编译环境平级。
 
6.添加预定义选项SQLITE_CORE,SQLITE_ENABLE_COLUMN_METADATA、SQLITE_ENABLE_RTREE，这是sqlite3的宏定义。
属性>>C/C++>>预处理器>>预处理定义>>
SQLITE_CORE
SQLITE_ENABLE_COLUMN_METADATA
SQLITE_ENABLE_RTREE
编译出错提示：
1>sqlite3.def : error LNK2001: 无法解析的外部符号sqlite3_column_database_name
1>sqlite3.def :error LNK2001: 无法解析的外部符号sqlite3_column_database_name16
1>sqlite3.def :error LNK2001: 无法解析的外部符号sqlite3_column_origin_name
1>sqlite3.def :error LNK2001: 无法解析的外部符号sqlite3_column_origin_name16
1>sqlite3.def :error LNK2001: 无法解析的外部符号sqlite3_column_table_name
1>sqlite3.def :error LNK2001: 无法解析的外部符号sqlite3_column_table_name16
1>sqlite3.def :error LNK2001: 无法解析的外部符号sqlite3_rtree_geometry_callback
1>sqlite3.def :error LNK2001: 无法解析的外部符号sqlite3_rtree_query_callback
前面6个函数，必须定义了SQLITE_ENABLE_COLUMN_METADATA才能够将函数导出，一般情况下，这些函数，我们可以直接在sqlite3.def文件中删除，不导出
后面2个函数，必须定义了SQLITE_ENABLE_RTREE才能够将函数导出，如果我们不适用R树的空间搜索功能，这些函数，我们可以直接在sqlite3.def文件中删除，不导出

7.按F7生成相应的dll和lib。

编译说明
1）fts2 has a designflaw and has been deprecated
2）fts1 has a designflaw and has been deprecated
解决方案：
解析：FTS1和FTS2都有设计的缺陷，现在已经被废弃，目前已经提供了FTS3或者FTS4，这些作为全文搜索的模块，弥补了以前的FTS1的不足。如果确定不会使用到全文搜索，可以直接使用SQLITE_CORE，禁用。将SQLITE_CORE添加到编译选项。
VS 的基本设置：属性>>C/C++>>预处理器》》预处理定义
3）Cannot open includefile: 'unicode/utypes.h': No such file or directory  
该问题主要是调用了FTS1或者FTS2引起的，通过禁用FTS1和FTS2顺利编译通过。
FTS1有一个设计的缺陷，会导致数据库错误（databasecorruption）.强烈推荐废弃该模块，改用fts3或者更高的模块。如果你相信fts1的使用是安全的，可以通过添加DSQLITE_ENABLE_BROKEN_FTS1=1到编译选项。
FTS1模块将会作为一个扩展模块而被编译（当SQLITE_CORE没有被定义的情况下）。
另外如果SQLITE_ENABLE_FTS1被定义，FTS1也会被编译进SQLite内核。
4）Error: no module:rtree
默认情况下sqlite3.exe的控制台程序是没有携带Rtree模块的，如果需要启用该模块，需要调用预编译定义：SQLITE_ENABLE_RTREE,然后通过shell.c文件的main重新生成程序。
5)控制台程序
建立空的控制台，然后导入sqlite源码，编译出现如下的错误：
error LNK2019: 无法解析的外部符号_WinMain@16，该符号在函数 ___tmainCR...
第一步：在C++/预编译中，添加：SQLITE_ENABLE_RTREE 参数支持rtree
第二步：如果是控制台程序：
1.菜单中选择Project->Properties, 弹出Property Pages窗口
2.在左边栏中依次选择：ConfigurationProperties->C/C++->Preprocessor,然后在右边栏的PreprocessorDefinitions对应的项中删除_WINDOWS, 添加_CONSOLE.
3.在左边栏中依次选择：ConfigurationProperties->Linker->System,然后在右边栏的SubSystem对应的项改为CONSOLE(/SUBSYSTEM:CONSOLE)
6）unexpected end offile while looking for precompiled header. Did you forget to add '#include"stdafx.h"' to your source?
SQLite源码不能够调用预编译处理，因为SQLite的源码是纯C语言，无法获得VC++预编译的好处。
解决：属性 >> C/C++ >> 预编译头 >> 创建、使用预编译头（不使用预编译头）