AWS Mobile - Developer Guide

1 AWS MobileDeveloper GuideAWS Mobile : Developer GuideCopyright 2018 Amazon Web Services, Inc. and/or its affiliates. All rights Mobile Developer GuideAmazon's trademarks and trade dress may not be used in connection with any product or service that is not Amazon's, in any mannerthat is likely to cause confusion among customers, or in any manner that disparages or discredits Amazon. All other trademarks notowned by Amazon are the property of their respective owners, who may or may not be affiliated with, connected to, or sponsored Mobile Developer GuideTable of ContentsMobile and Web App Development .. 1 android and iOS .. 2 Get Started .. 2 Step 1: Set Up Your Development Environment .. 2 Step 2: Set Up Your Backend.

2 3 Step 3: Connect to Your Backend .. 4 Next Steps .. 6 Add Analytics .. 6 Add User Sign-in .. 14 Add Push Notifications .. 38 Add User File Storage .. 50 Add Serverless Backend (AWS AppSync) .. 60 Add Cloud Logic .. 60 Add Messaging .. 68 Tutorials .. 69 Looking for the Notes App Tutorial? .. 69 How To .. 69 Manual SDK Setup.. 70 User Sign-in (Amazon Cognito) .. 83 User File Storage (Amazon S3) .. 120 NoSQL Database (Amazon DynamoDB) .. 165 Serverless Code (AWS Lambda) .. 194 Natural Language (Amazon Lex) .. 205 Text to Speech (Amazon Polly) .. 213 Data Streaming (Amazon Kinesis) .. 214 Machine Learning (Amazon Machine Learning) .. 223 Miscellaneous.

3 229 Reference .. 239 SDK API References .. 239 AWS Mobile Hub Reference .. 239 android and iOS .. 239 Web .. 328 React Native .. 360 Mobile Hub Features .. 374 IAM Usage.. 398 Project Service Region Hosting .. 407 Troubleshooting Projects .. 412iiiAWS Mobile Developer GuideMobile and Web App DevelopmentAWS provides SDKs, libraries, tools, and documentation that enable you to build sophisticated cloud-powered Mobile and web apps. To get started, choose your preferred platform from the following:1 AWS Mobile Developer GuideGet StartedAWS Mobile for android and iOSThe AWS Mobile SDKs for android and iOS enable you to quickly and easily integrate robust cloudbackends into your existing Mobile Get Started (p.)

4 2) Tutorials (p. 69) AWS Mobile android and iOS How To (p. 69)Get StartedChoose your platform: android - JavaGet started building a cloud-powered android app using the AWS Amplify CLI and the AWS SDK forAndroid. This page guides you through setting up an initial backend and integrating the SDK intoyour - KotlinGet started building a cloud-powered android app using the AWS Amplify CLI and the AWS SDK forAndroid. This page guides you through setting up an initial backend and integrating the SDK intoyour - SwiftGet started building a cloud-powered iOS app using the AWS Amplify CLI and the AWS SDK for page guides you through setting up an initial backend and integrating the SDK into your 1: Set Up Your Development EnvironmentWe strongly recommend that you use the Amplify CLI for building the serverless backend for your app.

5 Ifyou have already installed the CLI, skip ahead to Step 2 (p. 3). Sign up for an AWS Account. Install and npm (if they are not already installed).NoteVerify that you are running at least version or greater and npm version or greaterby running node -v and npm -v in a terminal/console window. Older versions aren't supportedand might generate Mobile Developer GuideStep 2: Set Up Your BackendTo install and configure the Amplify CLI globally, run the following commands in a terminal window.$ npm install -g @aws-amplify/cli$ amplify configureMinimum requirements for your development environment are as - Java Choose the android Java app project you want to integrate with an AWS backend. Install android Studio version or higher.

6 Install android SDK for API level 23 ( android SDK ). android - Kotlin Choose the android Kotlin app project you want to integrate with an AWS backend. Install android Studio version or higher. Install android SDK for API level 23 ( android SDK ).iOS - Swift Choose the iOS app project you want to integrate with an AWS backend. Install Xcode version or 2: Set Up Your CLI prompts you for configuration - JavaIn a terminal window, navigate to your project folder (the folder that typically contains yourproject level ), and add the SDK to your app.$ cd ./YOUR_PROJECT_FOLDER$ amplify initAndroid - KotlinIn a terminal window, navigate to your project folder (the folder that typically contains yourproject level ), and add the SDK to your app.

7 $ cd ./YOUR_PROJECT_FOLDER$ amplify initiOS - SwiftIn a terminal window, navigate to your project folder (the folder that typically contains yourproject level xcodeproj file), and add the SDK to your app.$ cd ./YOUR_PROJECT_FOLDER$ amplify create your backend AWS resources and add a configuration file to your app, run the following:3 AWS Mobile Developer GuideStep 3: Connect to Your BackendAndroid - Java$ amplify pushAndroid - Kotlin$ amplify pushiOS - Swift$ amplify pushIn the Finder, navigate to the folder containing your app .xcodeproj file. From there, to Xcode under the top Project Navigator folder (the folder nameshould match your Xcode project name). In the Options dialog box that appears, do the following: Clear the Copy items if needed check box.

8 Choose Create groups, and then choose verify that the CLI is set up for your app, run the following command. The CLI displays a statustable with no resources listed. As you add categories to your app, backend resources created for yourapp are listed in this table.$ amplify status| Category | Resource name | Operation | Provider plugin || -------- | ------------- | --------- | --------------- |Use the steps in the next section to configure the connection between your app and the 3: Connect to Your BackendPerform the following steps to set up a connection to AWS services that you'll use in the Get Startedsection of this - dependencies to your , and then choose Sync Now on the upper-rightside of android Studio. These libraries enable basic AWS functions, like credentials and { implementation ' :aws- android -sdk- +'} must contain the following:<uses-permission android :name=" "/> <uses-permission android :name=" "/>Your app is now ready for you to add cloud-powered features.

9 We recommend addinganalytics (p. 6) as your first Mobile Developer GuideStep 3: Connect to Your BackendAndroid - dependencies to your , and then choose Sync Now on the upper-rightside of android Studio. These libraries enable basic AWS functions, like credentials and { implementation ' :aws- android -sdk- +'} must contain the following:<uses-permission android :name=" "/> <uses-permission android :name=" "/>Your app is now ready for you to add cloud-powered features. We recommend addinganalytics (p. 6) as your first - Cocoapods. From a terminal window run the following:sudo gem install Podfile. From a terminal window, navigate to the directory that contains your project' file and run the following:pod Podfile in a text editor and add the pod for core AWS Mobile SDK components to :ios, ' 'target :'YOUR-APP-NAME' do use_frameworks!

10 Pod 'AWSCore', '~> ' # other dependencies by running the following:pod install --repo-updateIf you encounter an error message that begins "[!] Failed to connect to GitHub toupdate the CocoaPods/Specs ..", and your internet connectivity is working, you mightneed to update openssl and command pod install creates a new workspace file. Close your Xcode project and reopen itusing . ONLY your .xcworkspaceRemember to always use . to open your Xcodeproject from now your app after reopening it in the workspace to resolve APIs from new libraries called inyour code. This is a good practice any time you add import Mobile Developer GuideNext StepsYour app is now ready for you to add cloud-powered features. We recommend addinganalytics (p.)