Skapa en Ant-byggfil för projekt

Vi kommer att skapa ett enkelt projekt med en enkel källfil samt en Ant-byggfil som gör klassfilen till en jarfil för att se hur projektbyggfunktionerna fungerar. Även om Java används i det här exemplet finns det projektbyggfunktioner för alla projekt vare sig det är Java eller inte.

  1. Skapa ett Java-projekt med namnet HW.
  2. Skapa en Java-källfil med namnet HelloWorld med hjälp av en huvudmetod.
  3. Lägg in satsen System.out.println() i huvudmetoden och välj att den ska skriva ut valfri hälsning.
  4. Spara ändringarna.
  5. Skapa en fil med namnet projectBuilder.xml, öppna den i Ant-redigeraren, skriv följande innehåll och spara ändringarna.
    <?xml version="1.0" encoding="UTF-8"?>
    <project name="HW.makejar" default="makejar" basedir=".">
      <target name ="makejar" description="Create a jar for the HW project">
        <jar jarfile="HelloWorld.jar" includes="*.class" basedir="bin"/>
      </target>
    </project>
    
  6. Högerklicka på HW-projektet i en av navigeringsvyerna och välj Egenskaper på kontextmenyn.
  7. Välj Byggfunktioner och klicka sedan på Ny.
  8. Välj Ant-bygge i dialogrutan Välj konfigurationstyp och klicka på OK.
  9. Dialogrutan Externa verktyg öppnas. Ange namnet Makejar. Klicka på Bläddra på arbetsyta för byggfilen på huvudflikend och ange platsen till projectBuilder.xml som skapades ovan. Klicka sedan på Bläddra på arbetsyta för baskatalog och ange den till HW-projektet.

    Huvudfliken i dialogrutan Externa verktyg

  10. På fliken Uppdatera ser vi till att filen HelloWorld.jar ska visas i Eclipse. Som standard sker ingen uppdatering när en projektbyggfunktion har slutförts så markera Uppdatera resurser vid slutförande och välj sedan Projektet som innehåller den valda resursen i listan över variabler. Eftersom uppdatering kan ta tid bör du uppdatera den minsta enheten som innehåller alla resurser som påverkas av byggfilen.

    Fliken Uppdatera i dialogrutan Externa verktyg

  11. På fliken Mål kan du ange när projektbyggfunktionerna ska köras och målen för dem. Som standard körs standardmålet efter en "rensning" och efter manuellt bygge. Du kan ange andra mål och utlösare. Det går att köra projektbyggfunktionerna under automatiska byggen men det rekommenderas inte av prestandaskäl. Mer information om byggtyper finns här.

    Fliken Mål i dialogrutan Externa verktyg

  12. Tillämpa ändringarna och klicka på OK.
  13. I projektegenskaperna visas nu en projektbyggfunktion med namnet Makejar som körs efter den vanliga Java-byggfunktionen. Klicka på OK så sparas projektbyggfunktionen och dialogrutan stängs.
    Anm. Du kan ändra ordningen så att Ant-byggfilen körs före Java-byggfunktionen men det är ingen mening i det här exemplet.

    Dialogrutan Projektegenskaper

Java-byggfunktionen kör den inerna Eclipse Java-kompilatorn som indexerar källan så att sökning, omfaktorisering och andra funktioner blir tillgängliga. Därför går det inte att ersätta den interna Eclipse Java-kompileraren genom att använda en projektbyggfunktion. Du kan avaktivera Java-byggfunktionen och du kan styra när den körs med hänsyn till de projektbyggfunktioner du definierar.

Närliggande uppgifter
Skapa Ant-byggfiler
Ant-mål för projektbyggfunktionen
Redigera Ant-byggfiler
Spara och återanvända Ant-alternativ
Köra Ant-byggfiler
Ant-byggfiler som projektbyggfunktioner
Köra projektbyggfunktioner
Externa verktyg
Andra projektbyggfunktioner än Ant
Fristående externa verktyg