Hello Earth Project

Tutorial by Nicholas Hallahan.

Now we will be building a Hello Earth project. Similar to your typical Hello World, we will be creating a basic project in Android Studio that displays a globe and map using WhirlyGlobe-Maply.

Note: You can check out the completed Android tutorial on Github. It includes the WhirlyGlobe-Maply library and everything you need–all you have to do is run it in Android Studio.

Start New Android Studio Project

Open Android Studio and select Start a new Android Studio project.

Start New Android Studio Project

Name your application HelloEarth. Put this application somewhere outside of the WhirlyGlobe git repo.

Configure New Project

We’re selecting the Minimum SDK to be API 17: Android 4.2 (Jelly Bean). This is the most typical minimum for a project these days. WhirlyGlobe-Maply, however, does support Android SDKs as low as API 14: Android 4.0 (Ice Cream Sandwich).

Minimum SDK

Hello Earth is a very basic app that is meant to get you started. Select an Empty Activity – no bells and whistles.

Empty Activity

We’re going to just have one activity in this app, so keep the default name as MainActivity.

Main Activity

Select Finish.

WhirlyGlobe-Maply Distributions

At this point, you have started a new standard project, but you need to add WhirlyGlobe-Maply library as a dependency.

We distribute the WhirlyGlobe-Maply library in three ways. Any one of them is fine. Pick the one you are most familiar with. Don’t care? Try the repository.

It’s like a pick your own adventure book, but boring. So just like a pick your own adventure book.