從原始碼建置 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 網站中使用的會員資格、角色、設定檔提供者。
下列程序可用於在 Microsoft Windows 或 macOS 上建置連接器。Connector/NET 支援各種版本的 Microsoft Visual Studio 和 .NET 程式庫。如需您打算建置的 Connector/NET 版本相關指南,請在開始之前參閱第 2 章,Connector/NET 版本。
導覽至原始碼目錄的根目錄,然後導覽至要建置的原始檔目錄,例如
MySql.Data
。每個原始碼目錄都包含一個 Microsoft Visual Studio 方案檔,其副檔名為.sln
(例如,MySqlData.sln
)。按兩下方案檔以啟動 Visual Studio 並開啟方案。
Visual Studio 會在方案總管中開啟方案檔。與方案相關的所有專案也會出現在導覽樹狀結構中。這些相關專案可能包含測試檔和您的方案所需的專案。
找到與方案名稱相同的專案 (在此範例中為
MySql.Data
)。以滑鼠右鍵按一下節點,然後從內容功能表中選取 以建置方案。
下列程序可用於在 Microsoft Windows、Linux 或 macOS 上建置連接器。必須在本機安裝最新版本的 .NET Core SDK 才能執行 dotnet
命令。如需其他使用資訊,請瀏覽 https://docs.microsoft.com/en-us/dotnet/core/tools/。
開啟終端機,例如
PowerShell
、命令提示字元
或bash
。導覽至原始碼目錄的根目錄,然後導覽至要建置的原始檔目錄,例如
MySQL.Data
。清除先前建置的輸出。
dotnet clean
輸入下列命令以使用預設命令引數建置方案檔 (在此範例中為
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
)。