swiftwasm / swiftwasm-build

Patches, build scripts, and CI configuration for the SwiftWasm toolchain

SwiftWasm toolchain build

This repository contains the patches, build scripts, and CI configuration for the SwiftWasm toolchain.

Building the toolchain

$ mkdir swiftwasm-source
$ cd swiftwasm-source
$ git clone https://github.com/swiftwasm/swiftwasm-build
$ cd swiftwasm-build
# Install WebAssembly specific dependencies into ../build-sdk
$ ./tools/build/install-build-sdk.sh main
# Checkout the Swift repositories in the parent directory (swiftwasm-source) and apply patches
$ ./tools/git-swift-workspace --scheme main
# Build the toolchain (this will take a while)
$ ./tools/build/build-toolchain.sh main

See SwiftWasm book for more details about dependencies you need to install and how to build on Docker.

Project structure

• schemes/<scheme> - Scheme is the concept used in Swift's utils/update-checkout script to describe a set of build sources.
• schemes/<scheme>/manifest.json - The manifest file for the scheme, which describes the base source revisions to check out.
• schemes/<scheme>/swift - Patches to be applied on top of the checked out Swift repository. This is where the SwiftWasm-specific patches live. Most of them are ready to be upstreamed, but patches marked with HACK need modification or another solution.
• tools/git-swift-workspace - A tool to check out the Swift repositories and apply patches.
• tools/git-swift-update-patch - A tool to help daily patch maintenance.
• tools/build - Scheme agnostic build scripts.

Contributing

See docs/upstreaming.md for more details.