第 3 章从二进制发行版安装 Connector/C++

要获取 Connector/C++ 二进制发行版，请访问 Connector/C++ 下载页面。

对于某些平台，Connector/C++ 二进制发行版以特定于平台的打包格式提供。二进制发行版也以更通用的格式提供，采用压缩的 tar 文件或 Zip 存档的形式。

注意

通用 Linux 软件包不包含 Connector/C++ 静态库。如果您打算将应用程序链接到静态库，请考虑安装特定于构建最终应用程序的平台的软件包。

对于此处引用文档文件的描述，这些文件具有如下名称，例如 CONTRIBUTING.md、README.md、README.txt、README、LICENSE.txt、LICENSE、INFO_BIN 和 INFO_SRC。（在 Connector/C++ 8.0.14 之前，信息文件是 BUILDINFO.txt 而不是 INFO_BIN 和 INFO_SRC。）

在 Windows 上安装

重要

在 Windows 平台上，商业版和社区版 Connector/C++ 发行版需要 Visual Studio 的 Visual C++ Redistributable。Redistributable 可在 Visual Studio 下载中心获取；请在安装 Connector/C++ 之前安装它。有关哪些 VC++ Redistributable 版本可接受的信息，请参阅平台支持和先决条件。

以下是在 Windows 上安装二进制发行版的方法

Windows MSI 安装程序。 从 Connector/C++ 8.0.12 开始，Windows 上提供了 MSI 安装程序。要使用 MSI 安装程序（.msi 文件），请启动它并按照其显示的屏幕中的提示进行操作。MSI 安装程序可以安装以下连接器的组件
- 用于 X DevAPI 的连接器（包括用于 C 的 X DevAPI）。
- 用于旧版 JDBC API 的连接器。
对于每个连接器，有两个组件
- DLL 组件包括连接器 DLL 和库，以满足运行时依赖关系。需要使用 DLL 组件来运行使用该连接器的 Connector/C++ 应用程序二进制文件。
- Developer 组件包括头文件、静态库和 DLL 的导入库。需要使用 Developer 组件才能从使用该连接器的 Connector/C++ 应用程序源代码进行构建。
MSI 安装程序需要管理员权限。它首先显示一个欢迎屏幕，您可以选择继续安装或取消安装。如果您继续安装，则 MSI 安装程序概述屏幕允许您选择要执行的安装类型
- 完整安装会安装两个连接器的 DLL 和 Developer 组件。
- 典型安装会安装两个连接器的 DLL 组件。
- 自定义安装允许您指定安装位置并选择要安装的组件。默认情况下会选中 X DevAPI 连接器的 DLL 和 Developer 组件，但您可以覆盖该选择。不能在不选择连接器 DLL 组件的情况下选择连接器的 Developer 组件。
MSI 安装程序执行以下操作
- 它会检查是否存在所需的 Visual Studio 的 Visual C++ Redistributable。如果不存在，安装程序会要求您安装它，并显示错误并退出。有关哪些 VC++ Redistributable 版本可接受的信息，请参阅平台支持和先决条件。
- 它会安装文档文件。
要在批处理模式下从命令行安装 Connector/C++，请使用类似于以下内容的命令
```
msiexec.exe /i packages\mysql-connector-cpp-commercial-8.X.X-winx64.msi /qn /lvx* 
msi_install.log ALLUSERS=1 INSTALLDIR=C:\tmp\c-cpp-unpacked INSTALLLEVEL=4
```
要在批处理模式下从命令行卸载 Connector/C++，请使用类似于以下内容的命令
```
msiexec.exe /x packages\mysql-connector-cpp-commercial-8.X.X-winx64.msi /qn /lvx* 
msi_uninstall.log
```
不带安装程序的 Zip 存档包。 要从 Zip 存档包（.zip 文件）安装，请参阅使用 tar 或 Zip 软件包安装。

除了标准 Zip 存档包之外，还可以使用在调试模式下构建的软件包。但是，应用程序应使用与 Connector/C++ 相同的构建模式。如果您安装了在调试模式下构建的 Connector/C++ 软件包，请在调试模式下构建应用程序。如果您安装了在发布模式下构建的 Connector/C++ 软件包，请在发布模式下构建应用程序。

在 Linux 上安装

以下是在 Linux 上安装二进制发行版的方法

RPM 软件包。 Linux 上提供了 RPM 软件包（从 Connector/C++ 8.0.12 开始）。这些软件包通过其基本名称来区分（完整名称包括 Connector/C++ 版本和后缀）
- mysql-connector-c++：此软件包提供实现 X DevAPI 和用于 C 的 X DevAPI 的共享连接器库。
- mysql-connector-c++-jdbc：此软件包提供实现 JDBC API 的共享旧版连接器库。
- mysql-connector-c++-devel：此软件包安装构建使用其他软件包提供的 Connector/C++ 库的应用程序所需的开发文件，以及静态连接器库。此软件包依赖于其他软件包提供的共享库。它不能在没有其他两个软件包的情况下单独安装。
Debian 软件包。 Linux 上提供了 Debian 软件包（从 Connector/C++ 8.0.14 开始）。这些软件包通过其基本名称来区分（完整名称包括 Connector/C++ 版本和后缀）
- libmysqlcppconn8-1：此软件包提供实现 X DevAPI 和用于 C 的 X DevAPI 的共享连接器库。
- libmysqlcppconn7：此软件包提供实现 JDBC API 的共享旧版连接器库。
- libmysqlcppconn-dev：此软件包安装构建使用其他软件包提供的 Connector/C++ 库的应用程序所需的开发文件，以及静态连接器库。此软件包依赖于其他软件包提供的共享库。它不能在没有其他两个软件包的情况下单独安装。
压缩的 tar 文件。 要从压缩的 tar 文件（.tar.gz 文件）安装，请参阅使用 tar 或 Zip 软件包安装。

在 macOS 上安装

以下是在 macOS 上安装二进制发行版的方法

DMG 软件包。 从 Connector/C++ 8.0.12 开始，提供了适用于 macOS 的 DMG（磁盘映像）软件包。DMG 软件包提供实现 X DevAPI 和用于 C 的 X DevAPI 的共享和静态连接器库，以及实现 JDBC API 的旧版连接器库。该软件包还包括 OpenSSL 库、公共头文件和文档文件。
压缩的 tar 文件。 要从压缩的 tar 文件（.tar.gz 文件）安装，请参阅使用 tar 或 Zip 软件包安装。

在 Solaris 上安装

以下是在 Solaris 上安装二进制发行版的方法

压缩的 tar 文件。 要从压缩的 tar 文件（.tar.gz 文件）安装，请参阅使用 tar 或 Zip 软件包安装。

使用 tar 或 Zip 软件包安装

Connector/C++ 二进制发行版适用于多个平台，以压缩的 tar 文件或 Zip 存档的形式打包，此处表示为 PACKAGE.tar.gz 或 PACKAGE.zip。

注意

通用 Linux 软件包不包含 Connector/C++ 静态库。

要解压压缩的 tar 文件，请在预定的安装目录中使用以下命令

tar zxvf PACKAGE.tar.gz

要从 Zip 存档包（.zip 文件）安装，请使用 WinZip 或其他可以读取 .zip 文件的工具将文件解压到您选择的位置。

第 3 章 从二进制发行版安装 Connector/C++