L'utilizzo di dipendenze software è una tecnica entrata già da tempo nella pratica quotidiana di ciascun buon programmatore. I suoi vantaggi sono indubbi ma non tutti sanno come funzionano le dipendenze e come sia possibile rendere disponibile pubblicamente la propria libreria. In questo talk cerco di spiegare per quale motivo è importante utilizzare dipendenze software, come funzionano, perché può essere utile pubblicare le proprie librerie e come è possibile farlo, mostrando un caso reale basato su Gradle.

1. #IOextendedGE16
DISTRIBUIRE UNA LIBRERIA JAVA
PER USARLA COME DIPENDENZA
GRADLE
+PaoloMontalto

2. #IOextendedGE16
DIPENDENZE
+PaoloMontalto
Librerie di terze parti o altri progetti necessari
alla compilazione di un progetto software
Non ha senso:
¤ Reinventare la ruota ad ogni nuovo progetto
¤ Portarsi dietro delle classi facendo copia e incolla da altri progetti
¤ Portarsi dietro dei jar di versione e provenienza dubbia
¤ Fare copia e incolla da Stackoverflow

3. #IOextendedGE16
DIPENDENZE
+PaoloMontalto
Librerie di terze parti o altri progetti necessari
alla compilazione di un progetto software
Non ha senso:
¤ Reinventare la ruota ad ogni nuovo progetto
¤ Portarsi dietro delle classi facendo copia e incolla da altri progetti
¤ Portarsi dietro dei jar di versione e provenienza dubbia
¤ Fare copia e incolla da Stackoverflow
build automation

4. #IOextendedGE16
MAVEN
+PaoloMontalto
Forse il più noto sistema di build automation
¤ consente di definire il ciclo di vita di un processo di build
¤ definisce le dipendenze del proge4o
¤ file di configurazione basa5 su XML
¤ repository di librerie
Identifica le dipendenze tramite
groupId identifica il progetto univocamente it.xabaras.android.logger
artifactId è il nome della libreria (senza versione) Logger
version è il numero di versione della libreria 1.3.6
E’ possibile distribuire più artifact nella stessa versione:
libreria, documentazione, sorgenti

5. #IOextendedGE16
MAVEN
+PaoloMontalto
<dependency>
<groupId>it.xabaras.android.logger</groupId>
<artifactId>Logger</artifactId>
<version>1.3.6</version>
<type>pom</type>
</dependency>

6. version
#IOextendedGE16
GRADLE
+PaoloMontalto
Sistema di build automation
¤ mul5pia4aforma
¤ mul5linguaggio
¤ mul5proge4o
¤ DSL basato su groovy
¤ build incrementali
¤ notazione compa4a per le dipendenze
¤ Usa maven come repository locale/remoto per le dipendenze
compile 'it.xabaras.android.logger:Logger:1.3.6’
groupId
ar5factId dependencies {
}

7. #IOextendedGE16
PERCHÉ DISTRIBUIRE LIBRERIE?
+PaoloMontalto
¤ Riuso del codice
¤ Librerie disponibili online sempre
¤ Rendere disponibili versioni aggiornate
¤ Certezza della provenienza dei file
¤ Maggiore facilità manutenzione
¤ Contribuire alla comunità

8. #IOextendedGE16
MAVEN CENTRAL VS JCENTER
+PaoloMontalto
Maven Central
h4p://search.maven.org
JCenter
h4p://jcenter.bintray.com
repositories {
mavenCentral()
}
repositories {
jcenter()
}

9. #IOextendedGE16
MAVEN CENTRAL VS JCENTER
+PaoloMontalto
Maven Central
h4p://search.maven.org
JCenter
h4p://jcenter.bintray.com
Sonatype
¤ Linea di commando
¤ Jira ticket
¤ cifratura build
JFrog
¤ Web UI
¤ semplice da usare (no cifratura)
¤ Integrazione con GitHub e BitBucket
¤ Sincronizzazione con Maven Central
¤ Statistiche di download

10. #IOextendedGE16
MAVEN CENTRAL VS JCENTER
+PaoloMontalto
Maven Central
h4p://search.maven.org
JCenter
h4p://jcenter.bintray.com
Sonatype
¤ Linea di commando
¤ Jira ticket
¤ cifratura build
JFrog
¤ Web UI
¤ semplice da usare (no cifratura)
¤ Integrazione con GitHub e BitBucket
¤ Sincronizzazione con Maven Central
¤ Statistiche di download
>=
mavenCentral()

11. #IOextendedGE16
PUBBLICARE SU JCENTER
+PaoloMontalto
¤ Registrarsi su Bintray
¤ Creare un package nel repository maven
¤ Configurare il progetto gradle
¤ Caricare gli artifact su bintray
¤ Sincronizzare il repository con jcenter

12. #IOextendedGE16
REGISTRARSI SU BINTRAY
+PaoloMontalto

13. #IOextendedGE16
PUBBLICARE SU JCENTER
+PaoloMontalto
¤ Registrarsi su Bintray
¤ Creare un package nel repository maven
¤ Configurare il progetto gradle
¤ Caricare gli artifact su bintray
¤ Sincronizzare il repository con jcenter

14. #IOextendedGE16
CREARE UN PACKAGE NEL REPOSITORY MAVEN
+PaoloMontalto

15. #IOextendedGE16
CREARE UN PACKAGE NEL REPOSITORY MAVEN 2
+PaoloMontalto

16. #IOextendedGE16
PUBBLICARE SU JCENTER
+PaoloMontalto
¤ Registrarsi su Bintray
¤ Creare un package nel repository maven
¤ Configurare il progetto gradle
¤ Caricare gli artifact su bintray
¤ Sincronizzare il repository con jcenter

17. #IOextendedGE16
CONFIGURARE IL PROGETTO GRADLE
+PaoloMontalto
¤ settings.gradle
apply plugin: 'java’
group 'it.xabaras.android.logger'
version '1.3.6’
jar {
manifest {
attributes(
"Created-By": "Paolo Montalto",
"Specification-Title": rootProject.name,
"Implementation-Title": group,
"Implementation-Version": version
)
}
}
dependencies {
testCompile group: 'junit', name: 'junit', version: '4.11'
...
}
rootProject.name = 'Logger'
¤ build.gradle

18. #IOextendedGE16
CONFIGURARE IL PROGETTO GRADLE 2
+PaoloMontalto
¤ Bintray plugin (build.gradle)
plugins {
id "com.jfrog.bintray" version "1.6"
}
¤ local.properties
bintray.user=xabaras
bintray.apiKey=abcdefghijklmnopqrstuwxyz1234567890ABCDE

19. #IOextendedGE16
CONFIGURARE IL PROGETTO GRADLE 3
+PaoloMontalto
¤ build.gradle
bintray {
user = properties.getProperty('bintray.user’)
key = properties.getProperty('bintray.apiKey’)
configurations = [’archives’]
publish = true
pkg {
repo = 'maven'
name = 'Logger'
desc = 'A simple class wrapping android logger introducing some utilities. '
websiteUrl = 'https://github.com/xabaras/Logger'
issueTrackerUrl = 'https://github.com/xabaras/Logger/issues'
vcsUrl = 'https://github.com/xabaras/Logger.git'
licenses = ['Apache-2.0']
publicDownloadNumbers = true
version {
name = project['version']
desc = 'Logger ' + project['version']
}
}
}

20. #IOextendedGE16
CONFIGURARE IL PROGETTO GRADLE 3
+PaoloMontalto
¤ build.gradle
bintray {
user = properties.getProperty('bintray.user’)
key = properties.getProperty('bintray.apiKey’)
configurations = [’archives’]
publish = true
pkg {
repo = 'maven'
name = 'Logger'
desc = 'A simple class wrapping android logger introducing some utilities. '
websiteUrl = 'https://github.com/xabaras/Logger'
issueTrackerUrl = 'https://github.com/xabaras/Logger/issues'
vcsUrl = 'https://github.com/xabaras/Logger.git'
licenses = ['Apache-2.0']
publicDownloadNumbers = true
version {
name = project['version']
desc = 'Logger ' + project['version']
}
}
}

21. #IOextendedGE16
CONFIGURARE IL PROGETTO GRADLE 3
+PaoloMontalto
¤ build.gradle
bintray {
user = properties.getProperty('bintray.user’)
key = properties.getProperty('bintray.apiKey’)
configurations = [’archives’]
publish = true
pkg {
repo = 'maven'
name = 'Logger'
desc = 'A simple class wrapping android logger introducing some utilities. '
websiteUrl = 'https://github.com/xabaras/Logger'
issueTrackerUrl = 'https://github.com/xabaras/Logger/issues'
vcsUrl = 'https://github.com/xabaras/Logger.git'
licenses = ['Apache-2.0']
publicDownloadNumbers = true
version {
name = project['version']
desc = 'Logger ' + project['version']
}
}
}

22. #IOextendedGE16
CONFIGURARE IL PROGETTO GRADLE 3
+PaoloMontalto
¤ build.gradle
bintray {
user = properties.getProperty('bintray.user’)
key = properties.getProperty('bintray.apiKey’)
configurations = [’archives’]
publish = true
pkg {
repo = 'maven'
name = 'Logger'
desc = 'A simple class wrapping android logger introducing some utilities. '
websiteUrl = 'https://github.com/xabaras/Logger'
issueTrackerUrl = 'https://github.com/xabaras/Logger/issues'
vcsUrl = 'https://github.com/xabaras/Logger.git'
licenses = ['Apache-2.0']
publicDownloadNumbers = true
version {
name = project['version']
desc = 'Logger ' + project['version']
}
}
}

23. #IOextendedGE16
CONFIGURARE IL PROGETTO GRADLE 3
+PaoloMontalto
¤ build.gradle
bintray {
user = properties.getProperty('bintray.user’)
key = properties.getProperty('bintray.apiKey’)
configurations = [’archives’]
publish = true
pkg {
repo = 'maven'
name = 'Logger'
desc = 'A simple class wrapping android logger introducing some utilities. '
websiteUrl = 'https://github.com/xabaras/Logger'
issueTrackerUrl = 'https://github.com/xabaras/Logger/issues'
vcsUrl = 'https://github.com/xabaras/Logger.git'
licenses = ['Apache-2.0']
publicDownloadNumbers = true
version {
name = project['version']
desc = 'Logger ' + project['version']
}
}
}

24. #IOextendedGE16
CONFIGURARE IL PROGETTO GRADLE 4
+PaoloMontalto
task sourcesJar(type: Jar, dependsOn: classes) {
classifier = 'sources'
from sourceSets.main.allSource
}
task javadocJar(type: Jar, dependsOn: javadoc) {
classifier = 'javadoc'
from javadoc.des5na5onDir
}
ar5facts {
archives sourcesJar
archives javadocJar
}
¤ build.gradle

25. #IOextendedGE16
PUBBLICARE SU JCENTER
+PaoloMontalto
¤ Registrarsi su Bintray
¤ Creare un package nel repository maven
¤ Configurare il progetto gradle
¤ Caricare gli artifact su bintray
¤ Sincronizzare il repository con jcenter

26. #IOextendedGE16
CARICARE GLI ARTIFACT SU BINTRAY
+PaoloMontalto

27. #IOextendedGE16
CARICARE GLI ARTIFACT SU BINTRAY 2
+PaoloMontalto

28. #IOextendedGE16
CARICARE GLI ARTIFACT SU BINTRAY 3
+PaoloMontalto
La libreria è sul vostro repository maven ma non su jcenter
repositories {
maven {
url 'h4ps://dl.bintray.com/xabaras/maven'
}
}
...
dependencies {
compile 'it.xabaras.android.logger:Logger:1.3.6'
}

29. #IOextendedGE16
PUBBLICARE SU JCENTER
+PaoloMontalto
¤ Registrarsi su Bintray
¤ Creare un package nel repository maven
¤ Configurare il progetto gradle
¤ Caricare gli artifact su bintray
¤ Sincronizzare il repository con jcenter

30. #IOextendedGE16
SINCRONIZZARE IL REPOSITORY CON JCENTER
+PaoloMontalto

31. #IOextendedGE16
SINCRONIZZARE IL REPOSITORY CON JCENTER
+PaoloMontalto

32. #IOextendedGE16
PRONTI AD USARE LA LIBRERIA PUBBLICATA
+PaoloMontalto
repositories {
jcenter()
}
dependencies {
…
compile 'it.xabaras.android.logger:Logger:1.3.6’
…
}

33. #IOextendedGE16
PUBBLICARE ANCHE SU MAVEN CENTRAL
+PaoloMontalto
¤ Creare un account Sonatype
¤ Creare una issue su JIRA
¤ Aggiungere lo username Sonatype su Bintray
¤ Abilitare l’auto signing delle build su Bintray (coppia chiavi GPG)
¤ Configurare il build.gradle
¤ Caricare gli artifact su bintray
¤ Sincronizzare il repository con Maven Central

34. #IOextendedGE16
PUBBLICARE ANCHE SU MAVEN CENTRAL 2
+PaoloMontalto
¤ Creare un account Sonatype
¤ Creare una issue su JIRA
¤ Aggiungere lo username Sonatype su Bintray
¤ Abilitare l’auto signing delle build su Bintray (coppia chiavi GPG)
¤ Configurare il build.gradle
¤ Caricare gli artifact su bintray
¤ Sincronizzare il repository con Maven Central

35. #IOextendedGE16
PUBBLICARE ANCHE SU MAVEN CENTRAL 3
+PaoloMontalto
¤ Creare un account Sonatype
¤ Creare una issue su JIRA
¤ Aggiungere lo username Sonatype su Bintray
¤ Abilitare l’auto signing delle build su Bintray (coppia chiavi GPG)
¤ Configurare il build.gradle
¤ Caricare gli artifact su bintray
¤ Sincronizzare il repository con Maven Central

36. #IOextendedGE16
PUBBLICARE ANCHE SU MAVEN CENTRAL 4
+PaoloMontalto
¤ Creare un account Sonatype
¤ Creare una issue su JIRA
¤ Aggiungere lo username Sonatype su Bintray
¤ Abilitare l’auto signing delle build su Bintray (coppia chiavi GPG)
¤ Configurare il build.gradle
¤ Caricare gli artifact su bintray
¤ Sincronizzare il repository con Maven Central

37. #IOextendedGE16
PUBBLICARE ANCHE SU MAVEN CENTRAL 5
+PaoloMontalto
¤ Creare un account Sonatype
¤ Creare una issue su JIRA
¤ Aggiungere lo username Sonatype su Bintray
¤ Abilitare l’auto signing delle build su Bintray (coppia chiavi GPG)
¤ Configurare il build.gradle
¤ Caricare gli artifact su bintray
¤ Sincronizzare il repository con Maven Central

38. #IOextendedGE16
PUBBLICARE ANCHE SU MAVEN CENTRAL 5
+PaoloMontalto
¤ local.properties
bintray_gpg_password=LA_MIA_PASSWORD_GPG
¤ build.gradle
bintray {
configurations = [’archives’]
publications = ['mavenStuff']
version {
…
gpg {
sign = true
passphrase = properties.getProperty('bintray_gpg_password’)
}
}

39. #IOextendedGE16
PUBBLICARE ANCHE SU MAVEN CENTRAL 5
+PaoloMontalto
¤ build.gradle
publishing {
publications {
mavenStuff(MavenPublication) {
from components.java
groupId group
artifactId rootProject.name
version version
artifact sourcesJar
artifact javadocJar
pom.withXml {
// package name, description, licenses and developer info
}
}
}
}

40. #IOextendedGE16
PUBBLICARE ANCHE SU MAVEN CENTRAL 6
+PaoloMontalto
¤ Creare un account Sonatype
¤ Creare una issue su JIRA
¤ Aggiungere lo username Sonatype su Bintray
¤ Abilitare l’auto signing delle build su Bintray (coppia chiavi GPG)
¤ Configurare il build.gradle
¤ Caricare gli artifact su bintray
¤ Sincronizzare il repository con Maven Central

41. #IOextendedGE16
PUBBLICARE ANCHE SU MAVEN CENTRAL 7
+PaoloMontalto
¤ Creare un account Sonatype
¤ Creare una issue su JIRA
¤ Aggiungere lo username Sonatype su Bintray
¤ Abilitare l’auto signing delle build su Bintray (coppia chiavi GPG)
¤ Configurare il build.gradle
¤ Caricare gli artifact su bintray
¤ Sincronizzare il repository con Maven Central

42. #IOextendedGE16
PUBBLICARE UNA LIBRERIA ANDROID
+PaoloMontalto
Libreria Java
jar
Libreria Android
?

43. #IOextendedGE16
PUBBLICARE UNA LIBRERIA ANDROID
+PaoloMontalto
Libreria Java
jar
Libreria Android
aar

44. #IOextendedGE16
PUBBLICARE UNA LIBRERIA ANDROID 2
+PaoloMontalto
Android Archive Library
¤ AndroidManifest.xml
¤ classi java (classes.jar)
¤ risorse (cartella “res”)
¤ assets
¤ I jar della cartella libs
¤ librerie JNI
¤ etc.

45. #IOextendedGE16
PUBBLICARE UNA LIBRERIA ANDROID 3
+PaoloMontalto
¤ local.properties
bintray.user=xabaras
bintray.apiKey=abcdefghijklmnopqrstuwxyz1234567890ABCD
bintray.gpg.password=LA_MIA_PASSWORD_GPG
dependencies {
classpath 'com.android.tools.build:gradle:1.1.2+'
classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.4'
classpath 'com.github.dcendents:android-maven-gradle-plugin:1.3'
}
¤ build.gradle

46. #IOextendedGE16
PUBBLICARE UNA LIBRERIA ANDROID 4
+PaoloMontalto
apply plugin: 'com.android.library'
ext {
bintrayRepo = 'maven'
bintrayName = ’sliding-menu'
publishedGroupId = ’it.xabaras.android’
libraryName = ’SlidingMenu'
artifact = ’sliding-menu’
libraryDescription = ’A Facebook like sliding menu for Android apps’
libraryVersion = '0.1.2'
developerId = ’xabaras'
developerName = ’Paolo Montalto'
developerEmail = ’p.montalto@xabaras.it'
licenseName = 'The Apache Software License, Version 2.0'
licenseUrl = 'http://www.apache.org/licenses/LICENSE-2.0.txt'
allLicenses = [‘Apache-2.0’]
}
apply from: 'https://raw.githubusercontent.com/nuuneoi/JCenter/master/installv1.gradle'
apply from: 'https://raw.githubusercontent.com/nuuneoi/JCenter/master/bintrayv1.gradle'
¤ build.gradle

47. #IOextendedGE16
PUBBLICARE UNA LIBRERIA ANDROID 4
+PaoloMontalto
apply plugin: 'com.android.library'
ext {
bintrayRepo = 'maven'
bintrayName = ’sliding-menu'
publishedGroupId = ’it.xabaras.android’
libraryName = ’SlidingMenu'
artifact = ’sliding-menu’
libraryDescription = ’A Facebook like sliding menu for Android apps’
libraryVersion = '0.1.2'
developerId = ’xabaras'
developerName = ’Paolo Montalto'
developerEmail = ’p.montalto@xabaras.it'
licenseName = 'The Apache Software License, Version 2.0'
licenseUrl = 'http://www.apache.org/licenses/LICENSE-2.0.txt'
allLicenses = [‘Apache-2.0’]
}
apply from: 'https://raw.githubusercontent.com/nuuneoi/JCenter/master/installv1.gradle'
apply from: 'https://raw.githubusercontent.com/nuuneoi/JCenter/master/bintrayv1.gradle'
¤ build.gradle

48. #IOextendedGE16
PUBBLICARE UNA LIBRERIA ANDROID 5
+PaoloMontalto
dependencies {
compile 'it.xabaras.android:sliding-menu:0.1.2@aar'
}

49. #IOextendedGE16
QUALCHE RIFERIMENTO
+PaoloMontalto
¤ How to distribute your own Android library through jCenter and Maven Central from
Android Studio @TheCheeseFact
¤ Distribute your libraries via Maven, even privately @molsjeroen
¤ Getting Started Using the Gradle Bintray Plugin bintray/gradle-bintray-plugin

50. #IOextendedGE16 +PaoloMontalto

51. #IOextendedGE16
GRAZIE PER L’ATTENZIONE
https://github.com/xabaras/
http://www.slideshare.net/montypablo
PAOLO MONTALTO
http://www.xabaras.it
https://it.linkedin.com/in/paolomontalto
Always code as if the guy who
ends up maintaining your code
will be a violent psychopath who
knows where you live.
John F. Woods
+PaoloMontalto
p.montalto@xabaras.it