首页 > 代码库 > Maven配置笔记
Maven配置笔记
android-m2e插件与maven
自定义用户配置路径
不管插件还是maven，默认的用户配置路径是统一的：${user.home}/.m2/settings.xml
但是插件可以通过eclipse设置用户配置的路径（配置方法参考《ADT+Android-m2e环境搭建》）；而maven不能永久指定，只能在每次使用mvn命令时加上"-s 新路径"参数。
依赖
如果使用android-m2d，在eclipse中写好依赖配置（<dependency>），保存之后就会自动去仓库下载该插件。如果找不到就会用红线标出。
使用maven，只有在编译的时候才会去检查依赖。
修改本地仓库默认路径
打开${M2_HOME}/conf/settings.xml，可以找到这句被注释的配置：
<!-- localRepository
| The path to the local repository maven will use to store artifacts.
|
| Default: ${user.home}/.m2/repository
<localRepository>/path/to/local/repo</localRepository>
-->
将/path/to/local/repo替换为自己的路径即可。
如果使用android-m2e插件，直接在eclipse中设置即可。
配置代理仓库（私有库）的位置
代理仓库的配置可以放在pom.xml中，但放在用户配置中可以省去很多麻烦。配置好代理仓库后，本地工程依赖的构件都将从配置指定的远程仓库下载。但请注意，此配置仅用于下载构件，无法通过此配置发布构件。
配置文件内容参考：
... <profiles> <profile> <id>repository</id> <repositories> <repository> <id>REPOSITORY-ID</id> <url>REPOSITORY-URL</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </repository> </repositories> </profile> </profiles> <activeProfiles> <activeProfile>repository</activeProfile> </activeProfiles> ...
将以上配置添加到用户配置中，有几个重要元素
REPOSITORY-ID：远程仓库id
REPOSITORY-URL：指定远程仓库的url
<releases>：是否启用发布构件的下载
<snapshots>：是否启用快照构件的下载。对于快照版本，如果链接的是中央仓库，由于快照版本不稳定，所以一般会推荐禁用快照版本的下载。但对于代理仓库，在多人合作开发的时候快照版本是有必要开启的。
对于<snapshots>元素，可以通过<updatePolicy>为其指定检查快照版本的策略。
默认情况下，maven每天检查一次快照版本的更新。<updatePolicy>的值有：
daily：每天检查一次，默认
never：从不检查
always：每次构建都会检查
interval：X 每隔X分钟检查一次，X为任意整数。
<snapshots> <enabled>true</enabled> <updatePolicy>always</updatePolicy> </snapshots>
发布构建所需的配置
远程仓库配置
该配置必须放在pom.xml中。在pom.xml中指定发布版和快照版仓库的位置：
<distributionManagement> <repository> <id>发布版仓库</id> <name>发布版仓库名称</name> <url>发布版仓库url</url> </repository> <snapshotRepository> <id>快照版仓库</id> <name>快照版仓库名称</name> <url>快照版仓库url</url> </snapshotRepository> </distributionManagement>
id和url构成了远程仓库的唯一标识，name只是方便阅读。
配置认证信息
该配置要放在用户或全局配置中：
<servers> <server> <!-- 需要认证的仓库id --> <id>发布版仓库id</id> <username>admin</username> <password>123456</password> </server> <server> <id>快照版仓库id</id> <username>admin</username> <password>123456</password> </server> </servers>
需要注意的是，认证信息中的<id>应该对应在pom.xml中配置的仓库<id>。
依赖管理
对于Jar的依赖
如果使用了android-m2e插件，无需自行下载和添加jar到classpath，只需在pom.xml中配置好依赖（<dependencies>），之后maven会增加一个Maven Dependencies：
·
然后就可以在代码中引用了。
对于库工程的依赖
同jar一样，直接在<denpencies>中配置好了。虽然执行maven命令可以直接编译通过，但是ADT本身不支持从Maven仓库中直接引用。因此不得不将库工程下载到workplace，导入eclipse，然后设置为library，再让自己的工程引用该library。
发布jar到本地仓库
工程中依赖的jar包，在中央仓库上不一定有自己想要的版本，可以将项目组所需的版本上传到代理仓库，个人的话在本地仓库安装一份也可以。
比如我们要基于API 11进行编译，需要android-11/android.jar，那么进入到${ANDROID_HOME}/platforms/android-11，执行下面的命令：
mvn install:install-file -Dfile=android.jar -DgroupId=com.google.android -DartifactId=android -Dversion=3.0 -Dpackaging=jar
如此，在无需pom.xml文件的情况下将jar包发布到本地仓库中。这样我们就可以在pom.xml中配置新的android依赖。
对于install-file，各参数的含义非常好理解，其中-Dfile是将要发布到仓库的包的位置，剩余的则是maven坐标以及打包类型。
发布库工程到本地仓库
我们自己写的库工程，将<packaging>改为apklib，执行install命令就好了。
以support-v7为例，操作步骤如下：
1. 用SDK Manager将support-v7下载到本地；
2. 将${ANDROID_HOME}/extras/android/support/v7/appcompat代码导入eclipse，将工程转为maven工程；
3. 将工程依赖的两个jar包先安装到本地仓库，进入${ANDROID_HOME}/extras/android/support/v7/appcompat/libs目录：
mvn install:install-file -Dfile=android-support-v7-appcompat.jar -DgroupId=com.google.android -DartifactId=android-support-v7-appcompat -Dversion=r7 -Dpackaging=jar mvn install:install-file -Dfile=android-support-v4.jar -DgroupId=com.google.android -DartifactId=support-v4 -Dversion=r7 -Dpackaging=jar
4. 修改pom.xml文件，增加对上面两个jar包的依赖：
<dependency> <groupId>com.google.android</groupId> <artifactId>android-support-v7-appcompat</artifactId> <version>r7</version> </dependency> <dependency> <groupId>com.google.android</groupId> <artifactId>support-v4</artifactId> <version>r7</version> </dependency>
5. 执行命令：mvn clean install
注意，再添加这两个依赖的时候，<scope>最好不要设置为provided。使用默认的compile可以使得这两个jar在依赖工程中可见，这样就无需再引用这两个jar
其他的库工程发布方法同上，接着是修改需要依赖support-v7的工程的pom.xml文件，增加依赖：
<dependency> <groupId>com.google.android</groupId> <artifactId>support-v7-appcompat</artifactId> <version>r7</version> <type>apklib</type> </dependency>
此时执行mvn clean install即可。
上面只是演示如何发布一个库工程，实际对于support-v7，可以不用建立maven工程，采用下面的方法更加简洁：
1. 进入${ANDROID_HOME}/extras/android/support/v7/appcompat，将目录下所有文件打包为support-v7-appcompat.zip，名字可以任意；
2. 执行命令：
mvn install:install-file -Dfile=support-v7-appcompat.zip -DgroupId=com.google.android -DartifactId=support-v7-appcompat -Dversion=r7 -Dpackaging=apklib
接下来的步骤同上面的3、4、5。
pom中的<sdk>和platform-version关系
起初因为在同一份配置中要在两个地方配置sdk版本感到很迷惑，通过查看maven运行日志了解到其中的关系。
在编译android工程的过程中，会经过下面两个个重要的阶段：
android-maven-plugin:3.8.2:generate-sources
这一步就是将assert、res等资源文件打包。实际调用的android命令是aapt（Android Asset Packaging Tool）
该命令需要某个平台的android.jar包：
${ANDORID_HOME}/build-tools/android-xxx/aapt package -f --no-crunch -I, ${ANDORID_HOME}/platforms/android-xx/android.jar。
在pom.xml中，android-maven-plugin配置中的<platform>元素所指定的api level，对应的就是上面命令红色部分的值。意思就是在打包资源的时候，依赖哪个api level的jar包。
maven-compiler-plugin:3.1:compile
在这一步实际调用了javac命令来编译源码：
javac -target {VM_VERSION} -bootclasspath ${ANDROID_HOME}\platforms\android-xx\android.jar -d bin {TARGET}
在pom.xml中，该阶段所依赖的配置便是<dependency>中配置的sdk版本。
这两个位置所指定的android sdk版本应当一致，只不过在<dependency>中必须使用version name，因为这是maven坐标的要求。而在android-maven-plugin的配置中却不支持version name，必须使用api level。
如果中央仓库没有合适的编译版本，自己上传一个到代理仓库，或者就安装在本地仓库，安装方法同安装依赖jar包的方法相同。安装过后修改<dependency>中的<version>值即可。
参考
Android 自动编译、打包生成apk文件 1 - 命令行方式
在Maven项目中使用Android Support Library
[置顶] Maven如何手动添加依赖的jar文件到本地Maven仓库