Lazarus Packages/es: what changed

Revision 1 to 2. 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		-	~~<figure>~~
4		-	~~<img src="packagegraph1.png" title="packagegraph1.png" />~~
5		-	~~<figcaption>packagegraph1.png</figcaption>~~
6		-	~~</figure>~~
	3	+	![](/wiki-images/5/52/Packagegraph1.png)
7	4
8	5		## ¿Qué es un paquete Lazarus?
9	6
10	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)
11	8
12	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.
13	10
14	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.
15	12
16	13		## Desde Delphi
17	14
18	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.
19	16
20	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.
21	18		- A veces, el archivo de Delphi principal de un paquete se denomina "proyecto de paquete". Este término no tiene sentido en Lazarus.
22	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.
23	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.
24	21
25	22		## Preguntas frecuentes
26	23
27	24		¿Es necesario instalar un paquete?
28	25
29	26
30	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.
31	28
32	29		He instalado un paquete, pero el IDE no encuentra las unidades
33	30
34	31
35	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).
36	33
37	34		## Inicio rápido
38	35
39	36		Para ver el sistema de paquetes en acción y familiarizarse con él, haz lo siguiente:
40	37
41	38		### Creando un nuevo paquete
42	39
43	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)
44	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)
45	42		- Se abre la [ventana de edición de paquetes](http://wiki.lazarus.freepascal.org/images/a/a2/Lazarus_IDE_Nuevo_Paquete_Edicion.png).
46	43		- Utiliza el botón Guardar.
47	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í.
48	45
49	46		¡Felicidades! has creado tu primer paquete.
50	47
51	48		### Añadiendo un nuevo componente
52	49
53	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).
54	51		- Selecciona el ancestro del componente de entre la lista. Por ejemplo: TBevel. Las otras opciones se cumplimentan por defecto.Se pueden cambiar.
55	52		- Pulsa el botón aceptar.
56	53		- El archivo creado será añadido al paquete y aparecerá abierto en el editor.
57	54		- Instala el paquete usando el botón Instalar.
58	55		- Lazarus guardará el paquete y preguntará si reconstruye el IDE. Responde sí.
59	56		- El paquete será enlazado de forma estática y será necesario relanzar el IDE de Lazarus.
60	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).
61	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.
62	59
63	60		¡Felicidades! has instalado tu primer paquete con tu primer componente.
64	61
65	62		### Añadir un icono para el componente
66	63
67	64		Para los iconos del componente pueden usarse recursos Lazarus o recursos FPC.
68	65
69	66		#### Utilizando Recursos Lazarus:
70	67
71	68		- El tamaño de la imagen PNG debe ser de 24x24 puntos.
72	69		- El nombre del archivo png debe ser el mismo de la clase del nuevo componente (TMiComponente.png o tmicomponente para TMiComponente, por ejemplo).
73	70
74	71		Para crear el archivo lrs ejecutar (donde mi_paquete es el nombre de tu paquete y TMiComponente es el nombre de tu componente):
75	72
76	73		` ~/lazarus/tools/lazres mi_paquete.lrs TMiComponente.png`
77	74
78	75		- Puede que necesites compilar lazres para su primer uso. Simplemente abre lazres.lpi en el IDE y en el menú Ejecutar -\> Construir.
79	76
80	77		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 ...
81	78
82	79		Si abrimos el archivo mi_paquete.lrs veremos algo como esto.
83	80
84	81		``` pascal
85	82		LazarusResources.Add('TMiComponente','PNG',[
86	83		#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
87	84		+#0#0#0#4'gAMA'#0#0#177#143#11#252'a'#5#0#0#0'\|IDAT8O'#237#212#209#10#192' '#8
88	85		+#5'P'#247#231#251's'#215#138#133#164#166'\'#220#195'`'#209'c'#157'L'#173#131
89	86		+#153#169'd4'#168'dP'#137'r_'#235'5'#136'@Zmk'#16'd9'#144#176#232#164'1'#247
90	87		+'I'#8#160'IL'#206'C'#179#144#12#199#140'.'#134#244#141'~'#168#247#209'S~;'#29
91	88		+'V+'#196#201'^'#10#15#150'?'#255#18#227#206'NZ>42'#181#159#226#144#15'@'#201
92	89		+#148#168'e'#224'7f<@4'#130'u_YD'#23#213#131#134'Q]'#158#188#135#0#0#0#0'IEND'
93	90		+#174'B`'#130
94	91		]);
95	92		```
96	93
97	94		- 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.
98	95
99	96		- Añade una directiva de inclusión en tu unidad:
100	97
101	98		``` pascal
102	99		unit TuUnidad;
103	100		...
104	101		uses
105	102		..., LResources;
106	103		...
107	104		implementation
108	105		...
109	106		initialization
110	107		{$I tuunidad.lrs}
111	108		end.
112	109		```
113	110
114	111		Nota: Puedes incluir más de un archivo lrs, pero sólo una vez.
115	112
116	113		- Esto es todo. Compila e instala tu paquete.
117	114
118	115		#### Utilizando Recursos FPC
119	116
120	117		Crea una imágen de 24 x 24 puntos y 16 colores para cada componente. Ahora crea un archivo rc como este:
121	118
122	119		` Nombre_Componente_1 BITMAP "ruta_a_imagen_1//imagen_1.bmp"`\
123	120		` Nombre_Componente_2 BITMAP "ruta_a_imagen_2//imagen_2.bmp"`\
124	121		` ....`\
125	122		` Nombre_Componente_N BITMAP "ruta_a_imagen_N//imagen_N.bmp"`
126	123
127	124		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.
128	125
129	126		Usamos windres (Binutils) para crear el recurso:
130	127
131	128		` (ruta_a_windres)windres -J rc -O res "Nombre_Paquete.rc" "Nombre_Paquete.dcr"`
132	129
133	130		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.
134	131
135	132		### Crear un paquete para nuestras unidades comunes
136	133
137	134		Pongamos que tenemos varias unidades, que deseamos utilizar en nuestros proyectos. Colocaremos las unidades en un directorio independiente, por ejemplo, C:\MisUnidadesCompartidas.
138	135
139	136		- Paquete-\>Paquete Nuevo... o Archivo-\>Nuevo... -\> Paquete -\> Paquete
140	137		- El editor de paquetes se abre
141	138		- 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.
142	139		- 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.
143	140		- Ahora tendremos un paquete de nombre MiPaqueteUnidadesCompartidas en C:\MisUnidadesCompartidas\mipaqueteunidadescompartidas.lpk.
144	141		- Añadir las unidades: Añadir-\>Añadir Archivos-\>Añadir Directorio.
145	142		- Aparece un diálogo con el directorio C:\MisUnidadesCompartidas y los filtros incluir y excluir. Clic Aceptar para añadir todas las unidades.
146	143		- Las unidades aparecen en la lista. Clic Añadir archivos al paquete.
147	144		- Los archivos han sido añadidos al paquete. Clic Guardar.
148	145		- Si nuestras unidades únicamente requieren de las unidades normales de FPC, podemos simplemente dar a Compilar. En otro caso ver lo que sigue.
149	146
150	147		### Añadir la LCL como una dependencia
151	148
152	149		Si nuestro paquete contiene formularios u otros objetos de la LCL, entonces requerirá del paquete LCL.
153	150
154	151		- En el editor de paquetes pulsamos en el botón Añadir y seleccionamos la pestaña Nuevo Requerimiento
155	152		- De la lista desplegable, elegimos el paquete LCL
156	153		- Damos al botón Aceptar.
157	154		- La LCL ha sido añadida bajo el rótulo Paquetes Requeridos. Damos al botón Guardar.
158	155
159	156		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.
160	157
161	158		### Usar nuestro paquete en nuestros proyectos
162	159
163	160		Necesitamos añadir la dependencia de nuestro proyecto respecto del nuevo paquete. Hay varias formas de hacerlo:
164	161
165	162		- 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.
166	163		- También podemos utilizar el Inspector de Proyecto:
167	164		- Menú Proyecto opción Inspector de Proyecto.
168	165		- Dar al botón con el icono + para añadir.
169	166		- Seleccionar la pestaña Nuevo Requirimiento
170	167		- En la lista deplegable Nombre del Paquete seleccionar nuestro paquete
171	168		- Aceptar
172	169
173	170		## Los elementos del menú del IDE para paquetes:
174	171
175	172		- Archivo -\> Nuevo... -\> Paquete -\> Paquete
176	173		- Crea un nuevo paquete.
177	174		- Proyecto -\> Inspector de Proyecto
178	175		- En la ventana se ve la lista de paquetes que utiliza el proyecto abierto.
179	176		- Es posible añadir ( -\> botón Añadir -\> pestaña Nuevo Requerimiento) o eliminar ( botón Eliminar) paquetes.
180	177		- Proyecto -\> Opciones del Compilador... -\> Heredado
181	178		- Aquí vemos las opciones del compilador que son heredadas desde los paquetes usados.
182	179		- Componentes
183	180		- 'Abrir paquete cargado': Un diálogo muestra todos los paquetes abiertos con su estado e información cada uno sobre ellos.
184	181		- 'Abrir archivo de paquete (.lpk) ...': Abre un paquete desde un archivo .lpk, para editarlo, compilarlo o instalarlo.
185	182		- 'Abrir paquete de unidad actual': Abre el archivo .lpk, del paquete al que pertenece el archivo activo en el editor.
186	183		- 'Abrir paquete reciente ...': Muestra la lista de los archivos .lpk de los paquetes más recientes abiertos o editados.
187	184		- 'Añadir unidad activa a un paquete': Añade el archivo activo en el editor aun paquete.
188	185		- 'Gráfico de paquete ...': Un gráfico muestra todos los paquetes abiertos y sus dependencias.
189	186		- 'Configurar paquetes instalados': Edita la lista de los paquetes instalados en el IDE. Permite instalar o eliminar varios paquetes a la vez.
190	187
191	188		### Eliminar paquetes
192	189
193		-	~~<div class="floatleft">~~
194		-
195		-	~~<figure>~~
196		-	~~<img src="Componentes_Instalados.png" title="Paquetes instalados" />~~
197		-	~~<figcaption>Paquetes instalados</figcaption>~~
198		-	~~</figure>~~
199		-
200		-	~~</div>~~
	190	+	![](/wiki-images/3/35/Componentes_Instalados.png)
201	191
202	192		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.
203	193
204	194		Marcar los paquetes que queremos desinstalar y damos al botón Desinstalar selección.
205	195
206	196		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.
207	197
208	198		## La teoría
209	199
210	200		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:
211	201
212	202		Nombre: Paquete1, Versión: 1.0, Nombre de archivo: /home/.../Paquete1.lpk.
213	203
214	204		- 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.
215	205
216	206		- 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.
217	207
218	208		- 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.
219	209
220	210		- 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.
221	211
222	212		- 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.
223	213
224	214		Por ejemplo:
225	215
226	216		``` pascal
227	217		{This file was automatically created by Lazarus. Do not edit!
228	218		This source is only used to compile and install the package GTKOpenGL 1.0.}
229	219		unit GTKOpenGL;
230	220		interface
231	221		uses GTKGLArea, GTKGLArea_Int, NVGL, NVGLX, LazarusPackageIntf;
232	222		implementation
233	223		procedure Register;
234	224		begin
235	225		RegisterUnit('GTKGLArea', @GTKGLArea.Register);
236	226		end;</elphi>
237	227		initialization
238	228		RegisterPackage('GTKOpenGL', @Register)
239	229		end.
240	230		```
241	231
242	232		- El compilador se lanza y el paquete se compila en el directorio de salida.
243	233
244	234		- 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.
245	235
246	236		- 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).
247	237
248	238		Por ejemplo: gtkopengl.compiled:
249	239
250	240		``` xml
251	241		<?xml version="1.0"?>
252	242		<CONFIG>
253	243		<Compiler Value="/usr/bin/ppc386" Date="781388725"/>
254	244		<Params Value=" -Rintel -S2cgi -CD -Ch8000000 -OG1p1
255	245		-Tlinux -gl -vewnhi -l -Fu../../../lcl/units
256	246		-Fu../../../lcl/units/gtk -Fu../../../packager/units
257	247		-Fu. -FElib/ gtkopengl.pas"/>
258	248		</CONFIG>
259	249		```
260	250
261	251		- 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.
262	252
263	253		- 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.
264	254
265	255		- 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.
266	256
267	257		## Consejos y sugerencias
268	258
269	259		Por favor, añada cualquier consejo, sugerencia o error aquí.
270	260
271	261		- Para renombrar un paquete utiliza 'Archivo -\> Guardar Como...'.
272	262
273	263		- 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.
274	264
275	265		- Configuración de paquete
276	266
277	267		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.
278	268
279	269		` Source <= ruta completa \Programming\3rdParty\tiOPF\Source`\
280	270		` \Compilers`\
281	271		` \Delphi7 <= el paquete para Delphi 7 está aquí`\
282	272		` \D2005`\
283	273		` \FPC <= el archivo tiOPF.lpk está aquí`\
284	274		` \Core <= archivos de la unidades del núcleo`\
285	275		` \Options <= archivos de unidades opcionales para características adicionales`\
286	276		` \GUI`
287	277
288	278		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:
289	279
290	280		` "$(PkgOutDir);..\..\Core;..\..\Options;..\..\GUI" `
291	281
292	282		que se añadirán a cualquier proyecto que utilice el paquete.
293	283
294	284		## Añadir componentes existentes a un paquete
295	285
296	286		Si se quiere añadir un archivo que contiene un componente a un paquete existente, hay que hacer los siguiente:
297	287
298	288		- Abrimos el archivo del paquete.
299	289		- 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.
300	290		- 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.
301	291		- Seleccionamos el archivo que queremos añadir.
302	292		- 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.
303	293		- Pulsa el botón Añadir Unidad.
304	294		- Vuelve a compilar e instalar el paquete.
305	295
306	296		Y ya está, el componente aparecerá en la paleta de componentes.
307	297
308	298		## El procedimiento de registro (procedure Register;)
309	299
310	300		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.
311	301
312	302		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.
313	303
314	304		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.
315	305
316	306		Hay dos formas de marcar la unidad que contiene el procedimiento de registro:
317	307
318	308		- Hacerlo mientras se está añadiendo la unidad al paquete (ver #Añadir componentes existentes a un paquete),
319	309		- 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.
320	310
321	311		Hay que volver a compilar e instalar el paquete después de cambiar las propiedades.
322	312
323	313		## Rutas de búsqueda
324	314
325	315		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.
326	316
327	317		Cada paquete tiene dos tipos de rutas de búsqueda:
328	318
329	319		- Rutas en las Opciones del compilador, que son utilizadas para compilar el propio paquete.
330	320		- 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.
331	321
332	322		## Paquetes para ejecución y paquetes de diseño
333	323
334	324		- Un paquete puede ser para diseño (design time), de ejecución (run time) o ámbos a la vez.
335	325		- 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.
336	326		- Un paquete de ejecución será usado por los proyectos.
337	327		- 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.
338	328		- 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.
339	329		- 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.
340	330
341	331		### Escenario típico de los paquetes para diseño y de ejecución
342	332
343	333		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.
344	334
345	335		### Para Delphinianos: No puedo instalar un paquete de ejecución, ¿por qué?
346	336
347	337		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.
348	338
349	339		## Varias versiones de un paquete
350	340
351	341		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.
352	342
353	343		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.
354	344
355	345		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.
356	346
357	347		## Compilar un paquete mediante make
358	348
359	349		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:
360	350
361	351		` Makefile`\
362	352		` Makefile.fpc`\
363	353		` Makefile.compiled`
364	354
365	355		Ahora puedes ejecutar make (v.g. abriendo una consola, yendo (cd) al direcorio del paquete dode está el archivo Makefile) para compilar el paquete.
366	356
367	357		Notas:
368	358
369	359		- Makefile utiliza rutas fijas, por lo que no se adaptará automáticamente a los cambios en el IDE o lazbuild.
370	360		- Makefile no contiene la lógica de construcción condicional ni macros, contiene la configuración en el momento de la creación.
371	361		- Las macros \$(TargetOS), \$(TargetCPU) y \$(LCLWidgetType) son reemplazadas por %TargetOS%, %TargetCPU% y %LCLPlatform%.
372	362
373	363		- 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.
374	364		- 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.
375	365
376	366		## Creación de un paquete de fuentes cerradas
377	367
378	368		Propósito: Queremos publicar un paquete, pero deseamos mantener el código cerrado.
379	369
380	370		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:
381	371
382	372		- Crea una copia del paquete.
383	373		- 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).
384	374		- Compila una vez.
385	375		- 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.")
386	376		- Opcional: Puedes utilizar la herramienta de publicación de paquetes (Editor de Paquetes/Más .../Publicar Paquete) para crear un zip del paquete.
387	377		- No es necesario distribuir los archivos .compiled, .Makefile, .rst ni .lrt.
388	378
389	379		## Links
390	380
391	381		[[How To Write Lazarus Component\|Cómo escribir componentes Lazarus]] - una tutoría sobre cómo crear un nuevo componente.
392	382
393	383		## Contribuciones y comentarios
394	384
395	385		- Esta página ha sido convertida desde la [epiwiki](http://lazarus-ccr.sourceforge.net/index.php?wiki=LazarusPackagesversión).
396	386		- Versión en castellano (español) iskraelectrica (jldc) / noviembre de 2009.
397	387
398	388		---
399	389		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).
400	390		Category: Castellano
401	391		Category: Español

Back to history