命令

build

carbin build 编译一个包，但不安装它。这对于使用原始cmake很有用，因为它将使用由carbin初始化的cmake工具链，该工具链设置了cmake以便轻松找到carbin安装的依赖项。如果可用，这还将在 dev-carbin_deps.txt 文件中安装依赖项，否则将安装 carbin_deps.txt 中的任何依赖项。

<package-source>

这指定将构建的包源(见 源码安装 )。

-p, --prefix PATH

设置安装包的前缀。这默认为当前工作目录中名为 carbin 的目录。这也可以通过 CARBIN_PREFIX 环境变量覆盖。

-v, --verbose

启用详细模式。

-B, --build-path PATH

设置构建包时使用的构建目录的路径。

-t, --test

在构建后测试包。这将设置 BUILD_TESTING cmake变量为true。它将首先尝试运行 check 目标。如果失败，它将调用 ctest 尝试运行测试。

-c, --configure

配置cmake。这将运行 ccmake 或 cmake-gui ，以便设置cmake变量。

-C, --clean

删除构建目录。

-P, --path

显示构建目录的路径。

-D, --define VAR=VALUE

传递给CMake的额外配置变量

-T, --target TARGET

要构建的Cmake目标。

-y, --yes

确认所有问题。

-G, --generator GENERATOR

设置CMake要使用的生成器。

--debug

构建包的调试版本。

--release

构建包的发布版本。

clean

carbin clean 将清除由carbin使用的目录。这将删除已安装的所有包以及任何工具链设置。

-p, --prefix PATH

设置安装包的前缀。这默认为当前工作目录中名为 carbin 的目录。这也可以通过 CARBIN_PREFIX 环境变量覆盖。

-v, --verbose

启用详细模式。

-y, --yes

确认所有问题。

ignore

这将忽略一个包，因此如果安装命令或依赖项请求包，则将视为已安装。这对于忽略可能已由系统安装的依赖项很有用。

<package-name>

这是要忽略的包的名称。

-p, --prefix PATH

设置安装包的前缀。这默认为当前工作目录中名为 carbin 的目录。这也可以通过 CARBIN_PREFIX 环境变量覆盖。

-v, --verbose

启用详细模式。

init

这将初始化cmake工具链。默认情况下，如果不存在cmake工具链，则 install 命令将初始化一个cmake工具链。这允许设置不同的变量，例如设置C++编译器或标准版本。

-p, --prefix PATH

设置安装包的前缀。这默认为当前工作目录中名为 carbin 的目录。这也可以通过 CARBIN_PREFIX 环境变量覆盖。

-v, --verbose

启用详细模式。

-B, --build-path PATH

设置构建包时使用的构建目录的路径。

-t, --toolchain FILE

设置要使用的cmake工具链文件。

--cc COMPILER

设置c编译器。

--cxx COMPILER

设置c++编译器。

--cflags FLAGS

设置额外的c标志。

--cxxflags FLAGS

设置额外的c++标志。

--ldflags FLAGS

设置额外的链接器标志。

--std TEXT

设置C++标准(如果可用)。

-D, --define VAR=VALUE

传递给CMake的额外配置变量。

--shared

设置工具链默认构建共享库。

--static

设置工具链默认构建静态库。

install

可以使用 install 命令安装包。安装包时，carbin 使用cmake配置一个构建目录，然后构建 all 目标和 install` `目标。因此，本质上，``carbin 将在包上运行这些命令以安装它:

mkdir build
cd build
cmake -DCMAKE_TOOLCHAIN_FILE=$CARBIN_PREFIX/carbin/carbin.cmake -DCMAKE_INSTALL_PREFIX=$CARBIN_PREFIX ..
cmake --build .
cmake --build . --target install

但是， carbin 将始终在源外创建构建目录。 carbin.cmake 是一个由 carbin 设置的工具链文件，因此cmake可以找到已安装的包。还可以添加关于工具链的其他设置(见 init )

<package-source>

这指定要安装的包源(见 pkg-src_cb )。如果未提供包源，则 carbin 将默认使用 carbin_deps.txt 文件或 dev-carbin_deps.txt 文件(如果可用)。也就是说，carbin install 等同于 carbin install -f carbin_deps.txt 或 carbin install -f dev-carbin_deps.txt 。

-p, --prefix PATH

设置安装包的前缀。这默认为当前工作目录中名为 carbin 的目录。这也可以通过 CARBIN_PREFIX 环境变量覆盖。

-v, --verbose

启用详细模式。

-B, --build-path PATH

设置构建包时使用的构建目录的路径。

-U, --update

更新包。这将重新构建包，即使已经安装，并用新构建的包替换它。

-t, --test

在安装前测试包。这将设置 BUILD_TESTING cmake变量为true。它将首先尝试运行 check 目标。如果失败，它将调用 ctest 尝试运行测试。

--test-all

在安装前测试所有包及其依赖项，通过运行ctest或check目标。

-f, --file FILE

安装文件中列出的包。

-D, --define VAR=VALUE

传递给CMake的额外配置变量。

-G, --generator GENERATOR

设置CMake要使用的生成器。

-X, --cmake

这指定要用于构建库的替代cmake文件。这对于没有cmake文件的包很有用。

--debug

安装包的调试版本。

--release

安装包的发布版本。

list

这将列出所有已安装的包。

-p, --prefix PATH

设置安装包的前缀。这默认为当前工作目录中名为 carbin 的目录。这也可以通过 CARBIN_PREFIX 环境变量覆盖。

-v, --verbose

启用详细模式。

pkg-config

这将运行pkg-config，但将在carbin目录中搜索pkg-config文件。这对于在不使用cmake的情况下查找依赖项很有用。

-p, --prefix PATH

设置安装包的前缀。这默认为当前工作目录中名为 carbin 的目录。这也可以通过 CARBIN_PREFIX 环境变量覆盖。

-v, --verbose

启用详细模式。

remove

这将删除一个包。如果其他包依赖于要删除的包，则这些包也将被删除。

<package-name>

这是要删除的包的名称。

-p, --prefix PATH

设置安装包的前缀。这默认为当前工作目录中名为 carbin 的目录。这也可以通过 CARBIN_PREFIX 环境变量覆盖。

-v, --verbose

启用详细模式。

-y, --yes

确认删除。

-A, --all

选择所有已安装的包。

-U, --unlink

取消链接包，但不删除它。 install 命令可以用于重新链接包。