# gocd-zh

**Repository Path**: cd20/gocd-zh

## Basic Information

- **Project Name**: gocd-zh
- **Description**: 开源持续交付平台 GoCD 的中文支持版本。 
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-08
- **Last Updated**: 2025-08-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GoCD-zh 项目开发说明

这是一个 GoCD 的中文化项目。

本软件基于 [GoCD](https://github.com/gocd/gocd) 改编，原软件遵循 Apache License 2.0，修改部分包括：

1. 支持中文界面显示

## 开发说明

### 准备基本开发环境

### 0. 使用你喜欢的 IDE

本程序使用 Java，JavaScript,TypeScript，Ruby on Rails

#### 1. 查看 文件 `.tool_versions`, 安装项目开发所需要的基本环境

```bash
cat .tool_versions
```

你可以看到类似如下信息：

```bash
# Configuration for https://mise.jdx.dev/ or https://github.com/asdf-vm/asdf as an alternative to jabba, sdkman, rvm, nvm etc
java temurin-21.0.8+9.0.LTS
nodejs 22.18.0
```

#### 2. 安装所需要的 Java 对应版本

你可以使用 [sdkman](https://sdkman.io/install) 和 [nvm](https://github.com/nvm-sh/nvm) 来分别管理 Java 和 nodejs 的本地版本。

```bash
# 安装 sdkman
curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"
sdk version

```

#### 3. nodejs 版本控制

1. 安装 nvm

```bash
# 安装nvm
# 此安裝腳本會將 nvm repo clone 到 ~/.nvm，並且將 source line 新增至你的 profile 設定 ( ~/.bash_profile、~/.zshrc、~/.profile 或 ~/.bashrc )
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

```

2. 指定项目所用的 nodejs 版本

项目根目录下有文件我，名为 .nvmrc ， 写入我们需要的 nodejs 版本号

```bash
# file .nvmrc
v20.18.0
```

3. 在项目目录指定所用的 nodejs 版本

在终端命令行中,进放项目根目录，运行下面的命令:

```bash
cd gocd-zh
nvm use
```

### MacOS 如何构建项目的产物

```bash
unset GEM_HOME GEM_PATH
./gradlew clean :installers:agentGenericZip :installers:serverGenericZip
```

这会在 `installers/target/distributions/osx` 目录中生成 `go-agent-[version-number]-osx.zip` 和 `go-server-[version-number]-osx.zip` 两个文件。

### 如何运行项目产物

#### 1. 使用可执行文件运行 go-server

```bash

cd installers/target/distributions/zip
unzip go-server-*.zip

# 运行 gocd server, version-number should like 25.3.0
./go-server-[version-number]/bin/go-server console
```

#### 2. 使用可执行文件运行 go-agent

```bash
cd installers/target/distributions/zip
unzip go-agent-*.zip
# 进入解压后的目录
cd ./go-agent-[version-number]
./bin/go-agent console
```

### 查看有多个 gradle projects

```bash
# 查看所有项目
./gradlew projects

# 查看特定项目的任务
./gradlew :server:tasks

# 查看特定项目的依赖
./gradlew :server:dependencies

# 构建特定项目
./gradlew :server:build

# 运行测试
./gradlew :server:test
```

### 如何运行自动化测试

可自行通过 `./gradlew projects` 和 `./gradlew tasks` 查看

```bash
./gradlew fastUnitTest
./gradlew :server:check         # Runs all checks.
./gradlew :server:fastUnitTest  # Runs the fast unit tests.
./gradlew :server:integrationTest # Runs the integration tests.
./gradlew :server:sharedTest # Runs the functional tests.
./gradlew :server:test - Runs the test suite.
```

## 如何使用中文界面

### 方式 1 修改配置文件（推荐）

```bash
# 编辑 wrapper-config/wrapper-properties.conf
# 设置GoCD界面语言为中文
# 可选值: zh, zh-CN (中文), en (英文，默认)
wrapper.java.additional.100=-Dgocd.ui.language=zh
```

### 方式 2：JVM 参数

```bash
java -Dgocd.ui.language=zh -jar go-server.jar
```