Distribute your libraries via Maven, even privately

Transcript

MAVEN LIBRARY
DISTRIBUTION
@MOLSJEROEN

View Slide

@MOLSJEROEN
@MOLSJEROEN

View Slide

BEFORE SOFTWARE CAN BE REUSABLE
IT FIRST HAS TO BE USABLE.
Ralph Johnson

View Slide

@MOLSJEROEN
GOAL
dependencies { 
…
compile ‘com.jeroenmols:landscapevideocamera:1.1.4' 
}

View Slide

MAVEN FUNDAMENTALS

View Slide

@MOLSJEROEN
WHAT IS MAVEN
…a build automation tool used primarily for Java projects.
1. Describes how software is built
▸ Build system (like Ant)
2. Reuse/version dependencies
▸ Adopted by Gradle

View Slide

@MOLSJEROEN
HOW MAVEN HANDLES DEPENDENCIES
▸ Release identiﬁed by
▸ GroupId com.jeroenmols
▸ ArtifactId landscapevideocamera
▸ Version 1.1.4
▸ Multiple artifacts possible
▸ Library landscapevideocamera.aar
▸ Documentation javadoc.jar
▸ Sources sources.jar

View Slide

@MOLSJEROEN
HOW MAVEN STORES DEPENDENCIES

View Slide

@MOLSJEROEN
DEPENDENCY MANAGEMENT ADOPTED BY ANDROID/GRADLE
▸ Deﬁne Maven repositories
▸ Local Maven repository in SDK
▸ Dependency conﬁgurations
dependencies {
compile ‘com.jeroenmols:landscapevideocamera:1.1.4’ 
testCompile ‘org.mockito:mockito-core:2.0.54-beta’
androidTestCompile ‘com.android.support.test:runner:0.4’
}

View Slide

@MOLSJEROEN
DEPENDENCY MANAGEMENT ADOPTED BY ANDROID/GRADLE
▸ Deﬁne Maven repositories
▸ Local Maven repository in SDK
▸ Dependency conﬁgurations
dependencies {
testCompile ‘org.mockito:mockito-core:2.0.54-beta’
androidTestCompile ‘com.android.support.test:runner:0.4’
}

View Slide

@MOLSJEROEN
GRADLE - USE MAVEN ARTIFACTS
allprojects { 
repositories { 
jcenter() 
maven { url “http://mywebsite.com/mavenrepository" } 
} 
}
dependencies { 
compile fileTree(dir: 'libs', include: ['*.jar']) 
compile ‘com.android.support:appcompat-v7:23.1.0’
 
}

View Slide

@MOLSJEROEN
allprojects { 
repositories { 
jcenter() 
} 
}
dependencies { 
 
}

View Slide

@MOLSJEROEN
allprojects { 
repositories { 
jcenter() 
} 
}
dependencies { 
 
}

View Slide

@MOLSJEROEN
allprojects { 
repositories { 
jcenter() 
} 
}
dependencies { 
 
}
GroupId ArtifactId Version

View Slide

@MOLSJEROEN
IMPLICIT ASSUMPTIONS USING MAVEN
1. Repository reachable and online forever
2. Existing artifacts never modiﬁed
3. New versions come from same developer
▸ Code must always build immediately after checkout
▸ When doubt: add artifacts to version control

View Slide

PUBLIC DISTRIBUTION

View Slide

THERE IS AN EASY WAY AND A HARD
WAY. THE HARD PART IS FINDING THE
EASY WAY.
Dr. Lloyd

View Slide

@MOLSJEROEN
PUBLIC MAVEN REPOSITORIES
repositories { 
jcenter() 
}
‣ Bintray
‣ Browse repository
repositories { 
mavenCentral() 
}
‣ Sonatype

View Slide

@MOLSJEROEN
PUBLIC MAVEN REPOSITORIES
repositories { 
jcenter() 
}
‣ Bintray
repositories { 
mavenCentral() 
}
‣ Sonatype

View Slide

@MOLSJEROEN
1. PUBLIC DISTRIBUTION - BINTRAY
▸ Attractive UI
▸ Simple to use (no signing)
▸ Integrates with Github, Bitbucket, Twitter,…
▸ Download statistics
▸ Gradle/manual upload to staging
▸ Manually release to JCenter
▸ One click/automated sync to Maven Central

View Slide

@MOLSJEROEN

View Slide

@MOLSJEROEN

View Slide

@MOLSJEROEN
BINTRAY - UPLOAD ARTIFACTS 1
‣ LIBRARY_HOME/build.gradle
ext { 
bintrayRepo = 'maven' 
bintrayName = 'LandscapeVideoCamera' 
 
publishedGroupId = 'com.github.jeroenmols' 
libraryName = ‘LandscapeVideoCamera’
libraryVersion = ‘1.1.4'
 
artifact = ‘library'
 
libraryDescription = 'Powerful custom Android Camera.’ 
developerId = 'JeroenMols' 
developerName = 'Jeroen Mols' 
developerEmail = '[email protected]' 
}
apply from: 'https://raw.githubusercontent.com/attwellBrian/JCenter/master/installv1.gradle' 
apply from: 'https://raw.githubusercontent.com/attwellBrian/JCenter/master/bintrayv1.gradle'

View Slide

@MOLSJEROEN
ext { 
 
libraryName = 'LandscapeVideoCamera'
libraryVersion = ‘1.1.4’
artifact = 'library'
 
libraryDescription = 'Powerful custom Android Camera.’  
}

View Slide

@MOLSJEROEN
ext { 
 
 
}

View Slide

@MOLSJEROEN
ext { 
 
libraryName = ‘LandscapeVideoCamera'
libraryVersion = '1.1.4' 
 
 
}

View Slide

@MOLSJEROEN
ext { 
 
artifact = ‘library'
 
}

View Slide

@MOLSJEROEN
‣ PROJECT_HOME/local.properties
bintray.user=jeroenmols 
bintray.apikey=n1c3try
‣ PROJECT_HOME/build.gradle
buildscript { 
dependencies { 
classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.2' 
classpath 'com.github.dcendents:android-maven-gradle-plugin:1.3' 
} 
}

View Slide

@MOLSJEROEN
buildscript { 
dependencies { 
} 
}

View Slide

@MOLSJEROEN
buildscript { 
dependencies { 
} 
}

View Slide

@MOLSJEROEN
‣ $ ./gradlew assembleRelease bintrayUpload

View Slide

@MOLSJEROEN

View Slide

@MOLSJEROEN
2. PUBLIC DISTRIBUTION - JITPACK.IO
▸ Zero conﬁguration
▸ Download statistics, API, Badges,…
▸ Snapshot support
▸ No need to upload artifacts
▸ Builds any GitHub project (and more)
▸ Git tag to create a ‘formal’ release (optional)
▸ Add Jitpack repository

View Slide

@MOLSJEROEN
JITPACK.IO - UPLOAD ARTIFACTS
DO NOTHING

View Slide

@MOLSJEROEN

View Slide

@MOLSJEROEN
JITPACK.IO - CONSUME ARTIFACTS
allprojects { 
repositories { 
jcenter() 
maven { url "https://jitpack.io" } 
} }
‣ MODULE_HOME/build.gradle
dependencies { 
compile 'com.github.JeroenMols:LandscapeVideoCamera:1.1.4' 
}

View Slide

@MOLSJEROEN
allprojects { 
repositories { 
jcenter() 
} }
dependencies { 
}

View Slide

@MOLSJEROEN
allprojects { 
repositories { 
jcenter() 
} }
dependencies { 
}

View Slide

@MOLSJEROEN
allprojects { 
repositories { 
jcenter() 
} }
dependencies { 
compile ‘com.github.JeroenMols:LandscapeVideoCamera:
3f900ec00b302f75f3d377cff0bdca37145fc89d' 
}

View Slide

@MOLSJEROEN
allprojects { 
repositories { 
jcenter() 
} }
dependencies { 
compile ‘com.github.JeroenMols:LandscapeVideoCamera:
develop-SNAPSHOT‘ 
}

View Slide

@MOLSJEROEN
allprojects { 
repositories { 
jcenter() 
} }
dependencies { 
compile ‘com.jeroenmols:LandscapeVideoCamera:1.1.4’ 
}

View Slide

PRIVATE DISTRIBUTION

View Slide

I THINK, FUNDAMENTALLY, OPEN
SOURCE DOES TEND TO BE MORE
STABLE SOFTWARE.
Linus Torvalds

View Slide

@MOLSJEROEN
▸ Easy to set up Maven repository
▸ Cache remote repository artifacts
▸ Open source (free)
▸ Gradle plugin to do the upload
▸ Advanced features
▸ Backups?
▸ Cost/hassle of running a server?
1. PRIVATE DISTRIBUTION - ARTIFACTORY
RELATED BLOGPOSTS

View Slide

@MOLSJEROEN

View Slide

@MOLSJEROEN
ARTIFACTORY - UPLOAD ARTIFACTS 1
buildscript { 
dependencies {
classpath “org.jfrog.buildinfo:
build-info-extractor-gradle:3.1.1" 
} 
}

View Slide

@MOLSJEROEN
buildscript { 
dependencies {
classpath “org.jfrog.buildinfo:
build-info-extractor-gradle:3.1.1" 
} 
}

View Slide

@MOLSJEROEN
apply plugin: 'maven-publish'
def packageName = 'com.jeroenmols.awesomelibrary' 
def libraryVersion = '1.0.0'
publishing { 
publications { 
aar(MavenPublication) { 
groupId = packageName 
version = libraryVersion 
artifactId = project.getName() 
artifact("$buildDir/outputs/aar/${project.getName()}-release.aar") 
} } }

View Slide

@MOLSJEROEN
publishing { 
publications { 
} } }

View Slide

@MOLSJEROEN
publishing { 
publications { 
} } }

View Slide

@MOLSJEROEN
publishing { 
publications { 
} } }

View Slide

@MOLSJEROEN
publishing { 
publications { 
} } }

View Slide

@MOLSJEROEN
apply plugin: ‘com.jfrog.artifactory'
artifactory { 
contextUrl = 'http://localhost:8081/artifactory' 
publish { 
repository { 
repoKey = 'libs-release-local' 
username = "admin" 
password = "password" 
} 
defaults { 
publications('aar') 
publishArtifacts = true 
publishPom = true 
} 
} }

View Slide

@MOLSJEROEN
artifactory { 
publish { 
repository { 
} 
defaults { 
} 
} }

View Slide

@MOLSJEROEN
artifactory { 
publish { 
repository { 
} 
defaults { 
} 
} }

View Slide

@MOLSJEROEN
artifactory { 
publish { 
repository { 
} 
defaults { 
} 
} }

View Slide

@MOLSJEROEN
artifactory { 
publish { 
repository { 
} 
defaults { 
} 
} }
to gradle.properties

View Slide

@MOLSJEROEN
artifactory { 
publish { 
repository { 
} 
defaults { 
} 
} }

View Slide

@MOLSJEROEN
▸ $ ./gradlew assembleRelease artifactoryPublish

View Slide

@MOLSJEROEN
ARTIFACTORY - CONSUME ARTIFACTS
allprojects { 
repositories { 
maven {
url “http://localhost:8081/artifactory/libs-release-local"
} } }
dependencies { 
compile 'com.jeroenmols.awesomelibrary:1.0.0' 
}

View Slide

@MOLSJEROEN
allprojects { 
repositories { 
maven {
} } }
dependencies { 
}

View Slide

@MOLSJEROEN
allprojects { 
repositories { 
maven {
} } }
dependencies { 
}

View Slide

@MOLSJEROEN
2. PRIVATE DISTRIBUTION - WAGON-GIT
▸ Git as a Maven repository
▸ Supports GitHub and BitBucket (public or private)
▸ Open source (free)
▸ Maven plugin to do the upload
▸ Inherent backups and remote access
RELATED BLOGPOST

View Slide

@MOLSJEROEN

View Slide

@MOLSJEROEN

View Slide

@MOLSJEROEN
WAGON-GIT - UPLOAD ARTIFACTS 1
▸ LIBRARY_HOME/gradle.properties
ARTIFACT_VERSION=1.0.0 
ARTIFACT_NAME=landscapevideocamera 
ARTIFACT_PACKAGE=com.jeroenmols.landscapevideocamera
ARTIFACT_PACKAGING=aar 
 
BITBUCKET_TEAM=jmolsmobile 
REPOSITORY_NAME=maven_repository
▸ PROJECT_HOME/gradle.properties
USERNAME= 
PASSWORD=

View Slide

@MOLSJEROEN
 
USERNAME= 
PASSWORD=

View Slide

@MOLSJEROEN
 
USERNAME= 
PASSWORD=

View Slide

@MOLSJEROEN
 
USERNAME= 
PASSWORD=

View Slide

@MOLSJEROEN
▸ LIBRARY_HOME/build.gradle
apply from: 'https://raw.githubusercontent.com/JeroenMols/
GitAsMaven/master/publish-bitbucket.gradle'
▸ $ gradle assembleRelease uploadArchives

View Slide

@MOLSJEROEN
PUBLISH-BITBUCKET SCRIPT
▸ Dramatically simpliﬁes conﬁguration
▸ Check for existing artifacts
▸ Bitbucket authentication
▸ Source: https://github.com/JeroenMols/GitAsMaven/blob/master/publish-
bitbucket.gradle

View Slide

@MOLSJEROEN
PUBLISH-BITBUCKET SCRIPT - EXISTING ARTIFACTS 1
uploadArchives.dependsOn lookForArtifacts
task lookForArtifacts { 
doLast { 
def libraryName = ARTIFACT_NAME + '-' + ARTIFACT_VERSION + '.aar' 
def repoPath = ARTIFACT_PACKAGE.replace(".", "/") + "/"
+ ARTIFACT_NAME + "/" + ARTIFACT_VERSION + "/" + libraryName 
def repositoryUrl = 'https://api.bitbucket.org/1.0/repositories/'
+ COMPANY + '/' + REPOSITORY_NAME + '/raw/releases/' + repoPath 
if (urlExists(repositoryUrl)) { 
throw new RuntimeException(“Artifact exists:" + ARTIFACT_VERSION) 
} 
return true 
} }

View Slide

@MOLSJEROEN
doLast { 
} 
return true 
} }

View Slide

@MOLSJEROEN
doLast { 
} 
return true 
} }

View Slide

@MOLSJEROEN
doLast { 
} 
return true 
} }

View Slide

@MOLSJEROEN
doLast { 
} 
return true 
} }

View Slide

@MOLSJEROEN
def urlExists(String repositoryUrl) { 
try { 
def conn = (HttpURLConnection) new URL(repositoryUrl).openConnection() 
 
conn.setRequestProperty("Authorization","Basic " +
getBase64EncodedCredentials()) 
conn.setConnectTimeout(10000) 
conn.setReadTimeout(10000) 
conn.setRequestMethod("HEAD") 
 
def responseCode = connection.getResponseCode() 
println("responseCode: " + responseCode) 
 
return (200 == responseCode)
 
} catch (IOException ignored) { 
return false 
} }

View Slide

@MOLSJEROEN
try { 
 
 
 
 
return false 
} }

View Slide

@MOLSJEROEN
try { 
 
 
 
 
return false 
} }

View Slide

@MOLSJEROEN
CONSUME ARTIFACTS
allprojects { 
repositories { 
maven { 
credentials { 
username '' 
password ‘' 
} 
url "https://api.bitbucket.org/1.0/repositories/"
+ “//raw/releases" 
} } }
dependencies { 
compile "com.jeroenmols:landscapevideocamera:" 
}

View Slide

@MOLSJEROEN
CONSUME ARTIFACTS
allprojects { 
repositories { 
maven { 
credentials { 
username '' 
password ‘' 
} 
} } }
dependencies { 
compile “com.jeroenmols:landscapevideocamera:" 
}

View Slide

@MOLSJEROEN
CONSUME ARTIFACTS
allprojects { 
repositories { 
maven { 
credentials { 
username '' 
password ‘' 
} 
} } }
dependencies { 
compile “com.jeroenmols:landscapevideocamera:" 
}

View Slide

@MOLSJEROEN
CONSUME ARTIFACTS
allprojects { 
repositories { 
maven { 
credentials { 
username '' 
password ‘' 
} 
} } }
dependencies { 
compile "com.jeroenmols:landscapevideocamera:" 
}

View Slide

WRAP UP

View Slide

@MOLSJEROEN
CONCLUSION
▸ Use Gradle to simplify Maven uploads
▸ Public distribution
▸ Use Jitpack initially
▸ Scale to Bintray once usage grows
▸ Private distirbution
▸ Use Artifactory when possible ($$$, infrastructure,…)
▸ Fallback to Git for limited usage

View Slide

@MOLSJEROEN
CREDITS
▸ Distributing Android Libraries via jCenter for Gradle Importing @attwellbrian
▸ A private Maven repository in 30 min @molsjeroen
▸ Getting the most out of Artifactory @molsjeroen
▸ Git as a secure private Maven repository @molsjeroen

View Slide

@MOLSJEROEN
GITHUB SAMPLES
▸ Bintray example @attwellbrian
▸ Artifactory example @molsjeroen
▸ Wagon-git example @molsjeroen

View Slide

@MOLSJEROEN
IMAGE CREDITS
▸ Philips Hue living room 
http://www.philips.de
▸ Pouring concrete 
http://www.precisionpouredconcrete.com/images/concrete-being-poured.jpg
▸ Flying drones 
https://s3.amazonaws.com/digitaltrends-uploads-prod/2014/12/Drones-packages.jpg
▸ Pneumatic tubes 
https://41.media.tumblr.com/107ae958bff7ce2261c55e7a4de8f79e/tumblr_nlt2wfG8gr1t3cxt2o1_500.jpg
▸ Judge hammer 
http://www.quickhr.biz/wp-content/uploads/2015/03/Judges-hammer.jpg

View Slide

@MOLSJEROEN
MANY THANKS
▸ Jeroen Mols (Belgium)
▸ @MolsJeroen
▸ http://jeroenmols.com/blog

View Slide

@MOLSJEROEN
OTHER INTERESTING ARTICLES
▸ Gradle dependency and local repository @turhanoz
▸ Creating and publishing an Android library @Etienne_Lawlor
▸ Publish with Gradle on BitBucket @mul0w
▸ Gradle Maven Push script @chrisbanes

View Slide

Distribute your libraries via Maven, even privately

Distribute your libraries via Maven, even privately

Jeroen Mols

More Decks by Jeroen Mols

Other Decks in Programming

Featured

Transcript