Xcode run configurations
Paid featureNoctule provides three types of run configurations for Xcode:
Common settings
Some settings are shared by all types of Xcode run configurations. They are documented only once here.
- Toolchain
- The toolchain to use for building and deployment. This has to be an Xcode toolchain. By default, the project-wide toolchain is used.
- Project or workspace
- The Xcode project or workspace to use. The other settings like “scheme” depend on this setting and are updated to only show what’s available in the selected Xcode workspace or project.
- Scheme or target
- The scheme or target to build. Xcode workspaces only support schemes. For Xcode projects, the available schemes and targets are shown in the same box.
- Configuration
- Override the configuration (e.g. “Debug”) if you don’t want to use the default specified by the selected scheme or target.
- Destination
- Optional setting to define the destination. The button on the right of this control lets you choose one of the destinations available in the workspace or project. You can also enter your own destination value if you like.
- Xcode Build Settings
- These settings configure the command line of the executed
xcodebuildcommands. - Quiet build
- Allow provisioning updates
- Skip package updates
- Skip package plugin validation
- Skip package signature validation
- Skip macro validation
- Additional parameters
lets you pass your own additional parameters to
xcodebuildcommands
If you would like to skip
xcodebuildbefore you run the tests, remove “Build with Xcode” from the “Before launch” section.
Xcode simulator run configuration
Build and deploy an application to a simulator.
Running applications on physical devices isn’t supported yet. It’s planned for a later version of Noctule.
Settings
These settings are available for Xcode simulator run configurations in addition to the common settings above.
- Simulator Settings: Application arguments
- Arguments passed to the built application when it’s launched inside the simulator.
- Simulator Settings: Application environment
- Environment variables that are made available to the application launched inside the simulator.
- Before launch
- By default, the application to deploy is built before it’s deployed into the simulator. Remove the step “Build with Xcode” here to deploy what’s already on disk, without building it again.
Xcode test run configuration
Since Noctule 4.0Run the tests of a scheme with xcodebuild test on macOS.
The results of XCTest and Swift Testing are shown in the test tree of your IDE.
xcodebuild only runs the tests of a scheme, so choose a scheme rather than a target.
Choose a simulator as the destination, because a generic destination like “Any iOS Simulator Device” only builds.
Settings
These settings are available for Xcode test run configurations in addition to the common settings above.
- Test plan
- The test plan to run. By default, the default test plan of the scheme is used.
- Environment variables
- Environment variables that are passed to the tests.
- Test Options
- Parallel testing and Code coverage use the setting of the scheme or turn it on or off.
- Test iterations runs the tests several times; 0 uses the number defined by the scheme.
- Collect diagnostics of failed tests collects the logs and screen recordings of failed UI tests. This may delay the end of the run by minutes and is turned off by default for that reason.
- Repeat only failed tests repeats only the tests that failed.
- Test Inclusion and Exclusion
- Only testing
runs only the listed tests, and Skip testing
leaves out the listed tests.
Tests are identified like
Target,Target/ClassorTarget/Suite/test(). All tests run if the list is empty. - Before launch
- By default, the tests are built before they are executed. Remove the step “Build with Xcode” here to run what’s already on disk, without building it again.
Xcode build run configuration
Execute xcodebuild in the selected Xcode workspace or project.
This is especially helpful in compound run configurations or as a “Before launch” step of other run configurations in your project.
Settings
These settings are available for Xcode build run configurations in addition to the common settings above.
- Program arguments
- Additional arguments that are passed to the
xcodebuildcommand. - Environment variables
- Additional environment variables that are passed to the
xcodebuildcommand.