Projektek menedzselése Apache Maven segítségével

Átírás

1

2 1 TARTALOMJEGYZÉK 1 Tartalmjegyzék Bevezetés Leírás Alapfgalmak Maven beállítása Repsitry Maven prjektek felépítése és generálása Új Maven prjekt generálása Pm.xml fntsabb részei Néhány maven plugin clean cmpiler deply install verifier ear jar site checkstyle release carg Néhány példa Maven-ben Eclipse prjekt készítés mavennel Webes prjekt készítése és telepítése Tmcat-be Unit tesztek futtatása és riprtzása Flex prjekt frdítása maven-ant pluginnal Összegzés Irdalmjegyzék BEVEZETÉS A Maven egy az The Apache Sftware Fundatin által flyamatsan fejlesztett eszközök közül, amely a szftverfejlesztési életciklus néhány pntján nyújt segítséget. Egy frdítási feladatkat ellátó eszköznek indult, de az igények növekedésével a funkcinalitása skat bővült, de fő feladata talán, a fejlesztők által elkészített frráskódból, megfelelő knfiguráció alapján a prgram frdítása, tesztelése. A tanulmány a maven alapjait illetve néhány plugin-t hivattt bemutatni. 3 LEÍRÁS 3.1 Alapfgalmak pm.xml: Prject Object Mdel. A prjekt knfigurációját itt lehet megadni, a beállításkat xml struktúrában kell megadni. 34_Maven intr 2/15

3 prject: Alapegység. Az elemei a mdulk. A prjekt könyvtárban lévő pm.xml-ben mndhatjuk meg, mik a mdulk és definiálhatunk ezek között egy frdítási srrendet. archtype: Maven prjekt template. Segítségével legenerálhatunk maven prjektet, illetve saját magunk is készíthetünk templatet prjekt definiálására. artifact: Egy már meglévő prjekt vagy mdul lefrdíttt váltzata, amelynek van egy aznsítója artifactid és egy grupid-ja, illetve verziószáma. A buildelési flyamat végén is artifact áll elő, repsitrykból érhetők el. Pl.: Az apache struts2-cre artifactját, M2_REPO/rg/apache/struts/struts2-cre alatt lehet elérni, ahl a struts2-cre az arctifactid. Ezen belül lesznek a verziószámztt mappák, és azn belül a knkrét verziók. <artifactid>struts2-cre</artifactid> mdule: Nagybb prjektek esetén,amikr több részre lehet taglni funkció vagy valamilyen szempnt alapján a prjektet akkr a részeket mdulknak nevezi a maven. Ha ezeknek a részeknek a frdítása vagy telepítése összefügg, akkr mdulként fel lehet venni őket egy pm.xml-be és közöttük srrendet lehet megállapítani. A mdulk pm.xml-jei egymás után lesznek feldlgzva. <mdules> <mdule>business</mdule> <mdule>web</mdule> <mdules> dependency: Függőség, amit a pm.xml-ben be lehet állítani, hgy egy prjektnek vagy mdulnak mire van szüksége a frdítás, futtatás vagy egyéb scpe estén. A struts2-cre dependency a pm.xml-ben: <dependency> <grupid>rg.apache.struts</grupid> <artifactid>struts2-cre</artifactid> <versin>2.2.1</versin> </dependency> scpe: A dependencyhez kapcslódó fgalm. Itt lehet megadni, hgy a függőségként felvett artifactra mikr lesz szükség. cmpile: Ez az alapértelmezett, ilyenkr nem kell megadni semmilyen scpe-t a pm.xml-ben. A függő prjektek is látni fgják. Egy webes prjektnél a lib-ek közé autmatikusan bemáslódik, és belecsmaglódik a war-ba. A buildelési életciklus összes pntján szerepel a classpathn a függőség. prvided: Azk a függőségek, amik kellenek futási és frdítási időben is, de a futtató környezetben rendelkezésre állnak, azkat nem kell például egy webes prjekt libjei közé berakni. Ilyen például a ServletApi, ami egy webes knténerben vagy alkalmazás szerverben szerepel, de frdításkr is szükség van rá. Csak a frdítási és a tesztelési classpathkn szerepel a függőség. 34_Maven intr 3/15

4 runtime: Az a függőség, ami nem szükséges frdítás srán, de futás közben igen. Ilyenkr a függőség csak a test classpathn szerepel. test: Az alkalmazás futásáhz nem szükséges a függőség, de a tesztesetek futtatásáhz igen. system: Hasnló a prvidedhz, de ezt nem kell a repsitryban keresni, a rendszerben mindig megtalálható. PL.: <dependency> <grupid>cm.sun</grupid> <artifactid>tls</artifactid> <versin>1.4.2</versin> <scpe>system</scpe> <systempath>${java.hme}/../lib/tls.jar</systempath> </dependency> imprt: maven től lehet megadni. Csak apm típusú függőségekre lehet megadni a <dependencymanagement>részben. Egy másik prjektben definiált függőségeket lehet vele felhasználni. repsitry: Artifactk gyűjteménye. Létezik saját gépen lkális repsitry illetve meg lehet adni különbő publikus repsitrykat is. plugin: A maven pluginkból áll, amiket a pm.xml-ből tudunk knfigurálni. A maven-ben sk alapból definiált plugin létezik, de sajátkat is lehet írni. Pl.:maven-cmpiler-plugin amiben meg van adva milyen verzió a frrás és milyen legyen a lefrdíttt. <plugin> </plugin> <artifactid>maven-cmpiler-plugin</artifactid> <cnfiguratin> <surce>1.5</surce> <target>1.5</target> </cnfiguratin> gal: Egy plugin által elvégzendő funkciót adunk meg a gal-lal. Pl.:maven-cmpilerplugincmpilegal-ja: <gal>cmpile</gal> phase: A buildelési flyamat részekből áll pl: validálás, frdítás, tesztelés. így meg lehetadni, hgy a definált feladat mikr fussn le Maven beállítása Maven használata és beállítása előtt fel kell rakni egy JDK-t, és be kell állítani a JAVA_HOME környezeti váltzót. Ezután be kell állítani az M2_HOME-t ami maga a maven telepítési helye a maven mappával együtt, majd fel kell venni a PATH környezeti váltzóba a M2_HOME/bin könyvtárat. Ha frdításk srán valamilyen glbális beállítást kellenealkalmazni, akkr ezt a 34_Maven intr 4/15

5 MAVEN_OPTS környezeti váltzóba kell beállítani. A repsitry beállításkat 3 helyen lehet váltztatni: M2_HOME/cnf/settings.xml, a USER_HOME/.m2/settings.xml, illetve be lehet állítani külső repsitrykat a pm.xml-ben is. Ezekben lehet megadni a repsitry helyét, és ha a lkális repsitryban nem található a szükséges artifact, akkr azt hl keresse. 3.3 Repsitry A repsitry, mint már írtam,artifactk gyűjteménye. Lkálisan a gépen megtalálható a USER_HOME/.m2/repsitry alatt(alapbeállításként). A settings.xml-ben definiáltak alapján, ha lkálisan nem létezik egy artifact, akkr az le is fg ide töltődni. A frdítást lehet ffline módban futtatni, ilyenkr csak a lkális repsitryban tárlt artfactk lesznek használva. Ezt a kapcslóval lehet beállítani. Repsitry szerverek működtetésére és menedzselésére is léteznek eszközök pl.: Archiva, Nexus, Artifactry 3.4 Maven prjektek felépítése és generálása Egy Java-s prjekt számára nemlétezett előre definiált prjekt felépítés, valamilyen szabvány ami megmndaná egy prjekt hgy is nézzen ki, így a különböző prjektekhez különböző scripteket kellett létrehzni, hgy a frdítás sikeres lehessen. A Maven felkínál egy lehetőséget, mappa struktúrát, amely mentén autmatikusan tud működni, persze van lehetőség eltérni tőle. src/main/java Applicatin/Library surces src/main/resurces Applicatin/Library resurces src/main/filters Resurce filter files src/main/assembly Assembly descriptrs src/main/cnfig Cnfiguratin files src/main/webapp Web applicatin surces src/test/java Test surces src/test/resurces Test resurces src/test/filters Test resurce filter files src/site Site LICENSE.txt Prject's license NOTICE.txt Ntices and attributins required by libraries that the prject depends n README.txt Prject's readme target The target directry is used t huse all utput f the build Új Maven prjekt generálása A maven lehetőséget kínál az általa definiált prjektstruktúra generálására, léteznek előre definiált archetypk pl.: Archetype ArtifactIds Descriptin 34_Maven intr 5/15

6 An archetype which cntains a sample archetype. An archetype which cntains a simplifed sample J2EE applicatin. maven-archetype-mj An archetype which cntains a sample a sample Maven plugin. maven-archetype-site maven-archetypearchetype maven-archetypej2ee-simple maven-archetypeplugin maven-archetypeplugin-site maven-archetypeprtlet maven-archetypequickstart maven-archetypesimple maven-archetype-sitesimple maven-archetypewebapp An archetype which cntains a sample Maven plugin. An archetype which cntains a sample Maven plugin site. An archetype which cntains a sample JSR-268 Prtlet. An archetype which cntains a sample Maven prject. An archetype which cntains a simple Maven prject. An archetype which cntains a sample Maven site which demnstrates sme f the supprted dcument types like APT, XDc, and FML and demnstrates hw t i18n yur site. An archetype which cntains a sample Maven site. An archetype which cntains a sample Maven Webapp prject. Egyszerű prjektgeneráláshz parancssrban be kell gépelni: mvnarchetype:generate. Ezután a kiírt listából ki kell választani a generálandó prjekttípust, utána a típusnak megfelelő beállításkat és elkészül a prjekt. Egy maven-archetype-webapp esetén létrejön egy pm.xml, src/main/ mappaszerkezet benne a resurces és webapp mappával, amiben már benne van a WEB-INF egy web.xml-el. 3.5 Pm.xml fntsabb részei grupid: <grupid>..</grupid>. Meg kell adni egy egyedi aznsítót, amely vnatkzhat a készítőre vagy a prjektre. Az egyediség azért fnts, mert rengeteg artifact gyártó létezik és ha már egy meglévő csprt neve kerül megadásra, akkr abból kavardásk lehetnek, ha fel lesz töltve egy külső repsitryba. artifactid : <artifactid>..</artifactid>. Maga a prjekt aznsítója. A grupidval egyedi prjektet kell, hgy aznsítsanak. versin: <versin>..</versin>. A prjekt verziószáma. Ha éppen fejlesztés alatt lévő verzióról van szó, akkr szkás SNAPSHOT-ként megjelölni. Ha repsitryba lesz deplylás, akkr a SNAPSHOT kicserélődik UTC frmátumbeli dátumra. A pm.xml-ben lehet tvábbra is SNAPSHOT-ként hivatkzni és ilyenkr a legújabb dátummal rendelkezőt fgja használni az adtt verzióból. build: <build>..</build>.a prjekten végrehajtandó feladatkat két helyen lehet megadni a pmban. Vagy <prject></prject> ben megadtt build tagekben, vagy a prject tagekben definiálhatunk prfile-kat és azkban. defaultgal:<defaultgal>..</defaultgal>. A prjekt könyvtárában kiadtt mvn parancs után az itt definiált életciklusbeli pnt elérése a cél. 34_Maven intr 6/15

7 directry: <directry>..</directry>. Azt állítja be, hgy abuildelés flyamán előállíttt eredmények hva kerüljenek. A maven alapértelmezetten a ${basedir}/target et használja. resurces: <resurces>..</resurces>. Itt kell megadni azkat a knfigurációs fájlkat, leírókat, amelyek nem a mavennek alapértelmezettként megadtt resurces mappában vannak. prfile:<prfile>..</prfile>előfrdul hgy a prjektet különböző rendszerekben vagy különböző rendszereken kell buildelni. Ilyenkr érdemes prfile-kat létrehzni, amelyben meg lehet adni az adtt rendszer sajátsságait, és ha a prfile nevével paraméterezzük a futtatást, akkr csak a megfelelő prfileban leírtak fgnak történni (mvn P prfile_name). parent: <parent>..</parent>. A prjektek, mdulk közötti öröklődés, aggregáció eszköze. A következő elemek lesznek összevnva: Megadása: függőségek közreműködők és fejlesztők leírása plugink a beállításaikkal resurces <parent> <grupid>..</grupid> <artifactid>..</artifactid> <versin>..</versin> </parent> Abban az esetben, ha a parent nem közvetlenül 1 szinttel feljebb van a mappaszerkezetben, akkr meg kell adni a helyét: <relativepath>.../parent/pm.xml</relativepath> dependencymanagement: <dependencymanagement>..</dependencymanagement>. A prjektek közötti függőségek esetén, ha több prjekt is ugyanazt a függőséget használja, érdemes a dependencymanagment részben felvenni a függőségeket a megfelelő verziószámkkal és beállításkkal. Azk a prjektek amik öröklik ezeket a tulajdnságkat, azkban már elég lesz csak a plugin artifactid-ját és grupid-ját megadni(meg a típust ha nem jar típusról van szó). pluginmanagement: <pluginmanagement>..</pluginmanagement>. Hasnlóan a dependencymanagement-hez ezt is a prjektek közötti függőségek kezelésének megkönnyítésére lehet használni. Ebben a részben pluginkat és azk knfigurációját kell 34_Maven intr 7/15

8 megadni, majd a gyerek pm.xml-ekben ezekre autmatikusan történik a hivatkzás, a plugin grupid és artifactid-jával. A knfigurációt felül lehet definiálni a gyerek pm.xmlekben, egyszerűen csak meg kell adni az új infrmációkat és azk máris felülírták az eddigi beállításkat az adtt gyerek pm.xml-ben. 3.6 Néhány maven plugin clean Eltávlítja a buildelés srán keletkező fájlkat. Egy gal van, a clean. A cleannek saját életciklusa van: pre-clean->clean->pst-clean. Ezt a plugint nem kell megadni a pm.xml-ben ahhz, hgy használni lehessen, csak akkr, ha szeretnénk beépíteni a buildelési életciklusba. Használata: mvn clean vagy mvn clean:clean <artifactid>maven-clean-plugin</artifactid> cmpiler A frrásállmányk frdítására lehet használni. Alapértelmezetten a java frdítóját használja(javac). Két gal van: cmpile, ami a prgram frráskódt frdítja a cmpile fázisban, a másik a testcmpile, ami a teszt kódkat frdítja le testcmpile fázisban. A java-s frdítót is innen lehet paraméterezni. <artifactid>maven-cmpiler-plugin</artifactid> deply Ha nem elég csak a saját repsitrynkba berakni a prjekt buildelése srán elkészült artifactkat, akkr a deply pluginnal egy külső,távli repsitryba fel lehet rakni azkat. Ha a buildelési életciklusba kell ezt a funkciót beépíteni, akkr a deplyplugindeplygalját kell használni, ha nem ebben az életciklusban, akkr a deply-file galt, ahl meg kell adni, hgy mi az amit fel kell tölteni a külső repsitrykba. <artifactid>maven-deply-plugin</artifactid> install Az install plugin az install fázisban felrakja a lcal repsitryba az arctifactt. A pmban knfigurációt nem kell külön megadni, egyszerűen mvninstall al működni fg. Lehetőség van nem a build srán előálló artifact felrakására is, ilyenkr ainstall-filegalt kell használni, ahl meglehet mndani mi kerüljön be a lcal repsitryba. 34_Maven intr 8/15

9 <artifactid>maven-install-plugin</artifactid> verifier Integrációs teszteléshez nyújt segítséget. Egy gal van, a verify. Használatáhz egy xml-t kell definiálni, amiben a szükséges ellenőrzések vannak leírva. A plugin a buildelési életciklus verify fázisában fut le. <artifactid>maven-verifier-plugin</artifactid> ear Az ear plugin segítségével ear fájlkat lehet generálni, ki tudja generálni a telepítési leírást is. <artifactid>maven-ear-plugin</artifactid> jar Elkészíti a megadtt frrásfájlkból és resurcekból a jar fájlt, ha jar gallal van definiálva, ha test-jarral, akkr a tesztfrráskból készül a jar. <artifactid>maven-jar-plugin</artifactid> site A prjektről készít riprtt. Képes az elkészült riprtt webes knténerbe telepítve futtatni, illetve a megadtt helyre máslva publikálni. A site pluginnek saját életciklusa van: pre-site site pst-site site-deply executes prcesses needed prir t the actual prject site generatin generates the prject's site dcumentatin executes prcesses needed t finalize the site generatin, and t prepare fr site deplyment deplys the generated site dcumentatin t the specified web server <artifactid>maven-site-plugin</artifactid> checkstyle A frráskódk készítésekr nem elegendő az, hgy az elkészült kód frduljn, a megfelelő knvenciókat be kell tartani. Ezek ellenőrzésére létrehztt checkstyle knfigurációk betartását lehet ellenőrizni és riprtzni a prjekten. <plugin> <artifactid>maven-checkstyle-plugin</artifactid> <versin>2.6</versin> </plugin> 34_Maven intr 9/15

10 A pluginban az alábbi előredefiniált knfigurációk vannak: sun_checks.xml, turbine_checks.xml, avaln_checks.xml, maven_checks.xml. Saját knfiguráció megása: <cnfiguratin> <cnfiglcatin>checkstyle.xml</cnfiglcatin> </cnfiguratin> release A plugin a verzióváltástsegíti egy prjekten. Verziókezelő használata is be van építve, így autmatikusan tud tag-et készíteni egy adtt release kiadáskr, ezen felül elvégzi a pm.xml-ben a verzióváltáskat, figyel pl.: van e Snapsht verzióra hivatkzás. <artifactid>maven-release-plugin</artifactid> carg Webes knténerek és alkalmazásszerverek manipulálására alkalmas eszköz, mely nem csak mavennel használható, hanem ant illetve javaból is közvetlenül. Célja hgy a buildelés srán már be is lehessen deplylni az alkalmazást, a szervert le lehessen állítani, elindítani. Támgatja többek között a Weblgic, Tmcat, Jbss több verzióját. <grupid>rg.cdehaus.carg</grupid> <artifactid>carg-maven2-plugin</artifactid> 3.7 Néhány példa Maven-ben Eclipse prjekt készítés mavennel A prjektek fejlesztése közben felhasznált függőségek kezelését két helyen kell flyamatsan szerkeszteni. Egyik a mavenpm.xml, illetve a kódíráshz, alábbi példában Eclipse, használt fejlesztői eszközben. Ez körülményes, illetve kihagyásk, verziószám eltéréseket kzhat. Ennek kezelésében nyújt segítséget a maven eclipse-es pluginje. Fnts hgy a maven egy előre meghatárztt váltzóhz fgja megadni a függőségeket. Ez a váltzó M2_REPO ami a lcal repsitryra kell hgy mutassn. Ezért első lépés ezt az eclipsewrkspace-ben beállítani. Ezután a wrkspace-ben ki kell adni a következő parancst: mvn archetype:create -DgrupId=hu.neurn -DartifactId=maven-eclipse-test Ezzel létrejött egy egyszerű javas prjekta buildeléshez szükséges pm.xml-el együtt. Ahhz hgy ezt be is lehessen imprtálni eclipse-be, szükség lesz a.prject és a.classpath fájlkra. Ezek legeneráláshz a 34_Maven intr 10/15

11 mvn eclipse:eclipse parancst kell lefuttatni a pm.xml könyvtárában. A pm.xmlben megfigyelhető, hgy a junit, vagyis a teszteléshez szükséges framewrk jar fájlja már dependencyként szerepel, és a legenerált classpath fájlban is benne van: <classpathentry kind="var" path="m2_repo/junit/junit/3.8.1/junit jar"/> Látszik hgy az eclipsben használt váltzón keresztül van a hivatkzás a függőségre. Ez azért jó,mert ha csapat dlgzik a prjekten és valamilyen verziókezelő rendszert használnak, vagy csak egymás között megsztják a frrást és a prjektet, akkr ha valaki új függőséget vezet be a prjektbe, akkr ennek beállításával a többieknek nem kell fglalkzni csak használni a módsíttt classpatht, mert a váltzó elrejti a tényleges gépfüggő elérési utat. Ha egy új függőséget kell bevezetni a prjektbe, akkr nem kell mást tenni, mint kiegészíteni a pm.xml-t és lefuttatni újra a mvn eclipse:eclipse parancst. Pl.: be kellene rakni egy lg4j függőséget. Ha nem tudjuk, milyen grupid val és milyen artifactid-val kell rá hivatkzni, akkr érdemes egy maven repsitryban keresni. Lg4j-re keresve előjönnek a lehetőségek. Ez egy külső repsitry, itt megtalálhatjuk a szükséges artifactt. Kiválasztva az Apache Lg4j-t a megfelelő verziószámmal, tt van a pm.xml-beli hivatkzási frma. <dependency> <grupid>lg4j</grupid> <artifactid>lg4j</artifactid> <versin>1.2.16</versin> </dependency> Ezután lefuttatva az eclipse plugint megváltztt a classpath fájl, és mst már szerepel benne a lg4j-re a hivatkzás. A prjekt könyvtárában egy mvn install parancsra elkészül a jar fájlt a target könyvtárban Webes prjekt készítése és telepítése Tmcat-be Webes prjekt készítéséhez vagy a már Új prjekt részben leírtak mentén kell eljárni, vagy egyszerűen csak a következő paranccsal is lehet dlgzni: mvn archetype:create -DgrupId=hu.neurn.testapp -DartifactId=new-webapp - DarchetypeArtifactId=maven-archetype-webapp Létrejön egy egyszerű webes prjekt. A prjekt könyvtárába belépve, az mvn install parancsra, a maven által definiált target könytárba létre is jön a war állmány. Érdemes megfigyelni, hgy míg az előző prjekt pm.xml-jében a <packaging>jar</packaging> vlt, itt már <packaging>war</packaging>. Ebből fgja tudni a maven, hgy mit kell úgymnd előállítani, ez milyen prjekt. El kell készíteni a deplyláshz szükséges beállításkat. pm.xml a beállítás után: <prject xmlns=" xmlns:xsi=" xsi:schemalcatin=" 34_Maven intr 11/15

12 <mdelversin>4.0.0</mdelversin> <grupid>hu.neurn.testapp</grupid> <artifactid>new-webapp</artifactid> <packaging>war</packaging> <versin>1.0-snapshot</versin> <name>new-webapp Maven Webapp</name> <url> <dependencies> <dependency> <grupid>junit</grupid> <artifactid>junit</artifactid> <versin>3.8.1</versin> <scpe>test</scpe> </dependency> </dependencies> <build> <finalname>new-webapp</finalname> <plugins> <plugin> <grupid>rg.cdehaus.mj</grupid> <artifactid>tmcat-maven-plugin</artifactid> <cnfiguratin> <url> <server>mytmcat</server> <path>/new-webapp</path> </cnfiguratin> </plugin> </plugins> </build> </prject> Fnts hgy a repsitryban be kell állítani a tmcathez az authentikációt: <server> <id>mytmcat</id> <username>test</username> <passwrd>test</passwrd> </server> Ezek után, ha a war elkészült, mvn install utasításra, akkr ki lehet adni a mvn tmcat:deply parancst, és máris be van deplylva. Tipp: ha nem működik a plugin és 401-es hibát látunk a knzlban, akkr érdemes a címet ellenőrizni. (lcalhst helyett lehet,hgy gépnév kell) Unit tesztek futtatása és riprtzása A maven előre definiálja a tesztsztályk helyét a prjektben:src/test. Ha ide lettek létrehzva a teszt sztályk, akkr nem kell mást tenni a futtatásukhz, mint a megfelelő buildelés fázist kiválasztani és a tesztelés autmatikusan megtörténik(mvn test). Ilyenkr T E S T S Running hu.neurn.sampletest Tests run: 3, Failures: 1, Errrs: 0, Skipped: 0, Time elapsed: 0.03 sec <<< FAILURE! 34_Maven intr 12/15

13 Results : Failed tests: testgetfailstring(hu.neurn.sampletest) Tests run: 3, Failures: 1, Errrs: 0, Skipped: 0 egy hasnló rövid riprtt készít a maven. Ha valamelyik unit teszt sikertelenül futtt le, akkr a buildelés sikertelen lesz. Lehet készíteni a tesztelésről riprtt a Maven SureFire plugin segítségével. A plugin már a sima teszt lefutásakr dlgztt és létrehztt a target könyvtárban surefire-reprts mappát, ami a riprtkészítéshez szükséges adatkat tartalmazza. A riprt html ldalba való generálásáhz mvn surefire-reprt:reprt parancst kell kiadni. Ilyenkr a target könyvtárba generálódik egy site mappa, amiben megtalálható surefire-reprt.html. A html áttekinthetősége érdekében érdemes lefuttatni a site plugint (mvn site), amely a prjektről gyűjtött infrmációk alapján felépít néhány html ldalt. A surefire-reprt.html-ben jól látszik melyik unit teszt vlt sikertelen, illetve a keletkező hiba is lvasható Flex prjekt frdítása maven-ant pluginnal A jelenlegi legújabb Flex-ben (Flex 4) fejlesztett alkalmazásk frdítását maven plugin segítségével nem lehet megldani. Erre a feladatra SNAPSHOT illetve alpha váltzatk léteznek a pluginkból. A Flex SDK tartalmaz egy ant-t aminek segítségével visznt már le lehet frdítani a prjektet. Ahhz, hgy a mavenbőlants taszkkat tudjunk futtatni, egy ant pluginra lesz szükség. Az antpluginnak egy galja van, a run. Ezzel indít antstaskkat. A plugin a pm.xmlben: <plugin> <artifactid>maven-antrun-plugin</artifactid> <versin>1.6</versin> <executins> <executin> <phase>cmpile</phase> <cnfiguratin> <target> <taskdef resurce="flextasks.tasks" classpath="${flex_task}/flextasks.jar"/> <mxmlc file="${flash_src}/main/main.mxml" utput="target/${artifactid}-${versin}/flash/utput.swf"> <lad-cnfig filename="${flex_home}/framewrks/flex-cnfig.xml"/> <surce-path path-element="${flex_home}/framewrks"/> <!--surce-pathpath-element="${flash_src}"/--> <cmpiler.debug>false</cmpiler.debug> </mxmlc> </target> </cnfiguratin> <gals> <gal>run</gal> 34_Maven intr 13/15

14 </gals> </executin> </executins> </plugin> A taskdefben be kell állítani az antstaskt, ami majd a frdítást végzi, ezt a Flex SDK adja. Meg kell adni a mxmlc file ban hl van a prjekt main.mxmlje, az utputban pedig azt, hgy hva készüljön az swf. Ha a frdítás ezek után sikertelen, akkr a surce-path pathelement="${flash_src} t is be kell állítani, hgy a frráskban lévő hivatkzásk megfelelőek legyenek. Ha ez egy webes prjekt része, akkr cmpile fázisban, ha elkészül a swf és az utput úgy van megadva, hgy a target könyvtár megfelelő könyvtárába máslódjn, akkr a kész artifactban már benne lesz az swf. A használatáhz szükséges váltzókat a pm.xml lehet definiálni, az alábbi módn: <prperties> <prject.build.surceencding>utf-8</prject.build.surceencding> <FLEX_HOME>d:/tmp/flex_sdk</FLEX_HOME> <FLEX_TASK>d:/tmp/flex_sdk/ant/lib</FLEX_TASK> <FLASH_SRC>src/main/flash-surce</FLASH_SRC> </prperties> 34_Maven intr 14/15

15 4 ÖSSZEGZÉS A maven és a hzzá fejlesztett rengeteg pluginmegkönnyítheti a munkát, autmatizálhat egyes flyamatkat.a knfiguráció átlátható leírását az xml frmátumban való megadás segíti, módsítása egyszerű. Nagybb prjektek esetén a megfelelő pm.xml struktúra kialakítása nem egyszerű, de templatek létrehzásával ez is egyszerűsíthető. A flyamatkat elég csak egyszer megadni, utána autmatikusan végre tudnak hajtódni, így ki lehet zárni az emberi hibát pl.: kihagytt lépés. Az esettanulmány elkészítéséhez munkájával hzzájárult Tóth Gábr a Neurn Szftver Kft. alkalmazttja. 5 IRODALOMJEGYZÉK _Maven intr 15/15