AWS SDK for Android Samples

This repository has samples that demonstrate various aspects of the AWS SDK for Android.

Resources

• Developer Guide for AWS SDK for Android

Please refer to README file in each folder for more specific instructions. For general issues and help, check the FAQs section

List of Samples

• AmazonKinesisVideoDemoApp This is a sample mobile application that demonstrates how to stream video to Amazon Kinesis Video Streaming. Involved AWS Services are:

  • Amazon Kinesis Video Streaming
  • Amazon Cognito Identity
  • Amazon Cognito Identity Provider (Your User Pools)

• 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

• AndroidPubSub. This sample demonstrates use of the AWS IoT APIs to securely publish to and subscribe from MQTT topics with TLS and IoT certificates. Involved AWS Services are:

  • Amazon Cognito Identity
  • AWS IoT

• AndroidPubSubWebSocket. This sample demonstrates use of the AWS IoT APIs to securely publish to and subscribe from MQTT topics with WebSockets. Involved AWS Services are:

  • Amazon Cognito Identity
  • AWS IoT

• PollyDemo. This is a sample mobile application that demonstrates how to use Amazon Polly. Involved AWS Services are:

  • Amazon Cognito Identity
  • Amazon Polly

• Lex Sample. This is a sample mobile application that demonstrates how to use Amazon Lex. Involved AWS Services are:

  • Amazon Cognito Identity
  • Amazon Lex

How to Run a Sample

Requirements

• Android SDK. You can install the SDK via Android Studio or as stand-alone tools. See Installing the Android SDK.
• Android Studio IDE 3.2+ (the official IDE for Android) or Gradle if you prefer CLI.

Android Studio

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!

Gradle

• Make sure ANDROID_HOME environment 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, use gradlew.bat instead.

FAQs

The sample can no longer be compiled/imported if I move it to another directory

• 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

How do I use a different version of an included library(such as the Facebook SDK)?

• Change the path to the library in project.properties of the project you are building to be the path to the version you want

I'm getting an error saying that there are multiple versions of a jar

• 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.

Where do I find login-with-amazon-sdk.jar?

• 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.

Getting Help

We use AWS Android SDK GitHub issues for tracking questions, bugs, and feature requests.