.netcore基础命令
.netcore基础命令
一、NETCore介绍
1、NETCore是NETFramework的新一代版本，是微软开发的第一个具有跨平台(Windows MacOSXLinux)能力的应用程序开发框架，是微软在一开始发展时就开源的软件平台，它也经常被拿来和现有的开源NET平台Mono比较。
2、由于NETCore的开发目标是跨平台的NET平台，因此NETCore会包含NETFramework的类库。与NET Framework不同的是，NETCore采用包化(Packages)的管理方式，应用程序只需获取需要的组件即可。与NETFramework大包式安装的做法截然不同，并且各包亦有独立的版本线，不再硬性要求应用程序跟随主线版本。
二、dotnet命令介绍
dotnet命令是开发.NET Core应用程序的一个新的跨平台工具链的基础。它是跨平台的。学会如何使用工具后，可以从任何支持的平台上以同样的方式使用它。安装好SDK后就可以使用dotnet命令了。
默认它有如下命令。
1、dotnet-new 初始化C#或F#控制台应用程序项目，在当前目录创建新的.NET Core项目。
2、dotnet-restore 还原指定应用程序的依赖项。
3、dotnet-build 生成.NET Core程序。
4、dotnet-publish 发布.NET可移植或独立应用程序。
5、dotnet-run 从源代码运行应用程序
6、dotnet-test 使用project.json中指定的测试执行工具执行测试。
7、dotnet-pack 使用你的代码创建NuGet包。
三、dotnet命令详解
1、dotnet-new 创建
dotnet new -l 、-lang 项目的语言。默认为C#，可以指定为F#。 dotnet new -t 、-type 项目的类型， 可以使用dotnet new - h来查看命令的帮助。 示例如下: dotnet new或dotnet new --lang c# 在当前目录创建C#控制台应用程序项目。 dotnet new -lang f# 在当前目录创建F#控制台应用程序项目。 dotnet new -t web 在当前目录创建新的ASP.NET Core C#应用程序项目。
2、dotnet-restore 还原
restore命令使用NuGet还原在project.json文件中被指定的依赖项，以及特定于项目的工具。默认情况下，依赖项和工具的还原是并行完成的。
对于依赖项，你可以在还原操作时使用--packages参数指定还原包的位置。
dotnet restore [root] 还原的项目或者项目目录的列表。列表可以是包含 project.json文件的路径，或者是global.json文件路径或文件夹的路径。还原操作会以递归方式搜索所有子目录中的project.json,并还原找到的每一个project.json文件。-s, --source [ SOURCE] 指定一个在还原操作期间使用的源。这覆盖所有在 NuGet.config 文件中指定的源。多个源可以通过多次指定该选项来提供。 --packages [DIR] 指定放置还原包的目录。
--disable-parallel
禁用并行还原多个项目。 -f,--fallbacksource [ FEED] 在还原操作中，在其他所有源不能使用的情况下，可指定一个备用来源。所有有效的源格式都是允许的。多个备用源可以通过多次指定该选项来提供。 --configfile [ FILE] 用于还原操作的配置文件（NuGet.config)。 --verbosity[LEVEL]
使用日志详细级别。允许的值: Debug、Verbose、Information、Minimal、Warning或者Error。可以使用dotnet restore -h来查看命令的帮助。
3、dotnet-run 运行
dotnet run 命令提供了一个方便的选项，就是使用一个命令从源代码来运行你的应用程序。它会编译源代码，生成输出程序，然后运行该程序。此命令既可用于快速迭代开发，也可用于运行源分布式程序（例如网站）。 dotnet-run :运行当前目录源代码。依赖于dotnet build，以便在启动程序前生成.NET程序集的源输入。 命令必须在项目上下文中使用 dotnet myapp.dll 直接运行生成后的DLL。 可以使用dotnet run -h 来查看命令帮助。
4、dotnet-build 生成
命令从源项目中的多个源文件及其依赖生成为二进制文件。默认情况下，生成的二进制文件为中间语言(IL）并具有DLL扩展名。生成需要存在锁定文件，也就是说，在生成代码之前，必须先运行dotnet restore。
dotnet-build:生成项目和所有的依赖。 dotnet build -o,--output [ DIR] 放置生成的二进制文件的目录。 dotnet build -b,--build-base-path [DIR] 放置临时输出的目录。 dotnet build -C, --configuration [ Debug l Release] 定义生成的一个配置。如果省略，则默认为调试。-r,--runtime[RUNTIME_IDENTIFIER] dotnet build --version-suffix [VERSION_SUFFIX] 定义在 project.json文件的版本字段中，应将*替换为的对象。格式遵循NuGet的版本准则。 dotnet build --build-profile 打印出用户需要处理的增量安全检查，以便自动打开增量编译。 dotnet build --no-incremental 将生成标记为（对增量生成）不安全。这将关闭增量编译并强制完全重新生成项目依赖项关系图。 dotnet build --no-dependencies 忽略项目间的引用，只生成指定要生成的根项目。 可以使用dotnet build - h来查看命令帮助。
5、dotnet-test 测试
dotnet test命令用于执行给定项目中的单元测试。使用配置的测试运行工具运行单元测试。单元测试是包含单元测试框架（例如，NUnit或xUnit)和该单元测试框架的dotnet 测试运行程序上的依赖项的类库项目。
单元测试打包为NuGet包，并还原为该项目的普通依赖项。
测试项目需要在 project.json中使用“testRunner”节点指定测试运行程序属性。此值应包含单元测试框架的名称。
dotnet test 支持两种运行模式。
控制台:在控制台模式下，dotnet test完全执行传递给它的任意命令，并输出结果。当只调用但不传递dotnet test时，在控制台模式下运行的端口将反过来使运行程序在控制台模式下运行。
设计时:在其他工具，如编辑器或集成开发环境（IDE）的上下文中使用。
dotnet-test [project] 指定要测试项目的路径。如果省略，则默认为当前目录。-c，--configuration dotnet-test [Debug | Release] 生成下的配置。默认值是Releasc。 dotnet-test -o，--output [DIR] 二进制文件运行的目录。 dotnet-test -b,--build-base-path [ DIR] 临时输出的目录。 dotnet-test -f，--framework [ FRAMEWORK] 查找指定框架的测试二进制文件。 dotnet-test -r,--runtime [RUNTIME_IDENTIFIER] 查找指定运行时的测试二进制文件。 dotnet-test --no-build 运行前不生成测试项目。 dotnet-test --parentProcessId IDE用于指定其进程ID。执行父进程时将退出测试。 dotnet-test --port IDE用于指定侦听连接的端口号。 可以使用dotnet test - h来查看命令帮助。
6、dotnet-publish 编译
dotnet-publish:编译应用程序，读取在project.json文件中指定的依赖，并将生成的文件结果集发布到目录。
dotnet-publish [project] 要发布的项目，如果未指定[project]，则默认为当前目录。此值可以是 project.json文件或包含project.json文件的项目目录的路径。如果找不到 project.json文件，dotnet publish 会引发错误。 dotnet-publish -f,--framework [FID] 发布指定框架标识符（FID）的应用程序。如果未指定，则FID是从 project.json中读取。在没有有效的框架时，命令将抛出错误。如果发现多个有效的框架，命令将发布所有有效的框架。 dotnet-publish -r, --runtime [RID] 发布指定运行时的应用程序。-b,--build-base-path [DIR]临时输出的目录。 dotnet-publish -o,--output 指定放置目录的路径。如果未指定，则对于可移植应用程序，将默认为.binl[configuration]/[framework]/;或对于独立部署，将默认为.bin/[configuration]/[framework][runtime]。 dotnet-publish --version-suffix[ VERSION_SUFFIX] 定义在project.json文件中的版本字段*被替换。 dotnet-publish-c，--configuration [Debug | Release]发布时要使用的配置。默认值是Debug。 可以使用dotnet publish - h来查看命令帮助。
7、dotnet-pack 打包
dotnet pack命令生成项目并创建 NuGet包。此操作将生成两个含有nupkg扩展名的包:一个包含代码，另一个包含调试符号。
将被打包项目的NuGet依赖项添加到nuspec文件，以便在安装包时可以将其解析。默认情况下，项目到项目的引用不会打包到项目内。要想做到这一点，需要在依赖中将引用项目的 type节点设置为“build”。
dotnet-pack [project] 要打包的项目。它可能是project.json文件，或者是目录的路径。如果省略，则默认为当前目录。 dotnet-pack -o,--output [DIR] 指定生成包的目录。 dotnet-pack --no-build 打包前不生成项目。 dotnet-pack --build-base-path 指定临时生成项目的目录。默认情况下，是当前目录的obj目录。 dotnet-pack -c，--configuration [Debug / Release] 生成项目时使用的配置。如果没有指定，则默认为“Deoug”。 dotnet-pack --version-suffix 更新含有指定字符串的-*包版本后缀中的星形。 可以使用dotnet-pack - h来查看命令帮助。
