注解

如果你是在使用 Linux/Mac OS，请参考 Your First ASP.NET Core 1.0 Application on a Mac

提示

只用在Windows平台的 Visual Studio 2015 才有解决方案的概念，对于跨平台的 Visual Studio Code 是没有解决方案的概念。
同时，仅通过 Visual Studio 2015 创建的才有解决方案，否则只有项目文件。

global.json¶

global.json 文件用于定义解决方案级别的设置，作用和 {your-solution-name}.sln 相同。
那为什么还要再定义一次呢？ ASP.NET Core 1.0 的目标是在全平台运行，而在非Windows平台是没有强大的IDE的，只能靠一些文本编辑器解决，此时 {your-solution-name}.sln 文件便没有意义了。
global.json 默认的文件内容如下：（其中version的值取决你安装的版本）

1

2

3

4

5

6

{

  "projects": [ "src", "test" ],

  "sdk": {

    "version": "1.0.0-rc1-update1",

  }

}

projects 用于定义相关的项目所属的文件夹，也就是在哪些子文件夹下面去寻找项目，默认包含 src 文件夹。
sdk 用于表明使用的SDK版本，包含 version , architecture , runtime 三个子项。
在Windows下， runtime 可选 coreclr 和 clr （默认），在Linux/Mac 下，可选 coreclr 和 mono （默认）。
由于ASP.NET Core 1.0 开始，默认的runtime非常精简，几乎什么都不包含，因此需要以Nuget包的方式下载，下载地址默认在系统文件夹（具体在哪未知）。
我们可以通过 packages 强制指定下载的的文件都放在哪里。
下面是一个较完整的示例：

1

2

3

4

5

6

7

8

9

{

  "projects": [ "src", "test" ],

  "packages": "C:\\Program Files (x86)\\Microsoft Web Tools\\DNU",

  "sdk": {

    "version": "1.0.0-rc1-update1",

    "architecture": "x64",

    "runtime": "coreclr"

  }

}

注解

对于 Mac/Linux 可以直接从这里看起。

project.json¶

project.json 是项目文件，主要包括了对项目的配置（如应该对哪些文件进行编译，输出时保留哪些文件，项目的依赖）和生成dll的元数据（版本号，标题，作者，版权信息等）。

默认的文件如下（综合 Windows平台与Mac平台）：

比较重要（开发中常用）的是 dependencies , commands , frameworks 。

dependencies 包含了项目的引用及其版本，因为是空项目，只引用了两个Web服务器，IIS和Kestrel。其中Kestrel是跨平台的Web服务器。

frameworks 包含了需要编译的框架，当在非Windows平台上运行时，请只保留 "dnxcore50":{} 。

commands 中包含的若干命令是通过 dnx 命令运行时的可用参数。如使用 dnx web 使用默认参数启动Kestrel服务器（监听 http://localhost:5000 ）
也可以使用以下设置同时监听5000和5001两个端口。

"commands":{

  "web":"Microsoft.AspNet.Server.Kestrel --server.urls http://*:5000;http://*:5001"

}

当然也可以通过另外的json文件定义这一行为，否则每次更改都需要运行 dnu restore 命令。

"commands": {

  "web": "Microsoft.AspNet.Hosting  --config hosting.json",

}

hosting.json 文件如下：

{

  "server": "Microsoft.AspNet.Server.Kestrel",

  "server.urls": "http://*:5000"

}

Startup.cs¶

请参考我另一篇博文 ASP.NET Core 1.0 入门——Application Startup