Mapbox Android SDK官方教程（一）——Mapbox Maps SDK for Android

开始mapbox的学习，额，最近好像铺的太广，leaflet、openLayer、Qgis，其实还在学Cesium，最近看这么多，主要还是因为最近项目需要，很想把这几个都过一遍，熟悉熟悉，本来打算用leaflet做的，但是后来发现leaflet内嵌到android，JS和android交互麻烦，那就还不如直接用mapbox 的android SDK，所以又开始搞一下mapbox，最近已经搞了不少了，翻译记录下来。

mapbox android SDK是用来在安卓平台上展示地图的开源工具集。mapbox demo app中包含许多案例，可以在google play store中找到。本文档中很多demo也可以在该app找到。

Install the Maps SDK

在开始用map SDK开发你的应用之前，需要将SDK添加依赖，你可以在MavenCentral依赖中找到下面需要的依赖，下面提供的是通过gradle安装SDK，我们也提供对fabric的支持。

 如果你的应用有方法数量限制，你可以通过许可proguard来缓解这个问题。

一. Add the dependency

    1、打开android studio

    2、打开你application的build.gradle

    3、确保你工程的最小sdk版本在API14以上

    4、添加最新的mapbox-android-sdk的构建到依赖下

    5、点击sync同步工程

二、Get an access token

如果你没有mapbox的账号，去官方主页去注册获取token。当你将maps SDK添加到你的android工程后，打开String.xml文件，创建一个新的token的string。你将要在oncreate方法中用到此token。

三、Setup permissions

从5.0开始，权限只要加入如下：

四、Add a map

打开java文件activity加入下面代码到其中：

打开acivities布局文件，将下面mapView添加到布局：

五、生命周期方法

mapview的生命周期方法包含在android的opengl生命周期中。为了在app中正确调用mapview的生命周期方法，你需要在android的生命周期中重写如下方法：

以下生命周期方法都需要重写：

Attribution

Telemetry opt out

mapbox telemetry是内置在SDK中的一个很有用的位置分析平台。默认情况下，匿名位置和用户数据被发送到mapbox

MapView XML attributes