• 使用 NuGet 管理我们的程序集


    1、缘起

    在我们的项目中。须要引用的组件统一放在一个 Libs 文件夹下。不管对于平台上的公共组件。还是应用模块,都是如此。

    假设一个应用模块,比如能源管理(EM)。要引用平台提供的公共组件,比如数据库訪问(Platform.PL)。那么不但要把Platform.PL程序集复制到EM的Libs文件夹下,也要把Platform.PL所引用的程序集。也就是Platform.PL的Libs文件夹下的文件。复制到EM的Libs文件夹下。

    随着平台上应用模块的增多,Platform.PL被引用得也越来越多。我们是怎么把Platform.PL自身及其Libs下的程序集给到这些应用模块的呢?是通过手工拷贝的方式。

    那么问题来了——Platform.PL升级了怎么办?答案是,仅仅能一一手工拷贝了。

    这样的做法非常老土,并且由于手工拷贝,easy出错。最好是把共用组件放到server上,应用模块引用或升级时就去server上下载或更新。实际上,业界已经这么做非常久了。就是用 NuGet 获取程序集。

    仅仅是这些程序集普通情况下都是公开的,比如 NHibernate、Spring.Net等等。我们能够使用 NuGet 的机制,并且把共用的程序集放到内部的server上。

    因此,这里介绍的,不是怎么用 NuGet 来管理一个解决方式所使用的程序集,而是怎么把我们自己开发的公共组件放到内部的server上,让其它模块下载、更新。

    顺带说一下开发环境,当然是 .NET 了,Visual Studio的版本号是 2012。这个版本号已经缺省安装了 NuGet 包管理器。

    2、准备待公布的程序集

    开发好公共组件后。要将其公布到 NuGet server上,须要做些准备工作。

    0. 下载 NuGet.exe。地址在这里。这是一个控制台程序,以后要在命令行以下执行。下载后。将其放到一个合适的位置,并用path指向这个位置。当然,这个文件仅仅须要下载一次。

    1. 创建清单文件。

    打开命令行程序。进入公共组件所在项目的目录,执行 nuget spec。

    就像以下这样:

    这样就会创建一个文件:Platform.PL.nuspec。打开这个文件,会看到是这个样子的:

    <?

    xml version="1.0"?> <package > <metadata> <id>$id$</id> <version>$version$</version> <title>$title$</title> <authors>$author$</authors> <owners>$author$</owners> <licenseUrl>http://LICENSE_URL_HERE_OR_DELETE_THIS_LINE</licenseUrl> <projectUrl>http://PROJECT_URL_HERE_OR_DELETE_THIS_LINE</projectUrl> <iconUrl>http://ICON_URL_HERE_OR_DELETE_THIS_LINE</iconUrl> <requireLicenseAcceptance>false</requireLicenseAcceptance> <description>$description$</description> <releaseNotes>Summary of changes made in this release of the package.</releaseNotes> <copyright>Copyright 2014</copyright> <tags>Tag1 Tag2</tags> </metadata> </package>

    当中有些内容是不须要的,能够删除它。licenseUrl。projectUrl,iconUrl,都能够删掉,反正它提示我们删掉。

    releaseNotes和tags一定要改动。否则下一步会出现警告。

    比如,我把这个文件改动成这样:

    <?

    xml version="1.0"?> <package > <metadata> <id>$id$</id> <version>$version$</version> <title>$title$</title> <authors>$author$</authors> <owners>$author$</owners> <requireLicenseAcceptance>false</requireLicenseAcceptance> <description>$description$</description> <releaseNotes>MES平台数据库訪问组件首次公布到NuGetserver上</releaseNotes> <copyright>Copyright 2014</copyright> <tags>MES平台 数据库訪问</tags> </metadata> </package>

    2.打包。在上面的命令行界面下,执行 nuget pack,像以下这样:

    这样就会创建一个文件 Platform.PL.xyz.nupkg。这就是我们将要公布到NuGetserver上的包。

    有一种情况值得一提:由于某种原因,我们不得不使用spring.net的预发行版(pre-release)。好奇么?这个原因就是,spring.net在并发环节使用了Dictionary,而这个类不是线程安全的,导致在执行时出现故障。spring.net在预发行版 2.0.0-RC1攻克了这一问题,但还没有出稳定(Stable)版。所以我们就使用这个预发行版了。

    nuget有一项规定:假设使用了非稳定版的程序集,所公布的程序集就不能是稳定版本号。否则,打包是就会出现这种错误:

    为此。须要将我们要公布的包设置为測试版或预发行版。做法是手工编辑所在项目的 Properties/AssemblyInfo.cs 文件:

    当中的36行就是我们加进去的。


    3、将程序集公布到内部server上

    经过上一步。我们生成了要公布的包:Platform.PL.3.1.0-alpha.nupkg。

    这个包能够公布到公共的NuGetserver上,供全部人下载。但如今我们不想这么做。我们仅仅是公布到内部server上,仅供项目组内部使用。

    要做到这一点,我们首先要创建一个站点。用常规的方法创建IIS站点,能够给这个站点起名为 NuGetServer。

    其次,我们要创建一个Web应用。

    利用VS,创建一个 ASP.NET空Web应用程序。

    能够给这个项目起名为 NuGetServer。

    再次,在这个应用程序中,用 NuGet 加入 NuGet.Server 包引用:

    引用了NuGet.Server包以后。会自己主动增加非常多它引用的包。

    再再次,将我们刚创建的 Platform.PL.3.1.0-alpha.nupck 文件,增加到这个Web项目的packages目录中:

    最后,将这个应用公布到站点 NuGetServer 中就能够了。

    公布成功后,打开这个站点,能够看到类似这种内容:

    4、引用程序集

    将程序集在内部NuGetserver上公布成功后,就能够将其引用到应用模块中了。

    在应用模块引用之前,还须要做一件准备工作:将server加入到NuGet配置中。

    在VS 2012中,点击菜单 工具 --> NuGet程序包管理器 --> 管理解决方式的NuGet程序包,在弹出的对话框中,点击左下角的“设置”button,会弹出“选项”对话框。点击右上角的大加号,能够加入“可用程序包源”,将上面ie提示的地址。如http://localhost:8010/nuget。加入上去就能够了。能够起名字为mes:

    至此,就能够像从公共NuGetserver上下载程序集一样。从内部的NuGetserver上下载我们自己的程序集了。

    5、其他

    这个帖子的标题带有“预发行版”。表示这个做法刚实验通过。真正用起来。应该会面临诸多意想不到的问题。即便如此,也推荐使用。

    建议我们的项目组:

    1、摈弃用Libs管理所引用的程序集。转用 NuGet 下载程序集的方式;

    2、MES平台搭建统一的 NuGet server;

    3、公共组件统一公布到 NuGet server上,并參考语义化版本号的方式设置版本号号。

    
  • 相关阅读:
    .NET CORE中的配置系统
    .Net Core使用AspNetCoreRateLimit实现限流
    .NET CORE 依赖注入2
    linunx命令学习_文件命令
    .NET CORE 日志系统
    Rabbit MQ
    WPF学习
    Unity asp.net 依赖注入框架Unity
    .NET Core 依赖注入1
    备忘asp.net core使用中间件实现IP白名单访问
  • 原文地址:https://www.cnblogs.com/bhlsheji/p/5397675.html
Copyright © 2020-2023  润新知