Esta página describe una forma antigua en desuso de integrar con p2. Consulte la página "Construir repositorios de p2 y productos" para conocer los métodos recomendados para construir con p2. Las propiedades descritas a continuación funcionan con una capa de compatibilidad con versiones anteriores y no soportan las características nuevas que puedan añadirse al publicador p2.
Consulte la página Creación de metadatos p2 en la Guía del desarrollador de plug-ins de la plataforma para obtener detalles sobre la creación de metadatos p2. La generación de metadatos por sí misma no es suficiente para crear un producto habilitado para p2. Para hacerlo, debe realizar una instalación de p2 real a partir de los metadatos generados. Consulte la documentación del director de p2 para obtener detalles sobre cómo realizar esta instalación a partir de un script autónomo.
Es posible generar metadatos de p2 con llamadas manuales al generador de metadatos de p2 en cualquiera de las tareas personalizadas de PDE/Construcción (consulte la sección Personalizar una construcción autónoma). Sin embargo, PDE/Construcción proporciona integración con p2 a través de las propiedades siguientes:
generate.p2.metadata |
(EN DESUSO, utilice p2.gathering en su lugar) Defínalo como true para activar la creación de metadatos p2. Los scripts ant se basan en la existencia de esta propiedad y no del valor. Para desactivar la generación de metadatos, debe eliminarse la propiedad, no solamente establecerla como false. En los scripts de construcción, las llamadas a los destinos de p2 se generan cuando el paquete de p2 org.eclipse.equinox.p2.metadata.generator y sus dependencias están presentes en el Eclipse que está ejecutando la construcción. Estos destinos de p2 son condicionales en la propiedad generate.p2.metadata. |
p2.metadata.repo |
Especificar un file: URI proporcionando la ubicación de los metadatos de p2 y los repositorios de
artefactos en los que publicar. Es habitual pero no necesario para el repositorio de artefactos utilizar la misma
ubicación que el repositorio de metadatos. Ejemplo:
p2.metadata.repo=file:${buildDirectory}/repository
p2.artifact.repo=file:${buildDirectory}/repository
|
p2.metadata.repo.name |
Opcional. Especificar nombres para los repositorios de p2 de generador. Al utilizar un repositorio que ya existe, no se cambiará el nombre existente del repositorio. Si no se especifica, p2 denominará los repositorios según su ubicación. |
p2.flavor |
Establecer la modalidad de los metadatos de p2. Cuando se crean metadatos para el SDK de Eclipse, se utiliza la modalidad "tooling". |
p2.publish.artifacts |
Se establece en true para publicar jars en el repositorio de artefactos. Si se establece en false, se generan metadatos de artefacto pero los jar no se copian en el repositorio de artefactos. AVISO: cuando se establece en true, asegúrese de que p2.artifact.repo no es la misma ubicación que los directorios de ensamblaje utilizados por PDE/Construcción, de lo contrario es posible que se supriman los jar. |
p2.root.name |
Especifique el nombre y la versión para la interfaz de usuario raíz que contendrá todo lo construido. Si se especifica un archivo .product en la construcción, se omitirán estas propiedades. En su lugar, cuando hay un archivo .product disponible, el nombre y la versión raíz serán el id y la versión del archivo .product. Consulte lo siguiente para obtener más información. |
Al ejecutar una construcción con un archivo de producto establecido en el archivo build.properties de configuración de construcción de nivel superior (tanto en construcciones que utilicen productBuild.xml como en las que utilicen el build.xml normal), PDE/Construcción generará automáticamente metadatos para ese producto.
Además de crear unidades instalables para todas las características y paquetes, esto también creará las unidades instalables de producto siguientes:
Con todas estas unidades instalables, es posible utilizar p2 para instalar el producto completo fuera del repositorio.
PDE/Construcción está esencialmente llamando a la tarea de generación de metadatos proporcionada por p2 en determinados puntos durante la construcción. Es probable que durante una construcción nunca haya un solo punto en el tiempo en el que todos los artefactos de construcción existan en el disco en el mismo lugar. Por lo tanto, sería necesario llamar al generador de metadatos p2 en los archivadores finales o, como una optimización, llamarlo varias veces a través de la construcción.
La generación de metadatos se producirá durante las fases de ensamblado y empaquetado. Esto es cierto para las construcciones normales y para las construcciones de empaquetador. A modo de ejemplo, para una construcción de producto que utilice productBuild.xml, se generarán los scripts siguientes (suponiendo que configs=win32,win32,x86 & linux,gtk,ppc):
Los scripts de ensamblado recopilan características y plug-ins construidos conjuntamente con archivos raíz asociados. Los scripts de paquete recopilan características y plug-ins preconstruidos. Los scripts específicos de plataforma recopilan las piezas para esas configuraciones particulares y los scripts "all" delegan en cada uno de los scripts específicos de plataforma.
Las llamadas de generación de p2 se producirán de la forma siguiente:
La tarea de generador de metadatos de p2 soporta la generación incremental, cada llamada a los metadatos de p2 generados se hace con mode=incremental, la llamada final para generar la unidad instalable raíz se ejecutará con mode="final"