釋出Npm包到GitHub Packages

Github集成了GitHub Packages功能，目前提供了Npm、Docker、Maven、NuGet、RubyGems的包管理工具，可以通過Github管理開源包，本文主要介紹使用GitHub Packages釋出Npm包。

釋出

首先需要製作一個package.json檔案，可以通過npm init命令根據提示生成一個package.json檔案。

這是已經發布好的package.json檔案，作為示例，需要注意的是name欄位、publishConfig欄位與repository欄位的配置，在GitHub Packages釋出的包屬於作用域包，需要使用@username/package-name

{
  "name": "@WindrunnerMax/mini-program-cli",
  "version": "1.1.0",
  "description": "Uniapp小程式開發腳手架",
  "author": "Czy",
  "license": "MIT",
  "bin": {
    "mini-program": "bin/cli.js"
  },
  "scripts": {
    "test": "echo \"Please use HbuildX import this project\""
  },
  "engines": {
    "node": ">= 8"
  },
  "publishConfig": {
    "registry": "https://npm.pkg.github.com/WindrunnerMax"
  },
  "repository": "https://github.com/WindrunnerMax/Asse"
}
 

下面需要授權，首先在Github申請一個Token，user - setting - Developer settings - Personal access tokens - Generate new token，生成一個用以釋出Npm包的Token，需要選擇許可權，以下許可權必選：

接下來將Token新增至~/.npmrc，win使用者是路徑C://users/current-user。

//npm.pkg.github.com/:_authToken=TOKEN

或者使用npm login命令進行授權，注意使用者名稱要全部小寫，Token的輸入是以密碼的方式輸入，不會顯示。

npm login --registry=https://npm.pkg.github.com
> Username: USERNAME
> Password: TOKEN
> Email: PUBLIC-EMAIL-ADDRESS
 

接下來在專案的根目錄新增一個~/.npmrc檔案，並新增如下配置。

registry=https://npm.pkg.github.com/WindrunnerMax

接下來就可以使用npm publish命令釋出包。

npm publish --access=public

安裝

需要注意的是，無論釋出包還是安裝包都需要授權，也就是上述生成Token以及配置的過程，否則無法安裝指定的包，以我釋出的包為例，執行安裝。

npm install -g @windrunnermax/[email protected] --registry=https://npm.pkg.github.com/

如果使用Github安裝Npm包很慢的話，可以考慮配置代理，同樣是在~/.npmrc檔案中加入配置。

proxy=socks5://127.0.0.1:1080
https-proxy=socks5://127.0.0.1:1080

Github

https://github.com/WindrunnerMax