1. 程式人生 > >Android Studio中ArcGIS Runtime Android SDK 100.1.0(100.2.0,100.3.0)開發原生地圖應用(入門環境配置)

Android Studio中ArcGIS Runtime Android SDK 100.1.0(100.2.0,100.3.0)開發原生地圖應用(入門環境配置)

前言

    最近因為工作關係,需要使用ArcGIS Runtime SDK for Android搭建一個簡單的入門Demo,也就是傳說中的Hello GISer。翻了一遍官方文件,ArcGIS Runtime SDK for Android的安裝推薦使用Gradle,而且使用的是線上的Esri's maven repository ,也就是說第一次構建工程的時候,需要從(https://esri.bintray.com/arcgis)中下載相應的依賴包,才能通過編譯,如下圖所示:

              

    按照【Install the SDK】和【Develop your first map app】的指引,在Android Studio2.0中建立好工程,配置好build.gradle之後,點選【Sync Now】進行編譯,如下圖:

Install the SDK 地址:

Develop your first map app地址:

    由於使用線上下載依賴包的方式,編譯的時候在Android Studio的底部狀態列處會提示正在下載arcgis-android-100.1.0.aar檔案,如下圖:

    arcgis-android-100.1.0.aar這個檔案其實才34M,但是下載的速度非常的慢,幾K的下載速度,這是不能容忍的。所以就想著能不能下載好SDK之後再使用本地依賴庫的方式構建工程。

    又回去翻看了一回【Install the SDK】,寥寥幾行,只提了個需要下載SDK,至於怎麼樣配置,沒有任何說明:

    

    對於我這種需要的時候,才使用Android SDK的藍鳥來說,這可就有點小小挑戰了。但既然提供了SDK,那麼也就意味著可以離線使用,所以首要的是先下載好SDK並解壓。一份好的SDK,往往會有一個非常重要的檔案,它叫README.txt,這裡我們瞭解一份SDK的入門,所以我們開啟它看看到底都寫了些什麼如下圖:

 內容也是簡單的不能再簡單了,但是也都點出了重要的步驟:

總的來說就是需要做這麼幾件事:

  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來開發移動端的地圖應用,第一步的開發環境配置對於小白使用者來說還是有點挑戰,當然如果你人再國外,使用線上依賴包會簡單很多,但由於網路的原因,我們必須使用離線依賴包,所以才有了這篇文章。記錄下來,以免過了一段時間之後又不記得了。

彩蛋

寫下這篇文章的時候,ArcGIS Runtime SDK for Android的版本是100.1.0,而到今天(20180930)最新的版本是100.3.0,目前的版本中支援移動端三維能力,效能和功能上也越來越完善。對於ArcGIS Runtime SDK for Android 100.3.0版本的離線開發環境配置,它的思路其實是一樣的,只是中間有一個關節不需要再去操作,那就是arcgis-android-100.3.0.pom這個檔案在SDK中已經提供了,不用再費勁去下載。

OK,如果你是一個小白GIS從業人,想更省時省力的製作精美地圖,那麼強烈推薦開啟下面這個連結: