使用Gradle发布项目到JCenter仓库 (转载)

时间:2023-12-19 13:58:02

原文:使用Gradle发布项目到JCenter仓库

这篇文章介绍通过Gradle把开源项目发布到公共仓库JCenter中,方便你我他的事情,我们都是很懒的嘛。JCenter现在是Android Studio中repositories的默认节点了,之前是Maven的,不过JCenter是兼容Maven的,所以放心使用。步骤基本是按Publishing Gradle Android Library to jCenter Repository这里来的,英文能看的直接看这篇也行。下面我的步骤正式开始,发布到JCenter仓库的是我的项目:BounceProgressBar

申请Bintray账号

Bintray的基本功能类似于Maven Central,一样的我们需要一个账号,Bintray传送门,注册完成后第一步算完成了。

生成项目的JavaDoc和source JARs

简单的说生成的这两样东西就是我们在下一步中上传到远程仓库JCenter上的文件了。这一步需要android-maven-plugin插件,所以我们需要在项目的build.gradle(Top-level build file,项目最外层的build.gradle文件)中添加这个构建依赖,如下:

  1. buildscript {
  2. repositories {
  3. jcenter()
  4. }
  5. dependencies {
  6. classpath 'com.android.tools.build:gradle:1.0.0'
  7. classpath 'com.github.dcendents:android-maven-plugin:1.2'
  8. // NOTE: Do not place your application dependencies here; they belong
  9. // in the individual module build.gradle files
  10. }
  11. }
  12. allprojects {
  13. repositories {
  14. jcenter()
  15. }
  16. }

然后在你需要发布的那个module(我这里的即是library)的build.gradle里配置如下内容:

  1. apply plugin: 'com.android.library'
  2. apply plugin: 'com.github.dcendents.android-maven'
  3. apply plugin: 'com.jfrog.bintray'
  4. // This is the library version used when deploying the artifact
  5. version = "1.0.0"
  6. android {
  7. compileSdkVersion 21
  8. buildToolsVersion "21.1.2"
  9. resourcePrefix "bounceprogressbar__"    //这个随便填
  10. defaultConfig {
  11. minSdkVersion 9
  12. targetSdkVersion 21
  13. versionCode 1
  14. versionName version
  15. }
  16. buildTypes {
  17. release {
  18. minifyEnabled false
  19. proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
  20. }
  21. }
  22. }
  23. dependencies {
  24. compile fileTree(dir: 'libs', include: ['*.jar'])
  25. compile 'com.nineoldandroids:library:2.4.0+'
  26. }
  27. def siteUrl = 'https://github.com/zhengxiaopeng/BounceProgressBar' // 项目的主页
  28. def gitUrl = 'https://github.com/zhengxiaopeng/BounceProgressBar.git' // Git仓库的url
  29. group = "org.rocko.bpb" // Maven Group ID for the artifact,一般填你唯一的包名
  30. install {
  31. repositories.mavenInstaller {
  32. // This generates POM.xml with proper parameters
  33. pom {
  34. project {
  35. packaging 'aar'
  36. // Add your description here
  37. name 'Android BounceProgressBar Widget' //项目描述
  38. url siteUrl
  39. // Set your license
  40. licenses {
  41. license {
  42. name 'The Apache Software License, Version 2.0'
  43. url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
  44. }
  45. }
  46. developers {
  47. developer {
  48. id 'zhengxiaopeng'    //填写的一些基本信息
  49. name 'Rocko'
  50. email 'zhengxiaopeng.china@gmail.com'
  51. }
  52. }
  53. scm {
  54. connection gitUrl
  55. developerConnection gitUrl
  56. url siteUrl
  57. }
  58. }
  59. }
  60. }
  61. }
  62. task sourcesJar(type: Jar) {
  63. from android.sourceSets.main.java.srcDirs
  64. classifier = 'sources'
  65. }
  66. task javadoc(type: Javadoc) {
  67. source = android.sourceSets.main.java.srcDirs
  68. classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
  69. }
  70. task javadocJar(type: Jar, dependsOn: javadoc) {
  71. classifier = 'javadoc'
  72. from javadoc.destinationDir
  73. }
  74. artifacts {
  75. archives javadocJar
  76. archives sourcesJar
  77. }
  78. Properties properties = new Properties()
  79. properties.load(project.rootProject.file('local.properties').newDataInputStream())
  80. bintray {
  81. user = properties.getProperty("bintray.user")
  82. key = properties.getProperty("bintray.apikey")
  83. configurations = ['archives']
  84. pkg {
  85. repo = "maven"
  86. name = "BounceProgressBar"    //发布到JCenter上的项目名字
  87. websiteUrl = siteUrl
  88. vcsUrl = gitUrl
  89. licenses = ["Apache-2.0"]
  90. publish = true
  91. }
  92. }

配置好上述后需要在你的项目的根目录上的local.properties文件里(一般这文件需gitignore,防止泄露账户信息)配置你的bintray账号信息,your_user_name为你的用户名,your_apikey为你的账户的apikey,可以点击进入你的账户信息里再点击Edit即有查看API Key的选项,把他复制下来。

  1. bintray.user=your_user_name
  2. bintray.apikey=your_apikey

Rebuild一下项目,顺利的话,就可以在module里的build文件夹里生成相关文件了。这一步为止,就可以把你项目生成到本地的仓库中了,Android Studio中默认即在Android\sdk\extras\android\m2repository这里,所以我们可以通过如下命令(Windows中,可能还需要下载一遍Gradle,之后就不需要了)执行生成:

  1. gradlew install

上传到Bintray

上传到Bintray需要gradle-bintray-plugin的支持,所以在最外层的build.gradle里添加构建依赖:

  1. buildscript {
  2. repositories {
  3. jcenter()
  4. }
  5. dependencies {
  6. classpath 'com.android.tools.build:gradle:1.0.0'
  7. classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.0'
  8. classpath 'com.github.dcendents:android-maven-plugin:1.2'
  9. // NOTE: Do not place your application dependencies here; they belong
  10. // in the individual module build.gradle files
  11. }
  12. }
  13. allprojects {
  14. repositories {
  15. jcenter()
  16. }
  17. }

Rebuild一下,然后执行如下命令(Windows中)完成上传:

  1. gradlew bintrayUpload

上传完成即可在Bintray网站上找到你的Repo,我们需要完成最后一步工作,申请你的Repo添加到JCenter。可以进入这个页面,输入你的项目名字点击匹配到的项目,然后写一写Comments再send即可,然后就等管理员批准了,我是大概等了40分钟,然后网站上会给你一条通过信息,然后就OK了,大功告成。

使用Gradle发布项目到JCenter仓库 (转载)

成功后就可以在其它项目里方便的使用你发布的项目了:

  1. dependencies {
  2. compile 'org.rocko.bpb:library:1.0.0'
  3. }

End

不明白的可以再看看这两篇文章或者留言。

相关文章:
使用Gradle发布Android开源项目到JCenter
Publishing Gradle Android Library to jCenter Repository