Lazarus Packages/ru: what changed

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