VS Code Extension
SimBuild
Build and install your iOS app to a chosen simulator directly from VS Code—no Xcode UI needed.
What it does
- Auto-detects `.xcodeproj` or `.xcworkspace` in your workspace.
- Lets you pick an iOS simulator and an Xcode scheme.
- Builds a simulator target via `xcodebuild` and installs it on the chosen simulator.
- Launches the installed app and streams build logs in a dedicated output panel.
Requirements
- macOS with Xcode installed (includes iOS Simulator).
- Xcode command line tools available (`xcode-select -p` resolves).
- `xcrun simctl` available (bundled with Xcode).
- Node.js 18+ (for developing/building the extension).
Install
- VSIX: install the packaged VSIX directly in VS Code.
- Local build: clone the repo, run
npm installthennpm run compile.
Quickstart
- Open the iOS project folder in VS Code that contains a `.xcodeproj` or `.xcworkspace`.
- Open the Command Palette (Cmd/Ctrl+Shift+P) and choose:`SimBuild: Build``SimBuild: Build and Run`
- On first run, select a scheme and a simulator device.
- Watch progress in the SimBuild output panel; it installs and launches the app when done.
Commands
simbuild.build
Build the current project.
simbuild.run
Build and run on a simulator.
simbuild.selectSimulator
Pick a simulator device.
simbuild.selectScheme
Pick a scheme.
simbuild.clean
Clean build artifacts.
Settings
{
"simbuild.defaultSimulator": "iPhone 15 Pro",
"simbuild.derivedDataPath": "./build",
"simbuild.showBuildTime": true
}simbuild.defaultSimulator"iPhone 15 Pro"
simbuild.derivedDataPath"./build"
simbuild.showBuildTimetrue
Development
- Install deps:
npm install - Compile once:
npm run compile - Watch mode:
npm run watch - Tests:
npm run test - Lint:
npm run lint
Troubleshooting
- Ensure
xcode-select -ppoints to an installed Xcode. - Ensure
xcrun simctl list devices available --jsonreturns devices. - If no schemes are found, open the project in Xcode once and mark schemes as shared.