Android Studio2.0中使用离线ArcGIS Runtime Android SDK 100.1.0开发原生地图应用.docx

前言

    最近因为工作关系，需要使用ArcGIS Runtime SDK for Android搭建一个简单的入门Demo，也就是传说中的Hello GISer。翻了一遍官方文档，ArcGIS Runtime SDK for Android的安装推荐使用Gradle，而且使用的是在线的Esri's maven repository ，也就是说第一次构建工程的时候，需要从 Bintray Esri repository(https://esri.bintray.com/arcgis)中下载相应的依赖包，才能通过编译，如下图所示：

    按照【Install the SDK】和【Develop your first map app】的指引，在Android Studio2.0中创建好工程，配置好build.gradle之后，点击【Sync Now】进行编译，如下图：

Install the SDK 地址：

https://developers.arcgis.com/android/latest/guide/install-and-set-up.htm

Develop your first map app地址：

https://developers.arcgis.com/android/latest/guide/develop-your-first-map-app.htm

    由于使用在线下载依赖包的方式，编译的时候在Android Studio的底部状态栏处会提示正在下载arcgis-android-100.1.0.aar文件，如下图：

    arcgis-android-100.1.0.aar这个文件其实才34M，但是下载的速度非常的慢，几K的下载速度，这是不能容忍的。所以就想着能不能下载好SDK之后再使用本地依赖库的方式构建工程。

    又回去翻看了一回【Install the SDK】，寥寥几行，只提了个需要下载SDK，至于怎么样配置，没有任何说明：

    

    对于我这种需要才使用Android的蓝鸟来说，这可就有点小小挑战了，先不管，下载好SDK解压后，我们看到目录底下有一个README.txt文件，如下图：

    一般来说，这个非常重要，打开一看，内容也是简单的不能再简单了，但是也都点出了重要的步骤：

    

    总的来说就是需要做这么几件事：

1. 安装好Java JDK
2. 安装好Maven
3. 安装好Android Studio
4. 把arcgis-android-100.1.0.aar和arcgis-android-100.1.0.pom拷贝到Maven的repository中
5. 修改build.gradle

虽然上述的说明主要讲了个大概，但是有了大体的思考之后，后面操作起来就方便多了。啰嗦了那么多，其实重点是想说明一点：使用ArcGIS Runtime SDK for Android开发地图App，使用离线SDK比较靠谱。

环境

JDK：1.8.0_131

Maven：3.5.0

Android Studio：2.0

ArcGIS Runtime SDK for Android：100.1.0

部署过程

1.JDK安装。过程略，主要是配置好环境变量：

顺便在Path环境变量中加入%JAVA_HOME%\bin，这样在CMD命令窗口下就可以执行Java命令进行验证：

2.安装Maven。过程略，主要还是配置好环境变量：

顺便也在Path环境变量中加入%MAVEN_HOME%\bin，这样在CMD命令窗口下就可以执行mvn命令检查是否已经安装好：

3.Android Studio。这个也是默认下一步就OK，过程也省略。

4.把arcgis-android-100.1.0.aar和arcgis-android-100.1.0.pom文件拷贝到以下这个目录：

上图中的红色部分是需要手动创建，一个目录接着一个目录往下建，至于为什么要这样创建，是因为我们的工程使用的依赖包的所决定了，如下图：

上面这个红色下划线部分就是依赖包的路径。但是这里其实还有一个问题，就是下载的SDK里只有arcgis-android-100.1.0.aar文件，没有arcgis-android-100.1.0.pom文件，怎么办？很简单，下载一个？那从哪里下载？考验自我思考的时候到了，还记得在前言中所说的配置 build.gradle文件吗？里面有一个地方是配置依赖包的下载地址：

从这里就可以下载：

你会发现这个地址很熟，跟编译的时候的路径一个样：

没错，Gradle在下载依赖包的时候就根据这个地址去下载的。所以找到它就成功了一大半。

5. 最后再修改build.gradle (Project: <project name>).build.gradle (Module: <module name>)这两个文件就可以了：

6.再最近就跟着把该拷贝的代码拷贝上，运行下APP就OK了：

小结

总的来说，使用ArcGIS Runtime SDK for Android来开发移动端的地图应用，第一步的开发环境配置对于小白用户来说还是有点挑战，当然如果你人再国外，使用在线依赖包会简单很多，但由于网络的原因，我们必须使用离线依赖包，所以才有了这篇文章。记录下来，以免过了一段时间之后又不记得了。