buildinfo

package
v2.2.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 4, 2026 License: Apache-2.0 Imports: 3 Imported by: 0

Documentation

Overview

Package buildinfo 决定程序对外报告的版本号,并把版本号换算成 GitHub Release 标签。

版本号有两个来源:

  1. 发布流水线用 -ldflags "-X main.version=…" 写进二进制的值(Release 二进制、Docker 镜像、热更用的开发版都是这样);
  2. 没有 ldflags 时(go run / go install github.com/…/cmd/relaymesh@vX.Y.Z)Go 工具链记在二进制构建信息里的模块版本。

第二个来源让「go run …@v2.0.0-rc.2」起来的 Hub 也知道自己是哪个 Release:Agent / hook 的安装脚本、 Web 里生成的安装命令都要靠它去 GitHub 取同一个版本,而不是「最新正式版」(那里可能根本没有 Agent 与 hook)。

Index

Constants

View Source
const DevVersion = "dev"

DevVersion 是没有任何版本信息时的占位值,与各 main 包里 `var version = "dev"` 的默认值一致。

Variables

This section is empty.

Functions

func ReleaseTag

func ReleaseTag(version string) string

ReleaseTag 把版本号换算成对应的 GitHub Release 标签(vX.Y.Z 或 vX.Y.Z-rc.N)。 不是正式 / 预发布版本时返回空串,调用方(安装脚本、Web 安装命令)会改取最新 Release 或明确提示。 返回值是用匹配出的数字和固定的 alpha / beta / rc 重新拼出来的,只含数字、点、连字符、小写字母和前缀 v, 写进脚本或 shell 命令都不会有注入风险。

func Resolve

func Resolve(injected string) string

Resolve 返回程序应当对外报告的版本号。

injected 是 -ldflags 注入的值:空或 "dev" 表示没有注入。注入了真正的版本号就原样使用(不做任何换算, 发布流水线与热更脚本写的是什么,程序就报告什么)。 没有注入时,看 Go 工具链记下的模块版本:它是正式 / 预发布标签(例如 go run …@v2.0.0-rc.2 得到 v2.0.0-rc.2)就用它; 伪版本(v2.0.1-0.2026…-abcdef123456)、(devel)、带 +dirty 的工作区构建都不是 Release,继续报告 "dev"。

Types

This section is empty.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL