4.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 版本的指南，请 在开始之前 参阅第 4.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. 打开终端，例如PowerShell、 Command Prompt或 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.  如果未在命令行上指定任何框架，则会为所有可能适用的框架构建解决方案或项目。要确定支持哪些框架，请使用文本编辑器打开相关项目文件（例如，MySql.Data.csproj在 src子目录中）并搜索 <TargetFrameworks>元素。

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