Get Started

Choose Android as your platform and then choose Next.

Choose the Download Cloud Config and then choose Next.

The awsconfiguration.json file you download contains the configuration of backend resources that Mobile Hub enabled in your project. Analytics cloud services are enabled for your app by default.

Add the backend service configuration file to your app.

In the Project Navigator, right-click your app's res folder, and then choose New > Directory. Type raw as the directory name and then choose OK.

From the location where configuration file, awsconfiguration.json, was downloaded in a previous step, drag it into the res/raw folder. Android gives a resource ID to any arbitrary file placed in this folder, making it easy to reference in the app.

Pick iOS as your platform and choose Next.

Choose the Download Cloud Config and then choose Next.

The awsconfiguration.json file you download contains the configuration of backend resources that Mobile Hub enabled in your project. Analytics cloud services are enabled for your app by default.

Add the backend service configuration file to your app.

From your download location, place awsconfiguration.json into the folder containing your info.plist file in your Xcode project. Select Copy items if needed and Create groups in the options dialog. Choose Next.

Prerequisites

Your AndroidManifest.xml must contain:

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

Add dependencies to your app/build.gradle, then choose Sync Now in the upper right of Android Studio. This libraries enable basic AWS functions, like credentials, and analytics.

dependencies {
    implementation ('com.amazonaws:aws-android-sdk-mobile-client:2.6.+@aar') { transitive = true }
}

Add the following code to the onCreate method of your main or startup activity. AWSMobileClient is a singleton that establishes your connection to AWS and acts as an interface for your services.

import com.amazonaws.mobile.client.AWSMobileClient;

class YourMainActivity : Activity() {
  companion object {
    private val TAG: String = this::class.java.simpleName
  }

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState);

    AWSMobileClient.getInstance().initialize(this) {
      Log.d(TAG, "AWSMobileClient is initialized")
    }.execute()

    // More onCreate code...
  }
}

Prerequisites

Install Cocoapods. From a terminal window run:

sudo gem install cocoapods

Create Podfile. From a terminal window, navigate to the directory that contains your project's .xcodeproj file and run:

pod init

Add core AWS Mobile SDK components to your build.

platform :ios, '9.0'
target :'YOUR-APP-NAME' do
    use_frameworks!
    pod 'AWSMobileClient', '~> 2.6.13'
    # other pods
end

Install dependencies by runnng:

pod install --repo-update

If you encounter an error message that begins "[!] Failed to connect to GitHub to update the CocoaPods/Specs . . .", and your internet connectivity is working, you may need to update openssl and Ruby.

The command pod install creates a new workspace file. Close your Xcode project and reopen it using ./YOUR-PROJECT-NAME.xcworkspace.

Rebuild your app after reopening it in the workspace to resolve APIs from new libraries called in your code. This is a good practice any time you add import statements.

Replace the return true statement in didFinishLaunching with the following code in your AppDelegate to establish a run-time connection with AWS Mobile.

import UIKit
import AWSMobileClient

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

func application(_ application: UIApplication,
                 didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    // Override point for customization after application launch.

    // Create AWSMobileClient to connect with AWS
    return AWSMobileClient.sharedInstance().interceptApplication(
        application,
        didFinishLaunchingWithOptions: launchOptions)

}