Ulkoiset työkalut

Ulkoisten työkalujen avulla voit määrittää ohjelmien, komentotiedostojen, Ant-koontitiedostojen ja muiden vastaavien kohteiden kokoonpanon ja ajaa kyseisiä kohteita. Voit tallentaa ulkoisten työkalujen kokoonpanomääritykset ja ajaa työkalut myöhemmin.

Ulkoisten työkalujen tulosteet näkyvät konsolinäkymässä.

Voit lisätä ulkoisia työkaluja osana projektin koontiprosessia. Järjestelmä ajaa ulkoiset työkalut määritetyssä järjestyksessä aina, kun projekti kootaan.

Seuraavat muuttujat ovat käytettävissä ulkoisen työkalun määrityksen yhteydessä. Muuttujat laajennetaan automaattisesti aina, kun ulkoinen työkalu ajetaan.

${workspace_loc} - Eclipse-työtilahakemiston absoluuttinen polku järjestelmän kiintolevyllä.

${workspace_loc:<resurssin polku>} - Määritetyn resurssin absoluuttinen polku järjestelmän kiintolevyllä. <resurssin polku> on resurssin koko polku suhteessa työtilan juurihakemistoon. Esimerkiksi ${workspace_loc:/MyProject/MyFile.txt}. Huomaa, että tämän muuttujan laajennettu tila ei ole sama kuin ${workspace_loc}/MyProject/MyFile.txt, jos projektin MyProject-kohteen sisältöhakemisto on työtilahakemiston ulkopuolella.

${project_loc} - Valittuna olevan resurssin projektin absoluuttinen polku tai koottavan projektin absoluuttinen polku, jos ulkoinen työkalu ajetaan koonnin osana.

${project_loc:<resurssin polku>} - Määritetyn resurssin projektin absoluuttinen polku järjestelmän kiintolevyllä. <resurssin polku> on resurssin koko polku suhteessa työtilan juurihakemistoon. Esimerkiksi ${workspace_loc:/MyProject/MyFile.txt}. Huomaa, että tämän muuttujan laajennettu tila ei ole sama kuin ${workspace_loc}/MyProject, jos projektin MyProject-kohteen sisältöhakemisto on työtilahakemiston ulkopuolella.

${container_loc} - Valittuna olevan resurssin pääresurssin (joko kansion tai projektin) absoluuttinen polku järjestelmän kiintolevyllä.

${container_loc:<resurssin polku>} - Määritetyn resurssin pääresurssin (kansion tai projektin) absoluuttinen polku järjestelmän kiintolevyllä. <resurssin polku> on resurssin koko polku suhteessa työtilan juurihakemistoon. Esimerkiksi ${workspace_loc:/MyProject/MyFolder/MyFile.txt}. Huomaa, että tämän muuttujan laajennettu tila ei ole sama kuin ${workspace_loc}/MyProject/MyFolder, jos projektin MyProject-kohteen sisältöhakemisto on työtilahakemiston ulkopuolella.

${resource_loc} - Valittuna olevan resurssin absoluuttinen polku järjestelmän kiintolevyllä.

${resource_loc:<resurssin polku>} - Määritetyn resurssin absoluuttinen polku järjestelmän kiintolevyllä. <resurssin polku> on resurssin koko polku suhteessa työtilan juurihakemistoon. Esimerkiksi ${workspace_loc:/MyProject/MyFile.txt}. Huomaa, että tämän muuttujan laajennettu tila ei ole sama kuin ${workspace_loc}/MyProject/MyFile.txt, jos projektin MyProject-kohteen sisältöhakemisto on työtilahakemiston ulkopuolella.

${project_path} - Valittuna olevan resurssin projektin koko polku suhteessa työtilan juurihakemistoon tai koottavan projektin koko polku suhteessa työtilan juurihakemistoon, jos ulkoinen työkalu ajetaan koonnin osana.

${container_path} - Valittuna olevan resurssin pääobjektin (kansion tai projektin) koko polku suhteessa työtilan juurihakemistoon.

${resource_path} - Valittuna olevan resurssin koko polku suhteessa työtilan juurihakemistoon.

${project_name} - Valittuna olevan resurssin projektin nimi tai koottavan projektin nimi, jos ulkoinen työkalu ajetaan koonnin osana.

${container_name} - Valittuna olevan resurssin pääobjektin (kansion tai projektin) nimi.

${resource_name} - Valittuna olevan resurssin nimi.

${build_type} - Koonnin laji, kun ulkoinen työkalu ajetaan koonnin osana. Arvo voi olla "täysi", "täydentävä" tai "automaattinen". Jos ulkoinen työkalu ajetaan koonnin ulkopuolella, arvo on "ei mitään".

Oletetaan, että Eclipse-työtilan hakemisto on c:\eclipse\workspace ja käsiteltävänä on kaksi projektia, MyProject1 ja MyProject2. Ensimmäinen projekti, MyProject1, sijaitsee työtilan hakemistossa, ja toinen projekti, MyProject2, sijaitsee työtilan hakemiston ulkopuolella kohteessa c:\projects\MyProject2. Seuraavassa kuvataan, kuinka alla esitetyt muuttujaesimerkit laajentuvat ulkoisen työkalun ajon yhteydessä, jos valittuna on resurssi /MyProject2/MyFolder/MyFile.txt.


 
 
Muuttujaesimerkit
Laajennetut tulokset
${workspace_loc} c:\eclipse\workspace
${workspace_loc:/MyProject1/MyFile.txt} c:\eclipse\workspace\MyProject\MyFile.txt
${workspace_loc:/MyProject2/MyFile.txt} c:\projects\MyProject2\MyFile.txt
${project_loc} c:\projects\MyProject2
${project_loc:/MyProject1/MyFile.txt} c:\eclipse\workspace\MyProject
${container_loc} c:\projects\MyProject2\MyFolder
${resource_loc} c:\projects\MyProject2\MyFile.txt
${project_path} /MyProject2
${container_path} /MyProject2/MyFolder
${resource_path} /MyProject2/MyFolder/MyFile.txt
${project_name} MyProject2
${container_name} MyFolder
${resource_name} MyFile.txt
${build_type} ei mitään


Aiheeseen liittyviä käsitteitä
Ant-tuki
Koonnit

Aiheeseen liittyviä ohjeita
Ulkoisten työkalujen oletusasetukset
Ulkoiset työkalut ja Ant-kuvakkeet

Aiheeseen liittyviä tehtäviä
Ulkoisten työkalujen ajo
Ant-koontitiedostojen ajo