使用、创造和分享
笔者曾经不思量力的思考过『是什么推动了互联网技术的快速发展?』
这种伟大的命题。结论是,除了摩尔定律之外,技术经验的快速积累和广泛分享
,也是重要的原因。
有人戏称,『写 Java,首先要学会选包』,在这里不好评论对错。不过这句话里面,至少包含两层意思:首先 Java 有大量的现成的依赖包,不必要自己造轮子;其次,Java 的包存放较为集中,集成方式也方便。
笔者从事 Android 和 Java 开发以来,经历了几个阶段:
闭门造轮子 > 使用别人的轮子 > 开门造轮子 > 分享轮子
在使用、创造、分享轮子的过程中,maven 仓库的使用可谓必备技能。
相信各位使用 Android Studio,对于 jcenter()
、mavenCentral()
等概念应该是司空见惯了。程序员要知其然,知其所以然。本篇将按照如下脉络介绍在 Android Studio 中 Maven 仓库相关的概念和应用。
- Maven 包
- Maven 仓库
- 发布包到本地仓库
- 发布包到 Bintray Jcenter 远程仓库
- 发布包到 Sonatype MavenCentral 远程仓库
- 搭建私有 Sonatype 仓库
- 搭建私有 Artifacotory 仓库
Maven 包(Package)
至于 Maven 是什么,请参考 Apache 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 )有此要求。
使用这个包的方式,相信大家已经很熟悉了:
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 中央仓库
- 第三个是笔者的本机的仓库
- 第四个是笔者部署在内网服务器的私有仓库
读者可能会发现两个问题:
- 为什么有了 mavenCentral,谷歌还切换到了 jcenter?
maven { url : xxx}
,这种格式可以配置任何一个存在的仓库?
解释如下:
jcenter VS. mavenCentral
根据这篇博客,jcenter 具有如下优胜特点,使得谷歌进行切换:
- jcenter 是一个 mavenCentral 的超集,jcenter 还包含了其他 maven 包
- jcenter 具有更好的 cdn,默认支持 https,这个对于谷歌有巨大吸引力
- bintray(jcenter 的服务提供商)表示 jcenter 具有更好的性能
- 有数据表明 bintray jcenter 占用更少的本地缓存空间
- 更好的交互界面,可以从 jcenter 向 mavenCentral 同步包(下面两个平台的使用教程将会证实这一点)
笔者亲测,在 bintray 上发布包到 jcenter 在易用性上的确比 在 sonatype 发布到到 mavenCentral 要好得多。
使用符合规范的 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/' }