Lazarus Faq/ru: what changed

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

Old	New		Line
1	1		> Note: Этот FAQ может быть устаревшим в некоторых частях.
2	2
3	3		## Общее
4	4
5	5		### Почему получаемые бинарные файлы очень большие?
6	6
7	7		Бинарные файлы очень большие из-за того, что включают в себя много отладочной информации для использования в отладчик [gdb](http://www.gnu.org/software/gdb) (GNU Debugger). Компилятор имеет настройку для удаления отладочной информации из исполняемого файла (-Xs), но из-за ошибки в компиляторе (версия 2.0.2 и ниже) она не работает корректно. Ошибка исправлена в версиях компилятора 2.0.4 и выше.
8	8
9	9		Вы можете использовать программу "strip" для удаления отладочной информации из исполняемых файлов. Она находится в каталоге Lazarus'а: lazarus\pp\bin\i386-win32\\.
10	10
11	11		Наберите "strip --strip-all \<путь к исполняемому файлу\>" в командной строке.
12	12
13	13		Если Вы хотите сделать Вашу программу очень маленькой, то Вы можете попробовать использовать [UPX](http://upx.sourceforge.net/). UPX - это очень хороший exe-упаковщик. It includes no memory overhead due to in-place decompression. И также имеет очень быструю распаковку (~10 МБ/сек на Pentium 133).
14	14
15	15		Для использования upx наберите "upx \<путь к исполняемому файлу\>" в командной строке.
16	16
17	17		После использования strip и upx простая GUI программа на Lazarus'е получается:
18	18
19	19		- ~ 700Кб на Linux
20	20		- ~ 420Кб на Windows
21	21
22	22		Для более детальной информации о недостатках использования UPX обратитесь к статье [[Size Matters/ru\|Размер имеет значение]]. Также нужно отметить, что "hello world" программы lazarus уже включают в себя множество возможностей, таких как:
23	23
24	24		- Библиотеку работы с XML
25	25		- Библиотеки для обработки файлов рисунков типа png, xpm, bmp и ico
26	26		- Практически все виджеты Lazarus Component Library (LCL)
27	27		- Все Runtime библиотеки Free Pascal
28	28
29	29		Всё это делает приложение большим, но это так же и включает всё, что может потребоваться нетривиальному приложению.
30	30
31	31		Начальный размер исполняемого файла Lazarus велик, однако растёт в дальнейшем довольно медленно. Проект на С++ (это для примера, но относится и к другим языкам / инструментальные средства тоже), сначала очень маленький (типа "Hello world"), но быстро растет по экспоненте, когда Вы добавляете дополнительные возможности, чтобы написать нетривиальное приложение.
32	32
33		-	~~<figure>~~
34		-	~~<img src="Lazarus_vs_cpp.png" title="Lazarus_vs_cpp.png" />~~
35		-	~~<figcaption>Lazarus_vs_cpp.png</figcaption>~~
36		-	~~</figure>~~
	33	+	![](/wiki-images/d/de/Lazarus_vs_cpp.png)
37	34
38	35		Краткое руководство по уменьшению размера Lazarus/FPC приложения (проверено в Lazarus 0.9.26)
39	36
40	37		- 1\. Project\\|Compiler Options\\|Code\\|Smart Linkable (-CX) -\> Поставить галочку
41	38		- 2\. Project\\|Compiler Options\\|Linking\\|Debugging\\|Display Line Numbers in Run-time ErrorBacktraces (-gl) -\> Убрать галочку
42	39		- 3\. Project\\|Compiler Options\\|Linking\\|Debugging\\|Strip Symbols From Executable (-Xs) -\> Поставить галочку
43	40		- 4\. Project\\|Compiler Options\\|Linking\\|Link Style\\|Link Smart (-XX) -\> Поставить галочку
44	41
45	42		Самые важные элементы, мне кажется, 2 и 3. Для простого приложения выполнимый размер должен теперь составить 1-3 Мбайта вместо 15-20 Мбайт. В этом пункте Вы можете также попробовать: Project\\|Compiler Options\\|Code\\|Optimizations\\|smaller, вместо Faster -\> Поставить галочку (Предупреждение: это может уменьшить производительность),
46	43
47	44		- 5\. (Опционально) Запустите UPX \<путь к исполняемому файлу\> для сжатия вашего бинарника дополнительно в 2-3 раза (Предупреждение: как сказано выше, есть недостатки в использовании UPX).
48	45
49	46		### УСТАРЕЛО: Почему компоновка такая медленная в Windows?
50	47
51	48		Эта проблема свойственна лишь старым версиям: FPC 2.2 и Lazarus 0.9.24. Пожалуйста обновите Лазарус. Всё написанное здесь относится только к старым версиям.
52	49
53	50		В общем, компоновка на Windows занимает больше времени, чем на других платформах, потому что GNU компоновщик под эту операционную систему очень медленный. FPC (2.2) использует этот компоновщик при сборке программ. Эта проблема возникает только на Windows и только на слабых компьютерах (с процессором частотой менее 1ГГц и/или оперативной памятью меньше 128 Мегабайт)
54	51
55	52		Также, если вы используете умную компоновку (smartlinking), общее время компиляции так же увеличиться. Подробнее об этом можно прочитать здесь: [[File size and smartlinking]]
56	53
57	54		Для решения этой проблемы, был разработан внутренний компоновщик. Он есть во всех версиях FPC, начиная с 2.2. Его использование позволило в значительной степени сократить общее время компиляции. Внутренний компоновщик используется только при компиляции для Windows системы.
58	55
59	56		### Мне нужен ppc386.cfg или fpc.cfg?
60	57
61	58		Вам нужен только fpc.cfg. В нем указаны пути, по которым компилятор будет искать библиотеки.
62	59
63	60		### Как я могу скомпилировать lazarus?
64	61
65	62		Нет ничего проще :)
66	63
67	64		`$ cd lazarus`\
68	65		`$ make clean all`
69	66
70	67		### Как собирать LCL проекты без Lazarus-а?
71	68
72	69		- В тех случаях, когда использование графической среды невозможно, вы можете воспользоваться утилитой командной строки: lazbuild.
73	70
74	71		Эта утилита используется для сборки проектов и lazarus-пакетов (packages).
75	72
76	73		- Если вам нужно собрать LCL приложение без среды разработки и не используя lazbuild, вам необходимо добавить следующие строки в файл fpc.cfg
77	74
78	75		` # строчки начинающиеся с # можно не добавлять`\
79	76		` # это комментарии`\
80	77		` # пути для других модулей и компонентов `\
81	78		` -Fu{Путь_к_лазарусу}/lcl/units/{целевая_система}`\
82	79		` -Fu{Путь_к_лазарусу}/components/units/{целевая_система}`
83	80
84	81
85	82		Где {целевая_система} это системный префикс, указывающий для какой системы располагаются модули. Обычно этот префикс представляет собой пару имён "Процессор-ОСь", например i386-win32, i386-linux, i386-darwin.:
86	83
87	84		После добавления этих строк в конфигурационный файл, вызовете команду: fpc myproject.lpr myproject.lpr это имя основного файла проекта (модуль начинающийся с "program" или "library"). Но имя может быть другим, т.к. Лазарус не принуждает Вас использовать расширение .lpr.
88	85
89	86		Кроме того, если Ваш проект использует какие-либо особые настройки, вы можете получить командную строку для компиляции, используя меню в Лазарусе: Проект-\>Параметры проекта...-\>Показать параметры (параметров может быть очень много, удобно скопировать их в отдельный скрипт файл .bat или .sh);
90	87
91	88		### Какая версия FPC требуется?
92	89
93	90		Версия 2.4.0 для всех операционных систем.
94	91
95	92		### Я не могу скомпилировать Lazarus
96	93
97	94		1. Проверьте версию компилятора
98	95		2. Проверьте версию (fpc)библиотек, они должны быть той же версии
99	96		3. Проверьте путь установки компилятора на наличие в нем пробелов. Пробелов в нем не должно быть!
100	97		4. Проверьте наличие файла fpc.cfg, а не старого файла ppc386.cfg
101	98		5. Проверьте также OS-dependent FAQs
102	99
103	100		### При компиляции проекта возникает ошибка:
104	101
105	102		#### "Cannot find Unit interfaces". Как можно это исправить?
106	103
107	104		Ошибка возникает потомучто компилятор не может найти 'interfaces.ppu' или он найден, но он поврежден, неправильной версии или просрочен.
108	105
109	106		Этот модуль может находиться в {LazarusDir}\lcl\units\\{TargetCPU}-{TargetOS}\\{LCLWidgetSet}\interfaces.ppu. Например: /home/username/lazarus/lcl/units/i386-linux/gtk/interfaces.ppu.
110	107
111	108		Убедитесь, что он только здесь. Если находятся несколько версий interfaces.ppu, то вы возможно получите неверную конфигурацию (к примеру добавлен каталог lcl в список путей поиска). Удалите все interfaces.ppu, оставьте только тот что в каталоге указаном выше.
112	109
113	110		Если вы выберете другой widgetset, то при пересборке lazarus, понадобится пересобрать LCL для этого widgetset.
114	111
115	112		Если ошибка возникает несмотря на то что 'interfaces.ppu' на месте - значит используется, иная compiler/rtl для компиляции проекта нежели для компиляции Lazarus IDE. Можно сделать одно из следующего:
116	113
117	114		- Пересобрать LCL (или полностью Lazarus) с компилятором выбраным в Environmnent Options. Для этого можно кликнуть Tools -\> Build Lazarus. Перед этим проверьте текущие настройки в Tools -\> Configure Build Lazarus.
118	115		- Поменять компилятор в Environment Options на тот что используется для компиляции Lazarus. Посмотрите внимательно также в Environment Options что используются корректный путь к каталогу Лазаря (Lazarus Directory) и к исходникам FPC. Убедитесь что есть только только один файл конфигурации fpc.cfg - он должен располагаться /etc/ для Linux/Unix или вместе с компилятором fpc под Windows. Попробуйте запустить "fpc -vt bogus" для того чтобы увидеть какой fpc.cfg используется на вашей системе. Мешающие копии обычно появляются при обновлении компилятора; они могут находится в домашнем каталоге или вместе с пересобраным новым компилятором. УДАЛИТЕ ИХ!!
119	116		- Можно также попробовать сменить текущий widgetset проекта. Например, примерный проект "objectinspector" поставляемый с Лазарем поумолчанию использует gtk. Компиляция этого проекта наверняка выдаст "Can't find unit interfaces" под Windows. Смена widgetset на default(Win32) в Project \\| Compiler Options... \\| LCL Widget Type (various) должно исправить это.
120	117
121	118		### Когда я пытаюсь откомпилировать проект Delphi в lazarus, я получаю сообщение об ошибке
122	119
123	120		#### Ошибка на строке :{\$R *.DFM}. Как мне решить эту проблему?
124	121
125	122		Lazarus (а точнее - Linux) не знает о таком понятии, как "ресурсы", и не может использовать некоторые связанные с ними понятия, пришедшие из Delphi/Win32. Однако, Lazarus использует методы, обеспечивающие совместимость с этими понятиями. Вы сможете использовать формы Delphi (файлы .dfm), если выполните следующие шаги:
126	123
127	124		- Используйте текстовые версии .dfm-файлов. D5 и более поздние версии используют такие файлы по умолчанию. Если у вас более старые файлы, выполните следующее: нажмите ALT-F12 для просмотра кода формы в виде текста и скопируйте/вставьте текст. Если у вас есть текстовый .dfm-файл, просто скопируйте его содержание в .lfm-файл.
128	125		- Создайте файл с помощью lazres (в меню lazarus/tools) следующей командой: lazres yourform.lrs yourform.lfm
129	126		- Добавьте следующую строку в секцию initialization:
130	127
131	128		` initialization`\
132	129		` {$I yourform.lrs}`
133	130
134	131		Пожалуйста, помните, что не все свойства объектов, описанные в dfm-файлах, поддерживаются Lazarus, и часть из них может вызвать падения IDE.
135	132
136	133		Примечание: Вы не получите этой ошибки, начиная с версии Lazarus 0.9.29 (SVN) при использовании FreePascal 2.4.0 и выше. Компилятор этой версии умеет включать такие ресурсы в исполняемый файл на всех платформах. Тем не менее, проблема несовместимости отдельных свойств от этого не исчезает.
137	134
138	135		#### Ошибка: 'Identifier not found LazarusResources'.
139	136
140	137		При создании формы Lazarus автоматически добавляет некоторые необходимые модули в секцию uses вашего модуля, содержащего форму. После конвертации из Delphi в модуле могут отсутствовать необходимые ссылки. В данном конкретном случае вам необходимо добавить в секцию uses модуль LResources.
141	138
142	139		### При обращении к событиям объектов, например OnClick объекта button, я получаю следующую ошибку: ERROR unit not found: stdCtrls
143	140
144	141		Убедитесь (Project -\> Project Inspector),что ваш проект зависит от пакета 'LCL' и что вы установили исходники FPC.
145	142
146	143		Lazarus - это IDE (среда разработки) и библиотека визуальных компонентов LCL. Все другие вещи, как IO, Database, FCL и RTL предоставляются FPC. IDE нужны пути ко всем исходникам.
147	144
148	145		Пути к исходникам FPC могут быть установлены через: Environment -\> Environment Options -\> Files -\> FPC source directory (Окружение -\> Параметры -\> Файлы -\> Каталог исходного кода FPC).
149	146
150	147		### Как внедрять содержимое небольшого файла в исполняемый файл? Как внедрять ресурсы?
151	148
152	149		Например,
153	150
154	151		`/your/lazarus/path/tools/lazres sound.lrs sound1.wav sound2.wav ...`
155	152
156	153		создаст sound.lrs из sound1.wav и sound2.wav.
157	154
158	155		Потом включите его после lrs-файла формы:
159	156
160	157		`...`\
161	158		`initialization`\
162	159		`{$i unit1.lrs} // this is main resource file (first)`\
163	160		`{$i sound.lrs} // user defined resource file`\
164		-	\
	161	+
165	162		`end.`
166	163
167	164		В Вашей программе эти ресурсы можно использовать следующим образом:
168	165
169	166		`Sound1AsString:=LazarusResources.Find('sound1').Value;`
170	167
171	168		### Что означают различные расширения файлов, используемые Lazarus?
172	169
173	170		Глава [[Lazarus Tutorial\|Lazarus Tutorial#The Lazarus files]] разъясняет назначение некторых расширений. Вот их краткий список:
174	171
175	172		`*.lpi`
176	173		файл с информацией о проекте Lazarus (в формате XML; содержит настройки, относящиеся к конкретному проекту)
177	174
178	175		`*.lpr`
179	176		программный файл Lazarus; содержит основной Pascal-код программы
180	177
181	178		`*.lfm`
182	179		файл формы Lazarus; содержит информацию обо всех объектах, размещённых на форме (хранится в специальном текстовом формате; связанные с объектами формы действия хранятся в одноимённом `*.pas`-файле)
183	180
184	181		`.pas` или `.pp`
185	182		модуль с Pascal-кодом (обычно связан с формой в одноимённом `*.lfm`-файле)
186	183
187	184		`*.lrs`
188	185		файл ресурсов Lazarus (это генерируемый файл; не является файлом ресурсом Windows).
189	186
190	187		Этот файл может быть создан с помощью утилиты lazres (в каталоге Lazarus/Tools) путё вызова из командной строки: lazres myfile.lrs myfile.lfm
191	188
192	189		`*.ppu`
193	190		скомпилированный модуль
194	191
195	192		`*.lpk`
196	193		информационный файл для пакета Lazarus (в формате XML; содержит настройки, относящиеся к конкретному пакету)
197	194
198	195		### Когда я пишу var mytext: text;, чтобы объявить текстовый файл, я получаю ошибку "Unit1.pas(32,15) Error: Error in type definition". Как можно это исправить?
199	196
200	197		Класс TControl содержит свойство [[doc:lcl/controls/tcontrol.text.html\|Text]]. В методе формы используется тип[[doc:rtl/system/text.html\|Text]] из модуля system. Вы можете использовать тип [[doc:rtl/system/text.html\|TextFile]], который всего лишь является другим названием типа Text, или можете добавить модуль при объявлении (см. в примере):
201	198
202	199		` var`\
203	200		` MyTextFile: TextFile;`\
204	201		` MyText: System.Text;`
205	202
206	203		Сходный конфликт имен существует и при связывании и закрытии текстового файла. TForm имеет методы assign и [[doc:lcl/forms/tcustomform.close.html\|Close]]. Вместо них вы можете использовать [[doc:rtl/objpas/assignfile.html\|AssignFile]] и [[doc:rtl/objpas/closefile.html\|CloseFile]], или же добавлять имя модуля System (System.Close, System.Assign).
207	204
208	205		### Я получаю ошибку при использовании Printer.BeginDoc
209	206
210	207		Модуль Printers должен быть добавлен в секцию uses.
211	208
212	209		Пакет Printer4Lazarus должен быть добавлен в зависимости Вашего проекта в IDE: Project\\|Project Inspector\\|Add\\|New Requirement\\|Package Name:
213	210
214	211		Если пакета Printer4Lazarus нет в списке пакетов, то Вам нобходимо установить его. Пакет является частью установки Lazarus и может быть найден по следующему пути: \[каталог установки lazarus\]\components\printers
215	212
216	213		Если Вы используете стандартный путь для установки Lazarus'а, то \[каталог установки larazus\] находится:
217	214
218	215		- Windows: c:\lazarus
219	216		- Linux: /usr/lib/lazarus
220	217
221	218		Данное решение также применимо, если Вы получаете исключения при использовании Printer.Printers
222	219
223	220		### Почему TForm.ClientWidth/ClientHeight - это то же самое, что и TForm.Width/Height?
224	221
225	222		TForm.Width/Height не включают границ окна, поскольку не существует способа получить размер этих границ на всех платформах. Без надёжного способа LCL будет перемещать формы по всему экрану или бесконечно изменять их размер.
226	223
227	224		В конечном итоге, когда появится надёжный способ получения размера и позиции окна вместе с его границами для всех платформ, это будет изменено. Для сохранения совместимости со старыми LCL-формами, будет введён номер версии и использованы некоторые другие дополнительные методы.
228	225
229	226		## Отладка
230	227
231	228		### Как увидеть отладочные сообщения?
232	229
233	230		В модуле LCLProc в LCL есть две процедуры для вывода отладочных сообщений. Они называются:
234	231
235	232		- DebugLn: которая работает также, как WriteLn, но принимает только строки.
236	233		- DbgOut: которая работает также, как Write, но принимает только строки.
237	234
238	235		В обычных условиях сообщения выводятся в stdout. Если stdout закрыт (например когда приложение {\$AppType Gui} или откомпилировано с ключом -WG под Windows), сообщения не выводятся никуда.
239	236
240	237		Отладочные сообщение могут также выводится в файл. Код инициализации модуля LCLProc проверяет командую строку Lazarus.exe's на предмет наличия ключа '--debug-log=\<file\>'. Если этот ключ присутствует - весь последующий отладочный вывод направляется в \<file\>.
241	238
242	239		Если этого ключа нет, проверяется существование системной переменной окружения xxx_debuglog, где xxx - имя файла программы без расширения. Для Lazarus это будет lazarus_debuglog. Если такая переменная окружения существует, файл указанный в ней будет использован для вывода отладочных сообщений. Пример: если вы сделаете:
243	240
244	241		`set lazarus_debuglog=c:\lazarus\debug.txt`
245	242
246	243		то отладочные сообщения будут выводится в c:\lazarus\debug.txt.
247	244
248	245		Так как это реализовано в lclproc, любое приложение использующее lclproc может использовать этот механизм вывода отладочных сообщений.
249	246
250	247		Отладка Lazarus-а
251	248		Наиболее полезно для Windows: Если вы хотите выводить сообщения в консоль, добавьте {\$APPTYPE console} в lazarus.pp ; После чего перекомпилируйте Lazarus.
252	249
253	250		### Как мне просмотреть значение свойств?
254	251
255	252		Вам нужно использовать самую последнюю версию FPC из исходников (2.5.1) или релиз 2.4.0. Любая версия позднее указанных, так же подойдёт.
256	253
257	254		Если Вы скомпилируете приложение, использую ключ -gw (отладочная информация dwarf), Вы сможете просмотреть значения свойств.
258	255
259	256		Внимание: это возможно, только для тех свойст, которые напрямую связан с членом класса, директива "read" указывает на переменную, а не метод.
260	257
261	258		Если свойство возвращает значение через функцию, то достаточно опасно проверять её значение. Риск заключается в том, что для проверки её значения требуется вызвать процедуру или функцию, что может привести к изменению других значений и/или данных. А это значит, что данные изменились в режиме отладки, и дальнейшее исполнение программы, будет отличаться от работы без отладчика.
262	259
263	260		Проверка свойства по результату функции (как описана выше), ещё не реализована.
264	261
265	262		### Почему отладчик не показывает некоторые переменные или структуры (выдавая ошибки "no such symbol"/"incomplete type")
266	263
267	264		Для решения проблем с: - свойствами\
268	265		\- динамическими массивами\
269	266		\- переменными во вложенных процедурах\
270	267		\- "no such symbol in context"\
271	268		\- "incomplete type"\
272	269		смотри здесь [[GDB Debugger Tips]]
273	270
274	271		### Как я могу проводить отладку компонентов и пакетов FCL с помощью Lazarus
275	272
276	273		Компоненты и классы FCL скомпилированны по умолчанию без отладночной информации. Как результат - gdb не моэет получить доступ к методам и свойствам этих объектов. Для пересборки компонентов FCL необходимо включить ключ компилятора "-gl" для генерации отладочной информации.
277	274
278	275		Этот пример предпологает, что у вас Linux дистрибутив с установленным FPC в папке /usr/local/ и вам необходимо включить отладочную информацию для пакета fcl-db. По аналогии с пакетом fcl-db, используемом в данном примере, вы можете применить эти команды для ЛЮБЫХ пакетов, содержащихся в дистрибутиве.
279	276
280	277		В начале, вам необходимо найти путь к установленному FPC проверив ваш конфигурационный файл FPC. Это файл (fpc.cfg) расположен /etc/fpc.cfg. Просмотрите содержимое fpc.cfg определить папку установки. Обратите внимание на строки, начинающиеся с -Fu в fpc.cfg:
281	278
282	279		`-Fu/usr/local/lib/fpc/$fpcversion/units/$fpctarget/*`
283	280
284	281		При создании скрипта для установки модулей в папку INSTALL_PATH/lib/fpc/\$fpcversion/units/\$fpctarget/, вы должны быть уверены, что /usr/local это путь установки FPC, и он должен быть присвоем INSTALL_PREFIX, в противном случае Make-скрипт установи модули в неправильную папку или вообще завершится с ошибкой.
285	282
286	283		Step 1: Открыть терминал и набрать терминале\
287	284		Step 2: cd /user/local/share/src/fpc-2.3.1/fpc/fcl-db/\
288	285		Step 3: sudo make clean all install INSTALL_PREFIX=/usr/local OPT=-gl\
289	286		Замечание: Параметр INSTALL_PREFIX правильно указан для установки модулей. В примере ниже /usr/local - это путь по умолчанию для fpc в Linux, но он может сильно отличаться в других операционных системах
290	287
291	288		`make clean all install INSTALL_PREFIX=/usr/local OPT=-gl`
292	289
293	290		В конце, после пересборки любого FCL пакета, вам возможно необходимо будет пересобрать LCL.
294	291
295	292		## Contributing / Making Changes to Lazarus
296	293
297	294		### Я создал патч для пристыковки окна сообщений IDE к окну "Редактор исходного кода" (снизу)
298	295
299	296		Такие патчи не будут приняты, так как они реализуют лишь малую часть требуемой функциональности стыковки (docking). Цель состоит в создании полноценного менеджера стыковки и его использовании. Полноценный менеджер стыковки(dock manager) может соединять все окна и позволяет пользователю определять, как их стыковать (должно ли окно сообщений быть над или под окном кода ... или вообще быть отделено от него). К примеру:
300	297
301	298		+-------------------++--+
302	299		\|menu \|\| \|
303	300		+-------------------+\| \|
304	301		+--++---------------+\| \|
305	302		\|PI\|\| Source Editor \|\|CE\|
306	303		+--+\| \|\| \|
307	304		+--+\| \|\| \|
308	305		\| \|+---------------++--+
309	306		\|OI\|+-------------------+
310	307		\| \|\|messages \|
311	308		+--++-------------------+
312	309
313	310		Менеджер стыковки может сохранить это расположение и восстановить его при следующем старте. Предпочтительно, если менеджер может работать не только с окнами, но и со страницами редактора кода. Менеджер стыковки не требует использования drag&drop. Все патчи реализующие стыковку без менеджера стыковки усложняют реализацию настоящего менеджера стыковки и потому будут отклонены.
314	311
315	312		В качестве временного решения можно использовать это расширение IDE: [[Manual Docker]]
316	313
317	314		### Я исправил/улучшил Lazarus. Как добавить мои изменения в официальный код Lazarus?
318	315
319	316		Создайте патч и пришлите его разработчикам. Более подробную информацию смотрите здесь [[Creating A Patch/ru]].
320	317
321	318		### How can I become a Lazarus developer and access management in the SVN and bug-tracker?
322	319
323	320		First of all: you must learn about Lazarus, to prove your knowledge and skill. Start by reading the [[Lazarus Documentation\|wiki articles]], read the Lazarus source code, giving a look at the [Lazarus Bug-Tracker](http://www.lazarus.freepascal.org/mantis), fix some bugs, and if you think you are ready, contact the developers on the [mailing list](http://www.mail-archive.com/lazarus@miraclec.com).
324	321
325	322		## Где объявлены ...
326	323
327	324		### Константы виртуальных клавиш
328	325
329		-	~~Константы виртуальных клавиш (VK_UP, VK_ESCAPE и т.д ) объявлены в [[doc:lcl/lcltype\|LCLType]]. Добавьте LCLtype в <b>uses</b> секцию.~~
	326	+	Константы виртуальных клавиш (VK_UP, VK_ESCAPE и т.д ) объявлены в [[doc:lcl/lcltype\|LCLType]]. Добавьте LCLtype в uses секцию.
330	327
331	328		## Использование среды разработки
332	329
333	330		### Как я могу использовать "завершение идентификаторов"?
334	331
335	332		Чтобы вызвать окно завершения идентификатора нажмите \[ctrl\]\[space\] (по умолчанию для Windows и Linux).
336	333
337	334		Вы можете настроить автоматическое появление этого окошка в пункте меню Окружение-\>Редактор-\>Code Tools-\>Автоматические функции
338	335
339	336		## Linux
340	337
341	338		### Как выполнить отладку в Linux без IDE?
342	339
343	340		Прежде всего потребуется отладчик. gdb это стандартный отладчик под линукс, имеющий несколько GUI-интерфейсов. Наиболее распространённый интерфейс - ddd - является частью большинства популярных дистрибутивов. Для компиляции lazarus/lcl с информацией для отладчика вам нужно использовать следующие команды для запуска отладочной сессии:
344	341
345	342		` $ make clean; make OPT=-dDEBUG`\
346	343		` $ ddd lazarus`
347	344
348	345		Однако, следует отметить что ddd не такой удобный как например отладчик Lazarus. Особенно если он используется для просмотра значений имеющихся переменных, учитывая что ddd/gdb регистрозависимы, а Pascal - регистронезависим. Поэтому, чтобы видеть значения переменных, необходимо набирать их имена в верхнем регистре. Для получения более подробной информации обратитесь к fpc-manuals.
349	346
350	347		### I can debug now but ddd does not find my sources or complains that they contain no code. Whats that?
351	348
352	349		This is a path-related problem with either gdb or ddd. You can avoid this by
353	350
354	351		- Use the "Change directory" command from the ddd menu and choose the directory where the sources are located. The drawback of this method is that you now can't use the source of the program you started with (e.g. lazarus). Thus it may be neccessary to change the directory multiple times.
355	352		- In ddd goto \[Edit\] \[gdb-settings\] and set the search-path
356	353		- Create a \$(HOME)/.gdbinit file like:
357	354
358	355		` directory /your/path/to/lazarus`\
359	356		` directory /your/path/to/lazarus/lcl`\
360	357		` directory /your/path/to/lazarus/lcl/include`
361	358
362	359		### I receive an error during the linking that states /usr/bin/ld can't find -l\<some lib\>
363	360
364	361		Package Based Distributions
365	362		You need to install the package that provides the lib\<somelib\>.so or lib\<somelib\>.a files. Dynamic libs under linux have the extension .so, while static libs have the extension .a. On some Linux distro's you have installed the package (rpm, deb) \<packagename\> which provides \<some lib\>, but you also need the development package (rpm, deb), normally called \<packagename\>-dev, which contains the .a (static lib) and/or the .so (dynamic lib).
366	363
367	364		Some distributions have commands to find which package contains a file:
368	365
369	366		Mandriva
370	367
371	368		`[]$ urpmf lib<somelib>.so`
372	369
373	370
374	371		will list all packages containing the file named lib\<somelib\>.so, you'll have to install those ending in -devel
375	372
376	373
377	374		Debian
378	375
379	376
380	377		install the apt-file utility (apt-get install apt-file) then
381	378
382	379		`[]$ apt-file search lib<somelib>.so`
383	380
384	381
385	382		will list all packages containing the file named lib\<somelib\>.so, you'll have to install those ending in -dev
386	383
387	384		Source Based Distributions and Manual Compilation (LFS)
388	385		Make sure that there is a lib\<somelib\>.a in the path, and that it contains the right version. To let the linker find the dynamic library, create a symlink called lib\<some lib\>.so to lib\<some lib\>\<version\>-x,y.so if necessary (and/or for static lib; lib\<some lib\>.a to lib\<some lib\>\<version\>-x,y.a).
389	386
390	387		FreeBSD
391	388		As source based distro's, and also make sure you have -Fl/usr/local/lib in your fpc.cfg and/or Lazarus library path. Keep in mind that GTK1.2 has "gtk12" as package name under FreeBSD. (same for glib) NOTE: This has changed as of late. Newest ports have gtk-12 and glib-12 as well. You might stumble on this problem, since FPC requires the "-less" ones, you will need to symlink them like this:
392	389
393	390		`[]# cd /usr/local/lib && ln -s libglib-12.so libglib12.so`\
394	391		`[]# cd /usr/X11R6/lib && ln -s libgtk-12.so libgtk12.so`\
395	392		`[]# cd /usr/X11R6/lib && ln -s libgdk-12.so libgdk12.so`
396	393
397	394		NetBSD
398	395		As source based distro's, and also make sure you have -Fl/usr/pkg/lib in your fpc.cfg and/or Lazarus library path
399	396
400	397		### How can I convert a kylix 2 project into a lazarus project?
401	398
402	399		Nearly the same way as converting a Kylix project into a Delphi/VCL project.
403	400
404	401		The LCL (Lazarus Component Library) tries to be compatible to Delphi's VCL. Kylix's CLX tries to be QT compatible. Here are some general hints:
405	402
406	403		- Rename all used CLX Q-units like QForms, QControls, QGraphics, ... into their VCL counterparts: Forms, Controls, Graphics, ...
407	404		- Add LResources to the uses section of every form source
408	405		- Rename or copy all .xfm files to .lfm files.
409	406		- Rename or copy .dpr file to .lpr file.
410	407		- Add "Interfaces" to the uses section in the .lpr file.
411	408		- Remove {\$R *.res} directive
412	409		- Remove {\$R *.xfm} directive
413	410		- Add {\$mode objfpc}{\$H+} or {\$mode delphi}{\$H+} directive to .pas and .lpr files
414	411		- Add an initialization section to the end of each form source and add an include directive for the .lrs file (lazarus resource file):
415	412
416	413		` initialization`\
417	414		` {$I unit1.lrs}`
418	415
419	416
420	417		The .lrs files can be created via the lazres tool in: (lazarusdir)/tools/lazres.
421	418
422	419		For example: ./lazres unit1.lrs unit1.lfm
423	420
424	421		- Fix the differences. The LCL does not yet support every property of the VCL and the CLX is not fully VCL compatible.
425	422
426	423		- To make it more platform independant, reduce unit libc (which is deprecated) references and substitute with native FPC units like baseunix/unix as much as possible. This will be necessary to support other targets than linux/x86 (including OS X, FreeBSD and Linux/x86_64)
427	424
428	425		### When compiling lazarus the compiler can not find a unit. e.g.: gtkint.pp(17,16) Fatal: Can't find unit GLIB
429	426
430	427		1\. Check a clean rebuild: do a 'make clean all'
431	428
432	429		2\. Check if the compiler has the correct version (2.0.4 or higher)
433	430
434	431		3\. Check if the compiler is using the right config file. The normal installation creates /etc/fpc.cfg. But fpc also searches for ~/.ppc386.cfg, ~/.fpc.cfg, /etc/ppc386.cfg and it uses only the first it finds.
435	432
436	433
437	434		Hint: You can see which config file is used with 'ppc386 -vt bogus'
438	435
439	436		Remove any ppc386.cfg as it is really obsolete.
440	437
441	438		4\. Check if the config file (/etc/fpc.cfg) contains the right paths to your fpc libs. There must be three lines like this:
442	439
443	440		` -Fu/usr/lib/fpc/$fpcversion/units/$fpctarget`\
444	441		` -Fu/usr/lib/fpc/$fpcversion/units/$fpctarget/rtl`\
445	442		` -Fu/usr/lib/fpc/$fpcversion/units/$fpctarget/*`
446	443
447	444
448	445		The first part of these paths (/usr/lib/fpc) depends on your system. On some systems this can be for example /usr/local/lib/fpc/... .
449	446
450	447		Hint: You can see your searchpaths with 'ppc386 -vt bogus'
451	448
452	449		5\. Check that the config file (/etc/fpc.cfg) does not contain search paths to the lcl source files (.pp, .pas):
453	450
454	451		` forbidden: -Fu(lazarus_source_directory)/lcl`\
455	452		` forbidden: -Fu(lazarus_source_directory)/lcl/interfaces/gtk`
456	453
457	454
458	455		If you want to add the lcl for all your fpc projects, make sure that the two paths look like the following and are placed after the above fpc lib paths:
459	456
460	457		` -Fu(lazarus_source_directory)/lcl/units/$fpctarget`\
461	458		` -Fu(lazarus_source_directory)/lcl/units/$fpctarget/gtk`
462	459
463	460		6\. Check if the missing unit (glib.ppu) exists in your fpc lib directory. For example the gtk.ppu can be found in /usr/lib/fpc/\$fpcversion/units/i386-linux/gtk/. If it does not exists, the fpc lib is corrupt and should be reinstalled.
464	461
465	462		7\. Check if the sources are in a NFS mounted directory. In some cases the NFS updates created files incorrectly. Please, try to move the sources into a non NFS directory and compile there.
466	463
467	464		8\. If you are still not succeeded try to use samplecfg script as follows:
468	465
469	466		\# cd /usr/lib/fpc/version/
470	467
471	468		\# sudo ./samplecfg /usr/lib/fpc/\\\$version /etc
472	469
473	470		Note! Do not put - / - after etc because if you do that the system will create a file - /etc/fpc.cfg/fpc.cfg. In fact we want that samplecfg make a file - /etc/fpc.cfg - not the folder /etc/fpc.cfg.
474	471
475	472		### I have installed the binary version, but when compiling a simple project, lazarus gives: Fatal: Can't find unit CONTROLS
476	473
477	474		Probably you are using a newer fpc package, than that used for building the lazarus binaries. The best solution is to download the sources and compile lazarus manually. You can download the source snapshot or get the source via svn:
478	475
479	476		` $ bash`\
480	477		` $ svn checkout `[`http://svn.freepascal.org/svn/lazarus/trunk`](http://svn.freepascal.org/svn/lazarus/trunk)` lazarus`\
481	478		` $ cd lazarus`\
482	479		` $ make clean all`
483	480
484	481		Make sure that lazarus get the new source directory: Environment-\>General Options-\>Files-\>Lazarus Directory Top
485	482
486	483		### Lazarus компилируется, но компоновка прерывается с ошибкой: libgdk-pixbuf not found
487	484
488	485		Для решения проблемы нужно установить библиотеку gdk-pixbuf library для gtk1.x:
489	486
490	487		Библиотека gdk-pixbuf может быть найдена:
491	488
492	489		RPM пакет: <http://rpmfind.net/linux/rpm2html/search.php?query=gdk-pixbuf&submit=Search+>...&system=&arch=
493	490
494	491		Debian пакет: libgdk-pixbuf-dev
495	492
496	493		Исходники: <ftp://ftp.gnome.org/pub/gnome/unstable/sources/gdk-pixbuf/>
497	494
498	495		Ubuntu 8.10:
499	496
500	497		Если вы собираете Lazarus с GTK 2.0 вы можете получить ошибку "libgdk-pixbuf2.0 not found" . Для решения проблемы просто установите пакет libgtk2.0-dev, используя команду apt следующим образом (используйте sudo при необходимости):
501	498
502	499		`apt-get install libgtk2.0-dev`
503	500
504	501		### Я использую SuSE, при компиляции получаю ошибку: "/usr/bin/ld: cannot find -lgtk Error: Error while linking"
505	502
506	503		Ранние версии SuSE (до SuSE 11) устанавливали gtk библиотеки devel в директорию /opt/gnome/lib (или /opt/gnome/lib64 для 64-й версии), что не является общепринятым путём для библиотек.
507	504
508	505		Для решения проблемы, вы можете добавить этот путь библиотеки в конфигурационный файл FPC (/etc/fpc.cfg), следующей строкой:
509	506
510	507		`-Fl/opt/gnome/lib.`
511	508
512	509		### Лазарус после установки компонента падает с ошибкой runtime error 211
513	510
514	511		После установки компонента Лазарус падает со следующей ошибкой:
515	512
516	513		`Threading has been used before cthreads was initialized.`\
517	514		`Make cthreads one of the first units in your uses clause.`\
518	515		`Runtime error 211 at $0066E188`
519	516
520	517		Как это исправить?
521	518
522	519		Установленный компонент использует потоки. FPC не включает поддержку многопоточности автоматически на *nix системах, по-этому её необходимо включать вручную. Её включение происходит использованием модуля cthreads. Любое приложение, использующее такой компонент должна использовать этот модуль, причём он должен быть первым подключаемым модулем в программе. Лазарус так же не является исключением.
523	520
524	521		Подключить модуль cthreads можно двумя способами:
525	522
526	523		1\) Откройте пакет. В редакторе пакетов нажмите на Параметры (Options). Во вкладке Использование (Usage) добавьте настройкуПользовательские (custom) и запишите -dUseCThreads. Пересоберите Лазарус. В этом случае модуль cthreads подключиться автоматически для unix систем.
527	524
528	525		2\) Чтобы не изменять пакет, можно добавить директиву компиляци при сборке самого Лазаруса. Откройте меню Сервис(Tools)-\>Параметры сборки Lazarus(Configure "build Lazarus)". В диалоге Параметры "Cборки Lazarus"("build Lazarus") в поле "Параметры:"("Options:") впишите -Facthreads и нажмите кнопку "OK". После этого добавьте пакет и пересоберите среду.
529	526
530	527		Совет: Предыдущая копия Лазаруса (исполнительный файл, который при запуске на выдавал ошибку), скорее всего, находится в той же папке что и текущая версия, но с расширением .old.
531	528
532	529		См.также:[[Multithreaded Application Tutorial/ru\|Модули, необходимые для мультипоточных приложений]]
533	530
534	531		### Когда я запускаю программу, использующую потоки (threads), я получаю сообщение об ошибке "runtime error 232"
535	532
536	533		Полное сообщение выглядит так:
537	534
538	535		`This binary has no thread support compiled in.`\
539	536		`Recompile the application with a thread-driver in the program uses`\
540	537		`clause before other units using thread.`\
541	538		`Runtime error 232`
542	539
543	540		Решение: Добавьте модуль cthreads в секцию uses главного модуля вашей программы (обычно это .lpr-файл).
544	541
545	542		### У меня Ubuntu Breezy/Mandriva KDE3 и шрифты в Lazarus IDE выглядят слишком большими
546	543
547	544		Попробуйте следующее: Создайте файл с именем «.gtkrc.mine» в домашней директории (если он не существует) и внесите в него данный текст:
548	545
549	546		style "default-text" {
550	547		fontset = "--arial-medium-r-normal---100-----iso8859-1,\
551	548		--helvetica-medium-r-normal---100------"
552	549		}
553	550
554	551		class "GtkWidget" style "default-text"
555	552
556	553		Если это не сработает, попробуйте создать ссылку .gtkrc на .gtkrc.mine. Данный способ был опробован в Xubuntu 7.10 и Mandriva 2009.0 KDE3
557	554
558	555		Примечание: Если Lazarus был скомпилирован с использованием библиотеки Gtk1.2, то настройка шрифтов в Gtk2 не будет влиять на отображение текста в нём.
559	556
560	557		### Как подключать и использовать сторонние файлы ресурсов (*.rc) в GTK приложении?
561	558
562	559		Вариант 1. Переименуйте файл ресурсов (rc) мой_ресурс.rc в имя_программы.gtkrc и поместите в папку с исполняемым файлом программы.
563	560
564	561		Вариант 2. Подключите модуль GtkInt в секцию uses исходного кода проекта (*.lpr), и допишите код
565	562
566	563		``` pascal
567	564		{$IFDEF LCLGtk}
568	565		GTKWidgetSet.SetRCFilename('имя_вашего_файла_ресурса');
569	566		{$ENDIF LCLGtk}
570	567		```
571	568
572	569		перед вызовом Application.Initialize.
573	570
574	571		Вариант 3. Используя модуль gtk2 вызовите метод gtk_rc_parse('имя_файла_ресурса') а также gtk_rc_reparse_all.
575	572
576	573		### I have Ubuntu and I cannot compile for Gtk2 due to missing libraries
577	574
578	575		Ubuntu has a problem with not creating all the symbolic links that you'll need even when the libraries are installed. Make sure that all missing libraries when trying to link for Gtk2 have their appropriate links. For instance, you might need to do:
579	576
580	577		cd /usr/lib
581	578		sudo ln -s libgdk-x11-2.0.so.0 libgtk-x11-2.0.so
582	579
583	580		Make sure that the \[whatever\].so symbolic links are created and point to the actual libraries.
584	581
585	582		### How can I compile a program for Gtk2?
586	583
587	584		At the moment, the Gtk2 compiled IDE is a little unstable, but you can compile software for Gtk2 using the Gtk1 IDE.
588	585
589	586		To start with recompile LCL for Gtk2. Go to the menu "Tools"-\>"Configure Build Lazarus" and set LCL to clean+build and everything else to none.
590	587
591	588		Now click Ok and go to the menu "Tools"-\>"Build Lazarus"
592	589
593	590		Now you can compile your software with Gtk2 going on the Compiler options and changing the widgetset to Gtk2.
594	591
595	592		### I get this message: "\[WARNING\] ** Multibyte character encodings (like UTF8) are not supported at the moment."
596	593
597	594		Since revision 10535 (0.9.21) this message doesn't exist anymore. Previously it was used to warn that a UTF-8 encoding was used. The internal keyhandling routines for the gtk1 widgetset couldn't handle such encoding for keypresses, with the result that keypresses with for instance accented chars were not or wrong detected.
598	595
599	596		(original text for older versions of lazarus)\
600		-	<strike> This warning message indicates that your locale enconding is set to utf-8. If you are using Gtk 1 this can be a serious problem and prevent the correct working of Lazarus or software created with Lazarus.
	597	+	This warning message indicates that your locale enconding is set to utf-8. If you are using Gtk 1 this can be a serious problem and prevent the correct working of Lazarus or software created with Lazarus.
601	598
602	599		To work around this, just change your locale to a non utf-8 before executing the program on the command line, like this:
603	600
604	601		export LC_CTYPE="pt_BR"
605	602		export LANG="pt_BR"
606	603		export LANGUAGE="pt_BR"
607	604		./lazarus
608	605
609		-	~~Substitute pt_BR with the locale for your country. You can create a script to automate this. </strike>~~
	606	+	Substitute pt_BR with the locale for your country. You can create a script to automate this.
610	607
611	608		## Windows
612	609
613	610		### When I cycle the compiler, I get:The name specified is not recognized as an internal or external command, operable program or batch file.\>& was unexpected at this time.
614	611
615	612		In the compiler directory there is an OS2 scriptfile named make.cmd. Different versions of Windows also see this as a script file, so remove it since what is needed for OS2 becomes a hindrance on Windows.
616	613
617	614		### When I cycle the compiler, I get: make\[3\]: ./ppc1.exe: Command not found
618	615
619	616		I don't know why but somehow make has lost its path. Try to cycle with a basedir set like: make cycle BASEDIR=your_fpc_source_dir_herecompiler
620	617
621	618		### When I try to make Lazarus I get:
622	619
623	620		#### make.exe: * * * interfaces: No such file or directory (ENOENT). Stop.make.exe: * * * \[interfaces_all\] Error 2
624	621
625	622		You need to upgrade your make.
626	623
627	624		#### makefile:27: *** You need the GNU utils package to use this Makefile. Stop.
628	625
629	626		Make sure you didn't install FPC in a path with spaces in the name. The Makefile doesn't support it.
630	627
631	628		### How can I give my program an XP look like lazarus has?
632	629
633	630		Project -\> Project Options -\> Check 'Use manifest to enables themes'.
634	631
635	632		### Когда я запускаю Windows программу, созданную в Lazarus-е, открывается консольное (DOS) окно
636	633
637	634		Укажите параметр -WG (Windows графическое приложение) в командной строке компилятора или установите флажок
638	635
639	636		`Проект->Опции проекта->Параметры компилятора -> Связывание -> Графическое приложение Win32 `
640	637
641	638		англ:
642	639
643	640		`Project->Project Options-> Compiler Options -> Linking -> Win32 GUI application.`
644	641
645	642		## Mac OS X
646	643
647	644		### Why does compiling a project fail with 'unknown section attribute: no_dead_strip'?
648	645
649	646		Dead code stripping is not supported by the assembler and linker before Xcode 1.5 (available for Mac OS X 10.3.9). Disable the compiler options
650	647
651	648		- Code \> Unit style \> Smart linkable (-CX)
652	649		- and Linking \> Link Style \> Link smart (-XX)
653	650
654	651		## Лицензирование
655	652
656	653		### Могу ли я создавать коммерческие приложения, используя Lazarus?
657	654
658	655		Да, библиотека LCL разрабатывается под лицензией LGPL, что позволяет использовать её без открытия кода вашего приложения. Однако, модификации и расширения LCL должны распространяться с исходным кодом. Сам Lazarus, как IDE, использует лицензию GPL. Отметим, что LCL - это код, содержащийся в файлах из каталога "lcl", прочий код не подпадает под действие указанной лицензии.
659	656
660	657		### Могу ли использовать в коммерческих приложениях дополнительные компоненты Lazarus?
661	658
662	659		В составе Lazarus есть дополнительные компоненты, разработанные участниками сообщества. Некоторые из этих компонентов распространяются под лицензиями, отличными от лицензии самого Lazarus. Если вы используете такие компоненты, вы должны уточнить их лицензию. Обычно необходимое пояснение приводится в исходном коде файлов соответствующего пакета. Большинство дополнительных компонентов от сторонних разработчиков можно найти в подкаталоге "components" основного каталога Lazarus.
663	660
664	661		### Как я могу узнать, что компонент является частью LCL?
665	662
666	663		Все модули LCL размещаются в подкаталоге "lcl". Также доступен [список модулей](http://lazarus-ccr.sourceforge.net/docs/lcl/), входящих в LCL. Если в вашем коде вызываются модули, которых нет в этом списке, вероятно, вы используете компонент, не являющийся частью LCL.
667	664
668	665		### Могу ли я создавать коммерческие плагины для Lazarus?
669	666
670	667		Да, the IDEIntf part of the IDE is licensed under the LGPL with the same exception, so that shared data structures in this part will not force you to license your plug-in or design-time package under the GPL. You are free to choose a plug-in of any license; we don't want to limit your choice. Therefore non-GPL compatible plug-ins are allowed. Note that it's not allowed to distribute a precompiled Lazarus with these non-GPL-compatible plugins included statically; however, we do not see this as a severe limitation, since recompiling Lazarus is easy.
671	668
672	669		---
673	670		From the Free Pascal wiki, page "Lazarus Faq/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