ADT+Maven Android App开发配置备忘

Maven安装和配置：
1. 安装并配置Ant（ http://ant.apache.org/，略）
2. 安装并配置Maven 3.11及以上版本（ http://maven.apache.org/，略）
3. 安装并配置M2Eclipse插件（ http://marketplace.eclipse.org/content/maven-integration-eclipse-juno-and-newer，略）
4. 安装Android Configurator for M2E插件（ http://marketplace.eclipse.org/content/android-configurator-m2e）
5. 安装并配置Android SDK（ http://developer.android.com/tools/sdk/eclipse-adt.html）
6. 设置系统环境变量ANDROID_HOME=adt-bundle-windows-x86\sdk
7. 系统环境Path变量加入%ANDROID_HOME%\tools

maven-android-sdk-deployer安装和配置：
1. 下载并解压（ https://github.com/mosabua/maven-android-sdk-deployer）
2. 命令行进入maven-android-sdk-deployer目录下，运行mvn install -P 4.4，其中4.4为安卓版本，要安装4.3版本则运行mvn install -P 4.3，
    效果是将android.jar包安装到maven本地库（4.1之后google改了协议，不再将android sdk放到中央库上了）
3. 命令行进入maven-android-sdk-deployer\extras\compatibility-v4目录下，运行mvn install，将android-support-v4.jar包安装到本地库，
    以上两个命令都依赖于你通过sdk manager下载过对应版本的sdk以及兼容库，需要其他api安装到本地库的，到对应目录下install一下即可

创建Maven App项目(apk)：
​1. 使用坐标为de.akquinet.android.archetypes，android-quickstart的archetype创建maven项目
2. 修改pom.xml，大致如下：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>me.allenz</groupId>
    <artifactId>maven-app</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>apk</packaging>
    <name>maven-app</name>
 
    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <platform.version>19</platform.version><!-- 安卓Api版本 -->
        <android.plugin.version>3.8.2</android.plugin.version>
    </properties>
 
    <dependencies>
        <dependency>
            <groupId>android</groupId>
            <artifactId>android</artifactId>
            <version>4.4.2_r2</version><!-- 安卓版本，和安装到本地库的包版本对应 -->
            <scope>provided</scope>
        </dependency>
    </dependencies>
    <build>
        <finalName>${project.artifactId}</finalName>
        <pluginManagement>
            <plugins>
                <plugin>
                    <groupId>com.jayway.maven.plugins.android.generation2</groupId>
                    <artifactId>android-maven-plugin</artifactId>
                    <version>${android.plugin.version}</version>
                    <extensions>true</extensions>
                </plugin>
            </plugins>
        </pluginManagement>
        <plugins>
            <plugin>
                <groupId>com.jayway.maven.plugins.android.generation2</groupId>
                <artifactId>android-maven-plugin</artifactId>
                <configuration>
                    <sdk>
                        <platform>${platform.version}</platform>
                    </sdk>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.1</version>
                <configuration>
                    <source>1.6</source>
                    <target>1.6</target>
                    <encoding>${project.build.sourceEncoding}</encoding>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

3. 项目菜单Maven->Update Project...

创建不含资源的Maven Library项目(jar)：
引用android库，和普通的java项目一样配置即可

创建包含资源的Maven Library项目(apklib)：
​1. 使用坐标为de.akquinet.android.archetypes，android-library的archetype创建maven项目
2. 修改pom.xml，大致如下：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>me.allenz</groupId>
    <artifactId>maven-lib-test</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>apklib</packaging>
    <name>maven-lib-test</name>
 
    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <platform.version>19</platform.version>
        <android.plugin.version>3.8.2</android.plugin.version>
    </properties>
 
    <dependencies>
        <dependency>
            <groupId>android</groupId>
            <artifactId>android</artifactId>
            <version>4.4.2_r2</version>
            <scope>provided</scope>
        </dependency>
    </dependencies>
 
    <build>
        <plugins>
            <plugin>
                <groupId>com.jayway.maven.plugins.android.generation2</groupId>
                <artifactId>android-maven-plugin</artifactId>
                <version>${android.plugin.version}</version>
                <extensions>true</extensions>
                <configuration>
                    <sdk>
                        <platform>${platform.version}</platform>
                    </sdk>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.1</version>
                <configuration>
                    <source>1.6</source>
                    <target>1.6</target>
                    <encoding>${project.build.sourceEncoding}</encoding>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-source-plugin</artifactId>
                <version>2.2.1</version>
                <executions>
                    <execution>
                        <id>attach-sources</id>
                        <goals>
                            <goal>jar</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <groupId>org.codehaus.mojo</groupId>
                <artifactId>build-helper-maven-plugin</artifactId>
                <version>1.8</version>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>attach-artifact</goal>
                        </goals>
                        <configuration>
                            <artifacts>
                                <artifact>
                                    <type>jar</type>
                                    <file>${project.build.directory}/${project.build.finalName}.jar</file>
                                </artifact>
                                <artifact>
                                    <type>aar</type>
                                    <file>${project.build.directory}/${project.build.finalName}.aar</file>
                                </artifact>
                            </artifacts>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

3. 项目菜单Maven->Update Project...   
4. install和deploy与一般项目无异，apk项目会生成apk包和源码包，apklib项目会生成apklib包、jar包、aar包和源码包

引用新建（工作空间内）的Maven Library项目
1. 在pom.xml写依赖即可

使用其他仓库的Maven Library项目
不含资源文件(jar)：直接在pom内加入依赖即可；

包含资源文件(apklib)：这个问题就十分蛋痛了，因为ADT不支持导入apklib包，也不支持aar包（在Android Studio上的新的Android Library打包格式），而且Google的精力
都集中在Android Studio，m2e-android的作者也停止更新，很可能Eclipse永远都不会支持apklib格式，这里只能使用半手动的方法了……

1. 分别使用

mvn org.apache.maven.plugins:maven-dependency-plugin:2.8:get -DrepoUrl=url -Dartifact=groupId:artifactId:version

和

mvn org.apache.maven.plugins:maven-dependency-plugin:2.8:get -DrepoUrl=url -Dartifact=groupId:artifactId:version:apklib

将你需要的jar和apklib包下到本地库，现在很多android开源项目都已经放到中央库了，比如：
http://search.maven.org/#artifactdetails|com.actionbarsherlock|actionbarsherlock|4.4.0|apklib
2. 用压缩工具打开apklib，如果只有源代码文件夹(src)而没有资源文件夹(res)，或者资源文件夹下没有内容，说明这个库项目不需要使用资源，直接在主项目的pom.xml中依赖jar包即可，跳过下面所有步骤
3. 如果这个库自带资源，那么在ADT工作空间下，新建groupId同名目录
4. 将apklib的内容解压到该目录；将pom文件也拷贝到该目录，改名为pom.xml
5. 如果项目目录下没有src文件夹，将项目目录名和pom.xml里面的groupId改为和原来的groupId不一致，推荐使用groupId-version；如果包含src文件夹，将src文件夹扩展为src\main\java多级目录
6. 在命令行运行

android update project -t target -p path

其中target编号是你下载过的android sdk版本的序号，可以通过

android list targets

获取，path就是项目路径
7. 在项目路径下执行

ant debug

，如果报错，无视
8. 在ADT导入这个maven项目，如果导入后报错，就按上文配置一下pom.xml并Update Project
9. 在App项目的pom内依赖这个apklib项目，如果看到R文件生成，说明成功了