玩转Android studio 插件开发、测试、JCenter库发布（2）

上一节，我们以实例的方式，讲解了android studio依赖库的开发过程，但是，似乎还没有完成。
是的，还缺少插件的生成、发布和使用。

下面我们便接着上一节，继续讲解依赖库的生成、发布和使用

依赖库的发布，是在build.gradle构建脚本中处理的。
在讲解构建脚本之前，我们先说下JCenter库的申请等前期准备工作。

1、注册账号
在https://bintray.com/上注册一个账号。

2、获取API Key
注册后，在https://bintray.com/profile/edit页面的左边菜单的最下面有API Key，

复制明文API key，后面会用到。

3、定义相关网站
有单独的官方网站那是最好的，没用的话就用git网址就可以了。

def siteUrl = ‘https://github.com/xxxxxx‘// project homepage
def gitUrl = ‘https://github.com/xxxxxx.git‘// project git

4、定义Group（上一节已经定义，此处只是了解原因）
举个例子，当我们引用recylerview的时候是这样的：

compile'com.android.support:recyclerview-v7:21.0.2'

引号内字符串以冒号分割为三部分，第一部分就是group，第二部分是name， 第三部分是version。
其中group和version分别对应上一节最后在build.gradle中添加的信息，而name对应我们的模块名，由于上一节中模块名为app，所以name=app。
合起来，上一节开发的依赖库的引用就应该是这样：

compile 'com.myutils:app:0.1'

接着，便是上传依赖库到Jcenter库。需要知道的是上传到Jcenter库至少需要四个文件，除了打包的aar之外，还需要pom和javadoc，source，否则是通不过Jcenter库审核的。不过不用紧张，这些我们都可以用脚本生成。
添加创建javadocjar、sourcejar、pom和aar(也可以是jar)的脚本任务。

5、打包javadocjar和sourcejar
这两个也是上传到jcenter必须要的。

task sourcesJar(type: Jar) {
    from android.sourceSets.main.java.srcDirs
    classifier = 'sources'
}

task javadoc(type: Javadoc) {
    source = android.sourceSets.main.java.srcDirs
    classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
}

task javadocJar(type: Jar, dependsOn: javadoc) {
    classifier = 'javadoc'from javadoc.destinationDir
}

artifacts {
    archives javadocJar
    archives sourcesJar
}

6、定义pom并打包aar

install {
    repositories.mavenInstaller {
        // This generates POM.xml with proper parameters
        pom {
            project {
                packaging 'aar'
                name 'Utils For Android'      //project title
                url siteUrl
                // Set your license
                licenses {
                    license {
                        name 'The Apache Software License, Version 2.0'
                        url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
                    }
                }
                developers {
                    developer {
                        id 'test'      //your user id
                        name 'csky'  // your user name
                        email 'csky@qq.com'   // your email
                    }
                }
                scm {
                    connection gitUrl
                    developerConnection gitUrl
                    url siteUrl
                }
            }
        }
    }
}

7、配置个人信息
上传到jcenter的网站BinTray，需要用户验证，需要2个值。

// 示例值， 仅供参考
bintray.user=openproject                        // your bintray user name
bintray.apikey=c5434272d5xxxxxxxx225564155753   // your bintray api key

第二个API Key就是你在上面记录的API Key。
因为这个属于个人隐私，一般不能传到网上去，所以需要在记录到工程下的local.properties中(利用gitignore忽略这个文件到git)，然后脚本再从local.properties中读取这两个值。

Properties properties = new Properties()
properties.load(project.rootProject.file('local.properties').newDataInputStream())
bintray {
    user = properties.getProperty("bintray.user")
    key = properties.getProperty("bintray.apikey")
    configurations = ['archives']
    pkg {
        repo = "maven"
        name = "utils"                 //project name in jcenter
        websiteUrl = siteUrl
        vcsUrl = gitUrl
        licenses = ["Apache-2.0"]
        publish = true
    }
}

到目前为止，完整的build.gradle脚本如下：
项目根目录下build.gradle脚本内容为：

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:1.3.0'
        classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.0'
        classpath 'com.github.dcendents:android-maven-gradle-plugin:1.3'
    }
}

allprojects {
    repositories {
        jcenter()
    }
}

app目录下build.gradle脚本内容为：

apply plugin: 'com.android.library'
apply plugin: 'com.github.dcendents.android-maven'
apply plugin: 'com.jfrog.bintray'

group = "com.myutils"
version = "0.1"

android {
    compileSdkVersion 23
    buildToolsVersion "23.0.3"

    defaultConfig {
        applicationId "example.com.myutils"
        minSdkVersion 8
        targetSdkVersion 23
        versionCode 1
        versionName "1.0"

        ndk {
            moduleName "hello-jni"
            ldLibs "log", "z", "m"
            abiFilters "armeabi", "armeabi-v7a", "x86"
        }
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile 'com.android.support:appcompat-v7:23.1.1'
}

def siteUrl = 'https://github.com/xxxxxx'       // project homepage
def gitUrl = 'https://github.com/xxxxxx.git'

install {
    repositories.mavenInstaller {
        // This generates POM.xml with proper parameters
        pom {
            project {
                packaging 'aar'
                name 'Utils For Android'          // project title
                url siteUrl
                // Set your license
                licenses {
                    license {
                        name 'The Apache Software License, Version 2.0'
                        url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
                    }
                }
                developers {
                    developer {
                        id 'test'                   // your user id 
                        name 'csky'                 // your user name
                        email 'csky@qq.com'         // your email
                    }
                }
                scm {
                    connection gitUrl
                    developerConnection gitUrl
                    url siteUrl
                }
            }
        }
    }
}


task sourcesJar(type: Jar) {
    from android.sourceSets.main.java.srcDirs
    classifier = 'sources'
}

task javadoc(type: Javadoc) {
    source = android.sourceSets.main.java.srcDirs
    classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
}

task javadocJar(type: Jar, dependsOn: javadoc) {
    classifier = 'javadoc'
    from javadoc.destinationDir
}

artifacts {
    archives javadocJar
    archives sourcesJar
}

Properties properties = new Properties()
properties.load(project.rootProject.file('local.properties').newDataInputStream())
bintray {
    user = properties.getProperty("bintray.user")
    key = properties.getProperty("bintray.apikey")
    configurations = ['archives']
    pkg {
        repo = "maven"
        name = "utils"             //project name in jcenter
        websiteUrl = siteUrl
        vcsUrl = gitUrl
        licenses = ["Apache-2.0"]
        publish = true
    }
}

8、上传到Jcenter仓库
根据上面的build.gradle,会产生几个特别的gradle任务：

javadocJar
sourcesJar
install
bintrayUpload

通过gradew执行这些任务即可。

gradew javadocJar
gradew sourcesJar
gradew install
gradew bintrayUpload

或者通过Android Studio的最右边栏的Gradle窗口分别可视化操作，点击执行。

9、请求审核
当bintrayUpload成功之后，
在我的主页https://bintray.com/openproject/右下部分Latest Activity块，会看到你提交了一个项目，
从这个Latest Activity列表中点击你的项目，
进入详情页https://bintray.com/openproject/maven/lesscode-core/view，
找到Maven Central标签，
鼠标放上去它会提示你去提交审核，点击进入后，随便写什么都可以了。
只要上面没问题，一般审核很快，几个小时就差不多了。
库的默认地址：http://dl.bintray.com/申请的名字/maven
这次审核通过了，后面升级就不用再审核了。

10、依赖库的引用（使用）
在需要引用依赖库的android studio工程中的build.gradle中添加引用：

compile 'com.myutils:app:latest.release'  //最新版，自动更新
或者
compile 'com.myutils:app:0.2'  //指定版本

剩下的便是在自己代码中尽情的享受依赖库带来的好处吧！

android studio 依赖库的开发到目前已经讲解完成类，下一篇，咱们就聊聊android studio 插件的开发。