using-xtoollisted

# Using xtool ## Overview xtool is a **cross-platform Xcode replacement** for building iOS apps with SwiftPM on Linux, Windows, and macOS. It is NOT XcodeGen, Tuist, or Xcode project files. ## Critical: xtool is NOT XcodeGen | xtool Uses | NOT These | |------------|-----------| | `xtool.yml` | `project.yml`, `Project.swift` | | `Package.swift` (SwiftPM) | Xcode project files | | `xtool dev` | `xtool build`, `xtool run`, `xtool generate` | | `Sources/` directory | `Extensions/` directory | ## Project Structure ``` MyApp/ ├── Package.swift # SwiftPM package definition ├── xtool.yml # xtool configuration ├── Sources/ │ ├── MyApp/ # Main app target │ │ ├── MyAppApp.swift │ │ └── ContentView.swift │ └── MyWidget/ # Extension target (if any) │ └── Widget.swift ├── MyApp-Info.plist # Optional custom Info.plist └── MyWidget-Info.plist # Required for extensions ``` ## Quick Reference: Commands ```bash # Project lifecycle xtool new MyApp # Create new project xtool new MyApp --skip-setup # Create without running setup xtool dev # Build + run (same as `xtool dev run`) xtool dev build # Build only xtool dev build --ipa # Build IPA file xtool dev run -s # Run on iOS Simulator (--simulator) xtool dev run -c release # Release build (--configuration) xtool dev run -u <udid> # Target specific device (--udid) xtool dev generate-xcode-project # G