What's new in SwiftWasm #3
Examples and guides
@hassan-shahbazi wrote a 3 part guide about his experience when integrating SwiftWasm apps within Go apps through Wasmer. He also published example code accompanying the articles on GitHub. It's a great introduction to SwiftWasm that doesn't assume much prior knowledge, and could be useful if you'd like to integrate binaries produced by SwiftWasm in a host application.
@johngarrett published an interactive "Swift, Wasm, and Algorithms" documentation page. It is a demo of the recently released Swift Algorithms package where you can tweak parameters for some of the functions and observe results directly in the browser. Not all of the functions are fully interactive now, but it's a great proof of concept for interactive documentation websites one could build with SwiftWasm. Its source code is available on GitHub.
Two new sections were added to the SwiftWasm book that clarify limitations of Foundation, and recommended ways to use XCTest with the SwiftWasm SDK.
@kateinoigakukun published a pure Swift implementation of a transformer for Wasm binaries. This resolves the issue with
BigInt incompatibility in Safari, as we can now integrate an appropriate transformation into our build pipeline in
WasmTransformer library is still at an early stage, but it shows that Swift is suitable for low-level code just as well as C/C++ or Rust.
In addition to the WasmTransfomer integration mentioned above,
carton test now passes the
--enable-test-discovery flag to
swift test by default, which means that you no longer need to maintain
XCTestManifests.swift files in your test suites.
Dockerfile was added to the
carton repository, and you can now run
carton in a Docker container, which also has the toolchain and other dependencies preinstalled. You can pull the Docker image with a simple command:
docker pull ghcr.io/swiftwasm/carton:latest
carton gained support for Ubuntu 20.04, and now also has a CI job to test compatibility with it during development. Similarly, a CI job for macOS Big Sur on Intel platforms was added as soon as GitHub Actions started providing appropriate CI images.
After these changes were merged
carton 0.7 was released and is now available via Homebrew on macOS.
After the release, @carson-katri merged a PR that greatly improves command-line experience with
carton test. It builds on his previous work on
carton dev with compiler diagnostics parsing and error highlighting. With this new change XCTest output is also parsed, reformatted, and highlighted in a nice summary view.
Thanks to the fact that
carton is now available in a Docker image, it can now be used in our
swiftwasm-action, which previously only contained the plain SwiftWasm toolchain without any additional tools. This action now invokes
carton test by default on a given repository during a GitHub Actions run, but you can customize it and call any other command. For example, you could run
carton bundle with
swiftwasm-action, and then use the
peaceiris/actions-gh-pages step to deploy the resulting bundle to GitHub Pages.
@Cosmo pointed out that SwiftUI apps should change almost the whole palette when switching between color schemes. As he discovered when working on his OpenSwiftUI and SwiftUIEmbedded projects, the implementation of the
Color type is much more subtle than we originally anticipated. This was resolved by @carson-katri in #291 and is now available in the
main branch. The plan is to merge a few more changes and bugfixes, and to tag a new release of Tokamak soon after that.
@owenv merged a PR to the Swift Driver project implementing WebAssembly toolchain support. This mirrors our existing C++ implementation in the legacy driver, and it's great that the new parts of the Swift compiler rewritten in Swift are going to support WebAssembly too. While Swift Driver isn't enabled in any toolchain by default, we're definitely going to enable it at some point in the future as soon as it seems to be stable enough for us.
SwiftPM and Swift Tools Support Core
@kateinoigakukun submitted a PR to SwiftPM that propagates the
-static-stdlib flag correctly to the compiler driver. After it was merged, we were able to remove a bit of code that generated SwiftPM destination files to ensure correct linking, and this is no longer needed thanks to the upstream changes.
@MaxDesiatov merged a PR to Swift TSC that adds
.wasm file extension to WebAssembly binaries produced by SwiftPM. This extension was previously missing, which didn't make it obvious enough that these binaries can't be run without passing them to an appropriate WebAssembly host.
In preparation for the 5.3.0 release of SwiftWasm, our macOS archives are now distributed as signed
.pkg installers. Also need to mention that the toolchain archive is now available for Ubuntu 20.04, and all archive files now have consistent naming that includes the full OS name and CPU architecture. This will make it much easier for us to distribute ARM64 builds and builds for other Linux distributions in the future.
Another change to be included in 5.3 snapshots would add
.wasm file extension to binaries reflecting aforementioned upstream PRs.
Additionally, we found that it's currently not possible to build C++ code that includes certain headers with SwiftWasm 5.3 snapshots. As some Swift libraries do have C++ targets as their dependencies, it would be great if this is fixed before SwiftWasm 5.3.0 is tagged.
We'll be using latest 5.3 snapshots in our apps and libraries for some time, and will tag 5.3.0 when we have enough confidence there are no major issues.
wasm-DEVELOPMENT-SNAPSHOT archives will continue to be tagged on a regular basis to serve as a preview of the next version of SwiftWasm, but are not recommended for general use.
A lot of the progress wouldn't be possible without payments from our GitHub Sponsors. Their contribution is deeply appreciated and allows us to spend more time on SwiftWasm projects. You can see the list of sponsors and make your contribution on the sponsorship pages of Carson Katri, Yuta Saito and Max Desiatov.
Thanks for reading! 👋