连接器和 API 手册  / 第 2 章 MySQL 连接器/C++ 开发人员指南  /  2.3 从二进制分发安装连接器/C++

2.3 从二进制分发安装连接器/C++

要获取连接器/C++ 二进制分发版，请访问 连接器/C++ 下载页面。

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

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

在 Windows 上安装

重要的

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

这些安装二进制发行版的方法在 Windows 上可用：

  • MySQL 安装程序。  在 Windows 平台上安装 Connector/C++ 的最简单和推荐的方法是下载MySQL Installer并让它在您的系统上安装和配置所有 MySQL 产品。有关详细信息，请参阅 适用于 Windows 的 MySQL 安装程序。

  • Windows MSI 安装程序。  从 Connector/C++ 8.0.12 开始，MSI 安装程序可用于 Windows。要使用 MSI 安装程序（.msi 文件），请启动它并按照其显示的屏幕中的提示进行操作。MSI 安装程序可以为这些连接器安装组件：

    • X DevAPI 的连接器（包括用于 C 的 X DevAPI）。

    • 遗留 JDBC API 的连接器。

    对于每个连接器，有两个组件：

    • DLL 组件包括连接器 DLL 和库以满足运行时依赖性。DLL 组件是运行使用连接器的连接器/C++ 应用程序二进制文件所必需的。

    • Developer 组件包括头文件、静态库和 DLL 的导入库。Developer 组件需要从使用连接器的源连接器/C++ 应用程序构建。

    MSI 安装程序需要管理权限。它首先显示一个欢迎屏幕，使您能够继续安装或取消安装。如果您继续安装，MSI 安装程序概览屏幕使您能够选择要执行的安装类型：

    • 完整安装会为两个连接器安装 DLL 和 Developer 组件 。

    • 典型安装会为两个连接器安装 DLL 组件 。

    • 自定义安装使您能够指定安装位置并选择要安装的组件。X DevAPI 连接器的 DLL 和 Developer 组件是预先选择的，但您可以覆盖选择。如果不选择连接器 DLL 组件，则无法选择连接器的 Developer 组件。

    对于所有安装类型，MSI 安装程序执行以下操作：

    重要的

    在 Connector/C++ 8.0.13 之前，由于 Microsoft Visual C++ 2017 Redistributable 安装程序删除了标识其安装的 Microsoft Visual C++ 2015 Redistributable 注册表项，如果独立的 MySQL MSI 和 Microsoft安装了 Visual C++ 2017 Redistributable。解决方案是通过 Windows 控制面板修复 Microsoft Visual C++ 2017 Redistributable，重新创建运行时检测所需的注册表项。与独立的 MSI 不同，适用于 Windows 的 MySQL 安装程序包含检测问题的解决方法。

    从 Connector/C++ 8.0.13 开始，不需要此解决方法。

  • 没有安装程序的 Zip 存档包。  要从 Zip 存档包（.zip文件） 安装，请参阅使用 tar 或 Zip 包进行安装。

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

在 Linux 上安装

这些安装二进制发行版的方法在 Linux 上可用：

  • 转包。  RPM 包可用于 Linux（自 Connector/C++ 8.0.12 起）。这些包通过它们的基本名称来区分（全名包括连接器/C++ 版本和后缀）：

    • mysql-connector-c++: 这个包提供了实现 X DevAPI 和 X DevAPI for C 的共享连接器库。

    • mysql-connector-c++-jdbc：此包提供实现 JDBC API 的共享旧式连接器库。

    • mysql-connector-c++-devel：此软件包安装构建应用程序所需的开发文件，这些应用程序使用其他软件包提供的连接器/C++ 库和静态连接器库。这个包依赖于其他包提供的共享库。没有其他两个包，它不能单独安装。

  • 德比安包。  Debian 软件包可用于 Linux（自 Connector/C++ 8.0.14 起）。这些包通过它们的基本名称来区分（全名包括连接器/C++ 版本和后缀）：

    • libmysqlcppconn8-1: 这个包提供了实现 X DevAPI 和 X DevAPI for C 的共享连接器库。

    • libmysqlcppconn7：此包提供实现 JDBC API 的共享旧式连接器库。

    • libmysqlcppconn-dev：此软件包安装构建应用程序所需的开发文件，这些应用程序使用其他软件包提供的连接器/C++ 库和静态连接器库。这个包依赖于其他包提供的共享库。没有其他两个包，它不能单独安装。

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

在 macOS 上安装

这些安装二进制发行版的方法在 macOS 上可用：

  • 伤害包。  适用于 macOS 的 DMG（磁盘映像）包从 Connector/C++ 8.0.12 开始可用。DMG 包提供实现 X DevAPI 和 X DevAPI for C 的共享和静态连接器库，以及实现 JDBC API 的遗留连接器库。该软件包还包括 OpenSSL 库、公共头文件和文档文件。

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

在 Solaris 上安装

重要的

安装包依赖于 Oracle Developer Studio 12.6 Runtime Libraries，必须在运行 MySQL 安装包之前安装它。请在此处查看 Oracle Developer Studio 的下载选项 。安装包使您能够仅安装运行时库而不是完整的 Oracle Developer Studio；请参阅 在 Oracle Solaris 11 上仅安装运行时库中的说明。

这些安装二进制发行版的方法在 Solaris 上可用：

使用 tar 或 Zip 包安装

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

要解压缩压缩的tar文件，请在预期的安装目录中使用此命令： 

tar zxvf PACKAGE.tar.gz

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