用Nuget部署程序包

时间:2022-08-10 15:21:09

用Nuget部署程序包

Nuget是.NET程序包管理工具(类似linux下的npm等),程序员可直接用简单的命令行(或VS)下载包。好处:

(1)避免类库版本不一致带来的问题。GitHub是管理源代码的,这个是管理生成的类库/包的。

(2)可自动处理类库依赖:

(3)可指定下载历史版本: install-package name –version 1.0.2

(4)可部署私有包服务器: https://docs.microsoft.com/en-us/nuget/hosting-packages/overview

1.    注册账号

http://www.nuget.org

可用微软账户登录注册

2.    生成ApiKey

用Nuget部署程序包

(1)       这个key最多只能用一年。超出了怎么办?不知道有没有续期措施。

(2)       Glob pattern:匹配模式,用户搜索时用的?

3.    发布包方案一:使用命令行

(1)       去官网下载Nuget.exe:

https://www.nuget.org/downloads

VS 2017已经内置了,但不知道怎么在VS内部运行nuget命令

(2)       在项目目录下运行命令:

nuget setApiKey xxxxxxxxx-5a3c-4a67-b969-3cda4f074341

nuget spec, 生成并编辑 .nuspec 文件(是包的配置信息)

nuget pack xxx.csproj, 生成 .nupkg 文件(包)

nuget push xxx.1.0.x.nupkg, 发布

4.    发布包方案二:使用NuGetPackageExplorer

参考:https://github.com/NuGetPackageExplorer/NuGetPackageExplorer

(1)安装并运行:Microsoft Store > NuGet Package Explorer

(2)新建包 > 添加文件夹/文件

用Nuget部署程序包

可添加的目录类别包括:

build

输出到bin目录

content

原样拷贝

lib

添加到引用

src

源码拷贝

tools

(3)发布,填写入你的key

用Nuget部署程序包

5.    安装测试

在vs>工具>Nuget包管理器>管理解决方案的Nuget程序包>浏览:

用Nuget部署程序包

或者直接在程序包管理器控制台中用命令行

Install-package packageName

用Nuget部署程序包

部署后自动将引用、资源、配置等自动发布到新程序。

用Nuget部署程序包

注意,包发布后有时延。

6.    其它

(1)     指定依赖的.NET类库版本

用Nuget部署程序包

(2)     限制可下载的版本

用Nuget部署程序包

(3)     引用类库

用Nuget部署程序包

(4)     修改.config文件

在Content目录下包含app.config.transform 或 web.config.transform 文件。

https://docs.microsoft.com/zh-cn/nuget/create-packages/source-and-config-file-transformations

(5)     新增文件

在Content目录下放置代码文件,并附加.pp扩展名。如:

content\Model\ContosoData.cs.pp

代码中可用$token$放置一些变量(https://msdn.microsoft.com/library/vslangproj.projectproperties_properties.aspx

namespace $rootnamespace$.Models

{

public struct CategoryInfo

{

public string categoryid;

public string description;

public string htmlUrl;

public string rssUrl;

public string title;

}

}

(6)     部署到 bin 目录下

(7)     部署自己的Nuget服务器

https://github.com/NuGet/NuGetGallery#build-and-run-the-gallery-in-arbitrary-number-easy-steps

https://docs.microsoft.com/zh-cn/nuget/hosting-packages/nuget-server