{"id":32476,"date":"2019-10-31T21:47:17","date_gmt":"2019-10-31T18:47:17","guid":{"rendered":"https:\/\/prohoster.info\/blog\/opyt-ispolzovaniya-flatten-maven-plugin-dlya-uproshheniya-versionirovaniya-v-maven-proektah\/"},"modified":"2019-10-31T21:47:17","modified_gmt":"2019-10-31T18:47:17","slug":"opyt-ispolzovaniya-flatten-maven-plugin-dlya-uproshheniya-versionirovaniya-v-maven-proektah","status":"publish","type":"post","link":"https:\/\/prohoster.info\/it\/blog\/administrirovanie\/opyt-ispolzovaniya-flatten-maven-plugin-dlya-uproshheniya-versionirovaniya-v-maven-proektah","title":{"rendered":"Esperienza nell'uso di flatten-maven-plugin per semplificare la versioning nei progetti maven","gt_translate_keys":[{"key":"rendered","format":"text"}]},"content":{"rendered":"

Chi siamo<\/h4>\n

\nIn 1C, non solo sviluppiamo la piattaforma 1\u0421: Impresa<\/a><\/noindex> in C++<\/a><\/noindex> e JavaScript<\/a><\/noindex>, ma anche applicazioni in Java, in particolare un nuovo ambiente di sviluppo Strumenti di Sviluppo Enterprise<\/a><\/noindex> basato su Eclipse e un server profondamente integrato con la piattaforma del messenger - Sistemi di Interazione<\/a><\/noindex>.<\/p>\n

Introduzione<\/h4>\n

\nCome sistema di build per le applicazioni Java, utilizziamo pi\u00f9 frequentemente Maven e in questo breve articolo vorremmo parlare di uno dei problemi con cui ci siamo trovati a confrontarci durante l'organizzazione dello sviluppo e di un approccio che ha permesso di superare questo problema.
\n<\/a><\/noindex><\/p>\n

Presupposti e flusso di lavoro<\/h4>\n

\nA causa della specificit\u00e0 dello sviluppo nei nostri progetti Maven, utilizziamo un numero considerevole di moduli, dipendenze e progetti secondari. Il numero di file pom in un singolo albero pu\u00f2 raggiungere decine o addirittura centinaia.<\/p>\n

\"Esperienza
\n
\nSembrerebbe: non c'\u00e8 nulla di grave, una volta creati li dimentichiamo. Se \u00e8 necessario apportare modifiche o aggiungere elementi a tutti i file contemporaneamente, ci sono molti strumenti utili negli editor e IDE. E qual \u00e8 la modifica pi\u00f9 comune nel pom.xml? Riteniamo che sia la modifica delle versioni del progetto e delle dipendenze. \u00c8 possibile che qualcuno voglia contestare questo, ma per noi \u00e8 cos\u00ec. La ragione risiede nel fatto che, insieme al core, sviluppiamo parallelamente molte librerie proprie e per una costante riproducibilit\u00e0 dei risultati di build e test, l'uso dei snapshot non ci sembra un approccio comodo. Per questo motivo, dobbiamo innalzare il numero di versione nei progetti ad ogni build.<\/p>\n

Inoltre, a volte lo sviluppatore ha bisogno di costruire la propria branch di una libreria e verificare il suo funzionamento con tutte le dipendenze, per cui \u00e8 necessario cambiare manualmente la versione in tutte.<\/p>\n

Soluzione iniziale<\/h4>\n

\nCon cos\u00ec tanti cambiamenti frequenti e molteplici versioni, desideriamo semplificare e automatizzare il processo all'interno del CI. Qui viene in aiuto un plugin noto e conveniente versions-maven-plugin<\/i> \u2014 lo colleghiamo e lo eseguiamo <\/p>\n

mvn -N versions:set -DnewVersion=2.0.1 <\/i><\/p>\n

e Maven far\u00e0 tutto come deve: passer\u00e0 attraverso l'gerarchia dall'alto verso il basso, sostituir\u00e0 tutte le versioni - bellissimo! Ora rimane solo alzare una pull-request, i colleghi esamineranno le modifiche e possiamo rapidamente integrarsi nel trunk. Velocemente? Macch\u00e9. Un paio di centinaia pom.xml<\/i> in revisione, e questo senza contare il codice. Inoltre, nessuno \u00e8 al sicuro dai conflitti di merge con cos\u00ec tanti file modificati. Vale la pena notare che nel processo CI le versioni vengono aggiornate automaticamente insieme ai cambiamenti di funzionalit\u00e0, non separatamente.<\/p>\n

Nuove funzionalit\u00e0<\/h4>\n

\nCi siamo calmati per un po\u2019 e, rassegnati, abbiamo continuato a vivere cos\u00ec, fino a quando i ragazzi di Maven Apache Project<\/a><\/noindex> non hanno incluso in maven, a partire dalla versione 3.5.0-beta-1, il supporto per i cosiddetti \"sostituti\" delle versioni (placeholders). L\u2019idea di questi sostituti \u00e8 che pom.xml<\/i> anzich\u00e9 indicare un numero di versione specifico del progetto, si usano delle variabili ${revision}<\/i>, ${sha1}<\/i> e ${changelist}<\/i>. I valori di queste propriet\u00e0 possono essere definiti o all'interno dell'elemento <properties<\/i>>, oppure possono essere definiti tramite la propriet\u00e0 di sistema<\/p>\n

mvn -Drevision=2.0.0 clean package<\/i><\/p>\n

I valori delle propriet\u00e0 di sistema hanno la precedenza rispetto ai valori definiti in <properties<\/i>>.<\/p>\n

Padre<\/b>
\n<project>
\n\u00a0\u00a0<modelVersion>4.0.0<\\\/modelVersion>
\n\u00a0\u00a0<parent>
\n\u00a0\u00a0\u00a0\u00a0<groupId>org.apache<\\\/groupId>
\n\u00a0\u00a0\u00a0\u00a0<artifactId>apache<\\\/artifactId>
\n\u00a0\u00a0\u00a0\u00a0<version>18<\\\/version>
\n\u00a0\u00a0<\\\/parent>
\n\u00a0\u00a0<groupId>org.apache.maven.ci<\\\/groupId>
\n\u00a0\u00a0<artifactId>ci-parent<\\\/artifactId>
\n\u00a0\u00a0<name>First CI Friendly<\\\/name>
\n\u00a0\u00a0<version>${revision}${sha1}${changelist}<\/b><\\\/version>
\n\u00a0\u00a0\u2026
\n\u00a0\u00a0<properties>
\n\u00a0\u00a0\u00a0\u00a0<revision><\/b>1.3.1<\\\/revision><\/b>
\n\u00a0\u00a0\u00a0\u00a0<changelist><\/b>-SNAPSHOT<\\\/changelist><\/b>
\n\u00a0\u00a0\u00a0\u00a0<sha1\\\/><\/b>
\n\u00a0\u00a0<\\\/properties>
\n<\\\/project>
\n<\/i>
\nDiscendente<\/b>
\n<project>
\n\u00a0\u00a0<modelVersion>4.0.0<\\\/modelVersion>
\n\u00a0\u00a0<parent>
\n\u00a0\u00a0\u00a0\u00a0<groupId>org.apache.maven.ci<\\\/groupId>
\n\u00a0\u00a0\u00a0\u00a0<artifactId>ci-parent<\\\/artifactId>
\n\u00a0\u00a0\u00a0\u00a0<version>${revision}${sha1}${changelist}<\/b><\\\/version>
\n\u00a0\u00a0<\\\/parent>
\n\u00a0\u00a0<groupId>org.apache.maven.ci<\\\/groupId>
\n\u00a0\u00a0<artifactId>ci-child<\\\/artifactId>
\n\u00a0\u00a0\u00a0\u2026
\n<\\\/project>
\n<\/i><\/p>\n

Se si desidera raccogliere la versione 2.0.0-SNAPSHOT, basta utilizzare <\/p>\n

\u00a0\u00a0\u00a0\u00a0mvn -Drevision=2.0.0 clean package<\/i><\/p>\n

Se si desidera effettuare un rilascio, basta azzerare SNAPSHOT <\/p>\n

\u00a0\u00a0\u00a0\u00a0mvn -Dchangelist= clean package<\/i><\/p>\n

*Gli esempi sopra sono tratti da sul CommunityHelpWiki (sullo stesso dominio<\/a><\/noindex> sito del Maven Apache Project<\/p>\n

La dura realt\u00e0<\/h4>\n

\nTutto bene e bello, \u00e8 ora di provare un senso di soddisfazione, ma no. Si scopre che per install e deploy questo metodo non va bene, poich\u00e9 nelle descrizioni degli artefatti pubblicati nel repository non verr\u00e0 sostituito ${revision}<\/i> con il suo valore e maven non capir\u00e0 pi\u00f9 di cosa si stia parlando.<\/p>\n

<parent>
\n\u00a0\u00a0\u00a0\u00a0<groupId>org.apache<\\\/groupId>
\n\u00a0\u00a0\u00a0\u00a0<artifactId>apache<\\\/artifactId>
\n\u00a0\u00a0\u00a0\u00a0<version>${revision}<\\\/version>
\n<\\\/parent>
\n<\/i><\/p>\n

Luce in fondo al tunnel<\/h4>\n

\nDobbiamo cercare una soluzione al problema. La situazione potrebbe essere salvata da flatten-maven-plugin<\/a><\/noindex>. Questo plugin consente tutte le variabili nel pom, ma rimuove anche una quantit\u00e0 considerevole di altre informazioni necessarie solo durante la compilazione e non richieste per l'importazione di artefatti pubblicati in altri progetti. Inoltre, il plugin \u00abappiattisce\u00bb tutte le dipendenze parent-child, producendo pom piatti che includono tutto il necessario. Il problema era che tagliava via \u00abtroppe cose superflue\u00bb, il che non ci soddisfaceva affatto. Dopo aver esaminato le informazioni sullo sviluppo di questo plugin, abbiamo scoperto di non essere gli unici nell'universo e, gi\u00e0 nell'agosto 2018, \u00e8 stata creata su GitHub una pull-request nel repository del plugin con la richiesta di poter definire autonomamente come \u00abmanipolare\u00bb il pom.xml. Gli sviluppatori hanno ascoltato le richieste e gi\u00e0 a dicembre, con l'uscita della nuova versione 1.1.0, nel flatten-maven-plugin \u00e8 stata introdotta una nuova modalit\u00e0 resolveCiFriendliesOnly, che \u00e8 arrivata al momento giusto: mantiene il pom.xml cos\u00ec com'\u00e8, tranne per l'elemento <version><\/i> e consente ${revision}<\/i>, ${sha1}<\/i> e ${changelist}<\/i>.<\/p>\n

Aggiungiamo il plugin al progetto<\/p>\n

<plugins>
\n\u00a0\u00a0<plugin>
\n\u00a0\u00a0\u00a0\u00a0org.codehaus.mojo
\n\u00a0\u00a0\u00a0\u00a0flatten-maven-plugin
\n\u00a0\u00a0\u00a0\u00a01.1.0
\n\u00a0\u00a0\u00a0\u00a0<configuration>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0true
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<flattenMode>resolveCiFriendliesOnly<\/b><\/flattenMode>
\n\u00a0\u00a0\u00a0\u00a0<\/configuration>
\n\u00a0\u00a0\u00a0\u00a0<executions>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<execution>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0flatten
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0process-resources
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<goals>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0flatten
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/goals>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/execution>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<execution>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0flatten.clean
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0clean
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<goals>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0clean
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/goals>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/execution>
\n\u00a0\u00a0\u00a0\u00a0<\/executions>
\n\u00a0\u00a0<\/plugin>
\n<\/plugins>
\n<\/i><\/p>\n

Fatto!<\/p>\n

Happy end<\/h4>\n

\nDa ora in poi, per cambiare la versione dell'intero progetto e informare tutte le dipendenze, \u00e8 sufficiente modificare l'elemento <revision<\/i>> in un solo pom di root. pom.xml<\/i>Una sola revisione riceve in feedback, invece di una cento o due di questi file con modifiche identiche. Inoltre, non c'\u00e8 pi\u00f9 bisogno di utilizzare versions-maven-plugin<\/i>.
\n
Fonte: habr.com<\/a><\/p>","protected":false,"gt_translate_keys":[{"key":"rendered","format":"html"}]},"excerpt":{"rendered":"

\u041e \u043d\u0430\u0441 \u0412 1\u0421 \u043c\u044b \u0440\u0430\u0437\u0440\u0430\u0431\u0430\u0442\u044b\u0432\u0430\u0435\u043c \u043d\u0435 \u0442\u043e\u043b\u044c\u043a\u043e \u043f\u043b\u0430\u0442\u0444\u043e\u0440\u043c\u0443 1\u0421: \u041f\u0440\u0435\u0434\u043f\u0440\u0438\u044f\u0442\u0438\u0435 \u043d\u0430 \u0421++ \u0438 JavaScript, \u043d\u043e \u0438 \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u044f \u043d\u0430 Java \u2013 \u0432 \u0447\u0430\u0441\u0442\u043d\u043e\u0441\u0442\u0438 \u043d\u043e\u0432\u0443\u044e \u0441\u0440\u0435\u0434\u0443 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0438 Enterprise Development Tools \u043d\u0430 \u0431\u0430\u0437\u0435 Eclipse \u0438 \u0441\u0435\u0440\u0432\u0435\u0440 \u0433\u043b\u0443\u0431\u043e\u043a\u043e \u0438\u043d\u0442\u0435\u0433\u0440\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u043e\u0433\u043e \u0441 \u043f\u043b\u0430\u0442\u0444\u043e\u0440\u043c\u043e\u0439 \u043c\u0435\u0441\u0441\u0435\u043d\u0434\u0436\u0435\u0440\u0430 \u2013 \u0421\u0438\u0441\u0442\u0435\u043c\u044b \u0412\u0437\u0430\u0438\u043c\u043e\u0434\u0435\u0439\u0441\u0442\u0432\u0438\u044f. \u0412\u0441\u0442\u0443\u043f\u043b\u0435\u043d\u0438\u0435 \u0412 \u043a\u0430\u0447\u0435\u0441\u0442\u0432\u0435 \u0441\u0438\u0441\u0442\u0435\u043c\u044b \u0441\u0431\u043e\u0440\u043a\u0438 Java-\u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0439 \u0447\u0430\u0449\u0435 \u0432\u0441\u0435\u0433\u043e \u043c\u044b \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u043c maven, \u0438 \u0432 […]<\/p>\n","protected":false,"gt_translate_keys":[{"key":"rendered","format":"html"}]},"author":1,"featured_media":24280,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[688],"tags":[],"class_list":["post-32476","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-administrirovanie"],"aioseo_notices":[],"aioseo_head":"\n\t\t\n\t\n\t\n\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\n","aioseo_head_json":{"title":"\ud83e\udd47Esperienza nell'utilizzo di flatten-maven-plugin per semplificare la versione nei progetti maven | ProHoster","description":"Chi siamo In 1C sviluppiamo non solo la piattaforma 1C: Impresa su","canonical_url":"https:\/\/prohoster.info\/it\/blog\/administrirovanie\/opyt-ispolzovaniya-flatten-maven-plugin-dlya-uproshheniya-versionirovaniya-v-maven-proektah","robots":"max-image-preview:large","keywords":"","webmasterTools":{"miscellaneous":""},"schema":null,"og:locale":"it_IT","og:site_name":"ProHoster | \u041a\u0443\u043f\u0438\u0442\u044c \u043d\u0430\u0434\u0435\u0436\u043d\u044b\u0439 \u0445\u043e\u0441\u0442\u0438\u043d\u0433 \u0434\u043b\u044f \u0441\u0430\u0439\u0442\u043e\u0432 \u0441 \u0437\u0430\u0449\u0438\u0442\u043e\u0439 \u043e\u0442 DDoS, VPS VDS \u0441\u0435\u0440\u0432\u0435\u0440\u044b","og:type":"article","og:title":"\ud83e\udd47\u041e\u043f\u044b\u0442 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u044f flatten-maven-plugin \u0434\u043b\u044f \u0443\u043f\u0440\u043e\u0449\u0435\u043d\u0438\u044f \u0432\u0435\u0440\u0441\u0438\u043e\u043d\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f \u0432 maven-\u043f\u0440\u043e\u0435\u043a\u0442\u0430\u0445 | ProHoster","og:description":"\u041e \u043d\u0430\u0441 \u0412 1\u0421 \u043c\u044b \u0440\u0430\u0437\u0440\u0430\u0431\u0430\u0442\u044b\u0432\u0430\u0435\u043c \u043d\u0435 \u0442\u043e\u043b\u044c\u043a\u043e \u043f\u043b\u0430\u0442\u0444\u043e\u0440\u043c\u0443 1\u0421: \u041f\u0440\u0435\u0434\u043f\u0440\u0438\u044f\u0442\u0438\u0435 \u043d\u0430","og:url":"https:\/\/prohoster.info\/it\/blog\/administrirovanie\/opyt-ispolzovaniya-flatten-maven-plugin-dlya-uproshheniya-versionirovaniya-v-maven-proektah","og:image":"https:\/\/prohoster.info\/wp-content\/uploads\/2021\/11\/logo-350.jpg","og:image:secure_url":"https:\/\/prohoster.info\/wp-content\/uploads\/2021\/11\/logo-350.jpg","og:image:width":350,"og:image:height":350,"article:published_time":"2019-10-31T18:47:17+00:00","article:modified_time":"2019-10-31T18:47:17+00:00","article:publisher":"https:\/\/www.facebook.com\/prohoster","article:author":"https:\/\/www.facebook.com\/prohoster"},"aioseo_meta_data":{"post_id":"32476","title":null,"description":null,"keywords":null,"keyphrases":null,"primary_term":null,"canonical_url":null,"og_title":null,"og_description":null,"og_object_type":"default","og_image_type":"default","og_image_url":null,"og_image_width":null,"og_image_height":null,"og_image_custom_url":null,"og_image_custom_fields":null,"og_video":null,"og_custom_url":null,"og_article_section":null,"og_article_tags":null,"twitter_use_og":false,"twitter_card":"default","twitter_image_type":"default","twitter_image_url":null,"twitter_image_custom_url":null,"twitter_image_custom_fields":null,"twitter_title":null,"twitter_description":null,"schema":{"blockGraphs":[],"customGraphs":[],"default":{"data":{"Article":[],"Course":[],"Dataset":[],"FAQPage":[],"Movie":[],"Person":[],"Product":[],"ProductReview":[],"Car":[],"Recipe":[],"Service":[],"SoftwareApplication":[],"WebPage":[]},"graphName":"","isEnabled":true},"graphs":[]},"schema_type":null,"schema_type_options":null,"pillar_content":false,"robots_default":true,"robots_noindex":false,"robots_noarchive":false,"robots_nosnippet":false,"robots_nofollow":false,"robots_noimageindex":false,"robots_noodp":false,"robots_notranslate":false,"robots_max_snippet":null,"robots_max_videopreview":null,"robots_max_imagepreview":"large","priority":null,"frequency":null,"local_seo":null,"seo_analyzer_scan_date":"2026-01-21 11:03:20","breadcrumb_settings":null,"limit_modified_date":false,"reviewed_by":null,"ai":null,"created":"2021-03-01 02:58:23","updated":"2026-01-21 11:03:20","focus_keyword":null,"additional_keywords":null,"truseo_locale":null},"gt_translate_keys":[{"key":"link","format":"url"}],"_links":{"self":[{"href":"https:\/\/prohoster.info\/it\/wp-json\/wp\/v2\/posts\/32476","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/prohoster.info\/it\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/prohoster.info\/it\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/prohoster.info\/it\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/prohoster.info\/it\/wp-json\/wp\/v2\/comments?post=32476"}],"version-history":[{"count":0,"href":"https:\/\/prohoster.info\/it\/wp-json\/wp\/v2\/posts\/32476\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/prohoster.info\/it\/wp-json\/wp\/v2\/media\/24280"}],"wp:attachment":[{"href":"https:\/\/prohoster.info\/it\/wp-json\/wp\/v2\/media?parent=32476"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/prohoster.info\/it\/wp-json\/wp\/v2\/categories?post=32476"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/prohoster.info\/it\/wp-json\/wp\/v2\/tags?post=32476"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}