《ArcGIS Runtime SDK for Android开发笔记》——(4)、基于Android Studio构建ArcGIS Android开发环境

1、前言

2015年1月15日,发布ArcGIS Runtime SDK for Android v10.2.5版本。从该版本开始默认支持android studio开发环境,示例代码的默认开发环境也改为Android Studio。Eclipse插件被弃用。并且官方说明从版本v10.2.5,Esri公司不再提供的Eclipse IDE工具插件的形式,但是,它是可以继续使用jar包引用方式通过Eclipse完成开发工作。所以这里我们采用目前官方主推的方式给大家介绍ArcGIS Android开发环境的搭建。

2、第一个地图应用程序HelloMap配置过程

在Android Studio中基于ArcGIS Runtime SDK for Android应用程序总的来说配置分为以下四步:

  • 创建一个Android工程
  • 配置ArcGIS Runtime SDK 支持
  • 添加UI及代码信息
  • 运行程序查看结果

2.1、创建一个android工程

1)   新建一个空的Android工程,选择Start a new Android Studio project

《ArcGIS Runtime SDK for Android开发笔记》——(4)、基于Android Studio构建ArcGIS Android开发环境

2)   创建一个新的Activity,选择第一个Blank Activity,点击下一步

《ArcGIS Runtime SDK for Android开发笔记》——(4)、基于Android Studio构建ArcGIS Android开发环境

3)   到这里第一个Android应用程序就创建成功了

《ArcGIS Runtime SDK for Android开发笔记》——(4)、基于Android Studio构建ArcGIS Android开发环境

2.2、配置ArcGIS Runtime SDK for Android支持

1)   Gradle配置

Gradle是近来比较流行的一个系统构建工具,可以通过编译自己的构建文件(build.gradle)来自定义构建流程。一个Gradle项目的构建文件是在项目的根目录下,您可以在项目的根目录下找到构建文件(build.grade)。在开发ArcGIS for Android的Gradle项目时需要配置两部分的依赖管理内容:

  • Ÿ   配置project的ArcGIS Repository(Esri ArcGIS maven)仓库位置
  • Ÿ   配置appmodule 的ArcGIS Runtime SDK for Android依赖。

2)   ArcGIS Repository配置

打开根目录下的构建配置文件build.gradle文件 [对应Gradle Scripts中的 build.gradle(Project:HelloMap)]

《ArcGIS Runtime SDK for Android开发笔记》——(4)、基于Android Studio构建ArcGIS Android开发环境

添加仓库配置,如下:

allprojects {
repositories {
jcenter()
// Add the following arcgis repository
maven {
url'http://dl.bintray.com/esri/arcgis'
}
}
}

说明:这样你所需的ArcGIS的jar包就会自动下载到本地的仓库里了,下次再建项目时需要引用ArcGIS 的jar时,他会去你本地直接查找相关jar引入到你的项目里。

3)   App Module配置

App Module中的build.gradle文件适合用来放特殊的指令和任务(对应Gradle Scripts中的 build.gradle(Module:app))。一个ArcGIS Android app需要ArcGIS Android API library工程依赖。一旦在project级别的build.gradle文件中配置好了ArcGIS的仓库,则可以在这个文件中声明ArcGIS Android的依赖。

a)   ArcGIS依赖配置

dependencies {
...
// Add the ArcGIS Android 10.2.6 API
compile 'com.esri.arcgis.android:arcgis-android:10.2.6-2'
}

a)   Packaging配置

在生成APK时我们可能不希望将一些文件打包到APK中,这时我们可通过下面的配置将所需文件排除APK文件中:

packagingOptions{
exclude 'META-INF/LGPL2.1'
exclude 'META-INF/LICENSE'
exclude 'META-INF/NOTICE'
}

《ArcGIS Runtime SDK for Android开发笔记》——(4)、基于Android Studio构建ArcGIS Android开发环境

c)   Permissions和Features配置

对于绝大多数的ArcGIS Android apps的应用几乎都需要网络的支持;也有一些应用可能会需要访问设备的sdcard,需要对该卡有读写的权限;除此对于GIS来说最常用的功能就是定位了所有,应用应该具备定位权限。 ArcGIS Android apps的MapView使用了OpenGL2.x,所以在android应用程序的配置文件AndroidManifest.xml中还需添加OpenGL的支持,因此应用的配置文件至少包含下面的配置信息:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> <uses-feature
android:glEsVersion="0x00020000"
android:required="true" />

《ArcGIS Runtime SDK for Android开发笔记》——(4)、基于Android Studio构建ArcGIS Android开发环境

2.3、添加UI及代码信息

在完成了一系列的配置操作后,接下来需要完成UI的制作和地图代码信息的设置。

1)   设置应用程序Activity的UI信息

打开res>>layout>>activity_main.xml文件,添加Mapview信息

<com.esri.android.map.MapView
android:id="@+id/map"
android:layout_width="fill_parent"
android:layout_height="fill_parent">
</com.esri.android.map.MapView>

《ArcGIS Runtime SDK for Android开发笔记》——(4)、基于Android Studio构建ArcGIS Android开发环境

2)   新建MapView并设置UI和代码的绑定

private MapView mapView = null;
private ArcGISTiledMapServiceLayer arcGISTiledMapServiceLayer = null; this.mapView = (MapView)this.findViewById(R.id.map);//设置UI和代码绑定

3)   新建地图图层并添加到MapView中

String strMapUrl="http://map.geoq.cn/ArcGIS/rest/services/ChinaOnlineCommunity/MapServer";
this.arcGISTiledMapServiceLayer = new ArcGISTiledMapServiceLayer(strMapUrl);
this.mapView.addLayer(arcGISTiledMapServiceLayer);

结果如下图所示:

《ArcGIS Runtime SDK for Android开发笔记》——(4)、基于Android Studio构建ArcGIS Android开发环境

2.4、程序运行结果

《ArcGIS Runtime SDK for Android开发笔记》——(4)、基于Android Studio构建ArcGIS Android开发环境

上一篇:《ArcGIS Runtime SDK for Android开发笔记》——(11)、ArcGIS Runtime SDK常见空间数据加载


下一篇:Shell按行读取文件的3种方法