TeamCity On-Premises 2024.03 Help

Xcode 项目

Xcode Project 构建运行程序支持 Xcode 3(基于目标的构建)、Xcode 4(基于方案的构建)、Xcode 5-13。

该运行器基于 Xcode 构建阶段提供结构化的构建日志,检测编译错误,通过 xcodebuild 工具报告测试,添加适当版本的已安装工具(Xcode,SDK 等)的自动代理要求,并通过代理属性报告工具。

使用不同的 Xcode 设置

  • 如果代理机器上只安装了一个 Xcode 版本,那么将默认使用它。 如果安装/更新了 Xcode,需要重启代理。

  • 如果安装了多个 Xcode 版本,请执行 以下操作之一

    • 在 Xcode 项目构建步骤设置中的“Path to Xcode”设置(见下文)中指定到所需版本的路径

    • 使用 xcode-select 工具选择默认的 XCode 发行版。
      Xcode 的路径: /Applications/Xcode.app/Contents/Developer
      切换命令: sudo xcode-select -s path_to_xcode_distribution

Xcode 项目运行器设置

设置

Build(构建)

描述

路径至项目或工作空间

到 ( .xcodeproj) 项目文件或 ( .xcworkspace) 工作区文件的路径,应相对于检出目录。 对于 Xcode 3 构建,仅支持项目文件的路径。

工作目录

指定 构建工作目录

Xcode 的路径

在代理上指定 Xcode 的路径。 构建将使用这个 Xcode 进行运行。

Build(构建)

请选择目标基础(用于项目)或方案基础(用于项目和工作区)的构建方式。 根据所选内容的不同,显示的设置也会有所不同。

方案

基于方案的

构建的 Xcode 方案。 可用方案的列表是通过解析您在 VCS 中的项目/工作空间文件来形成的。 确保您的 项目或工作区路径 设置正确,并点击 检查/重新解析项目 按钮来显示/刷新方案列表。 请注意,只有共享的方案才会在列表中显示(要检查您的方案是否已共享,确认其位于 xcshareddata 目录下,而非 xcuserdata 目录下,并且 xcshareddata 文件夹已提交至您的 VCS。 要检查后者,请在 项目或工作空间的路径 字段旁使用 VCS 树弹出菜单。 关于管理 Xcode 方案的更多信息,请参阅 Apple 文档

构建输出目录

基于方案的

检查 使用自定义 框,以覆盖由您的构建产生的文件的默认路径。 指定相对于检出目录的自定义路径。

目标

基于目标

执行的 Xcode 目标。 可用目标的列表是通过解析您的 VCS 中的项目文件来形成的。 确保您的 项目路径 设置正确,点击 检查/重新解析项目 按钮以显示/刷新目标列表。

配置

基于目标

Xcode 配置。 可用配置的列表是通过解析您在 VCS 中的项目文件而形成的。 由于配置取决于目标,您必须首先选择目标。 确保您的 项目路径 设置正确,然后点击 检查/重新解析项目 按钮来显示/刷新配置列表。

平台

基于目标

defaultiOSmacOSSimulator - iOS,或者任何其他平台(如果代理提供)中选择,以在其上构建您的项目。

SDK

基于目标

您可以选择一个 SDK 来构建您的项目(可用的 SDK 列表是根据您所选平台上代理中的可用 SDK 形成的)。

架构

基于目标

您可以选择一种架构来构建您的项目(可用架构的列表是根据您所选择的平台上的代理可用的架构来生成的)。

构建操作

Xcode 构建操作。 默认操作是 清理构建。 支持以下操作的空格分隔列表: 清理构建test归档installsrc安装 ;在执行过程中,操作的顺序将被保留。

除非您确定要更改操作的数量或顺序,否则不建议更改此字段。

运行测试

如果您想在项目构建后运行测试,请选择此选项。

附加命令行参数

将其他命令行参数传递给 xcodebuild 实用程序。

最后修改日期: 16日 7月 2024年