xtool README

The project's README from github.com/xtool-org/xtool. As one markdown file: README.md.

xtool

Cross-platform Xcode replacement. Build and deploy iOS apps with SwiftPM on Linux, Windows, and macOS.

Overview

xtool is a cross-platform (Linux/WSL/macOS) tool that replicates Xcode functionality with open standards.

✅ Build a SwiftPM package into an iOS app

✅ Sign and install iOS apps

✅ Interact with Apple Developer Services programmatically

Getting Started

  1. Follow the guide to install xtool
  2. Create and run your first xtool-powered app by following the tutorial!

Examples

Screenshot

A screenshot of xtool being invoked from VSCode

Command line interface

$ xtool --help
OVERVIEW: Cross-platform Xcode replacement

USAGE: xtool <subcommand>

OPTIONS:
  -h, --help              Show help information.

CONFIGURATION SUBCOMMANDS:
  setup                   Set up xtool for iOS development
  auth                    Manage Apple Developer Services authentication
  sdk                     Manage the Darwin Swift SDK

DEVELOPMENT SUBCOMMANDS:
  new                     Create a new xtool SwiftPM project
  dev                     Build and run an xtool SwiftPM project
  ds                      Interact with Apple Developer Services

DEVICE SUBCOMMANDS:
  devices                 List devices
  install                 Install an ipa file to your device
  uninstall               Uninstall an installed app
  launch                  Launch an installed app

  See 'xtool help <subcommand>' for detailed help.

Library

xtool includes a library that you can use to interact with Apple Developer Services, iOS devices, and more from your own app. You can use this by adding XKit as a SwiftPM dependency.

// package dependency:
.package(url: "https://github.com/xtool-org/xtool", .upToNextMinor(from: "1.2.0"))
// target dependency:
.product(name: "XKit", package: "xtool")

xtool (xtool-org/xtool)

Searching Database…

11.9K ·GitHub
Xtool
What is this?xtool is a cross-platform tool that replicates Xcode's core functionality, letting you build, sign, and install iOS apps written as SwiftPM packages from Linux, Windows (via WSL), or macOS.
Is this a full IDE like Xcode, or just a command-line build tool?It's primarily a command-line tool for building, signing, and installing iOS apps built with SwiftPM, plus a bundled library (XKit) you can embed in your own tools to talk to Apple Developer Services.
How do I install and get started with xtool?Follow the platform-specific installation guide (one path for Linux/Windows, another for macOS), then follow the tutorial to create and run your first xtool-powered app.
Does it only work on macOS, or also on Linux and Windows?It runs on Linux, on Windows via WSL, and on macOS, covering all three as first-class install targets.
What exactly can xtool do with my SwiftPM package?It can build a SwiftPM package into an iOS app, then sign and install that app, covering the core build-and-deploy workflow Xcode normally handles.
What is XKit?XKit is the library underlying xtool that lets you programmatically interact with Apple Developer Services and iOS devices from your own app, added as a SwiftPM dependency.
Why would I use xtool instead of just using a Mac with Xcode?xtool lets developers on Linux or Windows build and ship real iOS apps without owning a Mac, using open standards instead of Xcode's proprietary toolchain.
What are similar projects?omarchy-apple-dev, SkeletonView, FSCalendar, AFNetworking, flutter_carplay, SwiftyJSON, Alamofire, CocoaPods
Which topics is it in?swift-package-manager, wsl, xcode, package-manager, mobile-development, swift, sdk, mobile, ios, command-line-tool, terminal, tool
Creator
xtool-org
Size
10.8 MB
Stars
11.9K
Updated
CommitOct 15Release1.22.2Oct 14
Age
1y
Commits · 90 Days