This repository has samples that demonstrate various aspects of the AWS Mobile SDK Version 2 for Android, you can get the source on Github. To find the AWS Mobile SDK Version 1 for Android samples, please select the v1 branch.
Please refer to README file in each folder for more specific instructions. For general issues and help, check the FAQs section
-
CognitoSyncDemo. This is a sample mobile application that demonstrates how to use Amazon Cognito. Involved AWS Services are:
- Amazon Cognito Identity
- Amazon Cognito Sync
-
S3TransferUtilitySample. This is a sample mobile application that demonstrates how to use Amazon S3 Transfer Utility to download and upload files to Amazon S3. Involved AWS Services are:
- Amazon Cognito Identity
- Amazon S3
-
DynamoDBMapper. This is a sample mobile application that demonstrates how to use Amazon DynamoDB Object Mapper. Involved AWS Services are:
- Amazon Cognito Identity
- Amazon DynamoDB
-
AndroidPubSub. This sample demonstrates use of the AWS IoT APIs to securely publish to and subscribe from MQTT topics. Involved AWS Services are:
- Amazon Cognito Identity
- AWS IoT
-
CreateIotCertWithCSR. This sample demonstrates use of the AWS IoT APIs to create an AWS IoT certificate. Involved AWS Services are:
- Amazon Cognito Identity
- AWS IoT
-
TemperatureControl. This sample demonstrates use of the AWS IoT device shadow APIs. Involved AWS Services are:
- Amazon Cognito Identity
- AWS IoT
- Android SDK. You can install the SDK via Android Studio or as stand-alone tools. See Installing the Android SDK.
- Your favorite IDE, either Android Studio or Eclipse. The former is the official IDE for Android. However all samples are backward compatible with Eclipse, though the setup is a little more complicated.
- Or Gradle if you prefer CLI.
This is the recommended way to run samples.
- Import sample project into Android Studio. In the welcome screen, click
Import project (Eclipse ADT, Gradle, etc.). Navigate to the sample directory and select a sample project to import. - Update source code with your AWS resources. Please read the README of each sample for more details.
- Run it!
- Make sure
ANDROID_HOMEenvironment variable is set to point to your Android SDK. See Getting Started with Gradle. - Update source code with your AWS resources. Please read the README of each sample for more details.
- Connect an Android device to your computer or start an Android emulator. The minimum required API version for most samples is API level 10.
- Compile the sample and install it. Run
gradlew installDebug. Or if you on a Windows computer, usegradlew.batinstead.
- Import sample project. Via menu, click File -> New -> Other -> Android Project from Existing Code. Browse to the sample directory and select a sample project to import.
- Get AWS Mobile SDK for Android. You can download it from AWS Mobile SDK website. Extract it, and copy libraries to the
libsfolder of the sample. Please refer to the README of each sample for required libraries. - Update source code with your AWS resources. Please read the README of each sample for more details.
- Run it!
- We typically include the dependencies in the repo and have them already linked, so if you move the project you'll need to also update the path to the dependency. To do this, modify the project.properties file of the project
- Change the path to the library in project.properties of the project you are building to be the path to the version you want
- To fix this, make sure that all the jars you are using conform to the same version. You can do this by just replacing all the problematic jars with the version you would like to use.
- The jar is usually already included where required. However, if not or if you want to use a different version, you can find it here.