AWS SDK for Android
For new projects, we recommend interacting with AWS using the Amplify Framework.
The AWS SDK for Android is a collection of low-level libraries for direct interaction with AWS backend services. For use cases not covered by the Amplify Framework, you may directly integrate these clients into your Android app.
Installation
The AWS SDK for Android can be directly embedded via .aar files, or you can download it from the Maven Central repository, by integrating it into your Android project's Gradle files.
From Maven
We recommend obtaining the dependency from Maven. To do so, add a dependency to your app's (module-level) build.gradle, in the dependencies section:
dependencies {
implementation 'com.amazonaws:aws-android-sdk-SERVICE:2.x.y'
}
Above, SERVICE might be s3, ddb, pinpoint, etc. A full list is provided below.
Downloading SDK libraries
You can also download a .zip file containg .aar files for each of the SDK modules, here.
Add the aar files to a folder in your project called libs (create one if it doesn't already exist).
Ensure that the libs directory is included in your module-level build.gradle, under the dependencies block:
dependencies {
implementation fileTree(dir: 'libs', include: ['*.aar'])
}
Available Modules
- apigateway-core
- auth-core
- auth-facebook
- auth-google
- auth-ui
- auth-userpools
- cloudwatch
- cognitoauth
- cognitoidentityprovider
- comprehend
- connect
- connectparticipant
- core
- ddb
- ddb-document
- ddb-mapper
- ec2
- iot
- kinesis
- kinesisvideo
- kinesisvideo-archivedmedia
- kinesisvideo-signaling
- kms
- lambda
- lex
- location
- logs
- machinelearning
- mobile-client
- pinpoint
- polly
- rekognition
- s3
- sagemaker-runtime
- sdb
- ses
- sns
- sqs
- testutils
- textract
- transcribe
- translate
SDK Fundamentals
There are a few fundamentals that are helpful to know when developing against the AWS SDK for Android.
- Never embed credentials in an Android application. It is trivially easy to decompile applications and steal embedded credentials. Always use temporarily vended credentials from services such as Amazon Cognito Identity.
- Unless explicitly stated, calls are synchronous and must be taken off of the main thread.
- Unless explicitly stated, calls can always throw an AmazonServiceException or an AmazonClientException (depending on if the exception is generated by the service or the client respectively).
- The SDK will handle re-trying requests automatically, but unless explicitly stated will throw an exception if it cannot contact AWS.
- We are always looking to help, please feel free to open an issue.
Versioning
The Android SDK is versioned like 2.x.y. 2 is a product identifier that never changes. x is bumped when there are breaking changes. y is bumped for not-breaking bugfixes, or for the introduction of new features/capabilities.
Building the SDK
Pre-requisites
The AWS Core Runtime (aws-android-sdk-core) module builds against Android API Level 23. Please download and install Android API Level 23 through SDK Manager in Android Studio, before building the SDK.
Set the ANDROID_HOME environment variable, to the root directory of your Android SDK installation.
For example, on a Mac OS X where Android Studio has been installed, the SDK comes bundled with it.
export ANDROID_HOME="$HOME/Library/Android/sdk"
Build
./gradlew build
Consuming Development Versions
Once you've built the SDK, you can manually install the SDK by publishing its artifacts to your local Maven repository.
The local Maven repository is usually found in your home directory at ~/.m2/repository.
To publish the outputs of the build, execute the following command from the root of the amplify-android project:
./gradlew publishToMavenLocal
After this, you can use the published development artifacts from an app. To do so, specify mavenLocal() inside the app's top-level build.gradle(Project) file:
buildscript {
repositories {
mavenLocal() // this should ideally appear before other repositories
}
dependencies {
classpath 'com.android.tools.build:gradle:4.0.1'
}
}
allprojects {
repositories {
mavenLocal() // this should ideally appear before other repositories
}
}
Then, find the VERSION_NAME of the library inside gradle.properties file.
Use the above version to specify dependencies in your app's build.gradle (:app) file:
dependencies {
implementation 'com.amazonaws:aws-android-sdk-SERVICE:VERSION_NAME'
}
Talk to Us
Come chat with us on our Discord Channel.
Report bugs to our GitHub Issues page.
Author
Amazon Web Services
License
See the LICENSE.txt for more info.
235 Dec 2, 2022
17 Nov 12, 2021
1.8k Dec 30, 2022
62 Dec 18, 2022
30 Nov 16, 2022
3 Oct 26, 2021
31 Dec 13, 2022
6 Jan 8, 2022
1 Oct 13, 2021
36 Dec 21, 2022
1 Feb 18, 2022
0 Jan 30, 2022
0 Nov 25, 2022
10 Dec 15, 2022
3 Oct 27, 2022
648 Dec 23, 2022
659 May 14, 2022
424 Dec 9, 2022
219 Nov 25, 2022