文/Bugtags(简书作者)
原文链接:http://www.jianshu.com/p/ca5cc986c001
著作权归作者所有,转载请联系作者获得授权,并标注“简书作者”。
什么是Maven
Apache Maven,是一个软件(特别是Java软件)项目管理及自动构建工具,由Apache软件基金会所提供。基于项目对象模型(缩写:POM)概念,Maven利用一个中央信息片断能管理一个项目的构建、报告和文档等步骤。
Maven也可被用于构建和管理各种项目,例如C#,Ruby,Scala和其他语言编写的项目。Maven曾是Jakarta项目的子项目,现为由Apache软件基金会主持的独立Apache项目。
Maven项目使用称为项目对象模型(Project Object Model,POM)来配置的。
项目对象模型存储在命名为 pom.xml 的文件中。
Maven包
对于 Android 开发者而言,只需要知道 Maven 是一种构建工具,Maven 包是由所谓 POM(Project Object Model)所定义的文件包格式即可。
Gradle 可以使用 Maven 包,而且大部分的 Android 能够使用的远程依赖包都是 Maven 包。
托管在某仓库上的 Maven 包:Bugtags-Android-Lib 所包含的内容:
bugtags-lib-1.1.0-javadoc.jar//javadoc 文件
bugtags-lib-1.1.0-javadoc.jar.asc//javadoc 文件的签名
bugtags-lib-1.1.0-sources.jar//源码文件
bugtags-lib-1.1.0-sources.jar.asc//源码文件的签名
bugtags-lib-1.1.0.aar//Android Library 的主文件包
bugtags-lib-1.1.0.aar.asc//主文件包的签名
bugtags-lib-1.1.0.pom//包描述文件
bugtags-lib-1.1.0.pom.asc//描述文件的签名
对于一个合符规范的 Maven Package,pom 文件、aar(或者 jar) 文件是必须的。
而 javadoc 文件、源码文件、签名文件都不是必要的,但是某些公开仓库(如 mavenCentral )有此要求。
在Android Studio中Gradle添加包资源的方式:
dependencies {
compile 'com.bugtags.library:bugtags-lib:1.1.0'
}
POM 文件
一个 Maven Package,最重要就是 POM(Project Object Model) 文件,这其实是一个 XML 文件,这里截取 Bugtags-Android-Lib POM 主要内容如下:
<?xml version="1.0" encoding="UTF-8"?>
<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"
xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<modelVersion>4.0.0</modelVersion>
<groupId>com.bugtags.library</groupId>
<artifactId>bugtags-lib</artifactId>
<version>1.1.0</version>
<packaging>aar</packaging>
<dependencies>
<dependency>
<groupId>com.android.support</groupId>
<artifactId>support-v4</artifactId>
<version>19.0.0</version>
<scope>compile</scope> </dependency>
</dependencies>
</project>
- modelVersion: 从 mvn 2.x 起,这个数值都是4.0.0
- packaging:打包方式,aar 是 Android Libirary 的打包方式,常用的还有 jar
- dependency:声明依赖列表
- 包的唯一标示:
<!--包组 id,通常是发布者拥有的域名的反向,以免跟别人的重复-->
<groupId>com.bugtags.library</groupId>
<!--包 artifactId,不好意思我也不知道如何准确翻译,其实就是组以下应该有一个更小的归类-->
<artifactId>bugtags-lib</artifactId>
<!--包版本-->
<version>1.1.0</version>
其中三个字段与 Gradle 的依赖格式'com.bugtags.library:bugtags-lib:1.1.0'
冒号分割的三段一一对应。这就解释了所谓的** Gradle 兼容 Maven 包
**。
Maven 仓库
Maven 包集中存放的地方,就是 Maven 仓库。这些仓库,可以是放在本地,也可以放在某个远程服务器上。 可以是私有仓库,也可以是公开的。添加各类包的用法如下:
mavenCentral();
jcenter()
maven { url 'file:///Users/my-user-name/Documents/Android/repo/'}
maven { url 'http://192.168.99.100:8081/content/repositories/releases/'}
Android Studio Gradle 主要支持两个 Maven 中央库:mavenCentral。
和 jcenter
- mavenCentral 是最早的 maven 中央仓库
- jcenter 是 Android Studio 0.8 版本起的默认 maven 中央仓库(jcenter 是一个 mavenCentral 的超集,jcenter 还包含了其他 maven 包
jcenter 具有更好的 cdn,默认支持 https。所以Android Studio默认是jcenter) - 第三个是本机的仓库
- 第四个是部署在内网服务器的私有仓库
使用符合规范的 maven 仓库
可以通过 maven { url : xxx }使用任何一个符合 maven 规范的仓库。
- 存在本地
maven { url 'file:///Users/my-user-name/Documents/Android/repo/' }
- 存在私有仓库
maven {
url 'http://192.168.99.100:8081/content/repositories/releases/'
}
- 存在某个远程服务器
maven {
url 'https://raw.githubusercontent.com/liaohuqiu/umeng-libs/master/repository'
}