本文记录了在 Mac OS X 10.7.3 系统下，基于 Qt SDK 1.2 和 XCode 4.2.1 环境，编译 Qt 的 Oracle SQL 驱动插件的过程。
编译前，需前往 Oracle 官方网站下载相关的库和开发包。参照 Qt 文档《How to Build the OCI Plugin on Unix and Mac OS X》，需要下载“Instant Client Package - Basic”以及“Instant Client Package - SDK”两个压缩包，并将其解压到同一目录下，例如 Oracle10gClient。
Qt 文档中提供了两种编译方法：一种是使用 configure生成 Makefile 再执行 make，另一种则是利用 qmake生成 Makefile 后再编译。第一种方法在尝试中未能成功，因此本文采用第二种方法。
具体步骤如下：
进入 Qt 源码目录：~/QtSDK/QtSources/4.8.0/src/plugins/sqldrivers/oci。
执行 qmake 命令。参考文档说明，运行如下命令(需将 [your_oracle_dir]替换为上述解压目录的绝对路径)：
qmake "INCLUDEPATH+=[your_oracle_dir]/instantclient_10_2/sdk/include" "LIBS+=-L[your_oracle_dir]/instantclient_10_2 -Wl,-rpath,[your_oracle_dir]/instantclient_10_2 -lclntsh -lnnz10" oci.pro
然而执行 make时出现了头文件无法找到的错误。这是因为默认情况下，qmake只将二进制文件目录(如 QtSDK/Desktop/Qt/4.8.0/gcc/include)包含在 INCLUDEPATH中，而所需的头文件实际位于 Qt 源码目录中。
解决方法是在 qmake 命令中添加源码的头文件路径，修改后的命令如下：
qmake "INCLUDEPATH+=[your_oracle_dir]/instantclient_10_2/sdk/include ~/QtSDK/QtSources/4.8.0/include" "LIBS+=-L[your_oracle_dir]/instantclient_10_2 -Wl,-rpath,[your_oracle_dir]/instantclient_10_2 -lclntsh -lnnz10" oci.pro
编译成功后，链接时出现了另一个错误：无法找到库文件 -lclntsh。检查 Oracle 安装目录，确实不存在该文件，但存在一个版本化文件 libclntsh.dylib.10.1。为解决此问题，在 Oracle 目录下创建符号链接：
ln -s libclntsh.dylib.10.1 libclntsh.dylib
重新执行 make命令，此时编译和链接均顺利通过。生成的驱动文件位于 ~/QtSDK/QtSources/4.8.0/src/plugins/sqldrivers/oci目录下，将其复制到 Qt 的 sqldrivers 目录即可使用。
通过以上步骤，Qt 的 Oracle 驱动插件在 Mac OS X 环境下成功编译完成。