android as上传maven javadoc 乱码_一行代码引用 library——如何将库上传至 jcenter

注册 Bintray

• 打开 Bintray官方网站，注册帐号。网站可能较慢或无法打开，建议.翻.墙.。

• 有 github 账户的用户，建议直接使用 github 授权并登录。

• 登录成功后，进入个人中心，点击Edit按钮。

• 获取 API KEY，并记录获取到的 API KEY。

配置Android Studio

• 在Project的最顶层的 build.gradle 文件内添加如下依赖：

classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.6'
classpath 'com.github.dcendents:android-maven-gradle-plugin:1.3'

• 在库 Module 中的 build.gradle 中继续添加如下内容：

ext {
    bintrayRepo = 'maven'     //仓库名
    bintrayName = 'switch'   //项目名

    publishedGroupId = 'com.fynn.switcher'  //发布id，一般为包名
    artifact = 'switch'     //jcenter的ArtifactId：一般是项目名
    libraryVersion = '1.0.0'    //发布的版本号：每次上传必须不一样

    siteUrl = 'https://github.com/ifynn/Switch'       //网站地址
    gitUrl = 'https://github.com/ifynn/Switch.git'    //git地址

    libraryName = 'switch'       //项目名
    libraryDescription = 'A switch for Android'     //项目描述

    //开发者信息
    developerId = 'Fynn'
    developerName = 'Fynn'
    developerEmail = 'ifynn@outlook.com'

    //版权信息
    licenseName = 'The Apache Software License, Version 2.0'
    licenseUrl = 'http://www.apache.org/licenses/LICENSE-2.0.txt'
    allLicenses = ["Apache-2.0"]
}
apply from: 'https://raw.githubusercontent.com/llxdaxia/GradleScript/master/install_v1.gradle'
apply from: 'https://raw.githubusercontent.com/llxdaxia/GradleScript/master/bintray_v1.gradle'

• 在local.properties文件中添加注册的 Bintray 信息：

bintray.apikey=之前记录的api key
bintray.user=bintray用户名

执行上传操作

• 在 Android Studio 中的 terminal 中输入命令：
  ./gradlew bintrayUpload
• 等待上传完毕后，进入 Bintray并登录即可看到已成功上传：

• 上传成功后，还需要提交add to JCenter的请求，待审核成功后即可使用如下方式引用。

compile 'com.fynn.switcher:switch:1.0.0'

可能遇到的问题：
1. Execution failed for task ':appu:bintrayUpload'.
> Could not create package '**': HTTP/1.1 401 Unauthorized [message:This resource requires authentication]
原因：bintray用户名或apikey错误
解决：进入bintray官网查看用户名和apikey，并修改

2.Execution failed for task ':pkg:javadoc'.
> Javadoc generation failed. Generated Javadoc options file (useful for troubleshooting): '.../build/tmp/javadoc/javadoc.options'
原因：若为GBK编码，java源文件中注释不能存在中文
解决：修改编码格式，或者注释中删除中文，或者在项目中添加如下配置，取消javadoc检查：
allprojects {
    repositories {
        jcenter()
    }

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

3.java.lang.UnsupportedClassVersionError: PR/Sort : Unsupported major.minor version 52.0
原因：jdk运行环境和编译环境不匹配
解决：设置JAVA_HOME环境变量、配置Android Studio的jdk路径为与环境变量配置一致的路径

知我者乎​www.zhihu.com