Ninja 构建系统快速入门教程

1. 项目目录结构及介绍

在 https://github.com/martine/ninja.git 中，Ninja 的源代码目录结构大致如下：

• doc：存放项目的文档材料，包括 AsciiDoc 格式的手册。
• misc：杂项工具或者辅助脚本。
• src：核心源代码所在，包含了构建系统的实现。
• windows：Windows 平台相关的源代码和工具。

2. 项目的启动文件介绍

Ninja 的主要启动文件是 ninja 它位于编译后的二进制文件目录下（例如，在 Unix-like 系统上是 ./build-cmake/ninja，在 Windows 上可能是 .\build\Debug\ninja.exe）。这个可执行文件是 Ninja 构建系统的命令行界面，用于运行构建任务。典型的用法是在项目根目录下创建一个名为 build.ninja 的规则文件，然后执行 ninja 来构建目标。

要构建项目，只需在命令行中运行：

/path/to/ninja

如果有特定的目标想要构建，可以指定目标名称：

/path/to/ninja my_target

3. 项目的配置文件介绍

Ninja 使用 build.ninja 文件作为其构建定义文件。该文件描述了如何从源代码生成目标，包括依赖关系、构建规则和其他设置。build.ninja 文件通常由构建系统生成，比如 CMake 或 Meson，但也可以手动编辑。

一个简单的 build.ninja 示例可能如下所示：

# 定义变量
cc = /usr/bin/gcc
cflags = -Wall

# 输出目标
rule compile
    command = ${cc} ${cflags} -o $out $in

# 生成目标
build prog.o: compile prog.c
build prog: prog.o

在这个例子中，cc 和 cflags 是变量，compile 是一个构建规则，定义了如何使用 gcc 编译源文件。prog.o 和 prog 是通过规则生成的目标文件。

为了自动化构建过程，通常会使用更高层次的构建系统（如 CMake 或 SCons）来生成 build.ninja 文件，这样可以避免手动维护复杂的构建逻辑。

完成这些步骤后，你应该具备了启动和配置 Ninja 基础构建系统的知识。若需深入学习，建议阅读 doc/manual.asciidoc 文件，它提供了详细的官方指南。