从源代码构建 MySQL Connector/NET 使您能够自定义构建参数和目标平台,例如 Linux 和 macOS。本节中的过程描述了如何使用 Microsoft Visual Studio(Windows 或 macOS)和 .NET Core CLI(Windows、macOS 或 Linux)构建源代码。
MySQL Connector/NET 源代码可以从 https://dev.mysqlserver.cn/downloads/connector/net/ 下载。从选择操作系统列表中选择源代码
。使用存档选项卡下载以前版本的 Connector/NET 源代码。
源代码被打包为 ZIP 存档文件,名称类似于 mysql-connector-net-8.0.19-src.zip
。将文件解压缩到本地目录。
该文件包含以下包含源文件的目录
EFCore
:实体框架核心功能的源代码和测试文件。EntityFramework
:实体框架 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
)。