本文主要是介绍Android Studio 上传 Library 至 Jcenter 生成依赖的两种方式(菜鸟级教程),希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
注册
Bintray官网首页默认注册是组织 , 个人的正确注册地址是:https://bintray.com/signup/oss
这里注意一点 不能使用国内的邮箱注册。 也可以使用 Google账号,Github账号 关联登录。
获取 Key
图片出处
创建个人Maven 仓库
注意:这里创建的maven仓库名字如果是 maven 那么可以使用以下两种配置方式的任意一种 ,如果自定义仓库名字非 maven 需要通过第二种配置进行上传,否则存在 404。
上传之前的配置
配置方式一(仓库名必须为 maven):
项目根目录 build.gradle 中完整配置代码:
buildscript {repositories {jcenter()}dependencies {classpath 'com.android.tools.build:gradle:2.3.1'classpath 'com.novoda:bintray-release:0.3.4'// NOTE: Do not place your application dependencies here; they belong// in the individual module build.gradle files}
}allprojects {repositories {jcenter()}// 解决 Execution failed for task':[YourLibraryName]:mavenAndroidJavadocs'.tasks.withType(Javadoc) {options.addStringOption('Xdoclint:none', '-quiet')options.addStringOption('encoding', 'UTF-8')}
}
在app 和 library 的 build.gradle 文件中加入以下代码解决 Execution failed for task ‘:core:lint’ :
android{......lintOptions {checkReleaseBuilds falseabortOnError false}
}
在 library 的 build.gradle 加入一些配置 :
apply plugin: 'com.novoda.bintray-release' // 新增
...
android{......lintOptions... 省略
}
publish {userOrg = 'xxx'//bintray.com注册的用户名groupId = 'com.lfq'//jcenter上的路径artifactId = 'customrepo'//上传到 Jcenter 的项目名称publishVersion = '1.0.1'//版本号desc = ''//选填website = 'https://github.com/xxx'//这里是必填;可以填写你 Github 上的当前项目地址。注意格式必须是 github地址(地址可以不存在)。
}
此配置的最终生成结果格式为:
compile 'com.lfq:customrepo:1.0.1'
这里调整一下,这种配置方式生成的依赖的组成格式:
依赖组成格式:'groupId : artifactId:版本号' 依赖组成格式:'groupId : artifactId:版本号' 依赖组成格式:'groupId : artifactId:版本号'
这里和下面的配置方式生成的依赖还是有点区别的。
配置方式二(自定义仓库名):
在Project 的 build.gradle 中添加 Maven 和 Jfrog Bintray 的依赖
buildscript {repositories {jcenter()}dependencies {classpath 'com.android.tools.build:gradle:2.3.0'// NOTE: Do not place your application dependencies here; they belong// in the individual module build.gradle files//添加下面两行classpath 'com.github.dcendents:android-maven-gradle-plugin:1.5'classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.7.3'}
}allprojects {repositories {jcenter()}
}task clean(type: Delete) {delete rootProject.buildDir
}
版本号这里目前是最新的,后续如果有更新,可以去查看 Maven 和 Jfrog Bintray 的最新版本。
在 module 的 builde.gradle 中进行配置
apply plugin: 'com.android.library'
//添加这两行
apply plugin: 'com.github.dcendents.android-maven'
apply plugin: 'com.jfrog.bintray'android {compileSdkVersion 24buildToolsVersion '25.0.0'defaultConfig {minSdkVersion 14targetSdkVersion 22version 1versionName "1.0"}buildTypes {release {minifyEnabled falseproguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'}}//添加配置lintOptions {
// checkReleaseBuilds false// Or, if you prefer, you `can continue to check for errors in release builds,// but continue the build even when errors are found:abortOnError false}}dependencies {compile fileTree(include: ['*.jar'], dir: 'libs')compile 'com.android.support:appcompat-v7:24.2.1'provided 'com.github.bumptech.glide:glide:3.7.0'
}//项目主页
def siteUrl = 'https://github.com/lvfaqiang/Multi-Image-Selector'
//项目的git地址
def gitUrl = 'git@github.com:lvfaqiang/Multi-Image-Selector.git'def libName = "MultiImageSelector"; // 上传到 Bintray 的 package 名称。
group = "me.lfq";
version = "1.0.1"
// 这两个参数配置是为了最终生成 compile 'me.lfq:依赖库的名称:1.0.0' group version 是关键字,自动识别的。只需配置好就行。install {repositories.mavenInstaller {// 生成pom.xml和参数pom {project {packaging 'aar'// 项目描述,复制我的话,这里需要修改。name 'MultiImageSelector'// 可选,项目名称。description ''// 可选,项目描述。url siteUrl // 项目主页,这里是引用上面定义好。// 软件开源协议,现在一般都是Apache License2.0吧,复制我的,这里不需要修改。licenses {license {name 'The Apache Software License, Version 2.0'url 'http://www.apache.org/licenses/LICENSE-2.0.txt'}}//填写开发者基本信息,复制我的,这里需要修改。developers {developer {id 'lvfaqiang' // 开发者的id。name 'lvfaqiang' // 开发者名字。email 'lvfaqiang@gmail.com' // 开发者邮箱。}}// SCM,复制我的,这里不需要修改。scm {connection gitUrl // Git仓库地址。developerConnection gitUrl // Git仓库地址。url siteUrl // 项目主页。}}}}
}//上传到JCenter
Properties properties = new Properties()
properties.load(project.rootProject.file('local.properties').newDataInputStream())bintray {user = properties.getProperty("bintray.username") //读取 local.properties 文件里面的 bintray.user 登录用户名。key = properties.getProperty("bintray.apikey") //读取 local.properties 文件里面的 bintray.apikeyconfigurations = ['archives']pkg {//这里的repo值必须要和你创建Maven仓库的时候的名字一样repo = "custom"//发布到JCenter上的项目名字name = libNamewebsiteUrl = siteUrlvcsUrl = gitUrllicenses = ["Apache-2.0"]publish = true //是否是公开项目。}
}// 生成jar包的task,不需要修改。
task sourcesJar(type: Jar) {from android.sourceSets.main.java.srcDirsclassifier = 'sources'
}
// 生成jarDoc的task,不需要修改。
task javadoc(type: Javadoc) {source = android.sourceSets.main.java.srcDirsclasspath += project.files(android.getBootClasspath().join(File.pathSeparator))// destinationDir = file("../javadoc/")failOnError false // 忽略注释语法错误,如果用jdk1.8你的注释写的不规范就编译不过。
}
// 生成javaDoc的jar,不需要修改。
task javadocJar(type: Jar, dependsOn: javadoc) {classifier = 'javadoc'from javadoc.destinationDir
}
artifacts {archives javadocJararchives sourcesJar
}
以上需要修改的地方也就配置的几个项目主页地址,项目描述,以及开发者个人信息。仓库名这里要对应你在 Bintray上创建的自定义仓库名。
在 app 的 build.gradle 中需要添加的配置
android{......lintOptions {checkReleaseBuilds false// Or, if you prefer, you can continue to check for errors in release builds,// but continue the build even when errors are found:abortOnError false}
}
在 local.properties 中添加个人的参数值:
bintray.username= bintray注册的用户名
bintray.apikey= 文章开头获取的 apikey
配置基本上也就这些了。
上传
基本就是以上所描述的这些配置,接下来我们打开 Studio 的控制台 Terminal .
windows 环境下输入:
gradlew clean build bintrayUpload -PbintrayUser=BINTRAY_USERNAME -PbintrayKey=BINTRAY_KEY -PdryRun=false
Mac OS 环境下输入:
如果出现拒绝该命令./gradlew: Permission denied,可以先运行 chmod +x gradlew再运行该命令;
./gradlew clean build bintrayUpload -PbintrayUser=BINTRAY_USERNAME -PbintrayKey=BINTRAY_KEY -PdryRun=false
上面命令中 BINTRAY_USERNAME 是你在 bintray 上注册的用户名。BINTRAY_KEY 是上面注册的时候所获取的 key.
替换了用户名和 API key 回车执行,等到控制台最终输出 BUILD SUCCESSFUL 就表明项目上传成功。
发布到 Jcenter
这个时候回到 bintray 我们的 maven 仓库中,进入我们刚上传成功的 packge 。
点击左下角红框区域,进入下一页 直接点击 send 等待审核,耐心等待审核通过之后,就可以直接通过 compile 引入项目使用。
在审核通过之前,我们可以通过配置上图右上角红框区域链接来使用,在根目录中添加:
allprojects {repositories {jcenter()maven {url '右上角的链接'}}
}
项目中加入依赖:
compile 'com.lfq:module名称:1.0.1' // 模拟类型
注意:如果这里依赖不成功,可以再后边加上@arr
compile 'com.lfq:module名称:1.0.1@arr'
以上两种配置方式,我都亲测过,如果还有什么问题,还望各位指出。我也好做出调整。谢谢!
补充一下两种上传配置的区别:
第一种配置简单,但是仓库名必须是 maven , 依赖组成格式:’groupId : artifactId:版本号’ , 并且 artifactId 也是上传到仓库的 package 名称。
第二种配置,相对复杂一点(无非也就是多复制一些代码)。仓库名可自定义,生成依赖组成格式是:’groupId: module名称:版本号’ 。 这里的 module名称也就是你本地依赖库的名称。上传仓库的package名称是单独配置的。
参考博客:
http://blog.csdn.net/wzgiceman/article/details/53707042
http://blog.csdn.net/xingshen58/article/details/51644599
http://blog.csdn.net/yanzhenjie1003/article/details/51672530
这篇关于Android Studio 上传 Library 至 Jcenter 生成依赖的两种方式(菜鸟级教程)的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!