Lazarus Packages/es: what changed

Revision 2 to 3. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		# Descripción del sistema de paquetes Lazarus
2	2
3	3		![](/wiki-images/5/52/Packagegraph1.png)
4	4
5	5		## ¿Qué es un paquete Lazarus?
6	6
7	7		Es una conjunto de unidades y componentes, que contiene información sobre cómo compilarlos y utilizarlos en proyectos, otros paquetes o en el IDE. Al contraio que en Delphi los paquetes no están limitados a librerías y pueden ser independientes de la plataforma. Los [[packages\|paquetes Delphi]] son librerías especiales compiladas que utilizan las aplicaciones, el IDE o ambos. Los paquetes Delphi necesitan de un soporte interno del compilador, FPC no es capaz por ahora de hacerlo y este truco es dependiente del sistema operativo)
8	8
9	9		Actualmente el compilador [[Free Pascal]] únicamente soporta paquetes estáticos. Por tanto hay que compilar y relanzar el IDE cada vez que se instala o elimina un paquete. El IDE automaticamente compila los paquetes si alguno de sus archivos es modificado.
10	10
11	11		Un paquete Lazarus se identifica y distingue por su nombre y su versión. Los paquetes son ideales para compartir código entre proyectos.
12	12
13	13		## Desde Delphi
14	14
15	15		Si estás familiarizado con los paquetes de Delphi lee el párrafo siguiente, porque hay algunas diferencias importantes entre los paquetes de Delphi y los de Lazarus.
16	16
17	17		- Los paquetes de Lazarus, no son sólo una librería dinámica. Se utilizan para compartir unidades entre los proyectos y modular grandes proyectos.
18	18		- A veces, el archivo de Delphi principal de un paquete se denomina "proyecto de paquete". Este término no tiene sentido en Lazarus.
19	19		- Muchos paquetes de Delphi proporcionan un "proyecto de paquete" por cada versión del compilador. Esto no es necesario en Lazarus. Pero puedes hacerlo por compatibilidad con Delphi. Los paquetes de Lazarus disponen de información de versión y en los proyectos se puede definir que requieren una versión superior o inferior a una específica de cierto paquete. Lazarus cargará automáticamente la versión correcta.
20	20		- Si una unidad no puede encontrarse, en Delphi se debe agregar el directorio a la ruta de búsqueda global. Esto tiene muchos inconvenientes al compartir código. Es por eso que no es compatible con Lazarus. Utiliza paquetes en su lugar.
21	21
22	22		## Preguntas frecuentes
23	23
24	24		¿Es necesario instalar un paquete?
25	25
26	26
27	27		Únicamente si el paquete contiene elementos de diseño, cómo componentes para la paleta del IDE. Si no es así, sí sólo utilizas el paquete en el proyecto, no hay que instalarlo.
28	28
29	29		He instalado un paquete, pero el IDE no encuentra las unidades
30	30
31	31
32	32		Al instalar un paquete este se integra en el IDE, no en tu proyecto. Son dos cosas distintas. Para utilizar un paquete en tu proyecto añádelo al mismo, con Proyecto -\> Inspector del proyecto, y en la ventana, botón Añadir, y [Nuevo Requerimiento](http://wiki.lazarus.freepascal.org/images/e/e6/Lazarus_Proyecto_A%C3%B1adir_Paquete.png).
33	33
34	34		## Inicio rápido
35	35
36	36		Para ver el sistema de paquetes en acción y familiarizarse con él, haz lo siguiente:
37	37
38	38		### Creando un nuevo paquete
39	39
40	40		- En el menú principal del IDE, Archivo -\> Nuevo... -\> Paquete -\> [Standard Package](http://wiki.lazarus.freepascal.org/images/2/2d/Lazarus_IDE_Nuevo_Paquete.png)
41	41		- Se abre una ventana titulada "Guardar Paquete Nuevo_paquete 0.0(.lpk)". Escoge una ruta y un nombre para tu nievo paquete. El nombre debe ser un identificador válido Pascal con extensión .lpk*. (Vamos al siguiente paso tanto si se cancela como si se guarda)
42	42		- Se abre la [ventana de edición de paquetes](http://wiki.lazarus.freepascal.org/images/a/a2/Lazarus_IDE_Nuevo_Paquete_Edicion.png).
43	43		- Utiliza el botón Guardar.
44	44		- Dependiendo de la configuración de Nombrado en las Opciones de del Entorno, el IDE preguntará si la guarda en minúsculas. Responde sí.
45	45
46	46		¡Felicidades! has creado tu primer paquete.
47	47
48	48		### Añadiendo un nuevo componente
49	49
50	50		- Utiliza el botón Añadir y selecciona la [pestaña Nuevo componente de la ventana](http://wiki.lazarus.freepascal.org/images/4/4c/Lazarus_IDE_Nuevo_Paquete_Edicion_Componente.png).
51	51		- Selecciona el ancestro del componente de entre la lista. Por ejemplo: TBevel. Las otras opciones se cumplimentan por defecto.Se pueden cambiar.
52	52		- Pulsa el botón aceptar.
53	53		- El archivo creado será añadido al paquete y aparecerá abierto en el editor.
54	54		- Instala el paquete usando el botón Instalar.
55	55		- Lazarus guardará el paquete y preguntará si reconstruye el IDE. Responde sí.
56	56		- El paquete será enlazado de forma estática y será necesario relanzar el IDE de Lazarus.
57	57		- Una vez de nuevo en Lazarus veremos nuestro nuevo componente del paquete en la pestaña que elegimos al crearlo (Por ejemplo: TBevel1 en la pestaña Additional).
58	58		- Si no se ve el nuevo componente en la paleta será seguramente porque no se está ejecutando la nueva versión compilada del IDE de Lazarus. Puedes ver donde se ha construido en: Entorno -\> Opciones del Entorno ... Archivos -\> Directorio de Lazarus (...). En vez de ejecutar directamente Lazarus puedes usar startlazarus, que arranca el recién creado Lazarus, en el directorio ~/.lazarus, si no tienes permiso de escritura en el directorio donde Lazarus está instalado.
59	59
60	60		¡Felicidades! has instalado tu primer paquete con tu primer componente.
61	61
62	62		### Añadir un icono para el componente
63	63
64	64		Para los iconos del componente pueden usarse recursos Lazarus o recursos FPC.
65	65
66	66		#### Utilizando Recursos Lazarus:
67	67
68	68		- El tamaño de la imagen PNG debe ser de 24x24 puntos.
69	69		- El nombre del archivo png debe ser el mismo de la clase del nuevo componente (TMiComponente.png o tmicomponente para TMiComponente, por ejemplo).
70	70
71	71		Para crear el archivo lrs ejecutar (donde mi_paquete es el nombre de tu paquete y TMiComponente es el nombre de tu componente):
72	72
73		-	~~` ~/lazarus/tools/lazres mi_paquete.lrs TMiComponente.png`~~
	73	+	```text
	74	+	~/lazarus/tools/lazres mi_paquete.lrs TMiComponente.png
	75	+	```
74	76
75	77		- Puede que necesites compilar lazres para su primer uso. Simplemente abre lazres.lpi en el IDE y en el menú Ejecutar -\> Construir.
76	78
77	79		Puedes agregar más de una imagen al archivo lrs, añadiendo el nombre del archivo de imagen al final. Por ejemplo ~/lazarus/tools/lazres mi_paquete.lrs TMiComponente.png TMiOtroComponente.png ...
78	80
79	81		Si abrimos el archivo mi_paquete.lrs veremos algo como esto.
80	82
81	83		``` pascal
82	84		LazarusResources.Add('TMiComponente','PNG',[
83	85		#137'PNG'#13#10#26#10#0#0#0#13'IHDR'#0#0#0#24#0#0#0#24#8#2#0#0#0'o'#21#170#175
84	86		+#0#0#0#4'gAMA'#0#0#177#143#11#252'a'#5#0#0#0'\|IDAT8O'#237#212#209#10#192' '#8
85	87		+#5'P'#247#231#251's'#215#138#133#164#166'\'#220#195'`'#209'c'#157'L'#173#131
86	88		+#153#169'd4'#168'dP'#137'r_'#235'5'#136'@Zmk'#16'd9'#144#176#232#164'1'#247
87	89		+'I'#8#160'IL'#206'C'#179#144#12#199#140'.'#134#244#141'~'#168#247#209'S~;'#29
88	90		+'V+'#196#201'^'#10#15#150'?'#255#18#227#206'NZ>42'#181#159#226#144#15'@'#201
89	91		+#148#168'e'#224'7f<@4'#130'u_YD'#23#213#131#134'Q]'#158#188#135#0#0#0#0'IEND'
90	92		+#174'B`'#130
91	93		]);
92	94		```
93	95
94	96		- Añade el archivo al paquete. Haz clic de nuevo en el botón Añadir, ve a la pestaña Agregar archivo y busca el archivo mi_paquete.lrs y haz clic en Aceptar. Así lograremos que el IDE controle los cambios en el archivo y lo compile cuando sea necesario.
95	97
96	98		- Añade una directiva de inclusión en tu unidad:
97	99
98	100		``` pascal
99	101		unit TuUnidad;
100	102		...
101	103		uses
102	104		..., LResources;
103	105		...
104	106		implementation
105	107		...
106	108		initialization
107	109		{$I tuunidad.lrs}
108	110		end.
109	111		```
110	112
111	113		Nota: Puedes incluir más de un archivo lrs, pero sólo una vez.
112	114
113	115		- Esto es todo. Compila e instala tu paquete.
114	116
115	117		#### Utilizando Recursos FPC
116	118
117	119		Crea una imágen de 24 x 24 puntos y 16 colores para cada componente. Ahora crea un archivo rc como este:
118	120
119		-	~~` Nombre_Componente_1 BITMAP "ruta_a_imagen_1//imagen_1.bmp"`\~~
120		-	~~` Nombre_Componente_2 BITMAP "ruta_a_imagen_2//imagen_2.bmp"`\~~
121		-	~~` ....`\~~
122		-	~~` Nombre_Componente_N BITMAP "ruta_a_imagen_N//imagen_N.bmp"`~~
	121	+	```text
	122	+	Nombre_Componente_1 BITMAP "ruta_a_imagen_1//imagen_1.bmp"
	123	+	Nombre_Componente_2 BITMAP "ruta_a_imagen_2//imagen_2.bmp"
	124	+	....
	125	+	Nombre_Componente_N BITMAP "ruta_a_imagen_N//imagen_N.bmp"
	126	+	```
123	127
124	128		Resaltar que se utilizan dobles barras (// en linux y \\\\ en windows) en la ruta de las imágenes. Es aconsejable que el nombre del archivo sea el mismo que el nombre del paquete con la extensión .rc, por ejemplo Nombre_Paquete.rc.
125	129
126	130		Usamos windres (Binutils) para crear el recurso:
127	131
128		-	~~` (ruta_a_windres)windres -J rc -O res "Nombre_Paquete.rc" "Nombre_Paquete.dcr"`~~
	132	+	```text
	133	+	(ruta_a_windres)windres -J rc -O res "Nombre_Paquete.rc" "Nombre_Paquete.dcr"
	134	+	```
129	135
130	136		Añade a la unidad de registro del paquete {\$R *.dcr} justo después de la palabra clave implementation, y compila e instala el paquete.
131	137
132	138		### Crear un paquete para nuestras unidades comunes
133	139
134	140		Pongamos que tenemos varias unidades, que deseamos utilizar en nuestros proyectos. Colocaremos las unidades en un directorio independiente, por ejemplo, C:\MisUnidadesCompartidas.
135	141
136	142		- Paquete-\>Paquete Nuevo... o Archivo-\>Nuevo... -\> Paquete -\> Paquete
137	143		- El editor de paquetes se abre
138	144		- Usar el botón Guardar. Navegar hasta nuestro directorio (C:\MisUnidadesCompartidas), poner el nombre que queremos (MiPaqueteUnidadesCompartidas.lpk). El nombre no debe entrar en conflicto con el de una unidad existente.
139	145		- Dependiendo de la opción 'nombrado' en las 'opciones de entorno' el IDE pude avisar para que al guardar se ponga el nombre en minúsculas. Aceptamos.
140	146		- Ahora tendremos un paquete de nombre MiPaqueteUnidadesCompartidas en C:\MisUnidadesCompartidas\mipaqueteunidadescompartidas.lpk.
141	147		- Añadir las unidades: Añadir-\>Añadir Archivos-\>Añadir Directorio.
142	148		- Aparece un diálogo con el directorio C:\MisUnidadesCompartidas y los filtros incluir y excluir. Clic Aceptar para añadir todas las unidades.
143	149		- Las unidades aparecen en la lista. Clic Añadir archivos al paquete.
144	150		- Los archivos han sido añadidos al paquete. Clic Guardar.
145	151		- Si nuestras unidades únicamente requieren de las unidades normales de FPC, podemos simplemente dar a Compilar. En otro caso ver lo que sigue.
146	152
147	153		### Añadir la LCL como una dependencia
148	154
149	155		Si nuestro paquete contiene formularios u otros objetos de la LCL, entonces requerirá del paquete LCL.
150	156
151	157		- En el editor de paquetes pulsamos en el botón Añadir y seleccionamos la pestaña Nuevo Requerimiento
152	158		- De la lista desplegable, elegimos el paquete LCL
153	159		- Damos al botón Aceptar.
154	160		- La LCL ha sido añadida bajo el rótulo Paquetes Requeridos. Damos al botón Guardar.
155	161
156	162		Podemos ver el efecto de la inclusión paquete LCL, haciendo doble clic en el editor de paquetes sobre Opciones del compilador en la pestaña Heredado.
157	163
158	164		### Usar nuestro paquete en nuestros proyectos
159	165
160	166		Necesitamos añadir la dependencia de nuestro proyecto respecto del nuevo paquete. Hay varias formas de hacerlo:
161	167
162	168		- Abrir el paquete. Por ejemplo vía Paquete / Abrir paquete reciente.... En el editor de paquetes pulsar el botón Más ... y en la lista, seleccionar Agregar al proyecto.
163	169		- También podemos utilizar el Inspector de Proyecto:
164	170		- Menú Proyecto opción Inspector de Proyecto.
165	171		- Dar al botón con el icono + para añadir.
166	172		- Seleccionar la pestaña Nuevo Requirimiento
167	173		- En la lista deplegable Nombre del Paquete seleccionar nuestro paquete
168	174		- Aceptar
169	175
170	176		## Los elementos del menú del IDE para paquetes:
171	177
172	178		- Archivo -\> Nuevo... -\> Paquete -\> Paquete
173	179		- Crea un nuevo paquete.
174	180		- Proyecto -\> Inspector de Proyecto
175	181		- En la ventana se ve la lista de paquetes que utiliza el proyecto abierto.
176	182		- Es posible añadir ( -\> botón Añadir -\> pestaña Nuevo Requerimiento) o eliminar ( botón Eliminar) paquetes.
177	183		- Proyecto -\> Opciones del Compilador... -\> Heredado
178	184		- Aquí vemos las opciones del compilador que son heredadas desde los paquetes usados.
179	185		- Componentes
180	186		- 'Abrir paquete cargado': Un diálogo muestra todos los paquetes abiertos con su estado e información cada uno sobre ellos.
181	187		- 'Abrir archivo de paquete (.lpk) ...': Abre un paquete desde un archivo .lpk, para editarlo, compilarlo o instalarlo.
182	188		- 'Abrir paquete de unidad actual': Abre el archivo .lpk, del paquete al que pertenece el archivo activo en el editor.
183	189		- 'Abrir paquete reciente ...': Muestra la lista de los archivos .lpk de los paquetes más recientes abiertos o editados.
184	190		- 'Añadir unidad activa a un paquete': Añade el archivo activo en el editor aun paquete.
185	191		- 'Gráfico de paquete ...': Un gráfico muestra todos los paquetes abiertos y sus dependencias.
186	192		- 'Configurar paquetes instalados': Edita la lista de los paquetes instalados en el IDE. Permite instalar o eliminar varios paquetes a la vez.
187	193
188	194		### Eliminar paquetes
189	195
190	196		![](/wiki-images/3/35/Componentes_Instalados.png)
191	197
192	198		Para eliminar componentes instalados, en el menú Paquete seleccionar la opción Configurar paquetes instalados .... La imagen muestra la ventana de gestión de los paquetes instalados.
193	199
194	200		Marcar los paquetes que queremos desinstalar y damos al botón Desinstalar selección.
195	201
196	202		Si algo va mal con un paquete (por ejemplo, un directorio de paquete se elimina sin desinstalarlo), Lazarus no permitirá desinstalar los paquetes. Para solucionar el problema, deberemos reconstruir Lazarus (menú Herramientas / Construir Lazarus ...), y en el proceso eliminar los paquetes problemáticos.
197	203
198	204		## La teoría
199	205
200	206		Todo paquete Lazarus tiene un archivo .lpk. Un paquete se identifica por su nombre y su versión. El nombre se corresponde con el nombre del archivo lpk. Por ejemplo:
201	207
202	208		Nombre: Paquete1, Versión: 1.0, Nombre de archivo: /home/.../Paquete1.lpk.
203	209
204	210		- El IDE crea automáticamente el archivo principal Paquete1.pas, ver más adelante. El archivo lpk contiene información sobre los paquetes necesarios, los archivos necesarios para compilarlo y que es necesario para usar el paquete con otros paquetes o proyectos. El directorio en el que reside el lpk se denomina directorio del paquete.
205	211
206	212		- El IDE mantiene una lista de todos los archivos de paquete (\<config directory\>/packagelinks.xml). Cada vez que un paquete es abierto por el IDE se añade a la lista. Cada vez que se abre un paquete, el IDE automáticamente abre todos los paquetes necesarios usando la lista.
207	213
208	214		- Hay tres paquetes básicos: FCL,LCL y SynEdit. Son parte del IDE y son creados automáticamente, son de sólo lectura y no tienen un archivo lpk.
209	215
210	216		- Normalmente un paquete tiene un directorio con las unidades con el código fuente pascal. También dispone de un directorio de destino, que por defecto es 'lib/\$(TargetCPU)-\$(TargetOS)/' dentro del directorio del paquete.
211	217
212	218		- Antes de compilar un paquete el IDE verifica todos los paquetes necesarios y si si estos necesitan actualización y la señal de hacerlo está marcada, se compilan antes. Después el IDE crea el archivo principal del paquete. Si el lpk es 'paquete1.lpk' es archivo principal será 'paquete1.pas'. Este archivo contendrá todas la unidades necesarias en la cláusula uses y además el procedimiento de registro que se llamará en la sección initialization.
213	219
214	220		Por ejemplo:
215	221
216	222		``` pascal
217	223		{This file was automatically created by Lazarus. Do not edit!
218	224		This source is only used to compile and install the package GTKOpenGL 1.0.}
219	225		unit GTKOpenGL;
220	226		interface
221	227		uses GTKGLArea, GTKGLArea_Int, NVGL, NVGLX, LazarusPackageIntf;
222	228		implementation
223	229		procedure Register;
224	230		begin
225	231		RegisterUnit('GTKGLArea', @GTKGLArea.Register);
226	232		end;</elphi>
227	233		initialization
228	234		RegisterPackage('GTKOpenGL', @Register)
229	235		end.
230	236		```
231	237
232	238		- El compilador se lanza y el paquete se compila en el directorio de salida.
233	239
234	240		- El IDE compara las opciones de compilación actuales con las previas, que se almacenan en el archivo .compiled. Si difieren el IDE limpia el directorio de salida y compila el paquete con la opción -B, diciéndole al compilador que compiler todo lo que pueda. Las diferencias en las rutas de búsqueda y opciones de verbosidad no desencadenan una limpieza. Desde 0.9.31 el IDE elimina todos los archivos en el directorio de salida de la unidad al limpiar si el directorio de salida no contiene archivos fuente (que figuran en el editor de paquetes) y no son compartidos con los paquetes necesarios.
235	241
236	242		- Tras una compilación (correcta o no) se crea un archivo de estado en el directorio de salida; su nombre será de la forma \<nombrepaquete\>.compiled y contiene información sobre cómo se compiló el paquete y el resultado. Este fichero de estado es utilizado por el IDE para comprobar si es necesaria una actualización y si es necesario que sea completa (-B).
237	243
238	244		Por ejemplo: gtkopengl.compiled:
239	245
240	246		``` xml
241	247		<?xml version="1.0"?>
242	248		<CONFIG>
243	249		<Compiler Value="/usr/bin/ppc386" Date="781388725"/>
244	250		<Params Value=" -Rintel -S2cgi -CD -Ch8000000 -OG1p1
245	251		-Tlinux -gl -vewnhi -l -Fu../../../lcl/units
246	252		-Fu../../../lcl/units/gtk -Fu../../../packager/units
247	253		-Fu. -FElib/ gtkopengl.pas"/>
248	254		</CONFIG>
249	255		```
250	256
251	257		- El IDE abre automáticamente todos los paquetes necesarios. Es decir, abre todos los paquetes instalados, todos los marcados para instalación (instalación automática), los que tengan un archivo en edición, todos los necesarios por el proyecto y todos los que necesiten otros paquetes. Los paquetes innecesarios son descargados automáticamente.
252	258
253	259		- El IDE núnca abre dos paquetes que se llaman igual al mismo tiempo. Cuándo el usuario abre un paquete con el mismo nombre que uno abierto el IDE solicita sustituir el anterior.
254	260
255	261		- El IDE mantiene dos conjuntos adicionales de paquetes: Los paquetes instalados y los paquetes de instalación automática, que serán enlazados al IDE en la siguiente compilación. SE crean dos nuevos archivos en el directorio de configuración staticpackages.inc y idemake.cfg. Ahora se lanzará make ide OPT=@/path/to/your/config/idemake.cfg para compilar el nuevo IDE.
256	262
257	263		## Consejos y sugerencias
258	264
259	265		Por favor, añada cualquier consejo, sugerencia o error aquí.
260	266
261	267		- Para renombrar un paquete utiliza 'Archivo -\> Guardar Como...'.
262	268
263	269		- Puedes agregar a cada dependencia el nombre de archivo predeterminado. Por ejemplo al ofrecer un proyecto de ejemplo para tsu paquete. Cuando otro programador abre tu ejemplo por primera vez, el IDE no sabe dónde está el lpk del paquete. Simplemente haz clic derecho sobre la dependencia y en menú contextual selecciona Guardar nombre de archivo de dependencia. El nombre de archivo se almacena relativo a la ruta del proyecto. Puedes hacer lo mismo con las dependencias del paquete.
264	270
265	271		- Configuración de paquete
266	272
267	273		Utilizamos tiOPF como ejemplo. El paquete tiOPF tiene esta estructura de directorios, debido al hecho de que se compila para FPC, Delphi 5-7, D2005 y D200.
268	274
269		-	~~` Source <= ruta completa \Programming\3rdParty\tiOPF\Source`\~~
270		-	~~` \Compilers`\~~
271		-	~~` \Delphi7 <= el paquete para Delphi 7 está aquí`\~~
272		-	~~` \D2005`\~~
273		-	~~` \FPC <= el archivo tiOPF.lpk está aquí`\~~
274		-	~~` \Core <= archivos de la unidades del núcleo`\~~
275		-	~~` \Options <= archivos de unidades opcionales para características adicionales`\~~
276		-	~~` \GUI`~~
	275	+	```text
	276	+	Source <= ruta completa \Programming\3rdParty\tiOPF\Source
	277	+	\Compilers
	278	+	\Delphi7 <= el paquete para Delphi 7 está aquí
	279	+	\D2005
	280	+	\FPC <= el archivo tiOPF.lpk está aquí
	281	+	\Core <= archivos de la unidades del núcleo
	282	+	\Options <= archivos de unidades opcionales para características adicionales
	283	+	\GUI
	284	+	```
277	285
278	286		Usando este ejemplo, se añade en la ventana de edición del paquete en "botón Opciones - pestaña Uso - Unidad" las siguientes rutas:
279	287
280		-	~~` "$(PkgOutDir);..\..\Core;..\..\Options;..\..\GUI" `~~
	288	+	```text
	289	+	"$(PkgOutDir);..\..\Core;..\..\Options;..\..\GUI"
	290	+	```
281	291
282	292		que se añadirán a cualquier proyecto que utilice el paquete.
283	293
284	294		## Añadir componentes existentes a un paquete
285	295
286	296		Si se quiere añadir un archivo que contiene un componente a un paquete existente, hay que hacer los siguiente:
287	297
288	298		- Abrimos el archivo del paquete.
289	299		- En la [ventana de edición](http://wiki.freepascal.org/Image:Lazarus_Abrir_Paquete.png) pulsamos el botón 'Añadir' para añadir un nuevo elemento al paquete.
290	300		- Seleccionamos la [pestaña Añadir Unidad](http://wiki.freepascal.org/images/0/0f/Lazarus_Paquete_A%C3%B1adir_Unidad.png) del diálogo Añadir a paquete.
291	301		- Seleccionamos el archivo que queremos añadir.
292	302		- Marca Tiene procedimiento de registro si la unida contiene un procedimiento de registro del componente. Sin esto el componente no se mostrará en la paleta de componentes.
293	303		- Pulsa el botón Añadir Unidad.
294	304		- Vuelve a compilar e instalar el paquete.
295	305
296	306		Y ya está, el componente aparecerá en la paleta de componentes.
297	307
298	308		## El procedimiento de registro (procedure Register;)
299	309
300	310		Para mostrar el componente en la paleta de componentes, hay que registrarlo en el IDE de Lazarus. Para ello se utiliza el procedimiento de registro.
301	311
302	312		Este procedimiento que debe aparecer en la sección interfaz de la unidad, y en el mismo se realizarán una o más llamadas a RegisterComponents, así mismo instalará los editores de componentes y propiedades.
303	313
304	314		En un paquete puede haber uno o más procedimientos; en el editor de paquetes hay que indicar la unidad que contiene el procedimiento de registro, para que Lazarus sepa cuál debe llamar cuándo se instala el paquete.
305	315
306	316		Hay dos formas de marcar la unidad que contiene el procedimiento de registro:
307	317
308	318		- Hacerlo mientras se está añadiendo la unidad al paquete (ver #Añadir componentes existentes a un paquete),
309	319		- o puede seleccionar la unidad en el [diálogo de edición de paquete](http://wiki.freepascal.org/Image:Lazarus_Abrir_Paquete.png) y marcar la casilla Registrar unidad del panel Propiedades de archivo.
310	320
311	321		Hay que volver a compilar e instalar el paquete después de cambiar las propiedades.
312	322
313	323		## Rutas de búsqueda
314	324
315	325		Todas las rutas de búsqueda son relativas al directorio donde reside el archivo .lpk. Si usamos una ruta absoluta, es que no entendemos los paquetes o no nos preocupa.
316	326
317	327		Cada paquete tiene dos tipos de rutas de búsqueda:
318	328
319	329		- Rutas en las Opciones del compilador, que son utilizadas para compilar el propio paquete.
320	330		- Rutas en Opciones (del paquete)/ Uso, que son utilizadas por los paquetes y proyectos que requieren este paquete, y por tanto añadidas a sus rutas de búsqueda.
321	331
322	332		## Paquetes para ejecución y paquetes de diseño
323	333
324	334		- Un paquete puede ser para diseño (design time), de ejecución (run time) o ámbos a la vez.
325	335		- Un paquete para diseño puede ser instalado en el IDE y provee extensiones al mismo, tales como nuevos componentes, nuevos tipos de archivos o proyectos, nuevos elementos de menú, nuevos editores de propiedades o componentes, etc.
326	336		- Un paquete de ejecución será usado por los proyectos.
327	337		- Un paquete de sólo ejecución (run time only) no puede instalarse en el IDE, por ejemplo, porque es incompatible con la LCL. El IDE lanza una advertencia si intentamos instalarlo.
328	338		- Un paquete para diseño únicamente (design time only) no se puede compilar en los proyectos. Por ejemplo, cuándo únicamente contiene extensiones del IDE. Desde la versión 9.31 el IDE no compila este tipo de paquetes en los priyectos. Cuando un proyecto utiliza un paquete el IDE lanza un aviso antes de abrir un formulario del proyecto, por lo que el usuario sabrá que debe instalarlo previamente.
329	339		- Estas restricciones no son fuertes. Por ejemplo, para probar un paquete para diseño habrá que usarlo en un proyecto de prueba. Desde la versión 0.9.31 se debe señalar la opción Proyecto/Opciones del proyecto.../Miscelánea/Usar de paquetes de tiempo de diseño.
330	340
331	341		### Escenario típico de los paquetes para diseño y de ejecución
332	342
333	343		Tenemos una librería de componentes llamados MisComponentes y queremos escribir editores IDE para algunas propiedades especiales. Por ejemplo, un editor de propiedades para la propiedad ArchivoDatos que muestra un TOpenDialog para que el usuario seleccione un archivo. Podemos poner los componentes en un paquete de ejecución llamado MisComponentesLaz.lpk y crear otro directorio diseño para el paquete para diseño MisComponentesIDELaz.lpk. Movemos todas las unidades que contienen los editores IDE y el registro de componenentes al directorio diseño. Añadir una dependencia en MisComponentesIDELaz.lpk a MisComponentesLaz.lpk. Comprobamos que no compartimos unidades ni rutas de búsqueda. Para ver un ejemplo, ../componentes/turbopower_ipro/: El paquete de ejecución es turbopoweripro.lpk y el paquete para diseño es design/turbopoweriprodsgn.lpk.
334	344
335	345		### Para Delphinianos: No puedo instalar un paquete de ejecución, ¿por qué?
336	346
337	347		Instalar un paquete implica compilar el código en su totalidad en el IDE. Un paquete de ejecución no contiene código para el IDE e incluso puede lastrarlo. Para utilizar un paquete en un proyecto, estando en el Editor de paquetes, hacer clic derecho para en el menú contextual seleccionarAgregar al proyecto. O bien, usar el menú Proyecto / Inspector de Proyecto y desde ahí, añadir o eliminar paquetes y dependencias.
338	348
339	349		## Varias versiones de un paquete
340	350
341	351		Puede especificar la versión mínima y máxima requerida. Cuando el proyecto se abre y hay varios archivos .lpk el IDE abrirá automáticamente el de la versión correcta.
342	352
343	353		Si trabajas con distintas versiones de un paquete, puedes abrir en cualquier momento, el archivo de otro paquete. El paquete previo será cerrado y el nuevo se abrirá. Los elementos registrados se transferirán al nuevo paquete.
344	354
345	355		Si trabajas con varios proyectos que requieren diferentes versiones de un paquete (por ejemplo, con diferentes ramas del mismo paquete), puedes definir el preferido en las dependencias. En el inspector de proyecto, haz clic derecho sobre la dependencia y en el menú contextual selecciona Establecer nombre de archivo como preferido para esta dependencia. Cuando se abra el proyecto, el paquete preferido será abierto. Si ya existe un paquete con el mismo nombre, será reemplazado. Esta característica aparece en la versión 0.9.29.
346	356
347	357		## Compilar un paquete mediante make
348	358
349	359		El IDE puede crear un sencillo Makefile para un paquete a través de la opción Crear Makefile del menú Más de la ventana de edición de paquetes. El IDE crea el archivo Makefile.fpc y llama a fpcmake, que crea el Makefile. Desde la versión 0.9.29 el IDE también crea el archivo Makefile.compiled. Si usas un sistema de control de versiones como svn o git, agrega estos tres archivos al repositorio:
350	360
351		-	~~` Makefile`\~~
352		-	~~` Makefile.fpc`\~~
353		-	~~` Makefile.compiled`~~
	361	+	```text
	362	+	Makefile
	363	+	Makefile.fpc
	364	+	Makefile.compiled
	365	+	```
354	366
355	367		Ahora puedes ejecutar make (v.g. abriendo una consola, yendo (cd) al direcorio del paquete dode está el archivo Makefile) para compilar el paquete.
356	368
357	369		Notas:
358	370
359	371		- Makefile utiliza rutas fijas, por lo que no se adaptará automáticamente a los cambios en el IDE o lazbuild.
360	372		- Makefile no contiene la lógica de construcción condicional ni macros, contiene la configuración en el momento de la creación.
361	373		- Las macros \$(TargetOS), \$(TargetCPU) y \$(LCLWidgetType) son reemplazadas por %TargetOS%, %TargetCPU% y %LCLPlatform%.
362	374
363	375		- El archivo Makefile.compiled es copiado por el Makefile después de la compilación con éxito a \<PkgOutDir\>/\<PkgName\>compiled y el IDE (y lazbuild) comprueban si un paquete necesita una recompilación. Por ejemplo los binarios de Lazarus se recopilan a través de make y cuando el IDE se inicia y se compila un programa que no se vuelven compilar los paquetes utilizados, a menos que el usuario establezca algunos parámetros adicionales.
364	376		- Si olvidas añadir Makefile.compiled a svn obtendrás el error: /bin/cp: cannot stat \`Makefile.compiled': No such file or directory (/bin/cp: no se puede crear 'Makefile.compiled': No existe el fichero o directorio.
365	377
366	378		## Creación de un paquete de fuentes cerradas
367	379
368	380		Propósito: Queremos publicar un paquete, pero deseamos mantener el código cerrado.
369	381
370	382		Por el momento muchas de las funciones IDE requieren los fuentes y le avisan si no encuentra los fuentes de una unidad. Por lo tanto, hay que publicar la sección de la interfaz de las unidades, y los archivos que el compilador crea (archivos .ppu y .o). Pasos a seguir:
371	383
372	384		- Crea una copia del paquete.
373	385		- Configura en el editor de paquetes la opción de /Opciones de Paquete/Integración IDE/Actualizar/Reconstruir en compilación manual (nunca automáticamente).
374	386		- Compila una vez.
375	387		- Elimina las secciones de implementación de todas las unidades (es decir, todo lo que hay después de la palabra clave "implementation" de cada unidad, incluyendo la iniciación y finalización dejando únicamente el "end.")
376	388		- Opcional: Puedes utilizar la herramienta de publicación de paquetes (Editor de Paquetes/Más .../Publicar Paquete) para crear un zip del paquete.
377	389		- No es necesario distribuir los archivos .compiled, .Makefile, .rst ni .lrt.
378	390
379	391		## Links
380	392
381	393		[[How To Write Lazarus Component\|Cómo escribir componentes Lazarus]] - una tutoría sobre cómo crear un nuevo componente.
382	394
383	395		## Contribuciones y comentarios
384	396
385	397		- Esta página ha sido convertida desde la [epiwiki](http://lazarus-ccr.sourceforge.net/index.php?wiki=LazarusPackagesversión).
386	398		- Versión en castellano (español) iskraelectrica (jldc) / noviembre de 2009.
387	399
388	400		---
389	401		From the Free Pascal wiki, page "Lazarus Packages/es", as it stood on 2020-02-18 after a change by Trev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).
390	402		Category: Castellano
391	403		Category: Español

Back to history