《ArcGIS Runtime SDK for Android開發筆記》——（5）、基於Android Studio構建ArcGIS Android開發環境（離線部署）

1、前言

在上一篇的內容里我們介紹了基於Android Studio構建ArcGIS Runtime SDK for Android開發環境的基本流程，流程中我們采用的是基於Gradle的構建方式，在這種方式里主要通過設置maven倉庫位置，設置編譯選項、依賴版本在聯網環境下下載對應SDK依賴包。

但是在網絡情況不好的情況下這種方式就不行了，那怎么解決在離線環境或者內網環境實現開發流程呢？目前了解到的有兩種方式：

1）配置內網環境maven倉庫，預先緩存到內網環境下，然后離線調用。

2）采用直接拷貝引用方式，拷貝jar包、so庫到對應第三方庫支持位置，直接調用使用。

這兩種方式各有各的優劣，看具體使用場景，在這里我們主要介紹第二種拷貝引用的方式。

轉載請注明出處：http://www.cnblogs.com/gis-luq/p/4760377.html

 

2、離線部署流程

2.1、下載ArcGIS Runtime SDK for Android的SDK包

1) 登陸ArcGIS Runtime SDK for Android開發者資源中心。

 

2) 登陸后點擊下載按鈕、在下載頁面下載對應SDK包

 

2.2、拷貝相關支持函數庫到指定項目對應位置並添加引用

1）解壓下載下來的zip包，SDK包中主要包含以下內容：

其中里面比較重要的有以下幾項：
1、doc —— 該版本SDK對應的API文檔，官網一直都是最新的，需要查看舊版API或者指定版本API說明的的一般需要到這里查找
2、lib-project —— aar格式的函數庫，例如：arcgis-android-v10.2.6-2.aar
3、libs —— jar和so格式的函數庫，一般在項目中拷貝到項目文件夾下，引用即可，可實現離線部署
4、samples——示例代碼。官方所有示例代碼都在這里，新版基於Android studio 開發環境
其他說明：SDK包下載及說明也可以參考博文http://www.cnblogs.com/gis-luq/p/4735815.html

2）打開SDK包中lib文件夾，將jar包拷貝包對項目的lib文件夾下

將libs中的：arcgis-android-api.jar、arcgis-android-app-toolkit.jar、jackson-core-1.9.5.jar、jackson-mapper-1.9.5.jar、jcifs-1.3.17.jar這個5個jar包拷貝到新建Android項目HelloMap2中的../app/libs文件夾下

3）在項目的../src/main文件夾下創建jniLibs文件夾，並將armeabi、armeabi-v7a、x86三個文件夾拷貝到jniLibs文件夾下。

 

說明：其實這里關於如何在android studio配置java訪問so庫的方式有很好幾種，在網上也有相關的說明博客，這里我是選了我認為相對最簡單一種做了測試，並測試OK，所以用了這種方式。其他方式暫時沒有測過

2.3、添加UI及代碼信息

1）在布局文件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>

在這里我們注意到環境並沒有識別到com.esri.android.map.MapView類，並提示異常。切換項目顯示方式為project。

選中項目下app/libs/arcgis-android-api.jar右鍵設置Add As Library，添加之后“找不到com.esri.android.map.MapView類”的問題就沒有了。

同時我們查看app下的build.gradle，發現增加了一條編譯選項，這里我們用代碼的方式直接加在這里也是可以的。

2）添加代碼信息，實現MapView的UI和代碼綁定，添加一個圖層並顯示出來

private MapView mapView = null;

this.mapView = (MapView)this.findViewById(R.id.map);//設置UI和代碼綁定
String strMapUrl="http://map.geoq.cn/ArcGIS/rest/services/ChinaOnlineCommunity/MapServer";
ArcGISTiledMapServiceLayer arcGISTiledMapServiceLayer = new ArcGISTiledMapServiceLayer(strMapUrl);
this.mapView.addLayer(arcGISTiledMapServiceLayer);

2.4、設置應用程序權限

對於絕大多數的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" />

2.5、編譯運行應用程序

直接運行后我們還發現了這樣的一個錯誤，提示需要忽略許可信息在打包選項中。

打開build.gradle(Module:app)設置排除相關信息

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

重新運行編譯，程序通過