使用Github Packages功能上传nuget包到Github
Agile.Zhou 人气:3
前几天微软收购npm的新闻对于软粉来收很是振奋。微软收购npm很可能是为了加强Github Packages。目前Github,Typescript,VSCode,npm这些开源社区的重磅工具全部都在微软旗下,显示出了微软对开源的态度,微软已经不是以前那个封闭的微软。Github推出Github Packages功能有一段时间了,一直没使用过,今天有空打算折腾一下,体验一下。
## 什么是Github Packages
Github Packages是一个包承载服务,它完全跟Github集成。Github Packages使你的源码和包在同一个地方进行统一的管理,使你可以集中的在Github上开发跟发布。你可以发布公共包(public packages)跟所有人分享,也可以发布私有包(private packages)提供给个人或者组织使用。以上是对官方文档的简单翻译。说简单点就是以前你代码是在Github,但是包可能是在npm,maven或者nuget上,现在你在Github上传代码后还可以直接把包也上传到Github,方便统一管理,发布。
## 在Github Packages上发布包
下面让我们开始尝试使用Github Packages发布一个包吧。
### 在Github上新建一个仓库HiGithubPackage
新建一个公共的仓库命名HiGithubPackage
![](https://s1.ax1x.com/2020/03/20/86QtBD.png)
### 在Github上申请Access Token
在Github上申请一个新的Access Token。这个Token是用来上传Package的凭证,后面需要配置。登录Github后点击个人头像-Settings-Developer settings-Personal access tokens-Generate new token,然后勾选packages的权限后点Generate token按钮生成token。复制好这个token,不要丢了,因为你关闭这个页面后,后面就再也找不回这个token了。
![](https://s1.ax1x.com/2020/03/20/86QB9I.png)
### 新建一个.net Core项目HiGithubPackage
使用Visual studio新建一个core标准库项目。新建一个类,这个类里只有一个静态方法Hi,调用的话会输出一行Hi GithubPackage ~。我打算把这个库上传到Github Packages上去。
```
public class GithubPackage
{
public static void Hi ()
{
Console.WriteLine("Hi GithubPackage ~");
}
}
```
顺手把代码也push到github上去吧。
```
git push -u origin master
```
### 新建一个nuget.config文件
在项目文件夹下新建一个nuget.config文件,并且配置它。
![](https://s1.ax1x.com/2020/03/20/86lA5d.png)
OWNER填写你Github的用户名
UserName填写你Github的用户名
Token填写上面申请的access token
以下是我的配置
```
```
### 修改包信息并打包
在Visual studio上右键项目,选择编辑项目文件。我们在csproj文件下编辑包信息。其中包含包的id,版本,授权等,比较简单一看就明白了。
```
```
修改完后**ctrl-b**一下进行一次编译。编译完后在bin\debug下会生成一个.nupkg的包文件。
![](https://s1.ax1x.com/2020/03/20/861kLT.png)
### 上传包到Github packages
使用dotnet cli进行上传
```
dotnet nuget push "binhttps://img.qb5200.com/download-x/debug/HiGithubPackage1.0.0.nupkg" --source "github"
```
![](https://s1.ax1x.com/2020/03/20/86QGjK.png)
这里可能要多试几次,有的时候会提示401的错误。
上传成功后回到Github网站刷新下看看HiGithubPackage仓库。可以看到我们的包已经出现在上面。
### 新建一个.net Core控制台项目HiGithubPackageTest
新建另外一个core项目,这个项目要引用我们上传成功的包并使用它。
使用dotnet cli来安装这个包
```
dotnet add HiGithubPackageTest package HiGithubPackage --version 1.0.0
```
这里也要多试几次,同样会出现401的问题。最后我挂上FQ工具才安装成功。
![](https://s1.ax1x.com/2020/03/20/86QYnO.png)
修改Program类来使用这个包。
```
class Program
{
static void Main(string[] args)
{
HiGithubPackage.GithubPackage.Hi();
Console.ReadLine();
}
}
```
运行一下成功的输入了“Hi GithubPackage ~”,说明成功的引用了HiGithubPackage这个包。
![](https://s1.ax1x.com/2020/03/20/86QQhR.md.png)
### 一些小问题
通过以上一些了操作我们演示了如果上传一个包到Github Packages服务。演示了如果下载一个包到项目并使用它。总体体验其实一般般,但是个人觉得有几个小问题:
1. 上传的包并不会出现在nuget.org官方源里面。不出现在官方源里面的话其他项目要使用这个包就会相当麻烦。毕竟大家都喜欢使用nuget管理程序来安装包,使用cli的话会比较麻烦。
2. 不知道是不是墙的问题,上传包跟安装包都碰到了比较严重的网络问题,如果没有FQ工具的话会很麻烦,当然这不是Github的锅。
加载全部内容