# Keil Build

> Keil Project Compilation

- Skill: `changde-tang/keil-build` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add changde-tang/keil-build`
- Raw SKILL.md: https://api.skillmd.com/api/skills/changde-tang/keil-build/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: changde-tang (https://skillmd.com/u/changde-tang)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/changde-tang/keil-build

---


# Keil Project Compilation

Invoke `py_keil_build.py` to compile projects via Keil UV4 command-line interface, and return structured build results.

## Tool Script

**Script Path**: `py_keil_build.py`
**Dependencies**: Python 3.x standard library + Installed Keil MDK (with UV4.exe)

## Usage

```bash
# Incremental build (default)
python py_keil_build.py -p <project.uvprojx>

# Full rebuild (clean rebuild)
python py_keil_build.py -p <project.uvprojx> -r

# Specify UV4.exe path
python py_keil_build.py -p <project.uvprojx> -k "D:\keil\UV4\UV4.exe"
```

## Parameter Description

| Parameter      | Short | Description                | Default                               |
| -------------- | ----- | -------------------------- | ------------------------------------- |
| `--project`    | `-p`  | `.uvprojx` file path      | **Required**                          |
| `--keil`       | `-k`  | UV4.exe path               | `D:\application\keil_v5\UV4\UV4.exe` |
| `--rebuild`    | `-r`  | Full rebuild              | Incremental build                     |

## Output Structure

Returns JSON format result:

```json
{
  "status": "success",       // "success" or "failed" or "error"
  "log_path": "C:\\project\\Objects\\GD32F303RCT6.build_log.htm",  // 编译日志路径
  "errors": 0,                // 编译错误数
  "warnings": 3               // 编译警告数
}
```

## Notes

- Keil default installation path: `D:\application\keil_v5\UV4\UV4.exe`, if different please specify with `-k`
- Build output is printed directly to terminal (no log file generated)
- Build success is determined by checking if `*build_log*.htm` exists after compilation
  - First checks: `<project_dir>\Objects\*build_log*.htm`
  - Falls back to searching recursively in project directory

## Typical Workflow

1. First use `keil-parser` to confirm project configuration is correct
2. Call this tool to build, check if `errors_count` is 0
3. After successful build, use `jlink-download` to flash firmware