Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

从源码构建

go.mod 声明最低 Go 版本为 1.26.0,并通过 toolchain go1.27.3 指定首选工具链。使用默认的 GOTOOLCHAIN=auto 时,Go 会在需要时选择或下载该工具链。Go CLI 可以独立于 web/ 前端构建;生成的平台清单和嵌入的多语言资源已提交到仓库。

go build ./...
go build -o cjv ./cmd/cjv

在 Windows 上请使用 go build -o cjv.exe ./cmd/cjv。第一条命令检查所有 Go 包是否正常编译,第二条命令生成独立可执行文件。如果要把当前工作区的代码直接安装到 GOBIN,可以运行 go install ./cmd/cjv。

在本地交互式调试改动时,建议将 CJV_HOME 和 CJV_CONFIG_FILE 指向一个临时目录,这样既能完整测试 cjv init 和工具链安装,又不会影响本机已有的 cjv 环境:

mkdir -p /tmp/cjv-dev
CJV_HOME=/tmp/cjv-dev CJV_CONFIG_FILE=/tmp/cjv-dev/settings.toml ./cjv init --no-modify-path -y

版本信息与镜像构建

普通本地构建的版本号显示为 dev,并在运行时自动跳过自更新版本比较。正式发布时,GoReleaser 会通过 -ldflags 注入 main.version 和 main.updateURL;你在本地也可以显式注入版本号,或者使用 -tags=mirror 构建 GitCode 镜像版:

go build -ldflags "-X main.version=0.0.0-local" -o cjv ./cmd/cjv
go build -tags=mirror -o cjv-mirror ./cmd/cjv

mirror 构建标签会选择 internal/config/manifest_*.go 与 internal/selfupdate/update_*.go 中的 GitCode 默认版本清单地址和自更新实现。修改 config 或 selfupdate 的共享接口时,请务必同时验证普通版和 mirror 版两种构建。

交叉构建与生成文件

使用 Go 的标准平台环境变量(GOOS 与 GOARCH)即可交叉编译。以 Bash 为例:

GOOS=linux GOARCH=arm64 go build -o cjv ./cmd/cjv

发布平台清单统一定义在 internal/target/catalog.go 中,包括:

  • Linux:amd64、arm64
  • macOS(darwin):amd64、arm64
  • Windows:amd64
  • OpenHarmony(openharmony):amd64、arm64

修改平台清单后,请在仓库根目录运行:

go generate ./...

随后检查生成的 web/src/generated/platforms.ts 前端平台列表,并同步核对 .goreleaser.yml 发布配置和 CI 矩阵的一致性。构建后的行为验证见测试与检查。

OpenHarmony

编译 OpenHarmony 目标程序(GOOS=openharmony)需使用 Go-HMOS go1.27.2-hmos.5 提供的 Linux/amd64 工具链,并设置 CGO_ENABLED=0。此构建保持 GOTOOLCHAIN=local,避免首选工具链指令将定制的 Go-HMOS 切换为标准 Go。

在仓库根目录设置工具路径,先用主机 Go 构建代码签名工具,再交叉编译并签名鸿蒙可执行文件:

export GOENV=off GOTOOLCHAIN=local
export HMOS_GO=/absolute/path/to/go-hmos/bin/go
export HMOS_SIGN=/tmp/cjv-hmos-sign
go build -tags=hmos_sign -o "$HMOS_SIGN" ./scripts/harmonyos
GOOS=openharmony GOARCH=arm64 CGO_ENABLED=0 "$HMOS_GO" build -o cjv ./cmd/cjv
"$HMOS_SIGN" cjv cjv

构建 x64 版本时使用 GOARCH=amd64;构建镜像版时增加 -tags=mirror。

主机签名工具(scripts/harmonyos)复用 internal/ohos/selfsign,负责检查 ELF 结构与 Go 构建信息,写入并校验 .codesign 签名段。传入 --verify FILE... 可单独检查已有二进制产物。

正式发布通过 .goreleaser.yml 构建普通版与 mirror 版,鸿蒙产物在打包归档和生成校验和之前完成签名;而在鸿蒙宿主上运行 cjv 下载安装仓颉 SDK 时,则由 internal/dist 的系统钩子自动对解压出的原生可执行文件完成自签名。