使用Github Packages功能上传nuget包到Github

前几天微软收购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

在Github上申请Access Token

在Github上申请一个新的Access Token。这个Token是用来上传Package的凭证，后面需要配置。登录Github后点击个人头像-Settings-Developer settings-Personal access tokens-Generate new token，然后勾选packages的权限后点Generate token按钮生成token。复制好这个token，不要丢了，因为你关闭这个页面后，后面就再也找不回这个token了。

新建一个.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文件，并且配置它。

OWNER填写你Github的用户名

UserName填写你Github的用户名

Token填写上面申请的access token

以下是我的配置

<?xml version="1.0" encoding="utf-8"?>

<configuration>

    <packageSources>

        <clear />

        <add key="github" value="https://nuget.pkg.github.com/kklldog/index.json" />

    </packageSources>

    <packageSourceCredentials>

        <github>

            <add key="Username" value="kklldog" />

            <add key="ClearTextPassword" value="xxx" />

        </github>

    </packageSourceCredentials>

</configuration>

修改包信息并打包

在Visual studio上右键项目，选择编辑项目文件。我们在csproj文件下编辑包信息。其中包含包的id，版本，授权等，比较简单一看就明白了。

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

  <PropertyGroup>

    <TargetFramework>netstandard2.0</TargetFramework>

    <PackageId>HiGithubPackage</PackageId>

    <Version>1.0.0</Version>

    <Authors>minjie.zhou</Authors>

    <Description>Test upload to github packages</Description>

    <PackageLicenseExpression>MIT</PackageLicenseExpression>

    <RepositoryUrl>https://github.com/kklldog/HiGithubPackage</RepositoryUrl>

    <GeneratePackageOnBuild>true</GeneratePackageOnBuild>

  </PropertyGroup>

</Project>

修改完后ctrl-b一下进行一次编译。编译完后在bin\debug下会生成一个.nupkg的包文件。

上传包到Github packages

使用dotnet cli进行上传

dotnet nuget push "bin/debug/HiGithubPackage1.0.0.nupkg" --source "github"

这里可能要多试几次，有的时候会提示401的错误。

上传成功后回到Github网站刷新下看看HiGithubPackage仓库。可以看到我们的包已经出现在上面。

新建一个.net Core控制台项目HiGithubPackageTest

新建另外一个core项目，这个项目要引用我们上传成功的包并使用它。

使用dotnet cli来安装这个包

dotnet add HiGithubPackageTest package HiGithubPackage --version 1.0.0

这里也要多试几次，同样会出现401的问题。最后我挂上FQ工具才安装成功。

修改Program类来使用这个包。

  class Program

    {

        static void Main(string[] args)

        {

            HiGithubPackage.GithubPackage.Hi();

            Console.ReadLine();

        }

    }

运行一下成功的输入了“Hi GithubPackage ~”，说明成功的引用了HiGithubPackage这个包。

一些小问题

通过以上一些了操作我们演示了如果上传一个包到Github Packages服务。演示了如果下载一个包到项目并使用它。总体体验其实一般般，个人觉得有几个小问题：

上传的包并不会出现在nuget.org官方源里面。不出现在官方源里面的话其他项目要使用这个包就会相当麻烦。毕竟大家都喜欢使用nuget管理程序来安装包，使用cli的话会比较麻烦。
不知道是不是墙的问题，上传包跟安装包都碰到了比较严重的网络问题，如果没有FQ工具的话会很麻烦，当然这不是Github的锅。