Cross-compilation SDKs for Android

There are now Swift 5.4 cross-compilation SDKs for AArch64, armv7, and x86_64 available, which you can use with a prebuilt Swift toolchain to cross-compile packages like swift-crypto or swift-system for Android with the Swift package manager.

Instructions on building and testing those packages on an Android device or emulator are in the README. Building with these SDKs is primarily tested on linux, but using them on Mac or Windows should be possible too.

I have set up a daily CI on github Actions that builds latest trunk of five Swift packages for all three architectures, then runs their tests for Android x86_64 in an emulator.

I plan to set up the same for the 5.5 branch snapshots and trunk, which will build the latest Swift SDK from source before testing it. I will also add some Swift scripts to automate the configuration of the SDK and building it.

Any suggestions of Swift packages to add to this Android CI are welcome, and you could use the CI script as an example to build or test packages yourself. Right now, the largest package tested on the CI is Swift NIO, which is about 60k lines of Swift code, about half tests.

I have also put out a Swift 5.4 toolchain that runs on Android in the Termux app, which can be used on Chromebooks that support running Android apps too.

19 Likes

With the release of Android NDK 23 a couple weeks ago, I've put together Swift 5.4.2 cross-compilation SDKs that can be used with this latest NDK.

The daily CI now builds the latest trunk commit of 11 Swift packages against all three Swift toolchains, ie 5.4.2 and the 5.5 and trunk snapshots, for the three Android architectures to make sure everything is still working. A few tests and packages are currently disabled from that matrix, for example, Swift NIO is only built by 5.4 because its tests currently can't be built by the 5.5 and trunk toolchains because of compiler regressions, which is reproducible on linux.

Building an Android SDK yourself is now easy because I added a Swift script to automate most of the setup. I will add a couple more Swift executables next, to similarly automate getting the Android SDK configured in your local environment.

Please report any problems by opening an issue on that github repo.

9 Likes

You might already have considered and rejected this, but it sounds like maybe the Source Compatibility Suite could be useful here?

That would be a good place to get ideas for Swift packages to add, but I doubt I will add server-oriented packages like Vapor. Some of the client-side packages make sense, but I may not need or be familar with them myself, pulls welcome.

As you can see with this pull adding two Swift packages, it is pretty easy. I need to switch the Android emulator to run on macOS soon, as it runs without hardware acceleration on linux in the github-provided CI VMs so the 11 testsuites take 90-120 mins. on there, as opposed to several mins. on my Android AArch64 phone.

2 Likes

I've added cross-compilation SDKs for Swift 5.5, which work with the latest Android NDK 23.

There is also a Swift 5.5 toolchain that runs natively on Android in the Termux app, which now includes a sourcekit-lsp package for the first time. Simply install that app on an Android phone or tablet, run pkg install swift sourcekit-lsp, and you can use sourcekit-lsp from the LSP-compatible editor of your choice.

I haven't tested it extensively, but simple things like jumping to the definition of a symbol in the same Swift file appear to work. Thanks to @blangmuir and everyone else who contributed to sourcekit-lsp.

You can also use this Swift toolchain on most Chromebooks, as most of them support installing Android apps these days, so you can install Termux and Swift on there too.

8 Likes

Android cross-compilation SDKs for Swift 5.6 are now available. The AArch64 SDK will not work with a fraction of devices running Android 11 or newer, because Android AArch64 is currently rolling out memory tagging. As I note in this SDK doc, I have submitted a fix and will update the AArch64 SDK once that is in the prebuilt Swift compiler.

Native builds of the Swift 5.6 toolchain that run on Android in the Termux app should work for 64-bit platforms, but cannot be built for 32-bit armv7 right now, because of some compilation issue that crept in last year. I'm guessing this is true when building the Swift compiler for all 32-bit platforms, as I doubt this is specific to Android armv7. I'll investigate further and update the Swift toolchain for Termux soon.

10 Likes

Awesome work Buttaface, just wanted to say thank you for posting this. I haven't had a chance to try this out yet but looking forward to trying the concurrency features on Android.

1 Like

I just put out Android SDKs for cross-compilation with the latest Android NDK 25b and the Swift 5.6.3 toolchain, the first release to include the fix for the Android memory tagging issue I mentioned six months ago. Thanks to the Swift devs who reviewed that pull and got it merged.

I've also updated the native Swift 5.6 toolchain that runs in the Termux app for Android, which is how I build and use Swift (my desk looks something like this, with an Android device driving a 2560X1600 monitor). I recently built one of the latest 5.7 source snapshots for Android, and while the AArch64 build works well, the 32-bit armv7 compiler still consistently crashes. I'm thinking about dropping support for running the Swift compiler on armv7 devices with 5.7, as I appear to be the only person still building the Swift toolchain for 32-bit devices.

6 Likes

Android cross-compilation SDKs for Swift 5.7 are now available.

Native builds of the Swift 5.7 toolchain that run on Android in the Termux app are also up. While the 32-bit ARM builds have been crashing for many months, I noticed that turning bootstrapping off, ie disabling the portions of the compiler written in Swift, got it to work again.

7 Likes