# baligo

**Repository Path**: itwarcraft/baligo

## Basic Information

- **Project Name**: baligo
- **Description**: Gitee 官方使用的极简 Golang 构建打包工具
- **Primary Language**: Go
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 11
- **Created**: 2020-04-11
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Baligo - 使用 Golang 重新实现的 Bali

在开发基于 Golang 的项目时，虽然使用 `go build` 便可以简单的完成构建，但在打包等操作时，还是遇到了一些麻烦，因此，我实现了一个基于 PowerShell Core 开发的跨平台工具  [bali](https://gitee.com/ipvb/bali/tree/pwsh)，用来简化这一过程，最早在 2017 年，bali 诞生，而今已经到了 2020 年，我对项目构建打包也有了新的认识，因此为了改进基于 PowerShell 编写的 bali，因此在这个项目中使用 Golang 重写了 bali.

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

```txt
Bali - Minimalist build and packaging tool
usage: 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
  -c|--cwd         Build dir. (Position 0, default cwd)
  -a|--arch        Build arch: amd64 386 arm arm64
  -t|--target      Build target: windows linux darwin ...
  -o|--out         Build output dir. default '$CWD/build'
  -z|--zip         Create archive file after successful build
  -m|--mkstgz      After successful build, create STGZ installation package
  -d|--dist        STGZ/TarGz package distribution directory

```

## 使用方法

普通构建：

```shell
bali /path/to/project
```

创建 `Tar.gz` 压缩包：

```shell
bali /path/to/project -z
```

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

```shell
bali /path/to/project -m
```

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

```shell
bali /path/to/project -m -d /tmp/output
# # bali /path/to/project -m -d/tmp/output
# bali /path/to/project -m -d=/tmp/output
# bali /path/to/project -m --dist=/tmp/output
# bali /path/to/project -m --dist /tmp/output
```

## Bali 项目文件

Bali 项目文件有两种，包括项目根目录下的 `bali.json` 和项目特定程序下的 `balisrc.json` 文件，其示例如下：

`bali.json`:

```js
{
  // name 用于项目打包命名
    "name": "baligo",
    // 用于打包的版本
    "version": "1.0.0",
    // bali(pwsh) 使用 install. baligo 与之兼容，但优先使用 files. files 主要用于提示 bali 安装配置文件。
    "files": [
        {
            "path": "config/bali.json",
            "destination": "config"
        }
    ],
    // 提示 bali 如何查找程序目录，bali(pwsh) 使用 Dirs baligo 与之兼容。
    "dirs": [
        "cmd/bali"
    ]
}
```

`balisrc.json`:

```js
{
  // 二进制名称
    "name": "bali",
    // 二进制安装目录
    "destination": "bin",
    // 二进制版本信息，会被解析到 goflags 中
    "version": "1.0.0",
    // Goflags，每一条都会使用环境变量展开，BUILD_VERSION 对应 version, BUILD_TIME 则是本地时间的 RFC3339 格式
    // BUILD_GOVERSION 则是 go version 去除前缀
    // BUILD_COMMIT 项目的 git commit 信息，非 go 存储库时使用 None 替代。
    "goflags": [
        "-ldflags",
        "-X 'main.VERSION=$BUILD_VERSION' -X 'main.BUILDTIME=$BUILD_TIME' -X 'main.BUILDCOMMIT=$BUILD_COMMIT' -X 'main.GOVERSION=$BUILD_GOVERSION'"
    ]
}
```