Mapbox Plugins for Android

Additional

Language
Java
Version
v0.2.0-scalebar (Jul 30, 2019)
Created
Apr 4, 2017
Updated
Aug 2, 2019
Owner
Mapbox (mapbox)
Contributors
mdakram
Pablo Guardiola (Guardiola31337)
sebastienrouif
arnekaiser
snkashis
Zhao Gang (zhao-gang)
cammace
theel0ja
Antonio Zugaldia (zugaldia)
tobrun
LukasPaczos
langsmith
ericrwolfe
danesfeder
romatroskin
trevorhalvorson
gustron12
dependabot[bot]
Show all (19)19
Activity
Badge
Generate
Download
Source code
APK file

Announcement



Plugins are single-purpose libraries built on top of the Mapbox Maps SDK for Android that you can include in your apps like any other Android dependency



Plugin artifacts are versioned based on the major release of the Maps SDK for Android, which means, that each artifact's name has a major version of the Maps SDK it's compatible with appended.

  1. Click the Sync Project with Gradle Files near the toolbar in Studio.

Maps SDK compatibility

The Mapbox Plugins for Android are heavily dependent on the major semantic versioning number of the Maps SDK. They either won't compile or hide runtime bugs when paired with a different major version of the Maps SDK. Each plugin's dependency name has a vX suffix which states the major version of the Maps SDK that the plugin is compatible with. This suffix makes the transition between versions easier and more educated without the need to jump into changelogs and compare repositories.

Help and Usage

This repository includes an app that shows how to use each plugins in this repository. Check out its code for ready-to-use snippets.

Plugins are easy to use. A plugin is simply a library module built on top of the Mapbox Maps SDK for Android. Currently, we are not requiring plugins to register themselves or to implement any specific interfaces so that they're simple to consume.

This might change in the future as we build more plugins and learn how you use them. We'd love to hear your feedback.

Why Plugins

Splitting specific functionality into plugins makes our Maps SDK lighter and nimble for you to use, and it also lets us iterate faster. We can release plugins more often than the SDK, which requires a slower pace due to its larger codebase.

The Mapbox Android team creates plugins but this plugins repository is an open-source project similar to the various Mapbox SDKs for Android. Plugins' lightweight nature makes them much easier for you and anyone else to contribute rather than trying to add the same feature to the more robust Maps SDK. The Mapbox team can also more easily accept contributed plugins and keep the plugin list growing.

Contributing

We welcome contributions to this plugin repository!

If you're interested in building and sharing your own plugin, please read the contribution guide to learn how to get started.