在Android Studio中发布Library到jCenter本地仓库

引论

在在Android Studio中发布Library到jCenter公共仓库中，我们知道了

repositories {
        jcenter()
    }

是如何工作的，也知道了如何向全球公共仓库提交自己的Library。
有时我们在添加依赖时还可能添加jCenter之外的仓库，如：

repositories {
        jcenter()
        maven { url "http://localhost:8081/artifactory/libs-release-local" }
    }

在此处url是一个本地仓库，也可能是网络的某个位置。
就好像github是一个网上的git repo，本地开发环境也有一个完整的git repo一样，jCenter就是这样一个最大的网络repo，同时我们可以利用Bintray提供的开源应用artifactory来搭建本地或团队使用的repo。
下图是jFrog BinTray官方提供的artifactory架构图：

可以看出，通过artifactory可以与非常多的开发工具进行集成，构建最优的开发流程，与内部用户权限管理整合，提供完整的应用包分发管理。还可以配置同步到jCenter，这也是BinTray设计artifactory的重要一环。

还有其它的库管理应用，因为我们的开发与jCenter尝试整合，就不考虑其它的了，给出列表供参考。
Repository Management Tools

搭建artifactory

JDK

artifactory本身是一个开源的Java EE应用，确保机器上有JDK运行，推荐使用最新的JDK8，JDK7官方已不再更新，artifactory也对JDK7支持不好。

➜  Downloads  java -version
java version "1.8.0_60"
Java(TM) SE Runtime Environment (build 1.8.0_60-b27)
Java HotSpot(TM) 64-Bit Server VM (build 25.60-b23, mixed mode)

artifactory

下载Artifactory后解压zip包，可以直接运行，已包含Tomcat容器。

➜  Downloads  ./artifactory-oss-4.1.3/bin/artifactory.sh

看到

###########################################################
### Artifactory successfully started (4.930 seconds)    ###
###########################################################

Done，本地的artifactory已经运行起来了，浏览器打开http://localhost:8081/artifactory/
默认的用户名密码是admin/password，可以进行管理，现在先不配置，继续我们的上传进程。

发布

配置Gradle

在Project/build.gradle下添加：

buildscript {
    dependencies {
    //添加引用位置
        classpath "org.jfrog.buildinfo:build-info-extractor-gradle:3.1.1"
    }
}

在Library/build.gradle中添加：

//plugin要添加到apply plugin: 'com.android.library'之后
//添加上传所需的插件
apply plugin: 'com.jfrog.artifactory'
apply plugin: 'maven-publish'
//定义包名和版本号
def packageName = 'com.geek.dev'
def libraryVersion = '1.0.2'

publishing {
    publications {
        aar(MavenPublication) {
            groupId packageName
            version = libraryVersion
            artifactId project.getName()

            // Tell maven to prepare the generated "*.aar" file for publishing
            artifact("$buildDir/outputs/aar/${project.getName()}-release.aar")
        }
    }
}
artifactory {
    contextUrl = 'http://localhost:8081/artifactory'
    publish {
        repository {
            // The Artifactory repository key to publish to
            repoKey = 'libs-release-local'

            username = "admin"
            password = "password"
        }
        defaults {
            // Tell the Artifactory Plugin which artifacts should be published to Artifactory.
            publications('aar')
            publishArtifacts = true

            // Properties to be attached to the published artifacts.
            properties = ['qa.level': 'basic', 'dev.team': 'core']
            // Publish generated POM files to Artifactory (true by default)
            publishPom = true
        }
    }
}

运行发布

在Terminal Panel中运行：

./gradle assembleRelease artifactoryPublish

看到发布结果：

Deploying artifact: http://localhost:8081/artifactory/libs-release-local/com/geek/dev/weatherlib/1.0.2/weatherlib-1.0.2.aar
Deploying artifact: http://localhost:8081/artifactory/libs-release-local/com/geek/dev/weatherlib/1.0.2/weatherlib-1.0.2.pom
Deploying build descriptor to: http://localhost:8081/artifactory/api/build
Build successfully deployed. Browse it in Artifactory under http://localhost:8081/artifactory/webapp/builds/WeatherLibrary/1445153016002/2015-10-18T15:23:35.938+0800/

BUILD SUCCESSFUL

到http://localhost:8081/artifactory/里验证：

使用本地库

在Project/build.gradle中添加本地库：

allprojects {
    repositories {
        jcenter()
        maven { url "http://localhost:8081/artifactory/libs-release-local" }
    }

}

在Module/build.gradle中添加依赖，格式如上图：

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile 'com.android.support:appcompat-v7:23.0.1'
    compile(group: 'com.geek.dev', name: 'weatherlib', version: '1.0.2', ext: 'aar')

}

总结

通过本文的介绍，可以掌握为自己或团队搭建本地库以及让如何使用，系统跑起来了，流程走通了，再进行深入细化，artifactory权限、服务器管理等等。
由aar包引用到jcenter()，整个系列囊括了本地文件，网络公共库和本地库，可以将整个Android开发过程中的依赖管理理解的更加深刻，让开发过程变得越来越清晰，整个信息流向越来越透明。

References

https://www.jfrog.com/wp-content/uploads/2014/05/artifactory_overview_diagram.jpg

distribute to maven centeral