AWS Mobile
Developer Guide

A Simple Note-taking App

Start with a working app and then add cloud enabled features. In this tutorial you will take a working app, driven from locally stored data, and then:

         Demonstration of the Notes tutorial app you can download.

You should be able to complete the setup section of this tutorial within 10-15 minutes after you have installed all required software. Once you complete the instructions on this page, you can run the project on your local system.

Getting Started

Before beginning, you must:

  • Download and install Android Studio version 3.0.1 or later.

  • Download an install Android SDK version 8.0 (Oreo), API level 26.

  • Install an Android Emulator - the app works with both phone and tablet emulators (for example, the Nexus 5X or Pixel C).

Windows Specific Instructions

Mac Specific Instructions

  • Install XCode using the Mac App Store.

  • Configure the XCode command line tools. Run xcode-select --install from a Terminal window.

    Why do I need XCode?

    The XCode package includes command line tools that are used on a Mac to assist with software development. You don't need to run the UI XCode application.

Download the Source code

  1. Get the tutorial source code using one of the following choices:

Compile the Source Code

To compile the source code:

  1. Start Android Studio.

  2. If you have a project open already, choose File > Close Project.

  3. Choose Open an existing Android Studio project.

  4. Find and choose the aws-mobile-android-notes-tutorial-master project in your file system, then choose OK.

                  Find MyNotes folder in the Android Studio project explorer.
  5. Select Build > Make Project from the menu bar.

The compilation step should complete with no errors. Errors are displayed within the Messages window, available on the status bar at the bottom of the project.

Run the Project in an Emulator

Create a new emulator if you have not done so already:

  1. Select Tools > Android > AVD Manager.

  2. Choose Create Virtual Device....

  3. Select Phone > Nexus 5X, then choose Next.

  4. Select the x86 Images tab, then select Android 8.0 (Google APIs).

    • If you have not previously downloaded the image, you can download it from this screen.

  5. Choose Next.

  6. Choose Finish.

  7. Close the AVD Manager.

Run the project in an emulator.

  1. Select Run > Run 'app'.

  2. Select the Nexus 5X API 26 virtual device.

  3. Choose OK.

The Android emulator will boot (if it is not already started) and the application will run. You should be able to interact with the application as you would any other mobile app. Try pressing on the + at the bottom to create a note, or choose a note to show the editor screen. A unique ID for each note is displayed in the list view underneath the note's title.

Running into Problems

The most common problems at this stage involve issues with the installation of Java, Android Studio, the Android SDK or the Android Emulator. Google provides detailed instructions on Android Studio and dependent features.

Next Steps

Next, integrate application analytics into your project.