Android - 5分钟发布Android Library项目到JCenter

浏览数：34 / 时间：2015年06月11日

android-library-publish-to-jcenter是一个帮助Android开发者将AAR库发布到jcenter的项目，android-library-publish-to-jcenter已经将需要写的脚本封装好了，我们只需要配置相关属性即可在5分钟之内发布我们的项目到JCenter（不包括审核时间哦）

1. 注册Bintray账号 (传送门)

Bintray是jcenter的托管商，因此你必须注册一个Bintray账号，注册完账号后记下你的用户名以及API Key。

登陆后在首页右上角点击用户名进入个人主页，然后点击用户名下面的Edit进入个人信息编辑页面，接下来点击页面左边列表的最后一项API Key

技术分享

如图所示点击最右边箭头指示的复制按钮即可复制你的API Key

2. 检查Android插件版本

首先你要检查你的Android插件的版本，因为1.1.0版本有一个BUG会导致生成javadoc失败，所以你只需升级到最新即可。目前最新版本是1.2.3，在你的项目根目录下的build.gradle文件中修改版本号即可，如下:

// Top-level build file where you can add configuration options common to all sub-projects/modules.

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath ‘com.android.tools.build:gradle:1.2.3‘
        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

allprojects {
    repositories {
        jcenter()
    }
}

如果你在看到这篇文章的时候有更新的版本的话，直接改为最新的版本即可。

3. 添加所需插件

在你的项目的根目录的build.gradle文件的dependencies中追加如下代码：

classpath ‘com.github.dcendents:android-maven-plugin:1.2‘
classpath ‘com.jfrog.bintray.gradle:gradle-bintray-plugin:1.0‘

android-maven-plugin插件是用来打包Maven所需文件的
gradle-bintray-plugin插件是用来就生成的Maven所需文件上传到Bintray的

完成后如下所示：

// Top-level build file where you can add configuration options common to all sub-projects/modules.

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath ‘com.android.tools.build:gradle:1.2.3‘
        classpath ‘com.github.dcendents:android-maven-plugin:1.2‘
        classpath ‘com.jfrog.bintray.gradle:gradle-bintray-plugin:1.0‘
        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

allprojects {
    repositories {
        jcenter()
    }
}

4. 配置项目信息

下载project.properties文件并放到你的library module目录下

project.properties文件的原始内容如下：

#project
project.name=
project.groupId=
project.artifactId=
project.packaging=aar
project.siteUrl=
project.gitUrl=

#javadoc
javadoc.name=

详解：

project.name：项目名称

project.groupId：项目组ID，通常情况下如果你的包名为com.example.test，那么项目组ID就是com.example

project.artifactId：项目ID，通常情况下如果你的包名为com.example.test，那么项目ID就是test

project.packaging：包类型，一般的java是jar，那么Android库就是aar

project.siteUrl：项目官方网站的地址，没有的话就用Github上的地址，例如：https://github.com/xiaopansky/Sketch

project.gitUrl：项目的Git地址，例如：https://github.com/xiaopansky/Sketch.git

javadoc.name：生成的javadoc打开后主页显示的名称，通常跟项目名称一样即可

完成配置后如下所示：

#project
project.name=Sketch
project.groupId=me.xiaopan
project.artifactId=sketch
project.packaging=aar
project.siteUrl=https://github.com/xiaopansky/Sketch
project.gitUrl=https://github.com/xiaopansky/Sketch.git

#javadoc
javadoc.name=Sketch

你无需配置项目版本，会自动从你的build.gradle中获取版本名称作为项目版本

5. 配置Bintray账号以及开发者信息

下载local.properties文件并放到你的library module目录下

local.properties文件的原始内容如下：

#bintray
bintray.user=
bintray.apikey=

#developer
developer.id=
developer.name=
developer.email=

详解：

bintray.user：你的Bintray的用户名

bintray.apikey：你的的Bintray的API Key

developer.id：通常是你在开源社区的昵称

developer.name：你的姓名

developer.email：你的邮箱

完成配置后如下所示：

#bintray
bintray.user=xiaopansky
bintray.apikey=*****************************

#developer
developer.id=xiaopan
developer.name=********
developer.email=[email protected]

*号显示的为个人信息不反方便透露，还请见谅
注意要将local.proerties文件加入忽略列表，以免被提交到Github或其他网站泄露个人信息

6. 配置bintrayUpload.gradle

方法1：直接使用远程bintrayUpload.gradle文件

修改你的library module的build.gradle文件，在最后加上apply from: "https://raw.githubusercontent.com/xiaopansky/android-library-publish-to-jcenter/master/bintrayUpload.gradle"，如下所示：

apply plugin: ‘com.android.library‘

android {
    compileSdkVersion 22
    buildToolsVersion "22.0.0"

    defaultConfig {
        minSdkVersion 7
        targetSdkVersion 22
        versionCode 100
        versionName "1.0.0"
    }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile(‘proguard-android.txt‘), ‘proguard-rules.pro‘
        }
    }
}

apply from: "https://raw.githubusercontent.com/xiaopansky/android-library-publish-to-jcenter/master/bintrayUpload.gradle"

方法2：下载后使用本地bintrayUpload.gradle文件

首先下载bintrayUpload.gradle文件并放到你的library module目录下，然后修改你的library module的build.gradle文件，在最后加上apply from: "bintrayUpload.gradle"，如下所示：

apply plugin: ‘com.android.library‘

android {
    compileSdkVersion 22
    buildToolsVersion "22.0.0"

    defaultConfig {
        minSdkVersion 7
        targetSdkVersion 22
        versionCode 100
        versionName "1.0.0"
    }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile(‘proguard-android.txt‘), ‘proguard-rules.pro‘
        }
    }
}

apply from: "bintrayUpload.gradle"