Personalización del proceso de empaquetado

Los usuarios avanzados pueden personalizar el proceso de compilación utilizando el lenguaje de scripts Apache Ant.

Por qué y cuándo se efectúa esta tarea

scmhace referencia a un identificador que representa el sistema SCM (Gestión de control de origen).

Consejo: WCB_installdir/wcbd-build-common.xml proporciona destinos Ant auxiliares que son reutilizables y sirven de ejemplo para la personalización. Para obtener más información, revise las secciones comentadas en el archivo wcbd-build-common.xml.

Procedimiento

Opcional: Desarrolle scripts personalizados para integrarlos con la SCM. Este paso es necesario si la SCM utilizada en el proyecto de personalización no es aquella para la que se proporcionan scripts de ejemplo. Para más información, consulte Configurar el script Ant de extracción de origen.
1. Copie WCB_installdir/extract/wcbd-extract.private.properties.template como WCB_installdir/extract-scm.private.properties.
2. Copie WCB_installdir/extract/wcbd-extract.properties.template como WCB_installdir/extract-scm.properties.
3. Copie WCB_installdir/extract/wcbd-extract.xml.template como WCB_installdir/extract-scm.xml.
4. Cambie el permiso de archivos con los mandatos siguientes:
```
chmod 755 WCB_installdir/extract-scm.*
```
5. Abra WCB_installdir/extract-scm.xml con un editor de texto y sustituya el atributo de nombre del elemento de proyecto raíz de wcbd-extract a extract-scm. A continuación, escriba la lógica personalizada para extraer el código fuente del SCM. Para obtener información más detallada, vea los comentarios del archivo.
6. Abra WCB_installdir/extract-scm.private.properties con un editor de texto y añada las propiedades sensibles a la seguridad que necesite WCB_installdir/extract-scm.xml.
7. Abra WCB_installdir/extract-scm.properties con un editor de texto y añada las propiedades que necesite WCB_installdir/extract-scm.xml.
Opcional: Añada funciones a la compilación Ant:
1. Cree un archivo de compilación ANT auxiliar que se denomina WCB_installdir/project-build-common.xml.
2. Abra el archivo con un editor de texto y añada la línea siguiente después del código de apertura de elemento de proyecto raíz:
```
<import file="${basedir}/wcbd-build-common.xml"/>
```
3. Añada nuevos destinos al archivo según convenga.
  El destino auxiliar existente y cualquier destino que pueda depender de él se pueden alterar basándose en la especificación de la tarea import de Ant.
Opcional: Añada propiedades sensibles a la seguridad, como nombres de usuario y contraseñas:
1. Copie WCB_installdir/wcbd-build.private.properties.template como WCB_installdir/project-build.private.properties.template.
2. Añada las nuevas propiedades al final del archivo. Para obtener información más detallada, vea los comentarios del archivo.
Este archivo se convierte en el archivo de plantilla de propiedades nuevas para la configuración.
Opcional: Añada propiedades:
1. Copie WCB_installdir/wcbd-build.properties.template como WCB_installdir/project-build.properties.template.
2. Añada las nuevas propiedades al final del archivo. Consulte los comentarios en el archivo para obtener detalles.
Este archivo se convierte en el archivo de plantilla de propiedades nuevas para la configuración.
Opcional: Añada bibliotecas:
1. Copie WCB_installdir/wcbd-setenv*.template como WCB_installdir/project-setenv*.template.
2. Actualice la variable CLASSPATH en WCB_installdir/project-setenv.bat.template.
Estos archivos se convierten en los nuevos archivos de plantilla setenv para la configuración.
Incluya funciones nuevas o cambiadas en el proceso de compilación global:
1. Copie WCB_installdir/wcbd-build.xml como WCB_installdir/project-build.xml.
2. Si el nuevo archivo de compilación Ant auxiliar WCB_installdir/project-build-common.xml se ha creado con los pasos anteriores, cambie la línea siguiente en WCB_installdir/project-build.xml:
```
<import file="${basedir}/wcbd-build-common.xml" />
```
  a:
```
<import file="${basedir}/project-build-common.xml" />
```
3. Modifique la lógica del proceso de compilación para incorporar los nuevos cambios. Consulte los comentarios en el archivo para obtener detalles.
La personalización de los archivos que se utilizan para Configuración de valores de empaquetado y Compilación de paquetes se realiza de la misma manera que la de los elementos predeterminados, excepto que se utilizan los archivos project-* en lugar de los archivos wcbd-*.