This is a public demo of the Mapbox Maps SDK for Android. The demo app is available now in the Google Play Store and it shows off all the examples found on mapbox.com/android-docs/map-sdk/examples using the same code. There are also examples that only live in the app. The app "labs" section combines the examples to create more complex demos. Check out the overview page to get started using the Mapbox Maps SDK for Android in your Android project.
Feedback and contribution is encouraged in this repo, if you'd like to see a new example added in the app either open an issue or create it yourself and open a pull request following these steps:
Note: This repo uses checkstyle to make sure code contributed follows the Mapbox Style standards. When a pull request is opened, Bitrise will check that no style issues occur in the code. To setup Checkstyle in Android Studio read this wiki entry.
- Create a new java file and place in the acceptable folder (
examplesorlabs) giving it a descriptive name and ending the title with*Activity. It's important that all activities extendAppCompat. - If the activity needs a layout, add one with the naming convention
activity_*. - Add the activity to the
AndroidManifest.xmlfile. - Open the
MainActivity.javafile and scroll down to thelistItemsmethod. You'll notice a switch statement, pick one of the cases (categories) and add the new example so it matches the others. - Code your example and test to make sure it works properly.
- Open a pull request with the new example.
This demo app uses Mapbox vector tiles, which require a Mapbox account and a Mapbox access token. Obtain a free access token on the Mapbox account page.
With the first Gradle invocation, Gradle will take the value of the MAPBOX_ACCESS_TOKEN environment variable and save it to SharedCode/src/main/res/values/developer-config.xml. If the environment variable wasn't set, you can edit developer-config.xml manually and add your access token to the access_token resource.
