swift-v5

Build Embedded Swift programs for VEX!

swift-v5 is a command line tool that simplifies the development process for Embedded Swift programs targeting the VEX V5 platform.

Installation

Install via shell script

Works best for Unix systems: macOS, Linux

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/vexide/swift-v5/releases/latest/download/swift-v5-installer.sh | sh

Install via Homebrew

Works best for people who have Homebrew installed

brew install vexide/vexide/swift-v5

Install via powershell script

Works best for Windows

irm https://github.com/vexide/swift-v5/releases/latest/download/swift-v5-installer.ps1 | iex

Install via cargo binstall

Works on all platforms but you need cargo-binstall installed

cargo binstall swift-v5 --git "https://github.com/vexide/swift-v5"

Build from source

Works on all platforms but it takes a long time

cargo install --git "https://github.com/vexide/swift-v5"

Usage

swift-v5 can manage the Arm Toolchain for Embedded version your Swift project uses. Run swift v5 install to download the latest version of the toolchain.

You can also make place a config file named v5.toml next to your Package.swift to specify which version of the toolchain swift-v5 should download:

# v5.toml

llvm-version = "20.1.0"

Uninstall

If you installed swift-v5 using the shell or powershell scripts above, you can remove it by running this command in your Unix shell:

rm ~/.local/bin/swift-v5 ~/.config/swift-v5/swift-v5-receipt.json

Or by running this in PowerShell:

rm ~\.local\bin\swift-v5 "$env:LOCALAPPDATA\swift-v5\swift-v5-receipt.json"