{"id":15058952,"url":"https://github.com/mapbox/mapbox-gl-native-android","last_synced_at":"2025-10-05T01:31:33.225Z","repository":{"id":41168866,"uuid":"213687575","full_name":"mapbox/mapbox-gl-native-android","owner":"mapbox","description":"Interactive, thoroughly customizable maps in native Android powered by vector tiles and OpenGL","archived":true,"fork":false,"pushed_at":"2023-08-21T13:46:32.000Z","size":9537,"stargazers_count":219,"open_issues_count":147,"forks_count":118,"subscribers_count":120,"default_branch":"main","last_synced_at":"2025-04-21T08:56:53.190Z","etag":null,"topics":["android","c-plus-plus","geojson","java","map","mapbox","mapbox-gl","maps","opengl","openstreetmap","vector-tiles"],"latest_commit_sha":null,"homepage":"https://mapbox.com/mobile","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mapbox.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":"CODE-OF-CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-10-08T15:52:14.000Z","updated_at":"2025-03-02T04:49:59.000Z","dependencies_parsed_at":"2025-01-23T20:42:10.695Z","dependency_job_id":null,"html_url":"https://github.com/mapbox/mapbox-gl-native-android","commit_stats":null,"previous_names":[],"tags_count":52,"template":false,"template_full_name":null,"purl":"pkg:github/mapbox/mapbox-gl-native-android","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mapbox%2Fmapbox-gl-native-android","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mapbox%2Fmapbox-gl-native-android/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mapbox%2Fmapbox-gl-native-android/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mapbox%2Fmapbox-gl-native-android/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mapbox","download_url":"https://codeload.github.com/mapbox/mapbox-gl-native-android/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mapbox%2Fmapbox-gl-native-android/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278399628,"owners_count":25980330,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","c-plus-plus","geojson","java","map","mapbox","mapbox-gl","maps","opengl","openstreetmap","vector-tiles"],"created_at":"2024-09-24T22:34:25.520Z","updated_at":"2025-10-05T01:31:32.448Z","avatar_url":"https://github.com/mapbox.png","language":"Java","readme":"# [Mapbox Maps SDK for Android](https://www.mapbox.com/android-sdk/)\n\nThe latest version of Mapbox Maps SDK is now available at [mapbox/mapbox-maps-android](https://github.com/mapbox/mapbox-maps-android). This version offers superior performance, features, and developer experience, and is the recommended mobile SDK solution for all Mapbox customers. \n\nMapbox maintains this repo to address bug fixes and security vulnerabilities. Please note that this project will cease to receive updates, including compatibility and bugfixes, after April 4, 2023. [Here is a helpful guide](https://docs.mapbox.com/android/maps/guides/) about our latest SDK features and how to migrate to our latest version. \n\n[![Circle CI build status](https://circleci.com/gh/mapbox/mapbox-gl-native-android/tree/master.svg?style=shield)](https://circleci.com/gh/mapbox/mapbox-gl-native-android/tree/master)\n\n[![](https://www.mapbox.com/android-docs/assets/overview-map-sdk-322-9abe118316efb5910b6101e222a2e57c.png)](https://docs.mapbox.com/android/maps/overview/)\n\nThe Mapbox Maps SDK for Android is a library based on Mapbox GL Native for embedding interactive map views with scalable, customizable vector maps onto Android devices.\n\n## Getting Started\n\nThis particular README is for people who are interested in working on and improving the Maps SDK for Android. If you're looking for more general information and instructions on the Maps SDK:\n\nVisit [https://docs.mapbox.com/android/maps/overview](https://docs.mapbox.com/android/maps/overview/) to see current documentation on the Maps SDK for Android.\n\nVisit [https://docs.mapbox.com/android/api/map-sdk](https://docs.mapbox.com/android/api/map-sdk/) to view the Maps SDK's current API reference Javadoc files.\n\nSee [the Mapbox website's Android install flow](https://www.mapbox.com/install/android/) to install and use the Mapbox Maps SDK for Android in an application.\n\n### Setup environment\n\nThese instructions are for developers interested in making code-level contributions to the SDK itself. If you instead want to use the SDK in your app, see above.\n\n#### Getting the source\n\nClone the git repository and pull in submodules:\n\n```bash\ngit clone git@github.com:mapbox/mapbox-gl-native-android.git \u0026\u0026 cd mapbox-gl-native-android\ngit submodule update --init --recursive\n```\n\n#### Installing dependencies\n\n- Latest stable [Android Studio](https://developer.android.com/studio/index.html) and Android SDK.\n\n### Opening the project\n\nOpen the root folder of this repository in Android Studio.\n\n### Project configuration\n\n#### Setup Mapbox Access token for dependency download\n\nAdd a Mapbox access token with scope set to `DOWNLOADS:READ` in the root `build.gradle`.\n\n```groovy\nallprojects {\n    repositories {\n        maven {\n            url 'https://api.mapbox.com/downloads/v2/releases/maven'\n            authentication {\n                basic(BasicAuthentication)\n            }\n            credentials {\n                username = \"mapbox\"\n                password = \"INSERT_MAPBOX_ACCESS_TOKEN_HERE\"\n            }\n        }\n    }\n}\n```\n\n#### Setup Checkstyle\n\nMapbox uses specific IDE settings related to code and check style.\nSee [checkstyle guide](https://github.com/mapbox/mapbox-gl-native-android/wiki/Setting-up-Mapbox-checkstyle) for configuration details.\n\n##### Setup Mapbox Access Token for Mapbox vector tiles\n\n_The test application (used for development purposes) uses Mapbox vector tiles, which require a Mapbox account and API access token. Obtain a free access token on the [Mapbox account page](https://www.mapbox.com/studio/account/tokens/)._\n\nWith the first gradle invocation, gradle will take the value of the `MAPBOX_ACCESS_TOKEN` environment variable and save it to `MapboxGLAndroidSDKTestApp/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 `mapbox_access_token` resource.\n\n### Additional resources\n\n#### Symbolicating native crashes\n\nWhen hitting native crashes you can use ndk-stack to symbolicate crashes.\nMore information in [this](https://github.com/mapbox/mapbox-gl-native-android/wiki/Getting-line-numbers-from-an-Android-crash-with-ndk-stack) guide.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmapbox%2Fmapbox-gl-native-android","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmapbox%2Fmapbox-gl-native-android","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmapbox%2Fmapbox-gl-native-android/lists"}