Update documentation, add BinTray release plug-in, document release

COLLABORATORS.md

@@ -0,0 +1,18 @@
+# Collaborator information
+
+## Release Process
+
+* Run a full build, which will include the key generation tests not run during continuous integration, via `./gradlew clean build`
+* Update the version number to remove the "-SNAPSHOT" designation. All version numbers should be a fully-qualified semantic version of form `<major>.<minor>.<micro>`
+* Change the header "Unreleased" in CHANGE_LOG.md to the target release number, and create a new "Unreleased" header above it
+* Commit the version number and CHANGE_LOG updates
+* Tag the git repository with the fully-qualified semantic version number
+* Upload artifacts to bintray via `./gradlew bintrayUpload -Dbintray_user=<username> -Dbintray_key=<API Key>`
+* Verify all artifacts were correctly uploaded - check that POM.xml scopes and version numbers are correct
+* Change version number to `<released version> + 1 micro` + `-SNAPSHOT`
+* Commit to git
+* Push changes and tag to GitHub
+* Publish artifacts on BinTray
+* Synchronize BinTray artifacts to Maven central
+* Verify artifacts are present on Maven central
+* Create a release on GitHub including all binary and source jars, as well as CLI capsule jar

README.md

@@ -93,3 +93,7 @@ task addCredentials(type: com.coronaide.lockdown.gradle.task.AddCredentialsTask)
     credentialFile "${projectDir}/credentials.properties"
 }
 ```
+
+## Collaborators
+
+Information for collaborators, including the release process, can be found in the [collaborator documention](./COLLABORATORS.md)

build.gradle

@@ -10,6 +10,7 @@ buildscript {
         classpath group: 'com.netflix.nebula', name: 'nebula-dependency-recommender', version: '4.2.0'
         classpath group: 'com.netflix.nebula', name: 'nebula-publishing-plugin', version: '4.2.0'
         classpath group: 'com.blackducksoftware.integration', name: 'hub-gradle-plugin', version: '4.0.0'
+        classpath group: 'com.jfrog.bintray.gradle', name: 'gradle-bintray-plugin', version: '1.7.3'
     }
 }
 
@@ -78,6 +79,8 @@ allprojects{
 
 subprojects{
     apply plugin: 'maven-publish'
+    apply plugin: 'com.jfrog.bintray'
+    apply plugin: 'nebula.maven-base-publish'
 
     //Add LICENSE so it is included in all JARs, fulfilling the "distributions include license" requirement
     jar{
@@ -154,10 +157,26 @@ subprojects{
         }
     }
 
-    //TODO romeara testing
-    publishing {
-        repositories {
-            mavenLocal()
+    bintray {
+        user = System.getProperty('bintray_user')
+        key = System.getProperty('bintray_key')
+        publications = [ 'nebula' ]
+        pkg {
+            repo = 'lockdown'
+            name = "${project.name}"
+            userOrg = 'corona-ide'
+            licenses = ['MIT']
+            vcsUrl = 'https://github.com/Corona-IDE/lockdown'
+
+            version {
+                name = "${version}"
+                released  = new Date()
+                vcsTag = "${version}"
+
+                gpg {
+                    sign = true
+                }
+            }
         }
     }
 }

lockdown-cli/build.gradle

@@ -2,6 +2,8 @@ plugins {
   id 'us.kirchmeier.capsule' version '1.0.2'
 }
 
+description = 'Command line interface for managing encrypted credential files'
+
 //Dependency versions managed in $rootDir/dependencies.lock
 dependencies {
     compile project(':lockdown-core')

lockdown-core/build.gradle

@@ -1,3 +1,5 @@
+description = 'APIs for storing and reading encrypted credentials'
+
 //Dependency versions managed in $rootDir/dependencies.lock
 dependencies {
     compile group: 'com.google.code.findbugs', name: 'jsr305'

lockdown-gradle-plugin/build.gradle

@@ -1,5 +1,7 @@
 apply plugin: 'groovy'
 
+description = 'Gradle tasks and utilities for credential management'
+
 //Dependency versions managed in $rootDir/dependencies.lock
 dependencies {
     compile gradleApi()