OGeek|极客世界-中国程序员成长平台 › 门户 › 开源› 开发工具›编译/构建/部署

baligo: Gitee 官方使用的极简 Golang 构建打包工具

原作者: [db:作者] 来自: 网络收藏邀请

Bali - 极简的 Golang 构建打包工具

Bali 是一个使用 Golang 开发的极简 Golang 构建打包工具，Bali(old) 最初使用 PowerShell 编写，用于解决项目构建过程中的打包和配置设置等问题。Bali(old) 在构建时能够将，时间，git 的 commit 等信息填充到构建的二进制文件中，在追溯应用程序缺陷时有一定的用处。但基于 PowerShell 开发的 Bali 并没有直接支持创建 STGZ 安装包，STGZ 安装包本质上将 Shell Script 头与 tar.gz 合并在一起，然后分发，用户在安装时，由 Shell Script 调用解压缩命令解压完成安装，在 Shell 脚本中，还可以设置好 post_install 之类的脚本在解压后执行相关操作。STGZ 小巧而又强大，在近两年的开发过程中，我开发的 Linux 平台项目大多都实现了创建 STGZ 安装包的功能。实际上 Bali 完全可以实现这一功能，考虑到 Golang 内置了 archive/tar archive/zip compress/gzip 实际上如果使用 Golang 重新实现 Bali 要获得更大的受益。这便是 Baligo(Gitee: Baligo)。但我仍然觉得 Baligo 还有所欠缺，比如 Windows 平台不支持嵌入图标，版本信息，清单文件，因此这才有了新的 Bali 诞生。

功能

Bali 有一些功能是我觉得有些用处的：

构建参数支持环境变量推导
打包，创建压缩包，target 为 Windows 时创建 zip, target 为其他时，创建 tar.gz。
Windows 平台支持嵌入版本信息，图标，和应用程序清单。
UNIX 平台支持 STGZ 打包

bali 的命令行帮助信息如下：

Bali -  Minimalist Golang build and packaging toolusage: ./build/bin/bali <option> args ...  -h|--help        Show usage text and quit  -v|--version     Show version number and quit  -V|--verbose     Make the operation more talkative  -F|--force       Turn on force mode. eg: Overwrite configuration file  -w|--workdir     Specify bali running directory. (Position 0, default $PWD)  -a|--arch        Build arch: amd64 386 arm arm64  -t|--target      Build target: windows linux darwin ...  -o|--out         Specify build output directory. default '$PWD/build'  -d|--dest        Specify the path to save the package  -z|--zip         Create archive file (UNIX: .tar.gz, Windows: .zip)  -p|--pack        Create installation package (UNIX: STGZ, Windows: none)  --cleanup        Cleanup build directory  --no-rename      Disable file renaming (STGZ installation package, default: OFF)

使用方法

普通构建：

bali /path/to/project

创建 Tar.gz 压缩包：

bali /path/to/project -z

创建 STGZ 安装包，主要用于 Linux/macOS 平台：

bali /path/to/project -p

将安装包输出到指定目录：

bali /path/to/project -p -d /tmp/output# # bali /path/to/project -p -d/tmp/output# bali /path/to/project -p -d=/tmp/output# bali /path/to/project -p --dist=/tmp/output# bali /path/to/project -p --dist /tmp/output

Bali 构建文件格式

Bali 同时支持 TOML 或者 JSON 格式的项目文件，JSON 使用内置解析不支持注释，TOML 支持注释。Bali 构建文件有两种，一种是项目文件 bali.json(bali.toml)，通常在项目根目录下，用于也可以在其他目录创建此文件，运行构建时，通过 bali -w 或者 bali /path/to/buildroot 指定 bali.json 所在目录，也可以在那个目录下运行 bali；另一种构建文件是特定程序源码目录下的 balisrc.json(balisrc.toml) 文件，balisrc.json 所在目录应当存在 main 包，bali 通过解析 bali.json 的 dirs 解析 balisrc.json，与 cmake 的 add_subdirectory 指令类似。二者示例如下：

项目文件 bali.json:

{  // name 用于项目打包命名    "name": "bali",    // 用于打包的版本    "version": "1.0.0",    // bali 配置文件等    "files": [        {            "path": "config/bali.json",            "destination": "config"        },        {            "path": "LICENSE",            // 安装目录            "destination": "share",            // 安装/配置时重命名文件            "newname": "LICENSE.bali",            // 创建 STGZ 安装包时，不改名，即安装时如果存在相应文件则会覆盖，默认不会覆盖            "norename": true        }    ],    // 程序相对目录    "dirs": [        "cmd/bali"    ]}

项目文件 bali.toml:

# https://toml.io/en/name = "bali"version = "1.2.11"dirs = [    "cmd/bali", # dirs][[files]]path = "LICENSE"destination = "share"newname = "LICENSE.bali"norename = true

程序构建文件 balisrc.json:

{    // 二进制文件名称，不存在时使用目录名    "name": "bali",    // 描述信息，默认填充到 PE 文件版本信息的 FileDescription    "description": "Bali -  Minimalist Golang build and packaging tool",    // 安装目录    "destination": "bin",    // 版本信息，在 goflags 中，可以推导 $BUILD_VERSION    "version": "1.0.0",    // 二进制的符号链接，比如在 GCC/Clang 编译后，程序为 GCC-9 然后会创建 GCC  的符号链接。    "links": [        "bin/baligo"    ],    // Go 编译器的参数，这些参数会使用 ExpandEnv 展开    "goflags": [        "-ldflags",        "-X 'main.VERSION=$BUILD_VERSION' -X 'main.BUILDTIME=$BUILD_TIME' -X 'main.BUILDBRANCH=$BUILD_BRANCH' -X 'main.BUILDCOMMIT=$BUILD_COMMIT' -X 'main.GOVERSION=$BUILD_GOVERSION'"    ],    // 构建 Windows 目标，PE 文件的版本信息    "versioninfo": "res/versioninfo.json",    // 构建 Windows 目标，PE 文件的图标    "icon": "res/bali.ico",    // 构建 Windows 目标，PE 文件的应用程序清单    "manifest": "res/bali.manifest"}

程序构建文件 balisrc.toml:

name = "bali"description = "Bali - Minimalist Golang build and packaging tool"destination = "bin"version = "1.2.11"versioninfo = "res/versioninfo.json"icon = "res/bali.ico"manifest = "res/bali.manifest"links = ["bin/baligo"]goflags = [    "-ldflags",    "-X 'main.VERSION=$BUILD_VERSION' -X 'main.BUILDTIME=$BUILD_TIME' -X 'main.BUILDBRANCH=$BUILD_BRANCH' -X 'main.BUILDCOMMIT=$BUILD_COMMIT' -X 'main.GOVERSION=$BUILD_GOVERSION'",]

内置环境变量：

BUILD_VERSION 由 balisrc.json/balisrc.toml 的 version 字段填充
BUILD_TIME 由构建时间按照 RFC3339 格式化后填充
BUILD_COMMIT 由存储库（为 git 存储库时）的 commit id 填充
BUILD_GOVERSION 由 go version 输出（删除了 go version 前缀）填充
BUILD_BRANCH 由存储库（为 git 存储库时）的分支名填充

可以在 goflags 中使用其他环境变量。

versioninfo.json:

{	"FixedFileInfo": {		"FileVersion": {			"Major": 0,			"Minor": 0,			"Patch": 0,			"Build": 0		},		"ProductVersion": {			"Major": 0,			"Minor": 0,			"Patch": 0,			"Build": 0		},		"FileFlagsMask": "3f",		"FileFlags ": "00",		"FileOS": "40004",		"FileType": "01",		"FileSubType": "00"	},	"StringFileInfo": {		"Comments": "",		"CompanyName": "Bali Team",		"FileDescription": "Bali - Minimalist Golang build and packaging tool",		"FileVersion": "",		"InternalName": "bali.exe",		"LegalCopyright": "Copyright \u00A9 2021. Bali contributors",		"LegalTrademarks": "",		"OriginalFilename": "bali.exe",		"PrivateBuild": "",		"ProductName": "Bali",		"ProductVersion": "1.0",		"SpecialBuild": ""	},	"VarFileInfo": {		"Translation": {			"LangID": "0409",			"CharsetID": "04B0"		}	}}

Bali 整合了 goversioninfo，在目标为 Windows 时，能够将版本信息嵌入到可执行程序中，versioninfo 字段与 goversioninfo 项目类似，但更宽松，一些特定的值，比如版本，描述会使用 bali.json/balisrc.json 的值填充过去，icon/manifest 则会覆盖 versioninfo.json。

添加引用程序清单的好处不言而喻，比如 Windows 的 UAC 提权，Windows 10 长路经支持（即路径支持 >260 字符），Windows Vista 风格控件，TaskDialog，DPI 设置等都需要修改应用程序清单。

自举

通常在安装配置好 Golang 环境后，你可以按照下面的命令完成 Bali 的自举：

UNIX:

./script/bootstrap.sh

Windows:

# 使用 powershell 运行pwsh ./script/bootstrap.ps1# 或者在 cmd 中运行script/bootstrap.bat

感谢

Bali 自动添加版本信息到 PE 文件的功能离不开开源项目的贡献，在这里非常感谢 akavel/rsrc 和 josephspurrier/goversioninfo 两个项目的开发者和维护者。

Bali Github 组织和 Bali 自身的图标来源于 www.flaticon.com 制作者为 Smashicons。

鲜花

握手

雷人

路过

鸡蛋

该文章已有0人参与评论

请发表评论

全部评论

专题导读

More+

gitman-web: 面向Git的代码自动发布工具发布时间：2022-02-13

react-native-upload: 一键打包部署 android/ios APP到蒲公英、fir.im和App Store，拒 ...发布时间：2022-02-13

客服电话

电子邮件

baligo: Gitee 官方使用的极简 Golang 构建打包工具

Bali - 极简的 Golang 构建打包工具

功能

使用方法

Bali 构建文件格式

自举

感谢

请发表评论

全部评论

上一篇：

下一篇：

关于我们

产品与服务

解决方案

139-2527-9053