Building Xcode Projects#

Paid feature

Choose Scheme and Destination#

As with Xcode, you need to choose a scheme and a destination to work with the Xcode project.

Xcode’s command line tools don’t work without a scheme, and many operations either don’t work without a destination or produce unexpected results.

Execute Tools → Noctule → Initialize xcode-build-server after changing the scheme or destination. It’s planned to do this automatically in an update of Noctule. For now, this is only done if SourceKit-LSP is launched without an existing buildServer.json file.

Building an Xcode Project#

The standard build actions like Build → Build Project and Build → Rebuild Project work as usual.

If these actions don’t seem to build your Xcode project, please verify that Preferences… → Build, Execution, Deployment → Noctule → Run swift build or xcodebuild for project build tasks is enabled in your project. This setting is automatically enabled for projects imported from an Xcode project.

Noctule provides additional build menu items like “Build Xcode workspace …, scheme …” based on the focused file. This is only available if a scheme is selected in the main toolbar or at Tools → Noctule → Choose Xcode scheme.

If you would like to build something other than the current scheme, then use an Xcode build run configuration.