Documentation support#40
Conversation
Joannis
left a comment
Joannis
left a comment
There was a problem hiding this comment.
Great start. Thanks for kicking off this PR
| Swift on Android uses cross-compilation: you build on a macOS or Linux host, and the compiler produces native ARM or x86_64 binaries targeting Android. | ||
|
|
||
| ```shell | ||
| $ swift build --swift-sdk aarch64-unknown-linux-android28 |
There was a problem hiding this comment.
I hope to get this changed to --swift-sdk swift-6.3.2-RELEASE_android --triple aarch64-unknown-linux-android28 soon.
There was a problem hiding this comment.
Is that WIP somewhere? That would be a great improvement, and will be relevant for all the SDKs going forward.
There was a problem hiding this comment.
It's in trunk now, 😄 trying to get it into 6.3 here, swiftlang/swift-package-manager#9998.
|
|
||
| ## Overview | ||
|
|
||
| Swift on Android uses cross-compilation: you build on a macOS or Linux host, and the compiler produces native ARM or x86_64 binaries targeting Android. |
| |---|---| | ||
| | ARM64 | `aarch64-unknown-linux-android28` | | ||
| | ARM32 | `armv7-unknown-linux-androideabi28` | | ||
| | x86_64 | `x86_64-unknown-linux-android28` | |
There was a problem hiding this comment.
32bit x86 is also supported in the Android SDK bundled with the Windows installer
There was a problem hiding this comment.
None of us use that SDK, which doesn't even have any install instructions yet. I have asked those behind it to write some up.
There was a problem hiding this comment.
32bit x86 Android is almost completely non-existent. I think we should avoid any mention of it, even if the Windows SDK happens to still support it.
5 participants
This PR adds support for documenting Swift on Android.
It follows the pattern of Swift embedded, whose documentation source at:
https://github.com/swiftlang/swift-embedded-examples/tree/main/Sources/EmbeddedSwift/Documentation.docc
is published to:
https://docs.swift.org/embedded/documentation/embedded/
Instructions for building and previewing the documentation locally are in the README.md.