TeamCity
 
7.0
You are viewing the documentation for an earlier version of TeamCity.
  1. TeamCity Documentation
  2. Administrator's Guide
  3. Managing Projects and Build Configurations
  4. Creating and Editing Build Configurations
  5. Configuring Build Steps
  6. Xcode Project

Xcode Project

Last modified: 20 April 2023

Since TeamCity 7.1 Xcode Project runner comes bundled with TeamCity. If you want to use it with TeamCity 7.0, you can install it as a Xcode Runner. Xcode Project runner supports both Xcode 3 (target-based build) and Xcode 4 (scheme-based build), provides structured build log based on Xcode build stages, detects compilation errors, reports tests from "xcodebuild", adds automatic agent requirements for appropriate version of tools installed (Xcode, SDKs, etc.) and reporting tools via agent properties. To run an Xcode build you should have one or more build agents running Mac OS X with installed Xcode 3 or 4.

Xcode Project Runner Settings



Setting

Build

Description

Path to the project or workspace

Path to the project file (.xcodeproj) or workspace file (.xcworkspace), should be relative to the checkout directory. For Xcode 3 build only path to the project is allowed.

Working directory

Specify the Build Working Directory.

Build

Select either target-based or scheme-based (for Xcode 4+ only) build.

Scheme

Scheme-based

Xcode scheme to build. List of available schemes is formed by parsing your project/workspace files in VCS. Press "Check/Reparse Project" button to show/refresh schemes list (make sure your "Path to the project or workspace" setting is correct before). Please note that scheme must be shared to be shown in the list (to check if your scheme is shared you should check if it is located under "xcshareddata" folder and not under "xcuserdata" one, and if "xcshareddata" folder is committed to your VCS; to check the latter you can use VCS tree popup near the "Path to the project or workspace" field). To know more about managing Xcode schemes please see Apple documentation.

Build output directory

Scheme-based

You can override the default path for the files produced in your build. To do it check "Use custom" checkbox and specify the path in the text field. Path should be relative to the checkout directory.

Target

Target-based

Xcode target to execute. List of available targets is formed by parsing your project files in VCS. Press "Check/Reparse Project" button to show/refresh targets list (make sure your "Path to the project" setting is correct before).

Configuration

Target-based

Xcode configuration. List of available configurations is formed by parsing your project files in VCS. Since configuration depends on the target, you must choose the target first. Press "Check/Reparse Project" button to show/refresh configurations list (make sure your "Path to the project" setting is correct before).

Platform

Target-based

You can choose either "iOS" or "Mac OS X" or "Simulator - iOS" or any other platform (if it is provided by agent) to build your project on.

SDK

Target-based

You can choose SDK to build your project with (list of available SDKs is formed according to the SDKs those are available on your agents). Since SDK depends on the platform, you must choose the platform first.

Architecture

Target-based

You can choose architecture to build your project with (list of available architectures is formed according to the architectures those are available on your agents). Since architecture depends on the platform, you must choose the platform first.

Build action(s)

Xcode build action(s). Default actions are "clean build", but you can specify any of "clean", "build", "test", "archive", "installsrc", "install" in any order.

Run tests

Uncheck this option if you just want to build your project and do not want to run tests.

Additional command line parameters

Any other command line parameters to be passed to "xcodebuild" utility.