Xcode Builder for Visual Studio Code

Xcode Builder is a lightweight VS Code extension that lets you build, run and clean native iOS projects (*.xcodeproj / *.xcworkspace) without leaving your editor.

Features


▶ One-click Build / Run / Clean	Trigger common Xcode tasks directly from the side bar or Command Palette
📱 Device & Simulator picker	Lists both physical devices and simulators – including connection / boot state icons
⏸ Live cancel	While a job is running the ▶ icon becomes ⏸; click to cancel safely
📊 Progress feedback	Percentage & step text shown in VS Code's window progress banner
🖍 Colour-coded logs	Errors, warnings and info lines are styled automatically in a single output channel
🔔 Non-blocking notifications	Status-bar hints instead of intrusive pop-ups
🍏 Physical-device deployment	Uses `ios-deploy` to install / launch on USB-connected devices
🌐 Built-in localisation	UI strings available in English & Turkish (auto-detect or manual override)

Installation

Marketplace (recommended)

Open the Extensions view (⇧⌘X).
Search for "Xcode Builder".
Click Install.

Manual via VSIX

# create the package
npm install -g @vscode/vsce   # once
vsce package                  # → xcode-builder-<version>.vsix

# install locally
code --install-extension xcode-builder-<version>.vsix

Requirements

macOS with Xcode 15 + (Command Line Tools included)
ios-deploy for physical-device deployment

brew install ios-deploy

Getting Started

Select Project – choose a *.xcodeproj or *.xcworkspace from the side bar.
Select Device – pick a simulator or connected device (defaults to last used simulator).
Run / Build / Clean – click the action: progress & logs stream in real time.
Cancel – click ⏸ to stop the current task gracefully.

Commands

Command	Description
Select Project	Pick the project / workspace to operate on
Select Device	Quick-pick of simulators and physical devices
Run Project	Build & launch on the selected destination
Build Project	Build only
Clean Project	Execute `xcodebuild clean`
Clean & Build Project	Sequential clean → build
Cancel	Abort the active process
Change Language	Force UI language (English / Turkish / Auto)

Run any command from:

the Actions view in the side bar, or
the Command Palette (⇧⌘P) by typing its name.

Configuration

Setting	Description	Default
`xcodeBuilder.language`	UI language: `auto`, `en`, or `tr`. Changing the value prompts to reload the window.	`auto`

No further configuration is required – everything else "just works".

License

MIT License – see LICENSE for details.

XcodeBuilder

ahmet