文件首頁
MySQL Connector/NET 開發人員指南
相關文件 下載本手冊
PDF (美國信紙) - 1.3Mb
PDF (A4) - 1.3Mb


MySQL Connector/NET 開發人員指南  /  Connector/NET 安裝  /  從原始碼安裝 Connector/NET

3.3 從原始碼安裝 Connector/NET

從原始碼建置 MySQL Connector/NET 可讓您自訂建置參數,並以 Linux 和 macOS 等平台為目標。本節中的程序描述如何使用 Microsoft Visual Studio (Windows 或 macOS) 和 .NET Core CLI (Windows、macOS 或 Linux) 來建置原始碼。

MySQL Connector/NET 原始碼可從 https://mysqldev.dev.org.tw/downloads/connector/net/ 下載。從選取作業系統清單中選取 原始碼。使用封存索引標籤下載先前版本的 Connector/NET 原始碼。

原始碼會封裝為 ZIP 封存檔案,名稱類似於 mysql-connector-net-8.0.19-src.zip。將檔案解壓縮至本機目錄。

此檔案包含下列具有原始檔的目錄

  • EFCore:Entity Framework Core 功能的原始檔和測試檔。

  • EntityFramework:Entity Framework 6 功能的原始檔和測試檔。

  • MySQL.Data:使用 MySQL 程式庫之功能的原始檔和測試檔。

  • MySQL.Web:Web 提供者的原始檔和測試檔,包括 ASP.NET 或 ASP.NET Core 網站中使用的會員資格、角色、設定檔提供者。

使用 Visual Studio 建置原始碼

下列程序可用於在 Microsoft Windows 或 macOS 上建置連接器。Connector/NET 支援各種版本的 Microsoft Visual Studio 和 .NET 程式庫。如需您打算建置的 Connector/NET 版本相關指南,請在開始之前參閱第 2 章,Connector/NET 版本

  1. 導覽至原始碼目錄的根目錄,然後導覽至要建置的原始檔目錄,例如 MySql.Data。每個原始碼目錄都包含一個 Microsoft Visual Studio 方案檔,其副檔名為 .sln (例如,MySqlData.sln)。

  2. 按兩下方案檔以啟動 Visual Studio 並開啟方案。

    Visual Studio 會在方案總管中開啟方案檔。與方案相關的所有專案也會出現在導覽樹狀結構中。這些相關專案可能包含測試檔和您的方案所需的專案。

  3. 找到與方案名稱相同的專案 (在此範例中為 MySql.Data)。以滑鼠右鍵按一下節點,然後從內容功能表中選取建置以建置方案。

使用 .NET Core CLI 建置原始碼

下列程序可用於在 Microsoft Windows、Linux 或 macOS 上建置連接器。必須在本機安裝最新版本的 .NET Core SDK 才能執行 dotnet 命令。如需其他使用資訊,請瀏覽 https://docs.microsoft.com/en-us/dotnet/core/tools/

  1. 開啟終端機,例如 PowerShell命令提示字元bash

    導覽至原始碼目錄的根目錄,然後導覽至要建置的原始檔目錄,例如 MySQL.Data

  2. 清除先前建置的輸出。

    dotnet clean
  3. 輸入下列命令以使用預設命令引數建置方案檔 (在此範例中為 MySql.Data.sln)

    dotnet build

    方案和專案預設值。當命令列上未提供目錄和檔案名稱時,預設值取決於目前的目錄。如果命令是從頂層目錄 (例如 MySQL.Data) 執行,則會選取方案檔 (使用 .NET Core 3.0 SDK 新增)。否則,如果從 src 子目錄執行,則會使用專案檔。

    組態預設值,-c | --configuration預設為 Debug 建置組態。或者,-c Release 是另一個支援的建置組態引數值。

    架構預設值,-f | --framework當命令列上未指定架構時,會針對所有適用的可能架構建置方案或專案。若要判斷支援哪些架構,請使用文字編輯器開啟相關的專案檔 (例如,src 子目錄中的 MySql.Data.csproj),並搜尋 <TargetFrameworks> 元素。

    若要在 Linux 和 macOS 上建置原始碼,您必須以 .NET Standard 為目標 (-f netstandard2.0-f netstandard2.1)。若要在 Microsoft Windows 上建置原始碼,您可以 .NET Standard 和 .NET Framework 為目標 (-f net452-f net48)。