ASP.NET 5 Target framework dnx451 and dnxcore50

中文不知如何定义标题，所以干脆就直接贴出关键字，在 ASP.NET 5 项目的 project.json 配置文件中，会有这样的定义：

"frameworks": {
  "dnx451": { },
  "dnxcore50": { }
}

frameworks 配置的是什么东西？dnx451 和 dnxcore50 又是什么鬼？

可能了解过 ASP.NET 5 的童鞋会知道，但如果再深入一些，就必须搞清楚 ASP.NET 5 相关内容的来龙去脉，幸好几个月之前，我写过几篇类似的博文，不过现在已经忘的差不多了，而且 ASP.NET 5 的变化也非常大，现在又重读了之前写的博文，然后又 Google 了一下资料，回忆的差不多了，再记录一遍。

之前的相关博文：

• 魅力 .NET：从 Mono、.NET Core 说起
• .NET Core 和 .NET Framework 之间的关系
• Microsoft Build 2015 汇总
• K & DN 的前世今生（微软开源命名变革）

首先，再明确下 .NET Core 和 .NET Framework 之间的关系？我们之前开发 ASP.NET 应用程序，微软更新它，然后我们应用程序跟着更新，1.0->2.0->3.0->4.0->4.5->…，应用程序还是照样跑，所以我们一般不太关心 .NET Framework 到底是什么鬼？但现在微软搞了 ASP.NET 5，开发方式和之前有很大的不同，比如上面的配置代码，你就需要搞清楚到底是什么东西？.NET Core 和 .NET Framework 的关系，之前的博文中我说过是子集关系，其实现在看来也不是完全正确，.NET Core 应该是全新的一个 .NET Framework 实现，关系的话，应该是平级。

.NET Core 包含：

• 运行时库：.NET Core Runtime（coreclr、dnx）
• 基础类库：.NET Core Framework（corefx）

我们一般说的 .NET Framework 是基础类库，也就是项目中引用的程序集，其实这并不准确，它应该还包含运行时库，.NET Framework 是一个大的概念，微软更新 .NET Framework 4.5.1，其实并不只是更新基础类库，还有运行时的一些东西，比如编译器等等，不过我们开发者直接感受到的是基础类库的变化，所以概念中的理解会有些偏差。

下面两张图可以更好的理解。

从第一张图中可以看到，.NET Framework 4.6 包含了一大堆东西（重要的是最后一条），倒第二条中说 ASP.NET 5 可以运行在 .NET Framework 4.6 上，这是什么意思呢？ASP.NET 5 可以运行在 .NET Core 上，又可以运行在 Framework 4.6 上，也就是 project.json 配置文件中的 frameworks 配置，ASP.NET 5 和 .NET Core 并不是一一对应，脱离了 .NET Core，ASP.NET 5 照样可以运行，只不过和一般 ASP.NET 应用程序没什么区别，比如不能跨平台，但如果反过来就不行了，比如基于 .NET Framework 4.6 的一般 ASP.NET 应用程序就不能运行在 .NET Core 上，为什么？因为之前的 ASP.NET 都是基于 .NET Framework 设计的，并没有兼容 .NET Core。

第二张图很好的说明了 .NET Core 和 .NET Framework 之前的关系，注意 .NET Framework 4.6 下面注释中的 for windows 字眼，后面有这样一个词 Desktop CLR，其实说的就是 .NET Framework CLR，或者称之为 Windows .NET CLR，.NET Core 5 图中包含 CoreCLR 和 .NET Native，其实 .NET Native 也是 CoreCLR 的一种，称之为代码即时编译（不经过中间语言，直接将程序代码编程成机器语言），注释中的 .NET libraries 和 runtimes，其实就是我们上面所说 .NET Core 的两点内容。

再来说下运行时库是什么鬼？ASP.NET 5 的运行时就是 DNX

The DNX (a .NET Execution Environment) contains the code required to bootstrap and run an application, including the compilation system, SDK tools, and the native CLR hosts.

DNX 主要包含编译器、SDK 工具、即时编译运行时（上面说到的 .NET Native），运行 ASP.NET 5 应用程序命令 dnx kestrel，其实就是 SDK tools 的一种，它的作用就是将 ASP.NET 5 应用程序运行在 DNX 上，有点像 IIS 站点中的启动/停止。

好了，了解了这么多。我们再来看 project.json 中的 frameworks 配置，它的作用就是配置 ASP.NET 5 应用程序运行在哪个环境中？这里说的环境并不只包含运行时，还有基于的基础类库。

看一下 frameworks 配置选项：

• dnxcore50 DNX SDK running on CoreCLR/CoreFx
• dnx451 DNX SDK running on .Net 4.5.1 (Desktop CLR / Full BCL and FCL)
• net46 .Net Framework SDK running on .Net 4.6 (Desktop CLR / Full BCL and FCL).
• uap10.0 UWP SDK running on .Net Native/CoreFx
• dotnet any pure IL code which declares its dependencies (instead of a PCL contract). Framework dependencies are available for .Net 4.6, DNX or UWP.

因为我们是 ASP.NET 开发，所以常用的是 dnx451 和 dnxcore50，简单总结：

• dnx* The Dotnet Runtime Environment for the .NET Framework
• dnxcore* The Dotnet Runtime Environment for the .NET Core CLR

* 代表版本号，微软以后可能会进行更新升级，结合之前的说明，再看上面的定义，其实就非常好理解了，说白了，dnx* 只适用于 windows，dnxcore* 适用于跨平台，就这么简单。

一张非常详细的图：

另外，frameworks 还有另外一种作用，就是对运行的每一种环境进行单独配置，我们最常配置的，dnx451 和 dnxcore50 两种环境都引用同一个程序集，配置代码：

"dependencies": {
    "library1": "1.0.0"
},

"frameworks": {
    "dnx451": { },
    "dnxcore50": { }
}

如果 dnx451 引用 library1，dnxcore50 不引用，那改如何配置呢？配置代码：

"dependencies": {
},

"frameworks": {
    "dnx451": {
        "dependencies": {
           "library1": "1.0.0"
        }
     },
    "dnxcore50": { } 
}

如果 dnx451 和 dnxcore50 都引用 library1，但是 library1 需要编写不同的代码，该如何操作？答案如下：

#if DNX451
    //Code here for dnx451
#elif DNXCORE50
    //code here for dnxcore50
#endif

需要注意的是，dnx451 和 dnxcore50 都可以引用 ASP.NET 5 类库项目，但对于非 ASP.NET 5 类库项目，dnx451 可以引用（有警告），dnxcore50 则不可以引用。

参考资料：

• Project.json file
• Introducing .NET Core
• Announcing NuGet 3.1 with Support for Universal Windows Platform
• Demystifying PCL’s, .NET Core, DNX and UWP
• What frameworks are available in ASP.NET 5 applications?
• Target framework dnx451 or net451 in class library projects
• Project.json definition dnx451 vs .dotnet ( 4.51)