AgentSkillsCN

use-build-py

使用build.py构建garnet项目，而非直接调用cmake。在构建项目、编译代码，或当用户请求构建、制作或运行cmake时使用。

SKILL.md
--- frontmatter
name: use-build-py
description: Builds the garnet project using build.py instead of invoking cmake directly. Use when building the project, compiling, or when the user asks to build, make, or run cmake.

Garnet build (build.py)

When to use

Use build.py (or alias b) for any garnet build. Do not run cmake directly from the project root.

Prerequisites: Python virtual environment

You must set up and activate the project’s Python virtual environment before running the build script. The environment scripts below create the venv (e.g. env/.pyvenv) if missing, activate it, and install dependencies from env/requirements.txt.

Commands (run from repo root)

Linux / WSL: Source the environment (sets up/activates venv), then build.

bash
source env/garnet.rc
build.py <variant> [options]

Windows (PowerShell): Run the garnet script (sets up/activates venv), then use the build alias.

powershell
. env\garnet.ps1
b <variant>

Variants

ShortLongCMake build type
ddebugDebug
pprofileRelWithDebInfo
rreleaseRelease

Common options

  • •Clang (Linux): build.py --clang d (or p, r)
  • •Android: build.py -a d (or -a p, -a r). Requires ANDROID_SDK_ROOT, ANDROID_NDK_ROOT, JAVA_HOME (or use Android docker).

Examples

Always activate the environment first (this sets up the Python venv if needed), then build:

bash
source env/garnet.rc
build.py d              # Debug build (GCC on Linux)
build.py --clang d      # Debug with Clang
build.py -a d           # Android debug (needs NDK/SDK)

Verification

Build output goes under build/<system><suffix>/ (e.g. build/linux.d/). Success = cmake + compile finish without errors.