Set up Swift and iOS: Xcode command line tools, Swift Package Manager, simulators and device debugging, the Linux toolchain and common error fixes.
Install the Xcode command line tools on macOS, which include Swift; a full Xcode install is not needed for packages
xcode-select --install
xcodebuild -version
swift --versionBuilding iOS apps still requires the full Xcode from the App Store plus simulators
Switch the active Xcode path when several versions are installed
sudo xcode-select -s /Applications/Xcode.app/Contents/DeveloperInstall the system dependencies required by the official Swift toolchain on Linux
# Linux（Ubuntu 22.04 示例）
sudo apt update && sudo apt install -y binutils git gnupg2 libc6-dev libcurl4-openssl-dev libedit2 libgcc-11-dev libpython3-dev libsqlite3-0 libstdc++-11-dev libxml2-dev libz3-dev pkg-config tzdata zlib1g-devInstall SwiftLint and SwiftFormat to enforce style and formatting
# macOS
brew install swiftlint swiftformatManage multiple Swift toolchains with the official Swiftly on macOS/Linux
swiftly install latest
swiftly use latestMirror a single dependency for intranet or slow-network setups
swift package config set-mirror --original-url https://github.com/apple/swift-argument-parser --mirror-url https://gitee.com/mirrors/swift-argument-parserRemove a dependency mirror and restore the original URL
swift package config unset-mirror --original-url https://github.com/apple/swift-argument-parserSwiftPM fetches through git, so proxy settings belong in the global git config
git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890Clear git proxy settings after turning the proxy off to avoid clone timeouts
git config --global --unset http.proxy
git config --global --unset https.proxyConfirm the active developer directory, Swift version and simulator SDK version
xcode-select -p
swift --version
xcrun --sdk iphonesimulator --show-sdk-versionPin the Xcode path via an environment variable for CI and multi-version setups
echo 'export DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer' >> ~/.zshrcList available simulator devices and their state
xcrun simctl list devicesAccept the Xcode license once, otherwise command-line builds fail
sudo xcodebuild -license acceptCreate an executable package with SwiftPM and run it directly
mkdir hello && cd hello
swift package init --type executable
swift runBuild an optimized binary and run it; the path varies by platform
swift build -c release
.build/release/helloRun every XCTest in the package
swift testResolve and print the dependency tree to trace version conflicts
swift package resolve
swift package show-dependenciesBoot a specific simulator and open the Simulator app
xcrun simctl boot "iPhone 15"
open -a SimulatorInstall the official Swift extension in VS Code for completion, debugging and tests
code --install-extension swiftlang.swift-vscodeOpen a project in Xcode; for SwiftPM packages you can open Package.swift directly
open -a Xcode hello.xcodeprojRun tests on a simulator from the CLI, ready for CI
xcodebuild -scheme hello -destination 'platform=iOS Simulator,name=iPhone 15' testReset the developer directory when xcrun reports an invalid active developer path
xcode-select -p
sudo xcode-select --resetErase and reset simulators when they misbehave; this wipes simulator data
xcrun simctl erase allClear DerivedData when odd build errors persist in Xcode
rm -rf ~/Library/Developer/Xcode/DerivedDataReset and re-resolve when SwiftPM dependency state is corrupt
swift package reset
swift package resolveInspect signing information to debug device install failures and expired certificates
codesign -dv --verbose=4 /path/to/App.appCheck installed runtimes when the target simulator OS is missing
xcrun simctl list runtimesThis website uses cookies to ensure you get the best experience on our website. Privacy Policy.