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仓库