Hello Earth Project

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

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

Empty Activity

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 28: Android 9.0 (Pie). WhirlyGlobe-Maply can go back much farther, so pick what you need.

Select Finish. You should see something similar to this.

Overview of New Project

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 for Android in a couple of ways ways. Either of them is fine. Pick the one you are most familiar with. Don’t care? Try the binary.

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


Tutorial by Nicholas Hallahan, Steve Gifford, Tim Sylvester.