Lazarus Packages/ru: what changed

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

Old	New		Line
1	1		## Обзор системы пакетов Lazarus
2	2
3	3		Другие значения Package в комбинированных проектах FPC/Lazarus см. [[packages(disambiguation)\|Packages(disambiguation)]].
4	4
5		-	~~<figure>~~
6		-	~~<img src="packagegraph1.png" title="packagegraph1.png" />~~
7		-	~~<figcaption>packagegraph1.png</figcaption>~~
8		-	~~</figure>~~
	5	+	![](/wiki-images/5/52/Packagegraph1.png)
9	6
10	7		## Что такое пакет Lazarus?
11	8
12	9		Пакет Lazarus - это набор модулей и компонентов, содержащий информацию о том, как их можно скомпилировать и как они могут использоваться проектами или другими пакетами или IDE. Среда IDE автоматически компилирует пакеты, если некоторые из ее файлов изменены. В отличие от Delphi, пакеты не ограничиваются библиотеками и могут быть независимыми от ОС. ([[packages\|Library Packages]] - это специально скомпилированные библиотеки, используемые приложениями, IDE или обоими. Для пакетов Delphi Library требуется поддержка внутри компилятора, на которую в настоящий момент FPC не способен, и, конечно, эта магия зависит от ОС.)
13	10
14	11		В настоящее время компилятор [[Free Pascal]] поддерживает только статические пакеты, а не динамические пакеты. Поэтому вы должны перекомпилировать и перезапускать IDE каждый раз, когда пакет устанавливается или удаляется.
15	12
16	13		Пакет Lazarus идентифицируется/различается по имени и его версии.
17	14
18	15		Пакеты идеально подходят для обмена кодом между проектами.
19	16
20	17		Вот типичный макет каталога пакета Lazarus:
21	18
22	19		/home/user/pascal/pkg1/ - произвольный каталог, часто он называется аналогично имени пакета
23	20		pkg1.lpk - файл пакета
24	21		pkg1.pas - этот модуль автоматически создается IDE и необходим только для компиляции
25	22		apackageunit.pas - ваш общий модуль, выбирайте уникальное имя, которое не конфликтует с другими исходниками/пакетами
26	23		aform.pas - ваша общая форма
27	24		aform.lfm - файл формы вашей общей формы
28	25		lib/i386-linux/ - выходной каталог пакета. Каталог и его содержимое создаются автоматически
29	26		pkg1.compiled - файл состояния, содержащий параметры того, как пакет был скомпилирован в последний раз
30	27		pkg1.o
31	28		apackageunit.ppu
32	29		apackageunit.o
33	30		aform.ppu
34	31		aform.o
35	32		aform.lfm
36	33
37	34		## Пришедшим из Delphi
38	35
39	36		Если вы знакомы с пакетами Delphi, прочитайте следующий параграф, потому что между пакетами Delphi и Lazarus есть некоторые важные различия.
40	37
41	38		- Пакеты Lazarus'а - это не только динамические библиотеки. Они используются для обмена модулями между проектами и модульностью крупномасштабных проектов.
42	39		- Иногда основной файл пакета Delphi называется "Пакетный проект". Этот термин не имеет смысла под Lazarus'ом.
43	40		- Многие пакеты Delphi предоставляют один «пакетный проект» для каждой версии компилятора. Это вряд ли нужно при Лазаре. Но вы можете сделать это для совместимости с Delphi. Пакеты Lazarus содержат информацию о версии, и проекты могут определить, что им требуется, как минимум или максимум, конкретная версия пакета. Lazarus автоматически загрузит нужную версию.
44	41		- Если модуль может быть не найден, под Delphi вы используете добавление каталога в глобальный путь поиска. Это имеет много недостатков при совместном использовании кода. Вот почему это не поддерживается Lazarus. Используйте вместо \[этого\] пакеты.
45	42
46	43		## ЧаВо
47	44
48	45		В: Нужно ли устанавливать \[любой\] пакет?\
49	46		О: Вам нужно устанавливать пакет только \[в том случае\], если он содержит элементы времени разработки, такие как компоненты для палитры компонентов IDE. Если вы не используете эти элементы, вам не нужно устанавливать пакет. Если вы хотите использовать пакет только в своем проекте, не устанавливайте его. Используйте инспектор проекта и добавьте зависимость \[от него\].
50	47
51	48		В: Я установил пакет, но IDE не находит модуль\
52	49		О: Установка пакета означает, что пакет интегрирован в IDE, а не в ваш проект. Это отдельные вещи. Чтобы использовать пакет в вашем проекте, используйте Project -\> Project Inspector -\> Add -\> New Requirement. И удалите пакет, если он не содержит каких-либо полезных свойств IDE.
53	50
54	51		## Быстрый старт
55	52
56	53		Чтобы увидеть систему пакетов в действии и привыкнуть к ней, сделайте следующее:
57	54
58	55		### Создание нового пакета
59	56
60	57		- Package-\>New Package... или File-\>New... -\> Package -\> Package
61	58		- Откроется редактор пакетов
62	59
63	60		![Package Maker](/wiki-images/3/37/How_to_write_lazarus_component_package_maker.png)\
64	61
65	62		- Откроется окно с заголовком "Save Package NewPackage 0.0(.lpk)". Выберите каталог и имя для вашего нового пакета. Имя должно быть действительным идентификатором Паскаля с расширением .lpk*.
66	63		- Используйте кнопку Save в правом нижнем углу, чтобы сохранить пакет в выбранном вами каталоге и с вашим названием.
67	64		- В зависимости от настроек \[раздела\] 'naming' в 'параметрах среды', среда IDE попросит вас сохранить файл в нижнем регистре. Ответьте утвердительно.
68	65
69	66		Поздравляем: Вы только что создали свой первый пакет!
70	67
71	68		### Добавление нового компонента
72	69
73	70		- Используйте кнопку Add -\> New component
74	71		- Выберите компонент-предок в выпадающем списке. Например: TBevel.
75	72		- Кликните Ok
76	73		- Файл будет добавлен в пакет и открыт в редакторе
77	74		- Установите пакет, нажав кнопку 'install' в верхней части редактора пакетов.
78	75		- Lazarus сохранит пакет и спросит вас, нужно ли пересобирать IDE. Ответьте утвердительно.
79	76		- Пакеты статически связаны, поэтому необходимо перезапустить IDE.
80	77		- Перезапустите Lazarus и увидите ваш новый компонент в палитре компонентов (например: TBevel1 будет на странице 'Additional').
81	78		- Если вы не видите свой новый компонент в палитре компонентов, скорее всего, вы используете не пересобранную версию Lazarus. Вы можете указать \[каталог\], где Lazarus \[будет\] пересобираться в меню:Tools -\> Options -\> Environment options -\> Files -\> Lazarus directory. Вместо непосредственного вызова lazarus вы также можете использовать [[startlazarus]], который запускает только что созданный lazarus, например исполняемый файл lazarus в каталоге ~/.lazarus, если у вас нет прав на запись в каталог, внутрь которого был установлен \[исполняемый файл\] lazarus.
82	79
83	80		Поздравляем: Вы только что установили свой первый пакет с первым компонентом пакета.
84	81
85	82		### Добавление иконки компонента
86	83
87	84		Иконки компонентов могут использовать ресурсы Lazarus или ресурсы FPC.
88	85
89	86		#### Использование ресурсов Lazarus'а
90	87
91	88		Также страница существует здесь: [[How to add icons my package components]].
92	89
93	90		Идея состоит в том, чтобы создать png, преобразовать его в файл подключения lrs с помощью инструмента [[lazres]] и включить его. Начиная с версии 0.9.29 на странице нового компонента есть кнопка, которая делает это автоматически.
94	91
95	92		Вот подробности:
96	93
97	94		- Размер файла PNG должен быть 24x24 px
98	95		- Имя png должно быть именем класса нового компонента, регистр не имеет значения (например, tmyComponent.png для TMyComponent).
99	96
100	97		Чтобы создать файл lrs, запустите (где TMyComponent - это имя класса вашего компонента, а yourunit - имя модуля):
101	98
102	99		``` pascal
103	100		~/lazarus/tools/lazres yourunit.lrs TMyComponent.png
104	101		```
105	102
106	103		- Вам может понадобиться скомпилировать lazres при первом использовании. Просто откройте lazres.lpi в IDE и в меню нажмите run \> build.
107	104
108	105		> Note: вы можете добавить более одного изображения в файл lrs, добавив имя файла изображения в конце. Например:\
109	106		> \
110	107		>
111	108		> ``` pascal
112	109		> ~/lazarus/tools/lazres yourunit.lrs TMyComponent.png TMyOtherCom.png ...
113	110		> ```
114	111
115	112		Ниже приведен пример файла yourunit.lrs.
116	113
117	114		``` pascal
118	115		LazarusResources.Add('TMyComponent','PNG',[
119	116		#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
120	117		+#0#0#0#4'gAMA'#0#0#177#143#11#252'a'#5#0#0#0'\|IDAT8O'#237#212#209#10#192' '#8
121	118		+#5'P'#247#231#251's'#215#138#133#164#166'\'#220#195'`'#209'c'#157'L'#173#131
122	119		+#153#169'd4'#168'dP'#137'r_'#235'5'#136'@Zmk'#16'd9'#144#176#232#164'1'#247
123	120		+'I'#8#160'IL'#206'C'#179#144#12#199#140'.'#134#244#141'~'#168#247#209'S~;'#29
124	121		+'V+'#196#201'^'#10#15#150'?'#255#18#227#206'NZ>42'#181#159#226#144#15'@'#201
125	122		+#148#168'e'#224'7f<@4'#130'u_YD'#23#213#131#134'Q]'#158#188#135#0#0#0#0'IEND'
126	123		+#174'B`'#130
127	124		]);
128	125		```
129	126
130	127		- Нажмите кнопку Add еще раз, перейдите на вкладку Add File, найдите файл yourunit.lrs и нажмите Ok. Это необходимо, чтобы среда IDE проверила этот файл на наличие изменений и перекомпилировала ваш пакет.
131	128
132	129		- Добавьте директиву включения \[файла ресурсов\] в YourUnit:
133	130
134	131		``` pascal
135	132		unit YourUnit;
136	133		...
137	134		uses
138	135		..., LResources;
139	136		...
140	137		implementation
141	138		...
142	139		initialization
143	140		{$I yourunit.lrs}
144	141		end.
145	142		```
146	143
147	144		> Note: You can include more than one lrs file, but each only once. Вы можете включить \[в код модуля вашего компонента\] более одного файла lrs, но каждый \[из них\] только один раз.
148	145
149	146		- Вот и все. Скомпилируйте или установите ваш пакет
150	147
151	148		#### Использование ресурсов FPC
152	149
153	150		Создайте 16-цветное растровое изображение 24x24 для каждого компонента. Затем создайте файл rc следующим образом:
154	151
155	152		``` pascal
156	153		TMYCOMPONENT1NAME BITMAP "pathtobitmap1//bitmap1.bmp"
157	154		TMYCOMPONENT2NAME BITMAP "pathtobitmap2//bitmap2.bmp"
158	155		....
159	156		TMYCOMPONENTnNAME BITMAP "pathtobitmapn//bitmapn.bmp"
160	157		```
161	158
162	159		Обратите внимание, что двойные слеши (Linux) и двойные обратные слешы (Windows) используются в пути к растровому изображению. Желательно, чтобы имя файла было таким же, как и имя пакета с расширением rc, т.е. \[в нашем случае было\] MyPackageName.rc
163	160
164	161		Пусть windres (Binutils) создаст текущий ресурс:
165	162
166	163		``` pascal
167	164		pathtowindres/windres -J rc -O res "MyPackageName.rc" "MyPackageName.dcr"
168	165		```
169	166
170	167		Добавьте в модуле регистрации пакета {\$R *.dcr} сразу после ключевого слова `implementation` и скомпилируйте/установите пакет.
171	168
172	169		### Создание пакета для ваших общих модулей
173	170
174	171		Допустим, у вас есть несколько модулей, которые вы хотите использовать в своих проектах. Поместите модули в отдельный каталог, например, C:\\ MySharedUnits.
175	172
176	173		- Package-\>New Package или File-\>New... -\> Package -\> Standard Package
177	174		- Откроется редактор пакетов
178	175		- Используйте кнопку Save в левом верхнем углу. Выберите C:\MySharedUnits\MySharedUnits.lpk. Имя пакета не должно конфликтовать с каким-либо существующим модулем.
179	176		- В зависимости от ваших настроек \[подраздела\] 'naming' в \[разделе\] 'environment options', среда IDE \[возможно\] попросит вас сохранить файл в нижнем регистре. Скажите да.
180	177		- Теперь у вас есть пакет с именем MySharedUnits, сохраненный как C:\MySharedUnits\mysharedunits.lpk.
181	178		- Добавление модулей: Add-\>Add Files-\>Add directory.
182	179		- Появится диалоговое окно с каталогом C:\MySharedUnits и некоторыми включающими и исключающими фильтрами. Нажмите Ok, чтобы добавить все модули.
183	180		- Модули теперь будут представлены списком. Нажмите Add files to package.
184	181		- Файлы теперь добавлены в пакет. Нажмите Save.
185	182		- Если для ваших модулей требуются только стандартные модули FPC, тогда вы можете просто нажать Compile. В противном случае смотрите ниже.
186	183
187	184		### Добавление LCL в качестве зависимости
188	185
189	186		Если ваш пакет содержит формы или любой другой модуль LCL с графическим интерфейсом, то для него требуется пакет LCL.
190	187
191	188		- В редакторе пакетов вашего пакета нажмите Add -\> New Requirement
192	189		- Выберите как package name LCL
193	190		- Нажмите Ok.
194	191		- LCL теперь добавлен как Required Packages \[(требуемые пакеты)\]. Нажмите Save.
195	192
196	193		Вы можете увидеть, что делает LCL, щелкнув в редакторе пакетов вашего пакета Compiler Options / Inherited.
197	194
198	195		Если вы используете только компоненты LCL без GUI, такие как [[fileutil]], вы можете \[вместо LCL\] добавить в зависимости LCLBase
199	196
200	197		### Использование вашего пакета в вашем проекте
201	198
202	199		Вам нужно добавить зависимость от проекта в ваш новый пакет. Есть несколько способов сделать это:
203	200
204	201		- Откройте свой пакет. Например, через Package / Open recent package. В редакторе пакетов вашего пакета нажмите More ... / Add to project.
205	202		- Или вы можете воспользоваться инспектором проекта:
206	203		- Project / Project Inspector.
207	204		- Нажмите на кнопку Add с плюсиком.
208	205		- Перейдите на страницу New Requirement
209	206		- Выберите в качестве имени пакета свой пакет
210	207		- Нажмите Ok
211	208
212	209		## Элементы меню IDE для пакетов
213	210
214	211		- Package -\> New Package или File-\>New... -\> Package -\> Standard Package
215	212		- Создает новый пакет.
216	213		- Project -\> Project Inspector
217	214		- Здесь вы можете увидеть, какие пакеты требуются для открытого в данный момент проекта.
218	215		- Вы можете добавить новые зависимости и удалить ненужные.
219	216		- Run -\> Compiler options -\> Inherited
220	217		- Здесь вы можете увидеть, какие параметры компилятора наследуются от какого пакета.
221	218		- Package
222	219		- Open package: Диалог показывает все открытые пакеты с их состоянием.
223	220		- Open package file: Открывает файл .lpk.
224	221		- Open package of current unit: Открывает файл .lpk, принадлежащий файлу в редакторе исходного кода.
225	222		- Open recent package: Открывает ранее открывавшийся файл пакета (файл lpk).
226	223		- Add active unit to a package: Добавляет в пакет модуль в редакторе исходного кода.
227	224		- Package Graph: На графике пакетов показываются все открытые пакеты и их зависимости.
228	225		- Configure installed packages: Редактирует список пакетов, установленных в IDE. \[Позволяет\] устанавливать или удалять несколько пакетов одновременно.
229	226
230	227		### Удаление пакетов
231	228
232	229		- Чтобы удалить установленные компоненты, в меню IDE выберите Package \> Configure. На следующем рисунке показан инструмент Installed Packages.
233	230
234		-	~~<figure>~~
235		-	~~<img src="How_to_write_lazarus_component_installed_components.png" title="Installed Components" />~~
236		-	~~<figcaption>Installed Components</figcaption>~~
237		-	~~</figure>~~
	231	+	![](/wiki-images/0/0e/How_to_write_lazarus_component_installed_components.png)
238	232
239	233		- Выберите пакет, который вы хотите удалить, и нажмите Uninstall selection.
240	234
241	235		Если что-то пойдет не так с пакетом (например, каталог пакета будет удален без предварительной деинсталляции), Lazarus может не позволить вам удалить пакеты. Чтобы устранить проблему, в меню IDE выберите Tools \> Build Lazarus. Lazarus пересоберет все пакеты и перезапустится. Теперь вы сможете удалить проблемные пакеты.
242	236
243	237		## Теория
244	238
245	239		Каждый пакет Lazarus имеет файл .lpk. Пакет идентифицируется по имени и версии. Имя должно соответствовать имени файла lpk. Например:
246	240
247	241		`Имя: Package1, Version: 1.0, Имя файла: /home/.../package1.lpk.`
248	242
249	243		- Среда IDE автоматически создает основной исходный файл (package1.pas). См. ниже. Файл lpk содержит информацию о необходимых пакетах, файлах, которые он использует, о том, как их скомпилировать, и о том, что необходимо для использования пакета другими пакетами/проектами. Каталог, в котором находится файл lpk, называется "package directory" \[(«каталогом пакетов»)\].
250	244		- В среде IDE содержится список всех файлов пакетов (\<каталог конфигурации\>/packagelinks.xml). Каждый раз, когда пакет открывается в IDE, он будет добавляться в этот список. Когда пакет открыт, IDE автоматически открывает все необходимые пакеты через этот список.
251	245		- Обычно пакет имеет исходный каталог с некоторыми модулями на паскале. И обычно там будет файл lpk. Пакет также имеет выходной каталог. По умолчанию это подкаталог 'lib/\$(TargetCPU)-\$(TargetOS)/' в каталоге пакета.
252	246		- Перед компиляцией пакета IDE проверяет все необходимые пакеты, и, если они нуждаются в обновлении и имеют флаг автоматического обновления, они компилируются в первую очередь. Затем IDE создает основной исходный файл пакета. Если файл lpk был package1.lpk, то основным исходным файлом является package1.pas. Этот файл содержит все модули в секции uses плюс [[Register (package)\|'Register' procedure]], которая вызывается в секции initialization.
253	247
254	248		Например:
255	249
256	250		``` pascal
257	251		{ This file was automatically created by Lazarus. Do not edit!
258	252		This source is only used to compile and install
259	253		the package GTKOpenGL 1.0.
260	254		}
261	255		unit GTKOpenGL;
262	256
263	257		interface
264	258
265	259		uses GTKGLArea, GTKGLArea_Int, NVGL, NVGLX, LazarusPackageIntf;
266	260
267	261		implementation
268	262
269	263		procedure Register;
270	264		begin
271	265		RegisterUnit('GTKGLArea', @GTKGLArea.Register);
272	266		end;
273	267
274	268		initialization
275	269		RegisterPackage('GTKOpenGL', @Register);
276	270		end.
277	271		```
278	272
279	273		- Затем вызывается компилятор и пакет компилируется в выходной каталог.
280	274		- Среда IDE сравнивает текущие параметры компилятора с последними, которые хранятся в файле .compiled. Если они различаются, IDE очищает выходной каталог и компилирует пакет с \[флагом\] -B, указывая компилятору перекомпилировать все, что может. Различия в путях поиска и параметрах вывода не приводят к очистке. Начиная с версии 0.9.31, среда IDE удаляет все файлы в выходном каталоге модуля при очистке, если выходной каталог не содержит исходных файлов (перечисленных в редакторе пакетов) и не используется совместно с необходимыми пакетами.
281	275		- После компиляции (успешной или нет) создается файл состояния. Файл состояния помещается в выходной каталог. Он имеет имя \<packagename\>.compiled и содержит информацию о том, как был скомпилирован пакет и удалось ли его собрать. Этот файл состояния используется в среде IDE для проверки необходимости обновления и необходимости полной перекомпиляции (\[с флагом\] -B).
282	276
283	277		Например: gtkopengl.compiled:
284	278
285	279		``` xml
286	280		<?xml version="1.0"?>
287	281		<CONFIG>
288	282		<Compiler Value="/usr/bin/ppc386" Date="781388725"/>
289	283		<Params Value=" -Rintel -S2cgi -CD -Ch8000000 -OG1p1
290	284		-Tlinux -gl -vewnhi -l -Fu../../../lcl/units
291	285		-Fu../../../lcl/units/gtk -Fu../../../packager/units
292	286		-Fu. -FElib/ gtkopengl.pas"/>
293	287		</CONFIG>
294	288		```
295	289
296	290		- IDE автоматически открывает все необходимые пакеты. Это означает, что он открывает все установленные пакеты, все пакеты, помеченные для установки (автоматическая установка), все пакеты с открытым редактором, все пакеты, требуемые проектом, и все пакеты, требуемые одним из других пакетов. Ненужные пакеты автоматически выгружаются, когда IDE простаивает.
297	291		- IDE никогда не открывает два пакета с одним и тем же именем одновременно. Когда пользователь открывает другой файл пакета с тем же именем, IDE спросит, должен ли он заменить старый.
298	292		- В среде IDE есть два дополнительных набора пакетов: 'installed'(«установленные») пакеты и 'auto install' пакеты («автоматической установки»). Пакеты автоматической установки будут связаны с IDE при следующей компиляции. Он создает два новых файла в каталоге config: staticpackages.inc и idemake.cfg. Затем они вызывают 'make ide OPT=@/path/to/your/config/idemake.cfg', чтобы скомпилировать самих себя.
299	293
300	294		## Состояние пакета
301	295
302	296		Пакет может не иметь ни одного, иметь один или несколько из следующих состояний:
303	297
304	298		- used (используемый) - пакет может использоваться проектом или пакетом, т.е. он является обязательным и перечислен в Инспекторе проекта или Редакторе пакетов соответственно. Когда вы открываете проект или пакет, все используемые пакеты автоматически загружаются в IDE.
305	299		- loaded (загруженный) - Когда IDE открывает файл .lpk, пакет загружается. IDE знает свои настройки и файлы. Среда автоматически загружает все используемые пакеты проекта и свои установленные пакеты. Это не загружает код пакета, так как компилятор и IDE еще не поддерживают динамические пакеты.
306	300		- marked for installation (помеченный для установки) - Чтобы запустить код пакета внутри IDE, необходимо пересобрать IDE и перезапустить его. Это означает, что первым шагом будет пометить пакет для установки. Затем пересобрать IDE и, наконец, перезапустить ее.
307	301		- installed (установленный) - Скомпилированный код пакета загружается и регистрируется в текущей запущенной IDE. Если в среде IDE удалось найти файл .lpk, он будет загружен.
308	302		- uninstall on next start (удаляемый при следующем запуске) - Пакет является установленным, но не будет скомпилирован в новую среду IDE. Это означает, что когда вы пересоберете среду IDE и перезапустите ее, пакет больше не будет установлен. Имейте в виду, что пакет может быть косвенно запрошен \[другим\] установленным пакетом и, следовательно, будет также \[опять\] установлен.
309	303
310	304		## Советы и подсказки
311	305
312	306		Пожалуйста, добавляйте здесь любые советы, подсказки или ошибки.
313	307
314	308		- Чтобы переименовать пакет, используйте 'сохранить как'.
315	309		- Вы можете добавить к каждой зависимости имя файла по умолчанию. Например, вы предоставляете пример проекта для вашего пакета. Когда другой программист впервые открывает ваш пример, IDE не знает, где находится файл lpk. Просто щелкните правой кнопкой мыши по зависимости в инспекторе проектов и выберите 'Store file name as default for this dependency' («Сохранить имя файла по умолчанию для этой зависимости»). Имя файла хранится относительно проекта. Вы можете сделать то же самое для зависимостей пакетов.
316	310		- Использование пакета: чтобы использовать все модули пакета в проекте, включите \[опцию\] Add package unit to uses section («Добавить модуль пакета в секцию uses») в package editor / Options / Usage. Когда пакет добавляется в проект, секция uses файла lpr расширяется основным модулем пакета. Например, если пакет реализует новый графический тип, он имеет только секцию initialization, но код проекта не использует его напрямую.
317	311
318	312		## Добавление существующих компонентов в пакет
319	313
320	314		Если вы хотите добавить файл, содержащий компонент, в существующий пакет, вы можете сделать следующее:
321	315
322	316		- Откройте файл пакета
323	317		- Нажмите 'Add file', чтобы добавить новый элемент в пакет.
324	318		- Выберите вкладку модуля в диалоговом окне 'Add to package'.
325	319		- Выберите файл для добавления.
326	320		- Проверьте \[наличие\] 'Has register procedure', если модуль содержит процедуру Register. Если вы этого не сделаете, компонент(ы) не будут отображаться в палитре компонентов.
327	321		- Нажмите 'Add unit'.
328	322		- Пересоберите и установите пакет.
329	323
330	324		Вот и все. Теперь компонент должен отображаться в палитре компонентов.
331	325
332	326		## Создание пакета с модулем, имя которого совпадает с именем пакета
333	327
334	328		Обычно IDE автоматически создает регистрационный код внутри модуля с тем же именем, что и пакет. Если вы хотите присвоить вашему пакету имя, совпадающее с существующим модулем, например, потому что пакет содержит только один модуль, тогда вам нужен как минимум Lazarus 0.9.29 и использование этого:
335	329
336	330		- Сделайте резервную копию вашего модуля mypackage.pas.
337	331		- Создайте пакет mypackage.lpk обычным способом и пока не добавляйте модуль.
338	332		- Добавьте новый модуль, например, mypackageall.pas.
339	333		- Выберите модуль mypackageall.pas в редакторе пакетов и щелкните правой кнопкой мыши для \[вызова\] всплывающего меню.
340	334		- Измените File type на Main Unit.
341	335		- Теперь восстановите ваш модуль mypackage.pas и добавьте его в пакет.
342	336
343	337		## Процедура регистрации
344	338
345	339		Чтобы отобразить компонент на палитре компонентов, он должен быть зарегистрирован в Lazarus. Это делается в процедуре 'Register'. Это процедура, которая должна появиться в секции интерфейса модуля, в котором она находится, и должна выполнить один или несколько вызовов RegisterComponent, а также установить редакторы свойств и компонентов для компонентов.
346	340
347	341		В пакете может присутствовать одна или несколько процедур регистрации: в редакторе пакетов необходимо указать модули, у которых есть процедура 'register', поэтому Lazarus знает, какие процедуры он должен вызывать при установке пакета.
348	342
349	343		Есть 2 способа пометить модуль, как имеющий процедуру регистрации:
350	344
351	345		- Вы можете сделать это при добавлении модулей в пакет (см. раздел [[Lazarus Packages/ru\|Добавление существующих компонентов в пакет]]),
352	346		- или вы можете выбрать устройство в диалоговом окне пакета и пометить checkbox 'Register' на панели сведений.
353	347
354	348		Не забудьте перекомпилировать и установить пакет после изменения свойств.
355	349
356	350		## Поиск путей
357	351
358	352		Все пути поиска хранятся относительно каталога файла .lpk. Если вы используете абсолютный путь, вы либо \[ничего\] не поняли \[про\] пакеты, либо вам все равно.
359	353
360	354		Каждый пакет имеет два типа путей поиска:
361	355
362	356		- Пути в Options / Compiler Options используются для компиляции самого пакета.
363	357		- Пути в [[IDE Window: Package Options/ru\|Options / Package Options / Usage]] используются пакетами и проектами, которым требуется этот пакет. Другими словами, эти пути добавляются в пути поиска проекта (или требующего пакет). Имейте в виду, что если в проекте используется пакет A, а в нем используется пакет B, то параметры Usage \[пакета\] B добавляется \[и\] к \[пакету\] A, и к проекту.
364	358
365	359		Начиная с версии 0.9.29 вы можете указывать параметры компилятора в зависимости от целевой платформы.
366	360
367	361		## Ваш пакет предоставляет библиотеку, как расширить путь поиска компоновщика во всех ваших проектах
368	362
369	363		Пакет может определять пути поиска, которые добавляются во \[все\] пакеты и проекты, использующие \[этот пакет\]. См. [[IDE Window: Package Options/ru\|Options / Package Options / Usage]].
370	364
371	365		## Пакеты Design Time vs пакетов Run Time
372	366
373	367		Существует четыре разных типа пакетов.
374	368
375	369		1. Пакет design and runtime \[(времени разработки и времени исполнения)\] может быть установлен в IDE и может использоваться проектами в обычном режиме. Это по умолчанию.
376	370		2. Пакет design time \[(времени разработки)\] может быть установлен в IDE и предоставляет расширения IDE, такие как новые компоненты, новые типы файлов или проектов, новые элементы меню, новые редакторы компонентов или свойств и т.д. Проекты могут использовать пакеты design time (т.е. они перечислены в требованиях инспектора проекта), но по умолчанию пакет времени разработки не компилируется в проект. Это означает, что модули проекта не могут использовать модули пакета design time. Когда проект использует такой пакет, IDE предупреждает \[об этом\] перед открытием формы проекта, поэтому пользователь может установить \[этот пакет\] в первую очередь. Чтобы протестировать пакет времени разработки вне IDE, вы можете использовать его в тестовом проекте. Для этого случая вы можете изменить \[стандартное поведение\] в \[разделе настроек проекта\] Project Options / Miscellaneous / Use design time packages.
377	371		3. Пакет run time \[(времени исполнения)\] может быть использован в проектах. Пользователь не может установить такой пакет напрямую (он не указан в списке). \[Пакет времени исполнения\] не может зарегистрировать сущности в IDE. Он может использоваться пакетами design time, поэтому он может быть установлен косвенно.
378	372		4. Пакет run time only \[(только времени исполнения)\] может использоваться только проектами. Он не может быть установлен в IDE, даже косвенно. Например, если пакет несовместим с основными пакетами IDE, такими как LCL. \[Тип доступен, начиная с версии\] 0.9.31.
379	373
380	374		### Типичный сценарий для запуска пакета time и design time package
381	375
382	376		У вас есть библиотека компонентов с именем Awesome, и вы хотите написать некоторые редакторы IDE для некоторых специальных свойств. Например, редактор свойств для свойства Datafile, который показывает TOpenDialog, чтобы позволить пользователю выбрать файл. Вы можете поместить компоненты в один runtime пакет с именем AwesomeLaz.lpk и создать другой каталог design для designtime пакета AwesomeIDELaz.lpk. Переместите все модули, содержащие редакторы IDE и регистрирующие материалы, в каталог design. Добавьте зависимость в AwesomeIDELaz от AwesomeLaz. Убедитесь, что они не имеют общих модулей или путей поиска. Примеры см. в разделе components/turbopower_ipro/: runtime пакет - turbopoweripro.lpk и designtime пакет - design/turbopoweriprodsgn.lpk.
383	377
384	378		### Для Дельфийцев: я не могу установить runtime пакет, с чего бы?
385	379
386	380		Установка пакета означает сборку всего кода в IDE. Пакет run time не содержит код для IDE или, возможно, даже кусает его. Чтобы использовать пакет в вашем проекте, просто откройте пакет, щелкните правой кнопкой мыши на редакторе пакетов для \[вызова\] всплывающего меню и нажмите Add to project. В качестве альтернативы вы можете использовать View / Project Inspector. Инспектор проектов показывает, какие пакеты используются вашим проектом, вы можете добавить зависимости или удалить их.
387	381
388	382		### Примеры
389	383
390	384		Пример для расширения Usage / Units path.
391	385
392	386		Платформа [tiOPF](http://tiopf.sourceforge.net/index.shtml) имеет следующую структуру каталогов, поскольку она компилируется для FPC, Delphi 5-7, D2005 и D2006:
393	387
394	388		Source <= полный путь \Programming\3rdParty\tiOPF\Source
395	389		\Compilers
396	390		\Delphi7 <= Delphi 7 файлы пакета находятся здесь
397	391		\D2005
398	392		\FPC <= tiOPF.lpk находится здесь
399	393		\Core <= файлы модуля ядра
400	394		\Options <= дополнительный файл модуля для специальных функций
401	395		\GUI
402	396
403	397		В этом примере в поле редактирования "Options - Usage - Units" включены следующие пути:
404	398
405	399		`"$(PkgOutDir);..\..\Core;..\..\Options;..\..\GUI" `
406	400
407	401		Этот путь поиска будет добавлен в любой проект, использующий этот пакет. По умолчанию используется \[макрос\] \$(PkgOutDir), который добавляет в проект только файлы ppu. Добавление дополнительных путей поиска приводит к тому, что исходные файлы .pas обнаруживаются компилятором второй раз - один раз при компиляции пакета и один раз при компиляции вашего проекта. Поскольку пакет и проект используют разные настройки, компилятор может создать вторую версию ppu, которая будет помещена в выходной каталог вашего проекта. Тогда у вас будет два процессора для одного устройства, а затем вы можете получить странные ошибки. Чтобы избежать дублирования, отключите компиляцию пакета, установив его для компиляции только вручную.
408	402
409	403		## Платформозависимые модули
410	404
411	405		Существуют различные способы разделения платформозависимого кода:
412	406
413	407		### Одна модуль на платформу, несколько модулей с одинаковым именем
414	408
415	409		Например, модуль myconnect.pas имеет две версии: одну для Windows и одну для Unix/Linux/OSX/BSD. Идея состоит в том, чтобы поместить модули в разные подкаталоги и использовать макросы в путях поиска.
416	410
417	411		- Создайте два подкаталога: win и unix.
418	412		- Добавьте в инспекторе пакета в Options / Compiler options / Paths / Other пути к файлам модулей \$(SrcOS). SrcOS - это [[IDE Macros in paths and filenames/ru\|макрос]], который переносит \[пути поиска в папку\] win под Windows и \[в папку\] unix под Linux/OSX/BSD.
419	413		- Создайте модуль нового пакета (package / Add / New file / Pascal unit) и сохраните под \[именем\] win/myconnect.pas.
420	414		- Если модуль не выбран в редакторе пакетов, выберите его.
421	415		- Отключите use unit.
422	416		- Создайте второй модуль нового пакета (package / Add / New file / Pascal unit) и сохраните под \[именем\] unix/myconnect.pas.
423	417		- Оставьте use unit включенным. Он будет использоваться один раз.
424	418
425	419		### Один модуль только для одной платформы / условный модуль
426	420
427	421		Например: модуль mywin.pas должен использоваться только под Windows, т.е. он должен использоваться и компилироваться, только если определен флаг Windows.
428	422
429	423		Идея состоит в том, чтобы использовать модуль косвенно, используя \[директиву условной компиляции\] IFDEF. В следующем примере показано, как модуль mywin.pas используется и компилируется только тогда, когда определен флаг Windows.
430	424
431	425		- Создайте модуль нового пакета (package / Add / New file / Pascal unit) и сохраните его под \[именем\] mywin.pas.
432	426		- Если модуль не выбран в редакторе пакета, выберите его.
433	427		- Отключите use unit.
434	428		- Создайте модуль нового пакета (package / Add / New file / Pascal unit) и сохраните его под \[именем\] mypkgcompile.pas.
435	429		- Добавьте в секцию \[модуля\] mypkgcompile.pas:
436	430
437	431		``` pascal
438	432		uses
439	433		Classes
440	434		{$IFDEF Windows}
441	435		,mywin
442	436		{$ENDIF}
443	437		;
444	438		```
445	439
446	440		> Note: \[Модуль\] mypkgcompile будет компилироваться на всех платформах. \[Модуль\] mywin будет компилироваться только под Windows. Вам не нужно использовать модуль mypkgcompile в вашем проекте.
447	441
448	442		## Различные версии пакета
449	443
450	444		Если вы работаете с разными версиями пакета, вы можете в любой момент открыть другой файл пакета. Старый пакет будет закрыт, а новый будет открыт. Зарегистрированные компоненты будут перенесены в новый пакет. Например, палитра компонентов по-прежнему будет показывать компоненты старого пакета, с которым была собрана среда IDE. Но по щелчку ПКМ по компоненту будут показаны пункты меню открытого в прошлый раз пакета.
451	445
452	446		Вы можете указать минимальную, максимальную требуемую версию. Когда проект открыт и в нем есть несколько файлов .lpk, IDE автоматически откроет файл с нужной версией.
453	447
454	448		Если вы работаете с разными проектами, для которых требуются разные версии пакета (например, с разными ветками одного и того же пакета), вы можете определить предпочтительный вариант в зависимостях. В инспекторе проекта щелкните правой кнопкой мыши по зависимости и выберите Set file name as preferred for this dependency \[(«Установить имя файла как предпочтительное для этой зависимости»)\]. При открытии проекта будет открыт и предпочтительный пакет. Если пакет с таким именем уже существует, он будет заменен. Эта функция существует с \[версии\] 0.9.29.\
455	449		![](/wiki-images/c/c8/SetDefaultPkDependency1.png)
456	450
457	451		См. также [[IDE Window: Project Inspector/ru\|Сохранить как имя файла по умолчанию для этой зависимости]]
458	452
459	453		### Пример библиотеки с несколькими lpk
460	454
461	455		Библиотека содержит два файла lpk: main.lpk и sub.lpk. main зависит от sub. Библиотека имеет две версии 1.0 и 2.0.
462	456
463	457		trunk/
464	458		main.lpk version 2.0, requires sub
465	459		sub.lpk version 2.0
466	460		fixes/
467	461		main.lpk version 1.0, requires sub
468	462		sub.lpk version 1.0
469	463
470	464		Когда вы открываете main.lpk 1.0 в первый раз, IDE ищет пакет sub в своей базе данных, а затем ищет sub.lpk в текущей папке. Она находит sub.lpk 1.0 и загружает его.
471	465
472	466		Когда вы открываете main.lpk 2.0, IDE уже знает sub.lpk версии 1.0 и загружает его. Она не загрузит sub.lpk 2.0.
473	467
474	468		Есть два решения:
475	469
476	470		#### Использование минимальной, максимальной версии
477	471
478	472		Вы можете установить для каждой зависимости минимальную и максимальную версию. Когда вы устанавливаете минимальную и максимальную версию зависимости, происходит следующее: main 1.0 и sub 1.0 открываются. Вы открываете main 2.0, для которого требуется sub \>=2.0 и \<=2.0. IDE выгружает main 1.0, загружает main 2.0. sub 1.0 не подходит, поэтому в среде IDE выполняется поиск sub 2.0. Она снова сначала ищет в своей базе данных, а затем в текущей папке. Она находит sub.lpk и загружает sub 2.0.
479	473
480	474		#### Использование предпочтительного имени файла
481	475
482	476		Если два файла lpk всегда распространяются вместе, вы можете использовать вместо минимальной и максимальной версий опцию preferred \[("предпочтительный")\]. Откройте main.lpk и sub.lpk из транка, чтобы убедиться, что загружены правильные версии. Затем щелкните правой кнопкой мыши на зависимости sub от main и выберите preferred file name \[("предпочтительное имя файла")\]. Имя файла появится справа от зависимости. Повторите этот шаг с файлами lpk из версии 2.0. Теперь в среде IDE всегда будет открываться правильный sub.lpk.
483	477
484	478		## Режимы сборки
485	479
486	480		Вы можете добавить режимы сборки в свой пакет. Смотрите здесь различные способы достижения этого:
487	481
488	482		[[Macros and Conditionals\|Build modes for packages]]
489	483
490	484		## Компиляция пакета через make
491	485
492	486		В среде IDE можно создать простой Makefile для пакета с помощью Package editor / More ... / Create Makefile. Среда IDE создает файл Makefile.fpc и вызывает fpcmake, который создает Makefile. Начиная с \[версии\] 0.9.29 в среде IDE также создается файл Makefile.compiled. Если вы используете систему контроля версий, такую как svn или git, добавьте все три файла в репозиторий:
493	487
494	488		`Makefile`\
495	489		`Makefile.fpc`\
496	490		`Makefile.compiled`
497	491
498	492		Теперь вы можете запустить make (например, откройте консоль, перейдите в каталог пакета с Makefile), чтобы скомпилировать пакет. Это скомпилирует пакет и после успешной компиляции скопирует Makefile.compiled в выходной каталог модуля.
499	493
500	494		Заметки:
501	495
502	496		- Makefile использует фиксированные пути, поэтому он не будет автоматически адаптироваться к изменениям, как \[это делают\] IDE или lazbuild.
503	497		- IDE может воссоздавать Makefile при каждой компиляции. \[Для этого\] включите параметр Package editor / Options / Compiler Options / Compilation / Create Makefile.
504	498		- Makefile не содержит логики для условных выражений и макросов сборки, он содержит настройки на момент создания.
505	499		- Макросы \$(TargetOS), \$(TargetCPU) и \$(LCLWidgetType) заменяются на %TargetOS%, %TargetCPU% и %LCLPlatform%. Makefile имеет некую логику для установки некоторых значений по умолчанию. Вы можете переопределить их (например, make LCLPlatform=qt).
506	500		- Файл Makefile.compiled копируется \[файлом\] Makefile после успешной компиляции в \<PkgOutDir\>/\<PkgName\>.compiled и проверяется IDE (и lazbuild), если пакет требует перекомпиляции. Например, двоичные файлы Lazarus (установщик Windows, пакеты deb и rpm, пакет OS X dmg) компилируются с помощью make, и когда IDE запускается и компилирует программу, она не будет пересобирать используемые пакеты, если пользователь не установит некоторые дополнительные флаги. Например, когда пользователь изменяет IDEBuildOptions через Configure Build Lazarus dialog, IDE обнаружит разницу и пересоберет пакет при следующей компиляции.
507	501		- Если вы забудете добавить Makefile.compiled в svn, вы получите сообщение об ошибке: /bin/cp: cannot stat \`Makefile.compiled': No such file or directory \[("/bin/cp: невозможно указать \`Makefile.compiled ': Нет такого файла или каталога")\].
508	502
509	503		## Создание закрытого пакета
510	504
511	505		Цель: вы хотите опубликовать пакет, но хотите сохранить исходный код закрытым.
512	506
513	507		На данный момент многие функции IDE требуют исходный код; среда IDE предупреждает, если исходный код модуля отсутствует. Поэтому вы должны опубликовать части интерфейса модулей и файлы, которые создает компилятор (файлы .ppu и .o).
514	508
515	509		Этапы:
516	510
517	511		- Создайте копию папки пакета и измените эту копию следующим образом.
518	512		- В инспекторе пакета в Package editor / Options / IDE integration установите Update / Rebuild в Manual compilation.
519	513		- Скомпилируйте его один раз.
520	514		- Удалите секции implementation всех модулей (т.е. все после ключевого слова `implementation` каждого модуля, включая `initialization` и `finalization`, сохраняя только "`end.`"). Вы также можете удалить секцию `private`.
521	515		- Необязательно: Вы можете использовать инструмент распространения пакета (Package Editor / More ... / Publish Package), чтобы создать zip-пакет.
522	516		- Вы можете удалить .compiled файл, Makefile, файлы rst, файлы lrt. Все остальные файлы в выходном каталоге, такие как .ppu, .o, .lfm, нужны для компилятора. Для среды IDE требуются файлы .lpk, а также файлы .pas и .inc.
523	517
524	518		Существует утилита командной строки sourcecloser, которая изменяет lpk и удаляет разделы реализации. Вы можете найти ее в lazarus/components/codetools/examples/sourcecloser.lpi.
525	519
526	520		См. также:
527	521
528	522		- эта статья о FPC с закрытым исходным кодом: [[Releasing units without source code/ru\|Releasing units without source code]]
529	523		- Prezi: <http://prezi.com/vpuyxca-qboq/how-to-create-a-closed-source-package-with-lazarus/>
530	524
531	525		## Параллельная компиляция
532	526
533	527		IDE и lazbuild компилируют пакеты параллельно (начиная с версии 1.3). Каждый пакет по-прежнему компилируется одним вызовом fpc (однопоточным).
534	528
535	529		Вы можете установить максимальное количество параллельных процессов в Tools / Options / Messages Window. По умолчанию среда пытается угадать количество ядер процессора с помощью функции GetSystemThreadCount в модуле UTF8Process.
536	530
537	531		## См.также
538	532
539	533		- [[How To Write Lazarus Component/ru\|How To Write Lazarus Component]] - учебник по созданию нового компонента.
540	534		- [[Install IDE packages without the IDE]]
541	535		- [Создание визуальных компонент для Lazarus](http://freepascal.ru/article/lazarus/20050530152619/) - статья Сергея Смирнова на русскоязычном ресурсе
542	536
543	537		---
544	538		From the Free Pascal wiki, page "Lazarus Packages/ru", 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).

Back to history