由于项目越来越多,有很多公共的代码都可以抽取出一个开发库出来传到公司搭建好的Maven私服,以供大家使用。
之前搭建的Maven仓库只有Release和Snapshot两个仓库,最近由于开发库有时候不稳定有bug,不便于测试。因此领导说要搭建三个版本的仓库,分别为Release版本、Beta版本、Dev版本,Snapshot版本废弃掉,下面来分别介绍下这三个版本仓库的意义。
Dev版本:是用于开发库维护人员能够很快的新增代码并上传到Maven仓库,这样其他开发人员就能够很快的获取该Dev版本的Android 开发库进行开发。Beta版本:用于当使用Dev版本提供的开发库开发功能,并且功能开发完毕之后,准备提测给测试人员测试功能的时候,将最新的稳定的Dev版本代码上传到Beta仓库变成Beta版本,Beta版本的开发库较Dev版本稳定。Release版本:用于测试人员测试完使用Beta版本提供的开发库开发完毕功能点,并且功能点稳定,准备发布APP的时候,最新的稳定的Beta版本代码上传到Release仓库变成Release版本,Release版本的开发库较Beta版本稳定。下面是我最近搭建的这三个版本Release版本、Beta版本、Dev版本的仓库的截图。

至于这三个版本Release版本、Beta版本、Dev版本的仓库如何新建,我准备在下一篇博客再写,因为一般搭建仓库的活不用每个人干,但是上传Android开发库到Maven私服的需求应该很多人都有。所以这篇博客先介绍如何快速创建和发布Android 开发库到Maven私服。
新建一个工程,如下图所示: 
如上图所示,新建一个工程MavenTest,然后新建一个Module(模块)名为ouyangpeng,这个名为ouyangpeng的Module就是我们准备测试打包成AAR上传到Maven私服的开发库。
新建好 ouyangpeng 模块之后,在settings.gradle文件中,将该module加入进去,用于编译,这一步Android Studio会自动添加好。 settings.gradle文件文件代码如下:
include ':app', ':ouyangpeng'在该Module里面随便新建一个类,名为MavenTest.java,代码如下所示:
package test.maven.xtc.com.ouyangpeng;/** * 测试上传Android开发库AAR文件到Maven私服 * </p> * created by OuyangPeng at 2017/2/24 19:06 * * 博客地址:http://blog.csdn.net/ouyang_peng/ */public class MavenTest { /** * 测试Maven注释 */ PRivate String mMaven = "maven"; public String getMaven() { return mMaven; } public void setMaven(String maven) { mMaven = maven; }}ouyangpeng 模块的build.gradle文件为
apply plugin: 'com.android.library'apply from: 'maven_upload.gradle'android { compileSdkVersion 25 buildToolsVersion "25.0.0" defaultConfig { minSdkVersion 15 targetSdkVersion 25 versionCode 1 versionName "1.0" testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner" } buildTypes { release { minifyEnabled false proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' } }}dependencies { compile fileTree(dir: 'libs', include: ['*.jar']) androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', { exclude group: 'com.android.support', module: 'support-annotations' }) compile 'com.android.support:appcompat-v7:25.0.0' testCompile 'junit:junit:4.12'}作者:欧阳鹏 欢迎转载,与人分享是进步的源泉! 转载请保留原文地址: http://blog.csdn.net/ouyang_peng/article/details/56872556

第二步,编写上传ouyangpeng 模块打包成AAR之后上传到Maven私服的gradle脚本 首先先大致的讲解下,我会新建的三个文件的作用,如下图所示: 
下面我们来具体的的讲解这几个文件。
在 ouyangpeng 模块中的build.gradle文件中,我们发现了有这么一段代码
apply plugin: 'com.android.library'apply from: 'maven_upload.gradle'这段代码的意思是,第一行代码将模块ouyangpeng生成为library类型的开发库,第二行代码的意思是引用名为maven_upload.gradle的gradle文件到该build.gradle文件中。
maven_upload.gradle文件代码如下:
apply plugin: 'maven'//读取第一个配置文件 maven_user.propertiesProperties user_properties = new Properties()user_properties.load(project.rootProject.file('maven_user.properties').newDataInputStream())def releaseRepoUrl = user_properties.getProperty("repository.url.release")def betaRepoUrl = user_properties.getProperty("repository.url.beta")def devRepoUrl = user_properties.getProperty("repository.url.dev")def userName = user_properties.getProperty("repository.user")def userPassWord = user_properties.getProperty("repository.password")//读取第二个配置文件 maven_pom.propertiesProperties pom_properties = new Properties()pom_properties.load(project.file('maven_pom.properties').newDataInputStream())def pom_name = pom_properties.getProperty("POM_NAME")def pom_description = pom_properties.getProperty("POM_DESCRIPTION")def pom_group = pom_properties.getProperty("POM_GROUP")def pom_artifact_id = pom_properties.getProperty("POM_ARTIFACT_ID")def pom_packaging = pom_properties.getProperty("POM_PACKAGING")def pom_version_type = pom_properties.getProperty("POM_VERSION_TYPE")def pom_version_release = pom_properties.getProperty("POM_VERSION_RELEASE")def pom_version_dev = pom_properties.getProperty("POM_VERSION_DEV")def pom_version_beta = pom_properties.getProperty("POM_VERSION_BETA")def repoUrldef pom_versionuploadArchives { if (pom_version_type.equals("DEV")) { repoUrl = devRepoUrl pom_version = pom_version_dev } else if (pom_version_type.equals("BETA")){ repoUrl = betaRepoUrl pom_version = pom_version_beta } else if (pom_version_type.equals("RELEASE")){ repoUrl = releaseRepoUrl pom_version = pom_version_release } else { throw Exception(">>>>>>>>>>>>>>上传失败,POM_VERSION_TYPE = "+pom_version_type+" ,请确认maven_user.properties文件中 POM_VERSION_TYPE 参数填写正确,POM版本必须为(DEV、BETA、RELEASE)中的一种类型<<<<<<<<<<"); } println "pom_version_type = " + pom_version_type println "pom_version = " + pom_version println "repoUrl = " + repoUrl +"/n" repositories.mavenDeployer { repository(url: repoUrl) { authentication(userName: userName, password: userPassword) } pom.project { name pom_name description pom_description url repoUrl groupId pom_group artifactId pom_artifact_id version pom_version packaging pom_packaging } }}task cleanDir(type:Delete) { delete buildDir}task androidJavadocs(type: Javadoc) { // 设置源码所在的位置 source = android.sourceSets.main.java.sourceFiles}// 生成javadoc.jartask androidJavadocsJar(type: Jar) { // 指定文档名称 classifier = 'javadoc' from androidJavadocs.destinationDir}// 生成sources.jartask androidSourcesJar(type: Jar) { classifier = 'sources' from android.sourceSets.main.java.sourceFiles}//是否是开发版本def isDevOrBetaBuild(String version) { if (version == null || version.isEmpty()){ throw Exception(">>>>>>>>>>>>>>编译失败,POM_VERSION_TYPE = "+pom_version_type+" ,请确认maven_user.properties文件中 POM_VERSION_TYPE 参数填写正确,POM版本必须为(DEV、BETA、RELEASE)中的一种类型<<<<<<<<<<"); } return version.contains("Dev") || version.contains("Beta");}artifacts { if (isDevOrBetaBuild(pom_version)) { archives androidSourcesJar archives androidJavadocsJar }}uploadArchives.mustRunAfter 'cleanDir'该gradle脚本主要是上传Maven的gradle脚本,该脚本会去读取maven_pom.properties配置文件和maven_user.properties配置文件的内容,然后新建一个upload任务Task,一旦你准备发布你的开发库,在 Android Studio 中, 打开右侧的 Gradle 视图,在 Tasks > upload 下,点击 uploadArchives,将会上传你的开发库到你所定义好的Maven私服的仓库上去。如下图所示: 
该脚本在上传到Maven仓库之前,会判断要上传的是什么版本的AAR,如果是Dev和Beta版本的AAR的话,上传之后的AAR文件在用的时候可以看到AAR里面的类的注释,如果是Release版本的AAR的话,将看不到AAR里面的类的注释
maven_user.properties配置文件主要是配置了Maven私服上的Release版本、Beta版本、Dev版本的仓库,以及用户名和密码等基本配置。如下所示

代码如下所示:
#用户名repository.user=androidcsdn#密码repository.password=ouyangpengcsdn#release仓库地址repository.url.release=http://172.28.10.222:8081/nexus/content/repositories/android-release/#beta仓库地址repository.url.beta=http://172.28.10.222:8081/nexus/content/repositories/android-beta/#dev仓库地址repository.url.dev=http://172.28.10.222:8081/nexus/content/repositories/android-dev/maven_pom.properties配置文件主要是配置了要打包生成后的AAR包上传到Maven私服之后的一些Maven属性,主要包括groupId属性,artifactId属性,version属性,type属性等,代码如下。

如上图所示的配置,我们这次要上传的版本为DEV版本,这样我会上传POM_VERSION_DEV=0.0.2-Dev到 dev仓库地址repository.url.dev (http://172.28.10.222:8081/nexus/content/repositories/android-dev/)
如果想上传Beta版本的,则将POM_VERSION_TYPE属性改为BETA ,并修改属性POM_VERSION_BETA为你想上传的版本号,如改为如下的配置:
#RELEASE版本POM_VERSION_RELEASE=0.0.1#DEV版本POM_VERSION_DEV=0.0.2-Dev#BETA版本POM_VERSION_BETA=0.0.5-Beta#类型分为 DEV、BETA、RELEASE 三种POM_VERSION_TYPE=BETA则说明你要将Beta版本的版本号为0.0.5-Beta的AAR上传到 Beta仓库地址repository.url.beta http://172.28.10.222:8081/nexus/content/repositories/android-beta/
之后想上传不同的版本到不同的仓库的话,只需要修改该文件的POM_VERSION_TYPE属性以及相应版本的版本号属性,如POM_VERSION_RELEASE对应的Release版本,POM_VERSION_DEV对应的Dev版本,POM_VERSION_BETA对应的Beta版本。
之后其他的配置文件maven_user.properties配置文件和maven_upload.gradle文件不需要修改,只需要修改该配置文件即可根据不同的类型上传到不同的仓库。
作者:欧阳鹏 欢迎转载,与人分享是进步的源泉! 转载请保留原文地址: http://blog.csdn.net/ouyang_peng/article/details/56872556

第一步点击右边的侧边栏 Gradle选项,第二步选中uploadArchives任务, 
第二步点击鼠标右键,选中第一项 Run ,执行上传gradle脚本 ,如下图所示 
例如上面我们上次版本为0.0.5-Beta的版本到Beta仓库,执行脚本之后,如果一切正常的话,Android Studio的Run窗口可以看到如下所示的提示:

点击左上角的漏斗标志,可以看到一片绿色。 

就会在Nexus服务器(http://172.28.10.222:8081/nexus/#view-repositories) 上可以查看上传的具体内容,如下所示:

点开可以查看上次的具体内容,如下图所示: 

因为坚持一个约定优于配置原则,因此我们团队内部有了如下的约定,并且要求大家严格按照约定来填写配置文件,约定如下所示。
RELEASE版本,不需要后缀POM_VERSION_RELEASE=0.0.1DEV版本,后缀为DevPOM_VERSION_DEV=0.0.2-DevBETA版本,后缀为BetaPOM_VERSION_BETA=0.0.6-Beta类型分为 DEV、BETA、RELEASE 三种,也仅有此三种情况。POM_VERSION_TYPE=DEV但是难免会有人不按照约定来,因此我在maven_upload.gradle文件文件中,读取maven_pom.properties配置文件和maven_user.properties配置文件的内容之后,会有相关的逻辑来判断配置的是否符合规范,如果不符合规范的话,则会抛异常提醒团队成员配置出错了。
例如我们将maven_pom.properties的部分配置配置如下所示,故意将POM_VERSION_TYPE配置为错误的BETAa,正确的只能是DEV、BETA、RELEASE 三种
POM_NAME=androidPOM_DESCRIPTION=a lib for ouyangpeng#对应Maven groupIdPOM_GROUP=com.xtc.ouyangpeng#对应Maven aritfaceIdPOM_ARTIFACT_ID=ouyangpeng#打包方式POM_PACKAGING=aar#RELEASE版本POM_VERSION_RELEASE=0.0.1#DEV版本POM_VERSION_DEV=0.0.2-Dev#BETA版本POM_VERSION_BETA=0.0.5-Beta#类型分为 DEV、BETA、RELEASE 三种POM_VERSION_TYPE=BETAa
因此就会报错,提示如下所示: 
提示我们 maven_upload.gradle’ 文件 42 行抛了异常,异常提醒为:
>>>>>>>>>>>>>>上传失败,POM_VERSION_TYPE = BETAa ,请确认maven_user.properties文件中 POM_VERSION_TYPE 参数填写正确,POM版本必须为(DEV、BETA、RELEASE)中的一种类型<<<<<<<<<<maven_upload.gradle’ 文件 42 行代码如下图所示:

因此,只要我们将POM_VERSION_TYPE配置为正确的只能是DEV、BETA、RELEASE 三种中的一种,即可正常上传成功。
还有一种可能出错的地方是用户名和密码配置出错了,也会报错,错误如下所示:
Error:Execution failed for task ':ouyangpeng:uploadArchives'.> Could not publish configuration 'archives' > Failed to deploy artifacts: Could not transfer artifact com.xtc.ouyangpeng:ouyangpeng:aar:0.0.5-Beta from/to remote (http://172.28.10.222:8081/nexus/content/repositories/android-beta/): Failed to transfer file: http://172.28.10.222:8081/nexus/content/repositories/android-beta/com/xtc/ouyangpeng/ouyangpeng/0.0.5-Beta/ouyangpeng-0.0.5-Beta.aar. Return code is: 401, ReasonPhrase: Unauthorized.
这儿提示是因为我们的用户名和密码填写错误了,或者是该用户名并不能在该仓库中上传文件之类的,总之配置好正确的用户名和密码之后,就可以上传成功了。
如上图所示,我们已经将模块ouyangpeng打包成aar并上传到了Maven私服,现在我们在模块app中使用刚才上传好的库文件。
先在工程根目录下的 build.gradle 文件中 repositories (2个都要)添加如下代码片段:
maven { url "http://172.28.10.222:8081/nexus/content/groups/android_public/" }配置完成之后的完整代码如下所示:
// Top-level build file where you can add configuration options common to all sub-projects/modules.buildscript { repositories { jcenter() maven { url "http://172.28.10.222:8081/nexus/content/groups/android_public/" } } dependencies { classpath 'com.android.tools.build:gradle:2.2.3' // NOTE: Do not place your application dependencies here; they belong // in the individual module build.gradle files }}allprojects { repositories { jcenter() maven { url "http://172.28.10.222:8081/nexus/content/groups/android_public/" } }}task clean(type: Delete) { delete rootProject.buildDir}
至于为什么是配置 http://172.28.10.222:8081/nexus/content/groups/android_public/ 这个地址的话,是因为我将Beta/Dev/Release仓库都使用android public 仓库来映射了,只要访问android public 仓库就可以顺利的访问Beta/Dev/Release仓库,如下图所示:

点击可以查看刚才上传好的Beta/Dev/Release版本的开发库,如下图所示 

在app模块的build.gradle 文件中添加如下依赖。
dependencies { compile 'com.xtc.ouyangpeng:ouyangpeng:0.0.5-Beta'}配置完之后的完整代码如下所示:
apply plugin: 'com.android.application'android { compileSdkVersion 25 buildToolsVersion "25.0.0" defaultConfig { applicationId "com.xtc.maven.test" minSdkVersion 15 targetSdkVersion 25 versionCode 1 versionName "1.0" testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner" } buildTypes { release { minifyEnabled false proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' } }}dependencies { compile fileTree(dir: 'libs', include: ['*.jar']) androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', { exclude group: 'com.android.support', module: 'support-annotations' }) compile 'com.android.support:appcompat-v7:25.0.0' compile 'com.android.support:design:25.0.0' testCompile 'junit:junit:4.12' compile 'com.xtc.ouyangpeng:ouyangpeng:0.0.5-Beta'}
然后重新同步编译一下,编译成功之后,可以看到如下所示的引用包中包含了刚才的ouyangpeng:0.0.5-Beta.aar

点开可以查看源代码如下所示,可以发现有注释。 
如果引用一个Release版本的,则没有注释,如下所示: 重新上传一个RELEASE版本的aar到Maven私服,配置文件如下
#RELEASE版本POM_VERSION_RELEASE=0.0.1#DEV版本POM_VERSION_DEV=0.0.2-Dev#BETA版本POM_VERSION_BETA=0.0.5-Beta#类型分为 DEV、BETA、RELEASE 三种POM_VERSION_TYPE=RELEASE上传成功后,如下所示: 
现在在工程中引用该ouyangpeng:0.0.1.aar版本的AAR文件,更改build.gradle的引用配置为
dependencies { compile 'com.xtc.ouyangpeng:ouyangpeng:0.0.1'}
现在打开ouyangpeng:0.0.1.aar的源代码查看,发现没有注释,如下所示: 
至于这三个版本Release版本、Beta版本、Dev版本的仓库如何新建,我准备在下一篇博客再写。
作者:欧阳鹏 欢迎转载,与人分享是进步的源泉! 转载请保留原文地址: http://blog.csdn.net/ouyang_peng/article/details/56872556

新闻热点
疑难解答