Welcome

[github-learning-lab]

👋 Welcome to the TomTom Maps SDK course!

Hello and welcome to this Learning Lab where I will walk you through creating an Android
application that displays a TomTom map using the TomTom Maps SDK for Android.

By the end of this course you will have an application that displays a TomTom map. All these running on your Android phone 📱

[github-learning-lab]

Get started

In general you have two options for using a development environment:

• Android Studio or
• Terminal + Gradle

For simplicity reasons this course will provide you instructions on using the
terminal and Gradle.

Apart from that you will need an Android phone so that you will be able to install
the created application on your own phone.

Now let's cover the pre-requisites.

Step 1: Build the project locally

⌨️ Activity: Set up your Android development environment

1. Ensure you have Java 1.8 installed (eg. https://adoptopenjdk.net/installation.html)
2. Go to the Android Studio page: https://developer.android.com/studio.
3. Go to the Command line tools only section or search for sdk-tools-. There you will find the zips which are around 150MB.
4. Download the SDK tools for your platform.
5. Extract and set your ANDROID_SDK_ROOT environment variable to the extracted location. Add this environment variable to your ~/.bashrc or ~/.bash_profile.
6. Go to the $ANDROID_SDK_ROOT/tools/bin/ folder
7. Run the sdkmanager command to accept all unaccepted licenses

   ./sdkmanager --licenses

   Just say y for all

⌨️ Activity: Clone the repository and build the project

1. Open your terminal
2. Change directories into a location where you want to keep this project
3. Clone this repository:

   git clone https://github.com/asmita08/lab-maps-sdk-android-display-a-map

4. Move into the repository's directory:

   cd lab-maps-sdk-android-display-a-map

5. In your repository folder, run the following build command:

   ./gradlew build

   This command will download Gradle, pull dependencies, build the sample app and run some tests.

In upcoming steps you will learn how to install the app on your phone and extend the app with many more features.

[github-learning-lab]

⌨️ Activity: Open a Pull Request

1. Create a pull request to base master from changes branch
2. Title your pull request Changes

I'll respond with next steps in your pull request.