Mapbox Gestures for Android
The Mapbox Gestures for Android library wraps GestureDetectorCompat and introduces implementation of scale, rotate, move, shove and tap gesture detectors.
Mapbox Gestures for Android was inspired by Android Gesture Detector Framework and offers the same functionality with some additional features on top.
The library is implemented in the projects found below, where you can head for more examples:
- The Mapbox Maps SDK for Android
- This library's sample app included in this repository
Are you using the library in your project as well? Let us know or create a PR, we'll be more than happy to add it to the list!
Documentation
You'll find all of this library's documentation on our Mapbox Gestures page. This includes information on installation, using the API, and links to the API reference.
Getting Started
If you are looking to include Mapbox Gestures for Android inside of your project, please take a look at the detailed instructions found in our docs. If you are interested in building from source, read the contributing guide inside of this project.
To use the Gestures library, include it in your app-level build.gradle
file.
// In the root build.gradle file
repositories {
mavenCentral()
}
// In the app build.gradle file
dependencies {
implementation 'com.mapbox.mapboxsdk:mapbox-android-gestures:0.7.0'
}
The library is published to Maven Central and SNAPSHOTS are available whenever new code is pushed to this repo's master
branch for testing the latest build:
// In the root build.gradle file
repositories {
jcenter()
maven { url 'https://oss.jfrog.org/artifactory/oss-snapshot-local/' }
}
// In the app build.gradle file
dependencies {
implementation 'com.mapbox.mapboxsdk:mapbox-android-gestures:0.8.0-SNAPSHOT'
}
To run the specific Mapbox activity in this repo's test application, include your developer access token in the developer-config.xml
file. An access token is not required to run this repo's test application.
Getting Help
- Need help with your code?: Look for previous questions on the #mapbox tag — or ask a new question.
- Have a bug to report? Open an issue. If possible, include the version of Mapbox Core that you're using, a full log, and a project that shows the issue.
- Have a feature request? Open an issue. Tell us what the feature should do and why you want the feature.
Sample code
This repo's test app can also help you get started with the Gestures library.
Contributing
We welcome feedback, translations, and code contributions! Please see CONTRIBUTING.md for details.
Version
Noting here, that 0.x
versions series of Mapbox Gestures for Android
is still in an experimental phase. Breaking changes can occur with every iteration.