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.
  6. <?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="."/>
    </target>
    </project>

  7. En una de las vistas de navegación, seleccione el proyecto HW y elija Propiedades en su menú de contexto.
  8. En el diálogo de propiedades del proyecto, seleccione Constructores y pulse Nuevo...
  9. En el diálogo Elegir tipo de configuración, seleccione Construcción Ant y pulse Aceptar.
  10. Aparece el diálogo Herramientas externas. Establezca el nombre en 'Makejar'. En la pestaña Principal, pulse el botón Examinar área 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 área de trabajo... de Directorio base y establezca el directorio base para que sea el proyecto HW.
    Pestaña Principal del diálogo Herramientas externas
  11. En la pestaña Renovar, debemos asegurarnos de que cuando se cree el archivo HelloWorld.jar se vea en Eclipse. Por omisión, 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
  12. En la pestaña Destinos, debe seleccionarse el destino por omisión.
  13. En la pestaña Opciones de construcción, puede especificar cuándo se ejecuta el constructor de proyectos. Por omisión, esta opción de establece en Después de un "borrado" y Durante las construcciones manuales. Es posible ejecutar el constructor de proyectos durante las construcciones automáticas, aunque no es recomendable ya que el rendimiento podría verse afectado.
    Pestaña Opciones de construcción del diálogo Herramientas externas
  14. Aplique los cambios y pulse Aceptar.
  15. 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 por omisión. 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 de propiedades del 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.