chore: android docs (#290)

Author: aajtodd

.github/workflows/continuous-integration.yml

@@ -5,9 +5,6 @@ on:
     branches: [ main ]
   pull_request:
     branches: [ main ]
-    paths-ignore:
-      - 'docs/**'
-      - '*.md'
   workflow_dispatch:
 
 env:

README.md

@@ -140,7 +140,5 @@ Please refer to our [security policy](https://github.com/awslabs/aws-sdk-kotlin/
 
 The SDK supports the following targets:
 
-* JVM
-* Android API level 16+ (Later versions of the Android may contain security
-  fixes so consider reviewing known vulnerabilities for the Android versions
-  you choose to support in your application.)
+* [JVM](docs/targets.md#jvm)
+* [Android](docs/targets.md#android) 

docs/GettingStarted.md

@@ -60,3 +60,4 @@ Consult the [stability guide](stability.md) for more information on SDK stabilit
 * [Additional examples](https://github.com/awslabs/aws-sdk-kotlin/tree/main/examples)
 * [Giving feedback and contributing](https://github.com/awslabs/aws-sdk-kotlin#feedback)
 * [Debugging](debugging.md)
+* [Android support](targets.md#android)

docs/targets.md

@@ -0,0 +1,49 @@
+# Supported Targets
+
+## JVM
+
+The AWS SDK for Kotlin supports running on JDK8+ on the following platforms and architectures:
+
+* Windows: `x86_32`, `x86_64`
+* Linux: `x86_32`, `x86_64`, `armv6`, `armv7`, `armv8`
+* macOS: `x86_64`
+
+If there is a platform or architecture not supported please submit an issue with details about your use case.
+
+## Android
+
+The AWS SDK for Kotlin supports Android API 24+ (`minSdk = 24`).
+
+NOTE: Later versions of Android may contain security fixes so consider reviewing known vulnerabilities
+for the Android versions you choose to support in your application.
+
+Additional requirements:
+
+* Enable [core library desugaring](https://developer.android.com/studio/write/java8-support#library-desugaring)
+* Exclude `xmlpull` module
+
+Example config fragments:
+
+```kotlin
+// build.gradle.kts
+
+android {
+    compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_1_8
+        targetCompatibility = JavaVersion.VERSION_1_8
+        isCoreLibraryDesugaringEnabled = true
+    }
+    kotlinOptions {
+        jvmTarget = "1.8"
+    }
+}
+
+// get around a build issue with xmlpull as a dependency
+configurations.all {
+    exclude(group = "xmlpull", module = "xmlpull")
+}
+
+dependencies {
+    coreLibraryDesugaring("com.android.tools:desugar_jdk_libs:1.1.5")
+}
+```