[Skill]多个开源项目Bintray一键发布环境部署

多个开源项目Bintray一键发布环境部署

　　我们发布到Bintray上共享的一般是一些库，而不是完整的App，而这些库是依附在我的主项目之中，如果我们主项目只维护一个共享库，那没什么问题，但维护多个开源库呢？不规划一下打包发布的流程，那么就会浪费我更很多的时间在打包发布上。截至至撰文时，笔者的ProjectX主项目已经管理维护者16个开源库，不规划一套打包方案，那么妥妥的能把笔者累死。

基础Plugin载入

　　需要实现自动化发包，就必须载入gradle-bintray-plugin与android-maven-gradle-plugin（点击链接查看最新版本号，使用最新版本插件）。载入方式有两种：

• 传统方式

  dependencies {
      classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.7.1'
      classpath 'com.github.dcendents:android-maven-gradle-plugin:1.5'
  }

• 新型方式(Gradle 2.1)

  plugins {
      id "com.jfrog.bintray" version "1.7.1"
      id "com.github.dcendents.android-maven" version "1.5"
  }

　　使用新型方式导入的gradle-bintray-plugin会提交不成功，不知AS更新以后是否解决，但是笔者出错的版本是1.7.1，新版本没出来前gradle-bintray-plugin还是建议使用传统方式，android-maven-gradle-plugin可以选择新型方式。

部署方案

1. 在库根目录（不是项目根目录）创建bintray.gradle文件，文件内容（可以直接拷贝给其他项目使用）：

   apply plugin: 'com.github.dcendents.android-maven'
   apply plugin: 'com.jfrog.bintray'
   
   // load properties
   Properties properties = new Properties()
   File localPropertiesFile = project.file("local.properties");
   if (localPropertiesFile.exists()) {
       properties.load(localPropertiesFile.newDataInputStream())
   }
   File projectPropertiesFile = project.file("project.properties");
   if (projectPropertiesFile.exists()) {
       properties.load(projectPropertiesFile.newDataInputStream())
   }
   
   // read properties
   def projectName = properties.getProperty("project.name")
   def projectDesc = properties.getProperty("project.desc")
   def projectGroupId = properties.getProperty("project.groupId")
   def projectArtifactId = properties.getProperty("project.artifactId")
   def projectVersionName = android.defaultConfig.versionName
   def projectPackaging = properties.getProperty("project.packaging")
   def projectSiteUrl = properties.getProperty("project.siteUrl")
   def projectGitUrl = properties.getProperty("project.gitUrl")
   def projectIssueTrackerUrl = properties.getProperty("project.issueTrackerUrl")
   def developerId = properties.getProperty("developer.id")
   def developerName = properties.getProperty("developer.name")
   def developerEmail = properties.getProperty("developer.email")
   
   def bintrayUser = properties.getProperty("bintray.user")
   def bintrayApikey = properties.getProperty("bintray.apikey")
   
   // This generates POM.xml with proper parameters
   install {
       repositories.mavenInstaller {
           pom.project {
               name projectName
               groupId projectGroupId
               artifactId projectArtifactId
               version projectVersionName
               packaging projectPackaging
               url projectSiteUrl
               licenses {
                   license {
                       name 'The Apache Software License, Version 2.0'
                       url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
                   }
               }
               developers {
                   developer {
                       id developerId
                       name developerName
                       email developerEmail
                   }
               }
               scm {
                   connection projectGitUrl
                   developerConnection projectGitUrl
                   url projectSiteUrl
               }
           }
       }
   }
   
   task androidJavadocs(type: Javadoc) {
       source = android.sourceSets.main.java.source
       classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
       options {
           encoding "UTF-8"
           charSet 'UTF-8'
           author true
           version projectVersionName
           links "http://docs.oracle.com/javase/7/docs/api"
           title projectName
       }
   }
   
   task androidJavadocsJar(type: Jar, dependsOn: androidJavadocs) {
       from androidJavadocs.destinationDir
       classifier = 'javadoc'
   }
   
   task androidSourcesJar(type: Jar) {
       from android.sourceSets.main.java.source
       classifier = 'sources'
   }
   
   if (JavaVersion.current().isJava8Compatible()) {
       allprojects {
           tasks.withType(Javadoc) {
               options.addStringOption('Xdoclint:none', '-quiet')
           }
       }
   }
   
   artifacts {
       archives androidSourcesJar
       archives androidJavadocsJar
   }
   
   // bintray configuration
   bintray {
       user = bintrayUser
       key = bintrayApikey
       group = projectGroupId
       configurations = ['archives']
       pkg {
           repo = "maven"
           name = projectName
           websiteUrl = projectSiteUrl
           vcsUrl = projectGitUrl
           desc = projectDesc
           issueTrackerUrl = projectIssueTrackerUrl
           licenses = ["Apache-2.0"]
           publish = true
           publicDownloadNumbers = true
       }
   }

2. 在库根目录创建project.properties用于配置项目信息（不同项目需要配置不同值）：

   #project
   project.name=BaseTabStrip
   project.groupId=am.widget
   project.artifactId=basetabstrip
   project.packaging=aar
   project.desc=项目描述
   project.siteUrl=https://github.com/AlexMofer/ProjectX/tree/master/basetabstrip
   project.gitUrl=https://github.com/AlexMofer/ProjectX.git
   project.issueTrackerUrl=https://github.com/AlexMofer/ProjectX/issues

3. 在库根目录创建local.properties用于配置bintray登录信息（可以直接拷贝给其他项目使用，需要加入git忽略列表）：

   ##必须Git忽略此文件，其包含隐私信息
   #bintray
   bintray.user=你的bintray账户
   bintray.apikey=API Key
   
   #developer
   developer.id=*******
   developer.name=***
   developer.email=*******@****.com

4. git添加bintray.gradle与project.properties，忽略local.properties ：

   # Local configuration file (sdk path, etc)
   local.properties

5. 在库的build.gradle最后加入：

   //apply from: "bintray.gradle"

发布

　　将要提交的开源库的build.gradle中的 apply from: "bintray.gradle" 去掉注释，保证 versionName 是你想要发布的，那么控制台输入gradlew bintrayUpload就可以了，成功以后再将 apply from: "bintray.gradle" 注释掉就不会干扰其他开源项目的提交了。

注意

• Git一定要忽略掉local.properties文件
• 发布完毕以后，build.gradle中的 apply from: "bintray.gradle" 要记得注释掉，否则会干扰其他开源项目提交
• bintray.gradle不单单是发布处理，还包括中文注释乱码处理