Fork me on GitHub

.NET Core系列 :3 、使用多个项目

通过前面的两篇文章,我们已经知道如何创建新的项目,如何生成并运行我们的应用程序,也知道(大致) project.json 文件中的内容是什么意思。但大多数项目往往也需要多个项目或引用的类库。我们要创建类库项目和应用程序项目。在应用程序中,如何引用我们的类库。

创建应用项目 File -> New Application

这个很熟悉了吧,输入下面的命令:

mkdir DotnetNewApp

cd DotnetNewApp

dotnet new

dotnet restore

dotnet build

dotnet run

[root@Mono ~]# mkdir DotnetNewApp
[root@Mono ~]# cd DotnetNewApp/
[root@Mono DotnetNewApp]# dotnet new
Created new C# project in /root/DotnetNewApp.
[root@Mono DotnetNewApp]# dotnet restore
log  : Restoring packages for /root/DotnetNewApp/project.json...
log  : Writing lock file to disk. Path: /root/DotnetNewApp/project.lock.json
log  : /root/DotnetNewApp/project.json
log  : Restore completed in 8774ms.
[root@Mono DotnetNewApp]# dotnet build
Project DotnetNewApp (.NETCoreApp,Version=v1.0) will be compiled because expecte      d outputs are missing
Compiling DotnetNewApp for .NETCoreApp,Version=v1.0

Compilation succeeded.
    0 Warning(s)
    0 Error(s)

Time elapsed 00:00:03.7500023


[root@Mono DotnetNewApp]# dotnet run
Project DotnetNewApp (.NETCoreApp,Version=v1.0) was previously compiled. Skippin      g compilation.
Hello World!

 

我们创建好了应用项目,接下来我们创建一个类库项目

创建类库项目 File -> New Library

dotnet new 默认创建的控制台项目,他还可以创建其他项目类型 :

[root@Mono DotnetNewApp]# dotnet new -t -h
Unrecognized type: -h
Avaiable types for C# :
- Console
- Web
- Lib
- xunittest

看这个输出,单词都拼错了,Avaiable 应该是Available,已经被提了bug https://github.com/dotnet/cli/pull/3822 ,除了控制台,还可以创建Web,Lib和xunittest,项目类型和使用Visual Studio 2015一致。web是asp.net core 模板,xunittest是测试项目,Lib就是我们需要创建的类库项目类型,所以我们将加上-t 参数指定为Lib,Scott Hanselman 的博文 Exploring dotnet new with .NET Core 讲的也很详细:

[root@Mono DotnetNewApp]# cd ..
[root@Mono ~]# mkdir DotnetNewLib
[root@Mono ~]# cd DotnetNewLib/
[root@Mono DotnetNewLib]# dotnet new -t Lib
Created new C# project in /root/DotnetNewLib.
[root@Mono DotnetNewLib]# pwd
/root/DotnetNewLib
我们创建完成了一个C#类库项目 /root/DotnetNewLib

我们来对比下控制台和类库项目的区别是什么?前面一篇文章《.NET Core系列 : 2 、project.json 这葫芦里卖的什么药》我们已经简单提及。我们来看下类库项目的project.json:

{
  "version": "1.0.0-*",
  "buildOptions": {
    "debugType": "portable"
  },
  "dependencies": {},
  "frameworks": {
    "netstandard1.6": {
      "dependencies": {
        "NETStandard.Library": "1.6.0"
      }
    }
  }
}

 

类库的编译选项buildOptions 少了 emitEntryPoint ,这是一个类库,所以不需要入口。依赖的框架不是netcoreapp1.0,而是用了一个netstandard1.6替代,上面一篇文章我们简要说明了一下,本质上来说netcoreapp1.0和.NET 4.6.3 都是NETStardard 1.6的实现,Mono 也正在调整NETStardard,https://github.com/mono/mono/tree/netstandard。

本质上来说,NETStandard.Library 是一个目标最低支持基础类库,这样就可以更好的向前兼容性,在现有的平台出现新的版本时(如.net core 1.1 甚至 2.0)而无需重新发布新的变化。具体参考 https://github.com/dotnet/corefx/blob/master/Documentation/architecture/net-platform-standard.md ,目前最新的表格:

image

如何理解这个表格

  • 如果一个类库指定.NET平台标准1.3版本,那么它仅能够运行在.NET Framework 4.6或更新的框架、Universal Windows Platform 10(UWP)、DNX Core 5.0和Mono/Xamarin这些平台上。
  • 如果一个类库指定.NET平台标准1.3版本,那么它能够引用(原文:consume)所有来自之前的.NET平台标准的版本(1.2、1.1、1.0)。

如果我们想要我们的类库项目,也可以更广泛地使用,比如旧版本的.Net项目也可以用, 我们可以降低修改为 netstandard1.0,这意味着所有.Net 4.5 或更高版本的运行时兼容,再加上Windows Phone Silverlight (8.0 + 8.1)。值得注意的.Net 4.5 以下版本不兼容这个新的NetStandard 版本化方案。在我们的控制台应用程序,我们针对 Microsoft.NETCore.App 的依赖项。这是指类型的平台,并且在我们的应用程序的运行时上声明依赖项。

 

我们的控制台程序将要依赖于我们这个类库项目做些计算逻辑,我们就用它来做个2个数相乘吧,修改Class1为Calculator,Method1修改为Multi:

namespace DotnetNewLib
{
    public class Calculator
    {
        public int Multi(int x,int y)
        {
             return x * y;
        }
    }
}

下面进入我们今天的重点是项目的引用.

 

项目引用Project References

引用项目和引用Nuget包不同的地方主要是 "target": "project" 这个属性,这和前面的Microsoft.NETCore.App 的依赖属性"type": "platform"类似。

下面我们给我们的控制台应用添加类库DotnetNewLib的依赖,在DotnetNewApp的project.json 添加,文件内容如下:

{
  "version": "1.0.0-*",
  "buildOptions": {
    "debugType": "portable",
    "emitEntryPoint": true
  },
  "dependencies": {},
  "frameworks": {
    "netcoreapp1.0": {
      "dependencies": {
        "Microsoft.NETCore.App": {
          "type": "platform",
          "version": "1.0.0"
        },
       "DotnetNewLib":{
           "target":"project"
        }
      },
      "imports": "dnxcore50"
    }
  }
}
这么写有个前提是你的DotnetNewApp 和DotnetNewLib文件夹有相同的父文件夹,这里有两件事需要注意,每当你dotnet build DotnetNewApp,他就会以递归方式尝试dotnet build DotnetNewLib。第二件需要注意的是build而不是执行restore,你需要确保这两个项目都运行了dotnet restore,当然你可以在他们的父文件夹执行dotnet restore。所有的子文件夹里面的project.json 都会被恢复。

接下来,我们在控制台应用DotnetNewApp里调用DotnetNewLib的乘法:

using System;
using DotnetNewLib;

 

namespace ConsoleApplication
{
    public class Program
    {
        public static void Main(string[] args)
        {
            Calculator calc = new Calculator();
            var result = calc.Multi(9,8);
            Console.WriteLine($"Hello World is {result} ");
        }
    }
}

 

编译和运行

我们切换到DotnetNewApp 文件夹下,我们现在可以编译和运行这个应用了,同时也会编译我们的类库项目DotnetNewLib。

[root@Mono DotnetNewApp]# dotnet build
Project DotnetNewLib (.NETStandard,Version=v1.6) will be compiled because expected outputs are missing
Compiling DotnetNewLib for .NETStandard,Version=v1.6

Compilation succeeded.
    0 Warning(s)
    0 Error(s)

Time elapsed 00:00:02.8849475
Project DotnetNewApp (.NETCoreApp,Version=v1.0) will be compiled because dependencies changed
Compiling DotnetNewApp for .NETCoreApp,Version=v1.0

Compilation succeeded.
    0 Warning(s)
    0 Error(s)

Time elapsed 00:00:03.0273700


[root@Mono DotnetNewApp]# dotnet run
Project DotnetNewLib (.NETStandard,Version=v1.6) was previously compiled. Skipping compilation.
Project DotnetNewApp (.NETCoreApp,Version=v1.0) was previously compiled. Skipping compilation.
Hello World is 72

到这里我们成功构建了一个类库项目和一个控制台项目,控制台引用类库项目完成乘法运算,这虽然是一个很简单的多项目应用,我们通过这个最简单的项目讲解了dotnet core的多项目应用如何进行开发和注意事项。

posted @ 2016-08-01 08:01  张善友  阅读(13002)  评论(4编辑  收藏  举报