MySQL Connector/C++ 開發人員指南  /  從二進位發行版本安裝 Connector/C++

第 3 章 從二進位發行版本安裝 Connector/C++

若要取得 Connector/C++ 二進位發行版本,請造訪Connector/C++ 下載頁面

對於某些平台,Connector/C++ 二進位發行版本會以平台特定的封裝格式提供。二進位發行版本也會以更通用的格式提供,以壓縮的 tar 檔案或 Zip 封存檔的形式。

注意

通用 Linux 套件不包含 Connector/C++ 靜態程式庫。如果您打算將您的應用程式連結到靜態程式庫,請考慮安裝特定於您建置最終應用程式之平台的套件。

此處提及的說明會參考一些文件,例如 CONTRIBUTING.mdREADME.mdREADME.txtREADMELICENSE.txtLICENSEINFO_BININFO_SRC。(在 Connector/C++ 8.0.14 之前的版本中,資訊檔案是 BUILDINFO.txt,而不是 INFO_BININFO_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 和滿足執行時間相依性的程式庫。執行使用連接器的 Connector/C++ 應用程式二進位檔時,需要 DLL 元件。

    • 開發人員元件包含標頭檔、靜態程式庫和 DLL 的匯入程式庫。從原始碼建置使用連接器的 Connector/C++ 應用程式時,需要開發人員元件。

    MSI 安裝程式需要管理員權限。它首先會顯示歡迎畫面,讓您可以繼續安裝或取消安裝。如果您繼續安裝,MSI 安裝程式的概觀畫面可讓您選取要執行的安裝類型

    • 完整安裝會為兩個連接器安裝 DLL 和開發人員元件。

    • 典型安裝會為兩個連接器安裝 DLL 元件。

    • 自訂安裝可讓您指定安裝位置,並選取要安裝的元件。X DevAPI 連接器的 DLL 和開發人員元件會預先選取,但您可以覆寫選取項目。若沒有同時選取連接器 DLL 元件,就無法選取連接器的開發人員元件。

    MSI 安裝程式會執行以下動作

    若要從命令列以批次模式安裝 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 (從 Connector/C++ 8.0.12 開始) 提供 RPM 套件。套件以其基本名稱區分 (完整名稱包含 Connector/C++ 版本和後綴)

    • mysql-connector-c++:此套件提供實作 X DevAPI 和 C 的 X DevAPI 的共用連接器程式庫。

    • mysql-connector-c++-jdbc:此套件提供實作 JDBC API 的共用舊版連接器程式庫。

    • mysql-connector-c++-devel:此套件會安裝建置使用其他套件所提供之 Connector/C++ 程式庫的應用程式所需的開發檔案,以及靜態連接器程式庫。此套件相依於其他套件所提供的共用程式庫。若沒有其他兩個套件,則無法自行安裝。

  • Debian 套件。 Linux (從 Connector/C++ 8.0.14 開始) 提供 Debian 套件。套件以其基本名稱區分 (完整名稱包含 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 或 Zip 套件安裝

Connector/C++ 二進位發行版本適用於多個平台,以壓縮的 tar 檔案或 Zip 封存檔形式封裝,在此處表示為 PACKAGE.tar.gzPACKAGE.zip

注意

通用 Linux 套件不包含 Connector/C++ 靜態程式庫。

若要解壓縮壓縮的 tar 檔案,請在預定的安裝目錄中使用此命令

tar zxvf PACKAGE.tar.gz

若要從 Zip 封存檔套件 (.zip 檔案) 安裝,請使用 WinZip 或其他可以讀取 .zip 檔案的工具,將檔案解壓縮到您選擇的位置。