CMake@1 - CMake v1 任务

使用 CMake 跨平台生成系统进行生成。

语法

# CMake v1
# Build with the CMake cross-platform build system.
- task: CMake@1
  inputs:
    #workingDirectory: 'build' # string. Working Directory. Default: build.
    #cmakeArgs: # string. Arguments. 
  # Advanced
    #runInsideShell: false # boolean. Run cmake command inside shell. Default: false.
# CMake v1
# Build with the CMake cross-platform build system.
- task: CMake@1
  inputs:
    #workingDirectory: 'build' # string. Working Directory. Default: build.
    #cmakeArgs: # string. Arguments.
# YAML Syntax is not supported in TFS 2018.
# Use the classic designer to add and configure tasks.
# See the following Inputs section for details on the inputs that this task supports.

输入

workingDirectory - 工作目录
输入别名: cwd. string. 默认值:build

运行 cmake 时的当前工作目录。

如果指定相对路径,则它相对于存储库。 例如,如果指定 build,则结果与指定 $(Build.SourcesDirectory)\build的结果相同。

还可以指定存储库外部的完整路径,并使用 变量。 例如:$(Build.ArtifactStagingDirectory)\build

如果指定的路径不存在,CMake 会创建它。


cmakeArgs - 参数
string.

传递给 cmake 的参数。


runInsideShell - 在 shell 中运行 cmake 命令
boolean. 默认值:false

CMake 参数将像在 OS 特定 shell 内部一样进行处理。 它可用于处理参数字符串内的环境变量。


任务控件选项

除任务输入之外,所有任务都具有控制选项。 有关详细信息,请参阅 控件选项和常见任务属性

输出变量

无。

备注

使用此任务通过 CMake 跨平台生成系统进行生成。

如何实现为 Microsoft 托管代理启用 CMake?

Microsoft 托管的代理已安装 CMake,因此无需执行任何操作。 无需在 azure-pipelines.yml 文件中添加 CMake 的需求。

如何实现为本地代理启用 CMake?

  1. 部署代理

  2. 安装 CMake ,并确保将其添加到代理计算机上运行代理的用户的路径。

  3. 在 Web 浏览器中,转到“代理池”, 并添加 名为 cmake 并设置其值 yes的功能。

CMake 的工作原理是什么? 可以使用哪些参数?

要求

要求 说明
管道类型 YAML,经典版本
运行平台 代理、DeploymentGroup
需求 自承载代理必须具有与以下要求匹配的功能才能运行使用此任务的作业: cmake
功能 此任务不满足作业中后续任务的任何要求。
命令限制 任意
可设置变量 任意
代理版本 1.91.0 或更高版本
任务类别 生成