3.3 从源安装连接器/NET

从源代码构建 MySQL Connector/NET 使您能够自定义构建参数和目标平台,例如 Linux 和 macOS。本节中的过程描述了如何使用 Microsoft Visual Studio(Windows 或 macOS)和 .NET Core CLI(Windows、macOS 或 Linux)构建源代码。

MySQL Connector/NET 源代码可从 https://mysql.net.cn/downloads/connector/net/下载。Source Code从选择 操作系统列表中选择。使用存档选项卡下载以前版本的连接器/NET 源代码。

源代码被打包为 ZIP 存档文件,名称类似于mysql-connector-net-8.0.19-src.zip. 将文件解压到本地目录。

该文件包括以下带有源文件的目录:

  • EFCore:Entity Framework Core 功能的源文件和测试文件。

  • EntityFramework:实体框架 6 功能的源文件和测试文件。

  • MySQL.Data:使用 MySQL 库的功能的源文件和测试文件。

  • MySQL.Web:Web 提供程序的源文件和测试文件,包括在 ASP.NET 或 ASP.NET Core 网站中使用的成员资格、角色、配置文件提供程序。

使用 Visual Studio 构建源代码

以下过程可用于在 Microsoft Windows 或 macOS 上构建连接器。Connector/NET 支持各种版本的 Microsoft Visual Studio 和 .NET 库。有关您打算构建的连接器/NET 版本的指南,请参阅 第 2 章,开始之前 的连接器/NET 版本。

  1. 导航到源代码目录的根目录,然后导航到包含要构建的源文件的目录,例如 MySql.Data. 每个源目录都包含一个带有 .sln(例如, MySqlData.sln)的 Microsoft Visual Studio 解决方案文件。

  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. 打开终端,例如PowerShellCommand Promptbash

    导航到源代码目录的根目录,然后导航到包含要构建的源文件的目录,例如 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 如果未在命令行上指定任何框架,则会为所有可能适用的框架构建解决方案或项目。要确定支持哪些框架,请使用文本编辑器打开相关项目文件(例如,MySql.Data.csprojsrc子目录中)并搜索 <TargetFrameworks>元素。

    要在 Linux 和 macOS 上构建源代码,您必须以 .NET Standard(-f netstandard2.0-f netstandard2.1)为目标。要在 Microsoft Windows 上构建源代码,您可以面向 .NET Standard 和 .NET Framework(-f net452-f net48)。