如何移植.NET Framework项目至.NET Core？

公司的项目一直采用.NET框架来开发Web项目。目前基础类库均为.NET Framework 4.6.2版本。Caching, Logging，DependencyInjection，Configuration等基础设施相关的依赖库一直和官方保持同步，目前是1.1版本。.NET Core越来越趋于稳定，新的开发工具也在三月份发布。因此，计划将.NET Framework移植至.NET Core/Strandard。目的是使基于.NET开发的Web应用可以跨平台运行。

按应用场景将公司的项目分为基础类库，基础服务和应用项目。基础类库以包的形式提供各类基础功能。基础服务通过Wcf项目搭建或者通过Web API项目搭建。应用项目则是Web Mvc项目为主。基础类库和基础服务是以一个一个解决方案的形式存在。每个解决方案的结构，包含一个或者多个类库项目，一个或多个控制台项目，它们分别用于功能实现、单元测试、功能演示。如果全部要移植，那么优先级应该是基础类库 -> 基础服务 -> 应用项目。此次移植的对象是基础类库。

基础类库最终会以包的形式通过NuGet发布出去，目前只面向.NET Framework框架。移植的目标之一，是让包也能被面向.NET Core、.NET Standard框架的项目引用。结合官方资料，我选择了直接迁移的方案。即直接将项目文件转换为新的基于.NET Core的项目文件。下面详细说明移植的细节。

1. 新建基于.NET Core的项目。

首先重命名现有项目文件*.csproj为*.Net46.csproj。然后使用VS2017新建一个新的基于.NET Core的项目，项目类型可以是“类库(.Net Core)”或者“类库(.Net Standard)”。注意，VS2017会提示存在同名目录，所以创建时可以输入一个不同的名称，然后手工调整回来。

 

2. 编辑项目文件，使之支持面向多个目标框架。

通过VS2017 RC新建的项目，“类库(.Net Core)”或者“类库(.Net Standard)”，默认只有一个目标框架。我们可以编辑项目文件，使之支持面向多个目标框架。如支持目标框架为.NET Standard 1.4、.Net Core App 1.0和.NET Framework 4.5，则这样来修改。

< Project  Sdk="Microsoft.NET.Sdk">