如何将github开源项目发布

gopyer

已于 2024-05-26 19:10:44 修改

阅读量414

点赞数 5

分类专栏：开源之路文章标签：开源 golang

于 2024-05-26 19:08:37 首次发布

本文链接：https://blog.csdn.net/fuxily/article/details/139218891

版权

开源之路专栏收录该内容

3 篇文章 0 订阅

订阅专栏

如何将github开源项目发布

当我们的开源项目完成后，如果是一些可执行程序，就最好要将开源项目发布生成Releases，Releases包含各个系统架构的分发二进制，用户可以不用源码编译安装，而是直接下载安装，这样可以提高开源项目的用户体检。我们可以使用goreleaser这个开源工具帮我们快速发布项目。本文将介绍goreleaser的基本使用。

在这里插入图片描述

安装

$ go install github.com/goreleaser/goreleaser@latest

使用go install命令安装需要安装Go，可以去https://go.dev/dl/ 下载安装即可

使用步骤

创建github项目并克隆到本地

git clone git@github.com:jagitch/go-downloader.git

初始化go项目

cd go-downloader
go mod init jagitch/go-downloader
touch main.go

编写应用

package main

func main() {
    println("Hello, Welcome to Go downloader v0.0.0!")
}

初始化goreleaser

$ goreleaser init
  • Generating .goreleaser.yaml file
  • config created; please edit accordingly to your needs file=.goreleaser.yaml
  • thanks for using goreleaser!

将会生成.goreleaser.yaml文件

before:
  hooks:
    - go mod tidy
    - go generate ./...
builds:
  - env:
      - CGO_ENABLED=0
    goos:
      - linux
      - windows
      - darwin

archives:
  - format: tar.gz
    # this name template makes the OS and Arch compatible with the results of uname.
    name_template: >-
      {{ .ProjectName }}_
      {{- title .Os }}_
      {{- if eq .Arch "amd64" }}x86_64
      {{- else if eq .Arch "386" }}i386
      {{- else }}{{ .Arch }}{{ end }}
      {{- if .Arm }}v{{ .Arm }}{{ end }}
    # use zip for windows archives
    format_overrides:
    - goos: windows
      format: zip
checksum:
  name_template: 'checksums.txt'
snapshot:
  name_template: "{{ incpatch .Version }}-next"
changelog:
  sort: asc
  filters:
    exclude:
      - '^docs:'
      - '^test:'

build.goos 可以配置生成多个系统的发行包

$ goreleaser release --snapshot --clean

修改.goreleaser.yaml符合自己需求，然后执行check检查该文件是否正确

$ goreleaser check

登录到github，打开settings -> Developer settinng -> Personal access tokens创建访问Token
设置GITHUB_TOKEN环境变量

export GITHUB_TOKEN="ghp_HHKqB7olfSYrIf6e0NUQIGaE1iAFoS3fSuX1"

提交代码并创建tag

git add .
git commit -m "feature x is finished"
git push
git tag -a v0.0.1 -m "version v0.0.1"
git push origin v0.0.1

注意，在发布之前一定要先执行此步骤提交代码和tag

执行发布

goreleaser release --clean

此条命令将会把二进制等发布到github上

执行此命令前必须先按第8步骤的顺序提交对应版本代码，创建对应版本tag，并push到远程仓库，否则发布的版本名称是新的但是代码却是上一次提交的代码。

Changelog是根据commit信息生成的，内容是基于上一个Release来的，即上一个Realse对应的commit到最新的commit之间的提交信息会体现在Changelog中。