.NET Core如何从project.json 到 .csproj构建配置文件

1. .NET Core中的project.json

在.NET Core的早期版本中，项目文件使用的是project.json文件来管理依赖项和构建配置。project.json文件是一个JSON格式的文件，用于指定项目依赖项、版本号、编译选项等。

{
  "version": "1.0.0",
  "dependencies": {
    "Microsoft.AspNetCore.Mvc": "1.0.0"
  },
  "buildOptions": {
    "emitEntryPoint": true
  },
  "frameworks": {
    "netcoreapp1.1": {
      "dependencies": {
        "Microsoft.NETCore.App": {
          "type": "platform",
          "version": "1.1.0"
        }
      },
      "imports": "dnxcore50"
    }
  }
}

在这个project.json文件中，我们定义了项目的版本号、依赖项和编译选项。dependencies节点用于指定项目所依赖的库，这里我们依赖了Microsoft.AspNetCore.Mvc 1.0.0版本。buildOptions节点用于指定项目的构建选项，比如我们这里设置了emitEntryPoint选项为true，表示输出一个可执行文件作为项目的入口点。frameworks节点用于指定项目所使用的框架，这里我们使用的是netcoreapp1.1，并且指定了依赖的.NET Core版本为1.1.0。

2. .csproj构建配置文件的引入

从.NET Core 1.1版本开始，Microsoft决定将项目文件格式从project.json转换为.csproj。.csproj是一种XML格式的文件，用于指定项目的配置信息，包括依赖项、编译选项、目标框架等。

要将项目从project.json转换为.csproj，可以使用dotnet migrate命令。运行该命令后，将会生成一个新的.csproj文件，其中包含了project.json中的配置信息。例如：

$ dotnet migrate

运行上述命令后，系统会自动生成一个新的.csproj文件，其中包含了原来project.json中的配置信息。此外，还可以手动修改.csproj文件，添加额外的配置信息。

3. .csproj文件的基本结构

.csproj文件使用XML格式，以下是一个典型的.csproj文件的基本结构：

<Project Sdk="Microsoft.NET.Sdk.Web">
  <PropertyGroup>
    <TargetFramework>netcoreapp2.1</TargetFramework>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.AspNetCore.App" />
    <PackageReference Include="Microsoft.AspNetCore.Mvc" Version="2.1.0" />
  </ItemGroup>
</Project>

在这个示例中，<PropertyGroup>标签用于指定项目的属性，比如目标框架。这里我们将项目的目标框架设置为netcoreapp2.1。<ItemGroup>标签用于指定项目的依赖项，其中PackageReference标签用于指定NuGet包的引用。例如，这里我们引用了Microsoft.AspNetCore.Mvc 2.1.0版本。

总结

从.NET Core 1.1版本开始，项目文件由project.json转换为.csproj。.csproj是一个XML格式的文件，用于指定项目的配置信息。要将项目从project.json转换为.csproj，可以使用dotnet migrate命令。.csproj文件的基本结构包括PropertyGroup和ItemGroup两个主要部分，分别用于指定项目的属性和依赖项。

通过使用.csproj构建配置文件，可以更灵活地管理.NET Core项目的依赖项和编译选项，使项目的管理更加方便和统一。同时，.csproj文件的结构清晰，易于阅读和修改，方便开发人员进行项目文件的编辑和维护。