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。但我仍然觉得 Baligo 还有所欠缺，比如 Windows 平台不支持嵌入图标，版本信息，清单文件，因此这才有了新的 Bali 诞生。

注意：此项目目前已经合并了 https://github.com/balibuild/bali。

功能

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

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

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

Bali -  Minimalist Golang build and packaging tool
usage: ./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 选择了 JSON 作为文件格式，使用 JSON 的好处在于 Golang 内置支持解析，并且可以使用编辑器的格式化。Bali 构建文件有两种，一种是项目文件 bali.json，通常在项目根目录下，用于也可以在其他目录创建此文件，运行构建时，通过 bali -w 或者 bali /path/to/buildroot 指定 bali.json 所在目录，也可以在那个目录下运行 bali；另一种构建文件是特定程序源码目录下的 balisrc.json 文件，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"
    ]
}

程序构建文件 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"
}

内置环境变量：

BUILD_VERSION 由 balisrc.json 的 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 2020. 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。

Ayrz / baligo

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

功能

使用方法

Bali 构建文件格式

自举

感谢

简介

发行版

贡献者

近期动态

Ayrz / baligo .gitee-modal { width: 500px !important; }

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

功能

使用方法

Bali 构建文件格式

自举

感谢

简介

发行版

贡献者

近期动态

搜索帮助

Ayrz / baligo