[翻譯]android-maven-plugin使用

0：前言：android-maven-plugin （原名maven-android-plugin)

首要參考文檔：

 （1）https://code.google.com/p/maven-android-plugin/wiki/GettingStarted

引子：

  我想用$sudo apt-get install maven來安裝可是報下面的錯誤：

maven:
 依賴: libaether-java 可是此軟件包將不會被安裝
 依賴: libplexus-containers1.5-java 可是此軟件包將不會被安裝
 依賴: libsisu-ioc-java 可是此軟件包將不會被安裝

因此我決定手動去下載來安裝了。看到了不錯的英文原文文檔，而後決定翻譯，

固然是是簡單的翻譯。

(第一篇）開始

 一： 準備

    1.JDK1.6+

    2.Android SDK(r17+,最新的會獲得最好的支持）

    3.Maven3.0.3+，見http://maven.apache.org/download.html

           （3.1）設置ANDROID_HOME環境變量爲Android SDK的目錄，同時將ANDROID_HOME/tools和ANDROID_HOME/platform-tools添加進環境變量

            （3.2)mac os用戶：須要在/etc/launchd.conf文件纔能有用，而不是.bashrc或者其它

=======插入 maven 安裝 及環境設置=========================

（以ubuntu爲例）

下載以後將apache-maven-3.0.4-bin-tar.gz解壓到~/bin目錄中。

而後：

（1）先設置一個連接：

banxi1988@banxi:~$ cd bin/
banxi1988@banxi:~/bin$ ls
aapt  apache-maven-3.0.4             apktool      qqgame  tomcat7
adb   apache-maven-3.0.4-bin.tar.gz  apktool.jar  repo
banxi1988@banxi:~/bin$ ln -s apache-maven-3.0.4 maven
banxi1988@banxi:~/bin$

（2）將maven環境變量設置寫入.bashrc中。

寫好後配置以下：

# add by banxi for java maven android development 
105 export JAVA_HOME=/usr/lib/jvm/java-6-openjdk-i386
106 export ANDROID_HOME=~/android/android-sdk-linux_x86
107 export M2_HOME=~/bin/maven
108 PATH=${PATH}:${M2_HOME}/bin:${ANDROID_HOME}/platform-tools:${ANDROID_HOME}/tools
109 export PATH

而後source下.bashrc

$source .bashrc

=========== END android maven環境配置=================================

二：推薦：測試你的開發環境

     測試開發環境，你能夠下載運行如下示例,見：https://code.google.com/p/maven-android-plugin/wiki/Samples

=========START 測試示例說明 ====================

示例文件在：https://github.com/jayway/maven-android-plugin-samples/zipball/stable

而後，下載後，能夠單獨運行其中的一個子項目。

由於是首次運行maven相關環境，因此maven一開始會下載不少相關的東西 ，插件之類：

morseflash示例項目，包含了大部分所須要的測試特性，因此我運行了：

$banxi1988@banxi :~/work/tmp/jayway-maven-android-plugin-samples/morseflash$ mvn install

=======================================

三 ：以簡單的方式建立Android應用(apk)

在maven中，最簡單的建立android應用的方式就是使用這些Maven Archetypes。

https://github.com/akquinet/android-archetypes/wiki

目前我在eclipse中手動添加archetypes時，發現倉庫中的最新的archetypes的版本號是1.0.8 ，沒有1.0.9的。

也許如今有了。

四：手動建立Android應用程序(apk)

 下面的手動建立Android項目的步驟：

         1.使用android工具建立一個項目。參考：http://developer.android.com/guide/developing/other-ide.html#CreatingAProject

          2.在項目中建立一個pom.xml文件，可使用示例項目helloflashlight中的pom.xml做爲模板。

                作些適當的修改：

                     (a) 將<groupId>,<artifactId>和<name>改成你本身項目的。(參考，Maven-命名約定指南)

                     （b)爲項目設置一個<version>標籤，例如<version>0.1.0-snapshot</version>

                      (c)更新你所依賴的所低的android平臺的版本：

<dependency>
  <groupId>com.google.android</groupId>
  <artifactId>android</artifactId>
  <version>1.5_r4</version>
  <scope>provided</scope>
</dependency>

能夠從：http://search.maven.org/#search%7Cga%7C1%7Ca%3A%22android%22 查看可用的版本號。

目前可用的有1.5_r3,1.5_r4,1.6_r2,2.1_r1,2.1.2 2.2.1,2.3.1,2.3.3,4.0.1.2,4.1.1.4 共10個可用版本號。

  在android-maven-plugin的配置中，爲<platform>設置與上面android版本號對應的api平臺例如：

<platform>7</platform>對應2.1_r1。

              3.對於使用android-maven-plugin來講，你不須要下面的文件或者目錄，你能夠刪除它們：

              $rm -r bin build.xml build.properties libs

              4.構建apk，你只需：

               $mvn clean install

              5.發佈apk到設置：

                 $ mvn android:deploy

            注意：src/test/java目錄下代碼只在本地測試運行而不會在android設備中。

             確保Android Maven goal是<goal>jar-no-fork</goal>，就是隻有測試也這樣作。

五：在設備中運行instrumentation測試

   參考測試示例的apidemos-15-instrumentationstest項目，你能夠建立一個相似的項目。

將你的"test"目錄改成如"myproject-instrumentationtest"，而後使用上面的apidemos-15-instrumentationtest目錄中的pom.xml做爲模板。

        

更多的文檔參見：

https://code.google.com/p/maven-android-plugin/wiki/Documentation