Update instructions for Swift 6.2 SDK, ndk 27d, and add some wording tweaks

marcprux · marcprux · commit 00e2fe72e420 · 2025-10-02T14:58:29.000-04:00
diff --git a/documentation/articles/swift-android-getting-started.md b/documentation/articles/swift-android-getting-started.md
@@ -1,21 +1,21 @@
 ---
 layout: page
 date: 2025-06-01 12:00:00
-title: Getting Started with the Swift Android SDK
+title: Getting Started with the Swift SDK for Android
 author: [marcprux]
 ---
 
-Since it was first open-sourced in 2015, Swift has grown from a language focused on creating apps for Darwin based systems (iOS, macOS, etc.) into a cross-platform development language supporting Linux, Windows, and various embedded systems. With the release of the Swift Android SDK, it is now possible to use Swift for Android application development as well.
+Since it was first open-sourced in 2015, Swift has grown from a language focused on creating apps for Darwin-based systems (iOS, macOS, etc.) into a cross-platform development language supporting Linux, Windows, and various embedded systems. With the release of the Swift SDK for Android, it is now possible to use Swift for Android application development as well.
 
 ### Getting Started
 
-Building a Swift package for Android involves installing and configuring a cross-compilation SDK. Cross-compilation is the process of building code on one platform (the host) to run on a different platform (the target). In the context of Swift for Android, this typically involves compiling Swift code on a macOS or Linux machine (the host) to produce executables or libraries for Android devices (the target). This differs from compiling Swift for the host platform, where the host and target are the same (e.g., compiling and running Swift code on macOS for macOS).
+Building a Swift package for Android involves installing and configuring a cross-compilation SDK. Cross-compilation is the process of building code on one platform, the host, to run on a different platform, the target. In the context of Swift for Android, this typically involves compiling Swift code on a host macOS or Linux machine to produce executables or libraries for the target Android OS. This differs from compiling Swift for the host platform, where the host and target are the same (e.g., compiling and running Swift code on macOS for macOS).
 
 To cross-compile Swift code for Android, you need three separate components:
 
 1. **The Host Toolchain**: this is the `swift` command and related tools that you will use to build and run your Swift code.
-2. **The Swift Android SDK**: the set of libraries, headers, and other resources needed to generate and run Swift code for the Android target.
-3. **The Android NDK**: the "native development kit" for Android includes the cross-compilation tools like `clang` that are used by the host toolchain to perform compilation and linking. 
+2. **The Swift SDK for Android**: the set of libraries, headers, and other resources needed to generate and run Swift code for the Android target.
+3. **The Android NDK**: the "Native Development Kit" for Android includes the cross-compilation tools like `clang` and `ld` that are used by the host toolchain to cross-compile and perform linking.
 
 
 #### 1. Install the Host Toolchain
@@ -25,56 +25,56 @@ The first thing to note is that while `swift` may already be installed on your s
 The easiest and recommended way to manage host toolchains on macOS and Linux is to use the [swiftly](https://www.swift.org/swiftly/documentation/swiftly/getting-started) command. Once that has been setup, you can install the host toolchain with:
 
 ```console
-$ swiftly install 6.1.1
-Installing Swift 6.1.1
+$ swiftly install 6.2
+Installing Swift 6.2
 Installing package in user home directory...
-Swift 6.1.1 installed successfully!
+Swift 6.2 installed successfully!
 
-$ swiftly use 6.1.1
-The global default toolchain has been set to `Swift 6.1.1` (was 6.1.0)
+$ swiftly use 6.2
+The global default toolchain has been set to `Swift 6.2` (was 6.1.0)
 
 $ swiftly run swift --version
-Apple Swift version 6.1.1 (swift-6.1.1-RELEASE)
+Apple Swift version 6.2 (swift-6.2-RELEASE)
 Target: arm64-apple-macosx15.0
 ```
 
-#### 2. Install the Swift Android SDK
+#### 2. Install the Swift SDK for Android
 
-Next, you can download and install the SDK bundle using the built-in `swift sdk` command:
+Next, download and install the SDK bundle using the built-in `swift sdk` command:
 
 ```console
-$ curl -fSLO https://github.com/skiptools/swift-android-toolchain/releases/download/6.1.1/swift-6.1.1-RELEASE-android-0.1.artifactbundle.tar.gz
-$ swiftly run swift sdk install swift-6.1.1-RELEASE-android-0.1.artifactbundle.tar.gz
-Swift SDK bundle at `swift-6.1.1-RELEASE-android-0.1.artifactbundle.tar.gz` successfully installed as swift-6.1.1-RELEASE-android-0.1.artifactbundle.
+$ swift sdk install https://github.com/swift-android-sdk/swift-android-sdk/releases/download/6.2/swift-6.2-RELEASE-android-0.1.artifactbundle.tar.gz --checksum ca7e09f09a591b6a661a39134aaf53b1b59d5e3a193b271ab1f20effdfc6e88e
+
+Swift SDK bundle at `swift-6.2-RELEASE-android-0.1.artifactbundle.tar.gz` successfully installed as swift-6.2-RELEASE-android-0.1.artifactbundle.
 ```
 
 You should now see the Android SDK included in the `swift sdk list` command:
 
 ```console
 $ swiftly run swift sdk list
-swift-6.1.1-RELEASE-android-0.1
+swift-6.2-RELEASE-android-0.1
 ```
 
 #### 3. Install and configure the Android NDK
 
-The Swift Android SDK depends on the Android Native Development Toolkit (NDK) version 27c to provide the headers and tools necessary for cross-compiling to Android architectures. There are a variety of ways to [install the Android NDK](https://developer.android.com/ndk/guides), but the simplest is to just download and unzip the archive from the [NDK Downloads page](https://developer.android.com/ndk/downloads/#lts-downloads) directly.
+The Swift SDK for Android depends on the Android Native Development Toolkit (NDK) version 27d to provide the headers and tools necessary for cross-compiling to Android architectures. There are a variety of ways to [install the Android NDK](https://developer.android.com/ndk/guides), but the simplest is to just download and unzip the archive from the [NDK Downloads page](https://developer.android.com/ndk/downloads/#lts-downloads) directly.
 
 You can automate this with the following commands in a directory of your choosing:
 
 ```console
 $ mkdir ~/android-ndk
 $ cd ~/android-ndk
-$ curl -fSLO https://dl.google.com/android/repository/android-ndk-r27c-$(uname -s).zip
-$ unzip -q android-ndk-r27c-*.zip
-$ export ANDROID_NDK_HOME=$PWD/android-ndk-r27c
+$ curl -fSLO https://dl.google.com/android/repository/android-ndk-r27d-$(uname -s).zip
+$ unzip -q android-ndk-r27d-*.zip
+$ export ANDROID_NDK_HOME=$PWD/android-ndk-r27d
 ```
 
-Once you have downloaded and unpacked the NDK, you can link it up to the Swift Android SDK by running the `setup-android-sdk.sh` utility script included with the SDK bundle: 
+Once you have downloaded and unpacked the NDK, you can link it up to the Swift SDK for Android by running the `setup-android-sdk.sh` utility script included with the SDK bundle:
 
 ```console
 $ cd ~/Library/org.swift.swiftpm || cd ~/.swiftpm
-$ ./swift-sdks/swift-6.1.1-RELEASE-android-0.1.artifactbundle/swift-android/scripts/setup-android-sdk.sh 
-setup-android-sdk.sh: success: ndk-sysroot linked to Android NDK at android-ndk-r27c/toolchains/llvm/prebuilt
+$ ./swift-sdks/swift-6.2-RELEASE-android-0.1.artifactbundle/swift-android/scripts/setup-android-sdk.sh
+setup-android-sdk.sh: success: ndk-sysroot linked to Android NDK at android-ndk-r27d/toolchains/llvm/prebuilt
 ```
 
 *Note that if you have already installed the NDK in a different location, you can simply set the `ANDROID_NDK_HOME` environment variable to that location and run the `setup-android-sdk.sh`*
@@ -108,7 +108,7 @@ $ .build/debug/hello
 Hello, world!
 ```
 
-With the Swift Android SDK installed and configured, you can now cross-compile the executable for Android for the `x86_64` architecture:
+With the Swift SDK for Android installed and configured, you can now cross-compile the executable for Android for the `x86_64` architecture:
 
 ```console
 $ swiftly run swift build --swift-sdk x86_64-unknown-linux-android28 --static-swift-stdlib
@@ -151,6 +151,6 @@ Congratulations, you have built and run your first Swift program on Android!
 
 Note that Android applications are typically not deployed as command-line executable tools. Rather, they are assembled into an `.apk` archive and launched as an app from the home screen. To support this, Swift modules can be built as shared object libraries for each supported architecture and included in the app archive. The Swift code can then be accessed from the Android app — which is typically written in Java or Kotlin — through the Java Native Interface ([JNI](https://developer.android.com/training/articles/perf-jni)).
 
-This is a larger development topic that will be expanded on in future articles and documentation. In the meantime, please visit the [Swift Android forums](https://forums.swift.org/c/development/android/) to discuss and seek help with the Swift Android SDK.
+This is a larger development topic that will be expanded on in future articles and documentation. In the meantime, please visit the [Swift Android forums](https://forums.swift.org/c/platform/android/115) to discuss and seek help with the Swift SDK for Android.
 
 
