1. 引言

• GitHub上面的倉庫往往有很多版本，有些版本很好用，有些版本上面一大堆bug。因此，我們需要對倉庫上的各個release軟件進(jìn)行篩選，找到最好用的那個軟件。但如果一個個手動下載的話，效率太低了，因此我們可以用CL這款工具進(jìn)行批量化asset下載，簡單快捷高效。

2. 工具官網(wǎng)

• GitHub - cli/cli: GitHub’s official command line tool

3. 官方教程

• git - How to download all files from GitHub release? - Stack Overflow
• gh release download | GitHub CLI 中文手冊

4. 測試用的網(wǎng)址

• Releases · Make-md/makemd · GitHub

5. 安裝

5.1. 使用winget安裝

• winget install --id GitHub.cli

安裝完成

5.2. 查看gh是否安裝成功了

• 重啟打開一個PowerShell中斷
• gh --version
• 如果可以顯示出版本號，就表明安裝成功了

6. 使用

6.1. 進(jìn)行GitHub授權(quán)

• 在使用之前需要先進(jìn)行授權(quán)，否則會顯示下面的問題

• 直接輸入gh auth login
• 個人用戶一般選擇默認(rèn)的GitHub服務(wù)，直接按Enter鍵

• 選擇GitHub的方式，可以用默認(rèn)的HTTPS方式

6.1.1. 授權(quán)

- 如果出錯的話，就給PowerShell添加代理

$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"

• 使用瀏覽器登錄GitHub，打開控制臺復(fù)制對應(yīng)的token，粘貼過來

github.com/settings/tokens 如果你之前沒有創(chuàng)建過Token的話，就新建一個Token

• 然后粘貼過來粘貼到終端的時候是沒有任何提示的，不要粘貼兩次

按下確定之后，會使用瀏覽器打開GitHub，同時命令行終端上面會產(chǎn)生一個八位字符 -

將其粘貼到瀏覽器的輸入框中，點擊繼續(xù) -

之后選擇授權(quán)即可 -

6.1.2. 授權(quán)成功

6.2 查看指定倉庫中的所有版本的release

6.2.1. 默認(rèn)的30個版本

gh release list -R <username>/<repo>

比如自己要下載Make-md/makemd，就修改代碼為

gh release list -R Make-md/makemd

效果如下，是不是整整齊齊的，很養(yǎng)眼？ -

6.2.2. 自定義的100個版本

gh release list -R Make-md/makemd --limit 100

6.3 下載特定版本的release

默認(rèn)的模板為

gh release download <tag> -D <dest> -R <username>/<repo>

• 為自己需要下載的版本，為自己要下載的文件夾路徑

修改后

gh release download 0.8.14 -D E:\Documents\Desktop -R Make-md/makemd

下載中

下載完

6.4 下載最新版本的release

• 不指定對應(yīng)的tag參數(shù)，下載的就是最新版本的release

gh release download -D E:\Documents\Desktop -R Make-md/makemd

6.5 下載最新發(fā)行版的源代碼存檔

gh release download -D E:\Documents\Desktop\test -R Make-md/makemd -A zip

6.6 下載特定發(fā)行版的源代碼存檔

gh release download  -D E:\Documents\Desktop -R Make-md/makemd 0.7.6 --archive=zip

6.7 下載所有版本的release源代碼存檔

• 下次使用的時候，只需要更改一下倉庫名稱即可

gh release download -p "*" -D E:\Documents\Desktop -R Make-md/makemd
gh release list -R Make-md/makemd | Select-String -Pattern '\d+\.\d+(\.\d+)?' | %{$_.Matches.Value} | ForEach-Object {Write-Host "Downloading version $_..." ; gh release download $_ -D E:\Documents\Desktop\test -R Make-md/makemd -A zip}

• 最終下載完之后，可以看到很壯觀的一長列

img

7. 問題

• 為什么有些版本明明存在，但卻下載不下來？
• 單個下載的時候有可能也是不存在的

gh release download  -D E:\Documents\Desktop -R Make-md/makemd 0.7.2 --archive=zip

是只存在標(biāo)簽，但卻不存在實際的文件 -

7.1. 為什么顯示的版本號不全？

• 這個倉庫有7頁，按理說版本應(yīng)該非常多了，但卻只能顯示出來少量的幾個版本

• gh release list -R Make-md/makemd

• 這是因為命令默認(rèn)只會顯示最近的30個版本
• 給命令加上一個限制之后，就顯示出來了更多的版本

7.2 failed to authenticate via web browser:

• Post “https://github.com/login/device/code”: read tcp 192.168.3.41:61001->20.205.243.166:443: wsarecv: A connection attempt failed because the connected party did not properly respond after a period of time, or established connection failed because connected host has failed to respond.
• 給PowerShell添加代理即可

$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"