上传 Android library 到 Jcenter

前言

自从用上了 Android-Studio ，我们只要简单的一句：

compile 'com.squareup.okhttp3:okhttp:3.6.0'

就可以引入类库了。既然那么方便，我们也可以利用 JCenter 让我们写封装好的方法通过一句代码来引用。

Bintray 账号

创建

这里我们利用 Bintray 来管理我们的类库。所以需要注册一个 Bintray 的账户。我们可以利用 Github 或 Google 的账号来进行注册所以十分方便。

不过需要注意的是，进入首页注册时不要点击 START YOUR FREE TRIAL 的按钮，那是组织账户，而我们只需要个人账户就好。

获取 API Key

在上传时我们需要填写我们的 API key 。

配置 Gradle

1. 首先我们需要在整个项目的 build.gradle 中加入

classpath 'com.github.dcendents:android-maven-gradle-plugin:1.5'
classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.7.2'

添加后

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

2. library 中的 build.gradle

apply plugin: 'com.android.library'
apply plugin: 'com.jfrog.bintray'
apply plugin: 'com.github.dcendents.android-maven'
//版本号，更新时记得修改
version = "0.0.1"
android {
  compileSdkVersion 25
  buildToolsVersion "25.0.2"

  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.2.0'
  compile 'com.squareup.okhttp3:okhttp:3.6.0'
  compile 'com.google.code.gson:gson:2.8.0'
  compile 'com.github.dcendents:android-maven-plugin:1.2'
  testCompile 'junit:junit:4.12'
}
// 项目的主页
def gitUrl = 'https://github.com/jianjunhuang/OkHttpDemo'
// Git仓库的url
def siteUrl = 'https://github.com/jianjunhuang/OkHttpDemo.git'

group = "com.library.jianjunhuang.okhttputils" //一般填你唯一的包名，在引用时的代码就是根据这个来的

install {
  repositories.mavenInstaller {
    // This generates POM.xml with proper parameters
  pom {
      project {
        packaging 'aar'
        name 'OkHttp Utils' //项目的描述
        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 'jianjunhuang' //填写的一些基本信息
            name 'jianjunhuang'
            email 'demon903732218@gmail.com'
  }
        }
        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"
    //发布到JCenter上的项目名字
    name = "OkHttpUtils"
    websiteUrl = siteUrl
    vcsUrl = gitUrl
    licenses = ["Apache-2.0"]
    publish = true
  }
}

3. 配置 UserName 和 APIKey

在项目的 local.properties 中的配置用户名和 APIKey

bintray.user=jianjunhuang
bintray.apikey=xxxxxxxxxxxxxxxxxxxxxxxxxxx

记得在 .gitignore 中配置避免上传至网上，造成信息泄露

/local.properties

执行命令

在 Terminal 中输入命令

gradlew install
gradlew bintrayUpload

//linux or mac
./gradlew install
./gradlew bintrayUpload

若都显示 BUILD SUCCESS 就成功了。

这时候我们就可以在 Bintray 的仓库中找到我们的 library 。点击 Add to JCenter，上传 JCenter 中只要经过验证就可以用了，不过要经过一段时间的审核。之后就可以引用了。

常见问题

• Could not upload to ‘https://.pom’: HTTP/1.1 400 Bad Request [message:Unable to upload files: Maven group, artifact or version defined in the pom file do not match the file path ‘***.pom’]
  名字错误

• bintrary 中没有建立 maven 仓库

• 注释中使用了中文
  添加：

tasks.withType(Javadoc) {
  options.addStringOption('Xdoclint:none', '-quiet')
  options.addStringOption('encoding', 'UTF-8')
  options.addStringOption('charSet', 'UTF-8')
}