.NET Core程序员

.NET Standard 2.0 特性介绍和使用指南(转发)

2017-08-16  本文已影响171人  p了个f

.NET Standard 2.0 发布日期：2017年8月14日
公告原文地址

前言

早上起来.NET社区沸腾了，期待已久的.NET Core 2.0终于发布！根据个人经验，微软的产品一般在2.0时会趋于成熟，所以一个新的.Net开发时代已经来临！未来属于.NET Core。

对于.NET Core 2.0的发布介绍，围绕2.0的开发生态，我想通过四篇文章（名称暂定）：

.NET Standard 2.0是基石，所以放在第一篇。使用之前，下载安装.NET Core 2.0，下载地址。

.NET Standard 2.0 特性介绍

.NET Standard 2.0 使用指南

创建.NET Standard类库

通过创建一个新项目来实践一下，在VS中 文件 | 新项目 选择.NET Standard分类找到 Class Library (.NET Standard)，项目名称为mylibrary。

创建.NET Standard类库

也可以通过命令行dotnet new创建一个类库（默认使用.NET Standard）

dotnet new lib -o mylibrary

为了让这个类库更加意义，编辑文件Class1.cs as，添加一行逻辑代码。

using System;

namespace mylibrary
{
    public class Class1
    {
        public static string GetMessage() => "Hello from .NET Standard!";
    }
}

使用.NET Standard类库

1. 创建一个项目

方式一：vs工具

方式二：命令行

dotnet new web -o aspnetcore

2. 引用Standard类库

方式一：vs工具

使用.NET Standard类库的方式和使用其他类库一样，只需要在项目中添加引用。在VS中右键项目，点击添加/引用，然后在项目（Projects）选项卡中选择 mylibrary。

方式二：命令行

命令行方式为项目添加引用

dotnet add reference ../mylibrary/mylibrary.csproj

3. 在Startup.cs文件，添加代码

app.Run(async (context) =>
{
    var message = mylibrary.Class1.GetMessage();
    await context.Response.WriteAsync(message);
});

4. 运行

方式一：vs工具

在VS中F5运行。

方式二：命令行

命令行工具运行

$ dotnet run
Now listening on: http://localhost:50878
Application started. Press Ctrl+C to shut down.
运行效果

恭喜！创建的.NET Standard 2.0类库在.NET Core中调用成功。同样也可以在 .NET Framework或Xamarin等不同类型的应用中使用，方式一样。

重用现有.NET Framework类库

方式一：vs工具添加Nuget包

.NET Standard 2.0 提供兼容模式，现在添加一个非.NET Standard类型的NuGet包，如要添加NuGet包为：Huitian.PowerCollections，在VS中右键项目mylibrary
，选择Manage NuGet Packages.，然后选择Browse，搜索Huitian.PowerCollections，在结果中找到包并点击安装。

方式二：命令行添加Nuget包

dotnet add package Huitian.PowerCollections

警告提醒

安装完包后，将显示以下警告:

NU1701: Package ‘Huitian.PowerCollections 1.0.0’ was restored using ‘.NETFramework,Version=v4.6.1’ instead of the project target framework ‘.NETStandard,Version=v2.0’. This package may not be fully compatible with your project.

这段警告不仅在安装包时提示，在每次构建时都会提示。

警告出现的原因是因为NuGet无法确定.NET Framework类库是否能够完全正常工作。例如，它可能依赖于Windows Forms（不跨平台）。建议测试应用程序，如果所有功能都按预期工作，您可以阻止警告。

取消警告提醒

方式一：vs工具

在VS中直接在包的属性中进行设置

再次编译，不再提示警告信息。注意：配置只针对每个引用包，不是全局的。因此，如果引用了另一个需要兼容模式的库，将再次得到警告，需要对该包进行单独设置。

方式二：直接文件修改方式

编辑项目文件中包引用配置，添加NoWarn属性：

<ItemGroup>
    <PackageReference Include="Huitian.PowerCollections" Version="1.0.0" NoWarn="NU1701" />
</ItemGroup>

上面的配置是将Huitian.PowerCollections(版本：1.0.0)包引用时产生的警告名为NU1701设置为不提示。

在VS中直接在包的属性中进行设置

发布NuGet包

方式一：vs工具

当类库开发完成，可以将其发布成NuGet包，在VS中，右键项目选择属性（Properties），在选项卡中找到Package，选中Generate NuGet package on build

发布NuGet

方式一：命令行

在命令行工具环境下，编辑项目文件添加GeneratePackageOnBuild设置值为true

<PropertyGroup>
<TargetFramework>netstandard2.0</TargetFramework>
<GeneratePackageOnBuild>true</GeneratePackageOnBuild>
</PropertyGroup>

编译项目，在输出目录中会找到生成的NuGet包。

补充：关于可移植类库（Portable Class Libraries）

.NET Standard 2.0发布之后，在.NET项目中共享代码，不再推荐使用PCL类库，有可能后面会废弃，如果现在使用PCL应该移植为.NET Standard类库。

总结

.NET Standard 2.0 支持API数量是 .NET Standard 1.x 的两倍多，这意味着我们将.NET Framework 中的代码移植到.NET Standard变得更加顺畅，另外通过兼容模式在.NET Standard类库中可以引用.NET Framework项目或类库，这样允许在没有将所有代码移植到.NET Standard的情况下快速使用现有类库。（提供一个过渡措施，如果代码没有执行到不支持的API是不会出错的。）

几乎所有.NET平台都支持 .NET Standard 2.0，包括.NET Framework, .NET Core, 和 Xamarin（前身是Mono），UWP在今年稍后的时间会支持。所有这些实现得益于新增的API以及兼容模式，特别是.NET Core和UWP，他们以前只能使用一个受限的API集。

建议你将所有的业务逻辑和UI中依赖的代码转换成.NET Standard，能确保你的业务逻辑可以在任何平台被复用，比如桌面应用、移动应用、云应用。

更多参考资料

.NET Standard 2.0新增命名空间提供绘图API啦！
.NET Standard documentation
.NET Standard API

原文地址

上一篇 下一篇

猜你喜欢

热点阅读