Crear un archivo de construcción de Ant para un constructor de proyectos

Para ver cómo funcionan los constructores de proyectos, crearemos un proyecto sencillo con un único archivo fuente y un archivo de construcción Ant que contenga (en un .jar) el único archivo de clase. Aunque este ejemplo utiliza Java, debe tenerse en cuenta que los constructores de proyectos están disponibles para todos los proyectos, Java u otros.

  1. Cree un proyecto Java denominado HW.
  2. Cree un archivo fuente Java denominado HelloWorld con un método principal.
  3. Coloque una única sentencia System.out.println() en el método principal y haga que escriba un saludo.
  4. Guarde los cambios.
  5. Cree un archivo denominado projectBuilder.xml, ábralo con el editor Ant, especifique el contenido siguiente y guarde los cambios.
    <?xml version="1.0" encoding="UTF-8"?>
    <project name="HW.makejar" default="makejar" basedir=".">
      <target name ="makejar" description="Crear un jar para el proyecto HW">
        <jar jarfile="HelloWorld.jar" includes="*.class" basedir="bin"/>
      </target>
    </project>
    
  6. En una de las vistas de navegación, seleccione el proyecto HW y elija Propiedades en su menú de contexto.
  7. En el diálogo de propiedades del proyecto, seleccione Constructores y pulse Nuevo...
  8. En el diálogo Elegir tipo de configuración, seleccione Construcción Ant y pulse Aceptar.
  9. Aparece el diálogo Herramientas externas. Establezca el nombre en Makejar. En la pestaña Principal, pulse el botón Examinar espacio de trabajo... de Archivo de construcción y establezca la Ubicación para que sea el archivo de construcción projectBuilder.xml creado más arriba. Después pulse el botón Examinar espacio de trabajo... de Directorio base y establezca el directorio base para que sea el proyecto HW.

    Pestaña Principal del diálogo Herramientas externas

  10. En la pestaña Renovar, debemos asegurarnos de que cuando se cree el archivo HelloWorld.jar se vea en Eclipse. De forma predeterminada, no se efectúa ninguna renovación cuando un constructor de proyectos termina de ejecutarse; por lo tanto, marque el recuadro Renovar recurso al concluir, y después seleccione El proyecto que contiene el recurso seleccionado en la lista de variables de ámbito. Debido a que la renovación puede ser costosa, en general debe renovar cualquier entidad, por pequeña que sea, que contenga todos los recursos que se verán afectados por el archivo de construcción.

    Pestaña Renovar del diálogo Herramientas externas

  11. En la pestaña Destinos, puede especificar cuándo se ejecuta el constructor de proyectos y cuáles son los destinos. De forma predeterminada, el destino default se establece para ejecutarse Después de un "Borrado" y una Construcción manual. Puede especificar otros destinos y otros desencadenantes. Es posible ejecutar el constructor de proyectos durante las construcciones automáticas, aunque no es recomendable ya que el rendimiento podría verse afectado. Aquí encontrará más información sobre las clases de construcción.

    Pestaña Destinos del diálogo Herramientas externas

  12. Aplique los cambios y pulse Aceptar.
  13. De nuevo en el diálogo de propiedades del proyecto, ahora verá un constructor de proyectos denominado Makejar que está establecido para ejecutarse después del constructor Java predeterminado. Pulse Aceptar para guardar el constructor de proyectos y cerrar el diálogo.
    Nota:puede cambiar el orden para que así el archivo de construcción Ant se ejecute antes que el constructor Java, aunque esto no tendría sentido en este ejemplo.

    Diálogo Propiedades de proyecto

El constructor Java ejecuta el compilador interno Java de Eclipse que, a su vez, es responsable de la indexación del código fuente para que estén disponibles la búsqueda, la refactorización y muchas otras características. De este modo no es posible sustituir el compilador interno Java de Eclipse mediante la utilización de un constructor de proyectos. Puede inhabilitar el constructor Java y también controlar cuándo se ejecuta el constructor Java con respecto a los constructores de proyectos que defina.

Tareas relacionadas
Crear archivos de construcción Ant
Destinos Ant de constructor de proyectos
Editar archivos de construcción Ant
Guardar y reutilizar opciones de Ant
Ejecutar archivos de construcción Ant
Archivos de construcción Ant como constructores de proyectos
Ejecutar constructores de proyectos
Herramientas externas
Constructores de proyectos no Ant
Herramientas externas autónomas