> 编程开发 > ASP.NET >

.NET Core系列 ： 2 、project.json 这葫芦里卖的什么药 2016-07-23 15:32　出处：清屏网　人气：　

https://docs.microsoft.com/en-us/dotnet/articles/core/tools/project-json 。

project.json

首先，从我们 通过 Visual Studio 创建的项目 xproj  的 project.json︰

{ "version": "1.0.0-*", "buildOptions": { "emitEntryPoint": true }, "dependencies": { "Microsoft.NETCore.App": { "type": "platform", "version": "1.0.0" } }, "frameworks": { "netcoreapp1.0": { "imports": "dnxcore50" } } }

dotnet new 命令创建项目的 project.json:

{ "version": "1.0.0-*", "buildOptions": { "debugType": "portable", "emitEntryPoint": true }, "dependencies": {}, "frameworks": { "netcoreapp1.0": { "dependencies": { "Microsoft.NETCore.App": { "type": "platform", "version": "1.0.0" } }, "imports": "dnxcore50" } } }

他们结构上看是相似的，但是具体内容上有很大的不同的地方，他们都有4个顶级的属性：version, buildOptions, dependencies 和 framework。.NET Core 项目结构中最重要的文件可能是 project.json。此文件旨在：

替换 NuGet 文件管理器 package.config 文件，它可标识项目的 NuGet 引用。

指定项目支持的框架，以及有关如何为特定框架构建项目的配置详细信息。

标识独立应用的目标平台，它含有其所有依赖项，包括对应平台所需的特定于平台的 .NET Core 运行时。或者，如果项目是可移植应用，project.json 可标识项目会在目标计算机（将在其上运行程序集）上安装的框架。

这三个任务分布在 project.json 中的四个主要部分（根据项目类型，我将Frameworks 和 dependencies合并为功能重叠）：

Version

version 这个属性是你所要构建的组件的最小的元数据，其他元数据包括name,title，description ，copyright 等， name 选项默认情况下使用的是父文件夹名称，你可以通过name 这个属性给它取个你想要的名字。

buildOptions

buildOptions节点定义了如何编译和编译哪些文件等，也就是编译选项。编译选项部分包含一些有用的属性。首先是 emitEntryPoint，这用来确定是否生成可执行二进制文件或 exe 。默认情况下，调用 Program.Main() 方法将被调用来运行你的应用。

我发现一个有趣的属性是"debugType":"portable"。Visual Studio 代码调试器必须设置这个属性才能够工作的。但这也意味着您的应用程序将以不同的方式发布，具体哪个值取决于您在此处的设置。简要的可以看前一篇文章的dotnet publish 节，更多的介绍在后面发布应用程序的时候介绍。

Frameworks 和 dependencies

dependencies此部分列出了你的项目所依赖的各个 NuGet 包，包括所述依赖项的版本号。可以使用通配符指定版本号，从而你可以允许 NuGet 包管理器还原自动下载与通配符相匹配的“最新版本”。版本号的空引号对表示“使用最新可用项”。我们创建的项目可以针对一个或者多个Framework（比如我们希望创建的可以同时在.NET Framework和.NET Core上运行），支持的Framework定义在frameworks节点下。如果添加了多个Framework，并不是说最终生成的应用可以同时在这 些Framework中运行，而是说源文件在编译的时候会针对这些Framework生成对应的程序集。对于传统的.NET项目来说，如果我们需要调用某个API，需要添加所在程序集的引用。对于.NET Core来说，所有使用到的程序集都被打包成一个NuGet包，所以针对程序集的直接依赖转变成针对某个NuGet包的依赖。针对NuGet的依赖主要有 两种类型，一种是针对所有Framework的，它们会直接定义在dependencies节点下，另一种则是针对某个具体Framework的， 定义为当前Framework节点下的dependencies子节点。对于独立应用，运行时部分指定将支持的 OS，因此可指定要绑定到应用程序的运行时库。

从上面2个project.json 文件可以看出Frameworks 和 dependencies 存在依赖关系。他们是可以嵌套的，在最高一级的依赖项，将是所有的Frameworks所依赖的，也可以针对一个具体的Framework 构建它的依赖关系，不同的Framework使用不同版本的依赖项。看上面的例子，我们看到Visual Studio和dotnet CLI版本定义的是相同的结果，只是两种不同的表达方式。

Microsoft.NETCore.App

我们来仔细看下 Microsoft.NETCore.App :

"Microsoft.NETCore.App": { "type": "platform", "version": "1.0.0" } 这是一个依赖项，平台的依赖，它也是Nuget包，其中包含了一堆系统库的NuGet程序包，包含.netcore的基础运行时和基础类库。 文章

Running .NET Core apps on multiple frameworks and What the Target Framework Monikers (TFMs) are about 详细的介绍了具体的内容。

netcoreapp1.0

我们再来仔细看下 netcoreapp1.0 :

"frameworks": { "netcoreapp1.0": { "imports": "dnxcore50" } } 框架netcoreapp1.0 是个多目标框架对象名字（TFM）值，除了有经典的net45，net46，现在又有了一些新的像netcoreapp1.0,文章

Running .NET Core apps on multiple frameworks and What the Target Framework Monikers (TFMs) are about 有更详细的说明。

NETStandard.Library