Skip to content
xcross
Documentation menu

Installation

Install xcross on Windows or Linux with a one-line installer.

The installer downloads the latest release, adds xcross to PATH, and lists anything missing. Builds ship for Windows x64 / ARM64 and Linux x64 / arm64. On Windows on ARM it picks the native ARM64 build, even from an emulated x64 PowerShell.

irm https://raw.githubusercontent.com/arxdeus/xcross/main/install.ps1 | iex

Then

  1. 1
    Install prerequisites
    $xcross setup
    On Linux, Swift 6.4+ first. On Windows it can install Swift for you. See Requirements.
  2. 2
    Extract the iOS SDK
    $xcross sdk install ~/Downloads/Xcode.xip
    Once per Xcode archive. Open a new terminal first so the new PATH applies.
  3. 3
    Verify
    $xcross flutter doctor
    Or xcross compose doctor in a Gradle project.

Watch it

Where it goes

HostLocationOverride
Windows%LOCALAPPDATA%\xcross\bin$env:XCROSS_INSTALL_DIR
Linux/usr/local/bin/xcrossINSTALL_DIR

Pin a version with XCROSS_VERSION=v2.0.2 on either host.

Verify a release

Every archive carries a SLSA build provenance attestation tying it to the commit it was built from. SHA256SUMS.txt sits next to the archives for plain integrity checks.

gh attestation verify xcross-linux-x64.tar.gz \
  --repo arxdeus/xcross \
  --signer-workflow arxdeus/xcross/.github/workflows/release.yml

Update, completion

xcross update                      # verified self-update
xcross completion >> ~/.bashrc     # or ~/.zshrc
ESC