project - 项目名称

顶层节点 project，定义了本仓库所属的项目名称。

节点属性

属性	内容	说明
是否可选	是	若不使用多仓库/多项目协同特性，可以省略该节点。
取值类型	字符串	-
取值范围	任意有效 YAML 字符串	-

节点说明

通过指定 project，你可以使得多个仓库归属于同一个 Catboy 项目。

当你只是工作于单一的 C/C++ 项目时，可以省略该节点。

多仓库/多项目协同 v2.1.3+

Catboy 提供多仓库以及多项目协同的高级功能。允许你在 Catboy 构建蓝图中轻松引用定义在其他仓库，或是其他项目内的配置及路径。

project: my-awsome-app
targets:
  my-app:
    build:
      includes:
        - "@my-lib/headers" # 将目标 "my-lib" 源码目录下的 "headers" 目录加入
                            # 到头文件搜索路径。Catboy 会自动发现同属于一个项目
                            # "my-awsome-app" 之下，目标 "my-lib" 的源码目录。

当你在构建蓝图中引用其他仓库中定义的配置或是路径时，必须填写 project 的值，声明当前仓库所归属的项目。 Catboy 依赖项目名称进行项目发现于依赖解析。

项目发现流程，以及推荐的项目目录结构，请参考 项目发现。