IDE Window: Compiler Options/ru: what changed

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

Old	New		Line
1	1		## Пути (Paths)
2	2
3	3		![](/wiki-images/2/21/CompilerOptions-Paths.png)
4	4
5	5		- Относительные пути дополняются путём от файла проекта или каталога пакета (где расположен файл .lpi/.lpk).
6	6		- Эти пути добавляются в пути поиска. Они не заменяют существующие пути.
7	7		- В среде IDE есть один набор путей поиска для каждого пакета / проекта. Это означает, что пакет может иметь пути поиска, отличные от активного проекта.\
8	8		«Набор путей поиска» относится к пути поиска объекта, включает в себя путь поиска, путь поиска источников, ...
9	9		- Если пакет или проект использует другие пакеты, со своими путями поиска. То эти "унаследованные" пути можно найти на закладке #Унаследованные (Inherited).
10	10		- Если вы не хотите использовать путь поиска, унаследованные от используемого пакета, вы должны изменить параметры компилятора используемого пакета.
11	11		- Пользуясь системой пакетов Lazarus вам практически не придётся устанавливать пути поиска вручную.
12	12		- Компилятор FreePascal имеет собственный файл настроек (по умолчанию /etc/fpc.cfg) который определяет набор путей поиска модулей. Например для нахождения модулей FPC из RTL или FCL вроде 'classes', 'sysutils'. Не добавляйте туда пути поиска к исходным файлам (.pas, .inc).
13	13		- Пути поиска разделяются точкой с запятой ';'.
14	14		- Начальные и конечные пробельные символы игнорируются и автоматически убираются IDE. IDE нормализует пути поиска и добавляет разделитель пути (windows: /, все остальные: \\). Пути каталога автоматически конвертируются в формат подходящий текущей операционной системе при открытии файла проекта .lpi или .lpk.
15	15		- Вы можете использовать макросы. Например \$(TargetCPU). Подробнее смотрите [[IDE Macros in paths and filenames]].
16	16		- В среде IDE есть один набор настроек путей для каждого каталога:
17	17		- Каждый каталог в пути поиска модуля проекта получает все пути поиска проекта.
18	18		- Каждый каталог в пути поиска модуля пакета получает все пути поиска пакета.
19	19		- Другие каталоги получают пути поиска проекта. Если путь поиска проекта содержит '.', каталог также увидит каталог проекта.
20	20		- Использование "uses unitname in 'filename'" не влияет на любой путь поиска.
21	21
22	22		### Другие модули (Other Unit Files)
23	23
24	24		Это пути поиска для модулей паскаля (.ppu, .pp, .pas, .p) вашего проекта или пакета. Посмотрите заголовок окна, чтобы узнать какого. Этот путь будет передан компилятору FreePascal, который добавит их к своим Unit Path.
25	25
26	26		- Добавляя и убирая модули из проекта/пакета, IDE спросит вас о необходимости изменить пути поиска.
27	27		- Этот путь содержит каталоги вашего проекта (или вашего пакета), который содержит файлы .pas, .pp или .p.
28	28		- Если вы хотите использовать одни и те же модули между разными проектами, создайте пакет для них. Это просто.
29	29
30	30		> Note: Не добавляйте каталоги использованный пакетов в этот путь. Это повлечёт за собой то, что FPC скомпилирует файлы .ppu включенного пакета и поместит их в ваш каталог проекта. Вы столкнётесь с множественными версиями .ppu и получите странные 'Can not find unit' ошибки.\
31	31		> Например: не добавляйте никакие FPC или LCL каталоги исходников в этот путь.
32	32
33	33		### Включаемые файлы (Include Files)
34	34
35	35		Это путь поиска для включаемый файлов (таких как файлы .inc, .lrs). Этот путь передаётся компилятору FreePascal Compiler, который добавляет их к своим путям поиска Включаемых файлов (Include Path), которые используются в директивах включения вроде {\$I filename.inc} или {\$INCLUDE filename.inc}.
36	36
37	37		### Другие исходные коды (Other sources)
38	38
39	39		Это пути поиска для модулей исходного кода паскаль, которые используются только IDE, но не компилятором.
40	40
41	41		Например: У вас имеется каталог с исходниками и каталог с соответствующими файлами .ppu. Вы добавляете каталог с .ppu в пути 'Другие модули (Other Unit Files)' а каталог с .pas в 'Другие исходные коды (Other sources)'. Таким образом компилятор будет использовать файлы .ppu и не будет пытаться компилировать их каждый раз. В то же самое время, IDE найдёт файлы с исходниками и будет работать функция Найти объявление (Find Declaration).
42	42
43	43		### Библиотеки (Libraries)
44	44
45	45		Это пути поиска для библиотек (файлов .dll или .so или .a).
46	46
47	47		### Каталог вывода модулей (Unit output directory)
48	48
49	49		Это каталог в который компилятор будет выводить файлы компиляции вроде .ppu, .o, .rst файлов (он передает это переключателю компилятора -FU). Если вы используете директиву \$R для файлов lfm, она также скопирует туда файлы lfm.
50	50
51	51		Популярным примером использования является выходной каталог с именем units, а затем дополнительный подкаталог для целевого CPU и целевой OS. Например:
52	52
53		-	~~` units/$(TargetCPU)-$(TargetOS)`~~
	53	+	```text
	54	+	units/$(TargetCPU)-$(TargetOS)
	55	+	```
54	56
55	57		Примечание:
56	58
57	59		- Если выходной каталог модуля пуст, Lazarus не 'передаст переключатель -FU компилятору. Затем компилятор будет использовать переключатель -FE. См.[[IDE Window: Project Options\|Project target file]]
58	60		- Пакеты обычно наследуют свой выходной каталог другим пакетам с помощью параметров 'usage'. Вам не нужно добавлять пути к пакетам вручную в ваш проект.
59	61		- Если выходной каталог пакета пуст, макрос \$(PkgOutDir) также \[будет пустым\] и не будет наследоваться для нисходящих пакетов и проектов. Используйте точку ".", чтобы определить текущий каталог.
60	62
61	63		### Имя целевого файла
62	64
63	65		> Note: только проекты имеют это. Эта опция недоступна для пакетов.
64	66
65	67		Установите здесь имя файла сгенерированного исполняемого файла. Если файл является относительным, он будет расширен каталогом проекта (где находится файл .lpi). Если файл не указан, исполняемый файл помещается в выходной каталог модуля и имеет имя основного исходного файла (обычно файла .lpr) без расширения. Если расширение не указано, добавляется расширение по умолчанию для платформы (например, «.exe» для MS Windows, но не для других). Когда новый проект еще не был сохранен и собран, среда IDE сохраняет файлы в тестовом каталоге. Относительные файлы затем относятся к этому каталогу.
66	68
67	69		Lazarus передает переключатель компилятора
68	70
69	71		- -o определяет имя целевого файла.
70	72		- -FE если имя целевого файла отсутствует в каталоге проекта (где находится файл lpi)
71	73		- -FU если выходной каталог устройства не пуст
72	74
73	75		Если имя целевого файла находится в другом каталоге (не в каталоге файла .lpi), Lazarus передаст компилятору ключ -FE, чтобы убедиться, что вторичные файлы, такие как .o и .rst помещаются в один и тот же каталог. Если вы очистили unit output directory(каталог вывода модуля), то среда IDE не передаст переключатель -FU, и компилятор сгенерирует файлы .ppu/.o для модулей тоже в целевом каталоге.
74	76
75	77		Если вы очистили unit output directory(каталог вывода модуля) и целевой файл проекта находится в каталоге проекта, то ни -FU ни -FE не передается компилятору, и компилятор будет работать с Delphi-совместимым файлом и генерировать файл «.ppu/.o» для каждого модуля в том же каталоге, что и модуль.
76	78
77	79		#### Применение конвенций
78	80
79	81		Включите это, чтобы применить различные соглашения об именах в зависимости от целевой платформы.
80	82
81	83		- Windows: Если это программа, она добавляет расширение .exe; если это библиотека, к ней добавляется «.dll».
82	84		- Unix (например, Linux, BSD, Darwin/macOS): если это библиотека, то имя в нижнем регистре, и если имя не начинается с 'lib', оно предшествует 'lib'.
83	85		- Linux, BSD: Если это библиотека, то добавляется '.so'.
84	86		- Darwin/macOS: Если это библиотека, то добавляется '.dylib'.
85	87
86	88		### Examples
87	89
88	90		\| Каталог вывода модуля \| Имя целевого файла \| Сгенерированные варианты \| Примечание \|
89	91		\|----\|----\|----\|----\|
90	92		\| lib/\$(TargetCPU)-\$(TargetOS) \| пустой\\|\\|-FElib\x86_64-win64 -olib\x86_64-win64\project1.exe \| все выходные файлы помещаются в lib\x86_64-win64\ \| \|
91	93		\| lib \| foo\\|\\|-FUlib -FE. -ofoo.exe \| все выходные файлы модуля, такие как `ppu` и `o`, помещаются в lib\, выходные файлы программы помещаются в базовый каталог (где находится lpi) \| \|
92	94		\| lib \| foo/bar\\|\\|-FUlib -FEfoo -ofoo\bar.exe \| все выходные файлы модуля, такие как `ppu` и `o`, помещаются в lib\, выходные файлы программы помещаются в foo \| \|
93	95		\| пустой \| пустой\\|\\|-oproject1.exe \| файлы `ppu` помещаются в файлы .pas, например, src\unit1.pas создаст src\unit1.ppu \| \|
94	96		\| пустой \| foo\\|\\|-ofoo.exe \| файлы `ppu` помещаются в файлы .pas \| \|
95	97		\| пустой \| . (одна точка и применение соглашений отключены) \| \| файлы `ppu` помещаются в файлы .pas, выходной файл может быть любым, как определит по умолчанию компилятор \|
96	98
97	99		### Дополнения к путям отладчика (Debugger path addition)
98	100
99	101		Эти каталоги добавляются в пути поиска отладчика IDE, когда он ищет исходники (модули и файлы включения).
100	102
101	103		### Библиотека виджетов LCL (LCL widget type)
102	104
103	105		Это выбор используемого набора виджетов LCL. Обычно используется набор виджетов по умолчанию. Если вы хотите попробовать другой набор виджетов, просто выберите его.
104	106
105	107		- Набор виджетов по умолчанию - это набор виджетов для текущего проекта.
106	108		- Набор виджетов по умолчанию зависит от текущей операционной системы. Например: win32 для windows 2000.
107	109		- Вы не должны устанавливать набор виджетов для пакетов, поскольку проект не сможет этого изменить. Устанавливайте его для пакетов только если этот пакет может использоваться лишь с одним конкретным набором виджетов LCL.
108	110
109	111		## Настройка и целевая платформа (Config and Target)
110	112
111	113		![](/wiki-images/4/45/CompilerOptions-Config_and_Target.png)
112	114
113	115		## Режимы сборки (Build modes)
114	116
115	117		### Добавление, удаление, активация режимов сборки
116	118
117	119		Только проекты имеют режимы сборки. Пакет не имеет режимов сборки.
118	120
119	121		Режимы сборки позволяют определять sets of compiler options (наборы опций компилятора) и быстро переключаться между этими наборами. Например, вы можете определить mode (режим) для отладки, который компилирует ваш проект с проверкой диапазона, а ваш режим по умолчанию - нет.
120	122
121	123		> Note: Если вы хотите передать некоторые параметры в зависимости от платформы, например, передать некоторые дополнительные параметры компоновщика в macOS, пожалуйста, посмотрите на [[IDE Window: Compiler Options/ru\|макросы IDE]].
122	124
123	125		Как добраться до этого диалога: Project(Проект) / Project Options(Настройки проекта) / Compiler Options (Настройки компилятора). Убедитесь, что "Build Modes" (Режимы сборки) включены.
124	126
125	127		![](/wiki-images/2/2c/EditProjectBuildModes.png)
126	128
127	129		Нажмите кнопку «...» справа, чтобы добавить/удалить/переименовать режимы сборки:
128	130
129	131		![](/wiki-images/7/7b/ListOfBuildModes1.png)
130	132
131	133		Сетка содержит список режимов сборки с тремя столбцами.
132	134
133	135		Первый столбец показывает, какой режим в данный момент активен, он отмечен. Когда вы активируете другой режим, все страницы параметров компилятора будут загружать настройки нового режима, включая значения макросов на странице режимов сборки. Всегда активен только один режим, и вы можете редактировать свойства только одного режима за раз. Какой режим активен, он хранится в файле сеанса (lps). Режим по умолчанию - первый режим.
134	136
135	137		Если ваш проект хранит сеанс в отдельном файле lps (см. Project options(Параметры проекта) / Session(Сеанс работы) / Save session info in(Сохранять сведения о сеансе работы в)), вы можете сохранить дополнительные режимы в файле сеанса lps, чтобы у каждого разработчика был свой набор режимов. В этом случае второй столбец показывает, где хранится режим, в lpi или lps (в сеансе). Имейте в виду, что первый режим является режимом по умолчанию для проекта, поэтому он должен храниться в проекте, а не в файле сеанса.
136	138
137	139		Последний столбец - это название режима. Это произвольная строка, поэтому вы можете дать ей короткое имя или целое предложение.
138	140
139	141		- Кнопка плюс добавляет новый режим, дублируя текущий активный и активируя его.
140	142		- Кнопка минус удаляет текущий выбранный режим. Должен быть хотя бы один режим. Если вы удалите первый режим, который является режимом по умолчанию, второй режим автоматически становится режимом по умолчанию.
141	143		- The up, down buttons allows to reorder the modes.
142	144		- Кнопки вверх, вниз позволяют изменить порядок режимов.
143	145
144	146		Подсказка:: после того, как вы добавили другой режим сборки, в главной панели IDE появится новая кнопка для быстрого переключения текущего активного режима.
145	147
146	148		> Note: При открытии нового проекта со старой IDE (\<0.9.31) вы увидите только режим по умолчанию. Если вы сохраните проект со старой IDE, вы потеряете все остальные режимы, все макросы и условия.
147	149
148	150		Опция «Режимы сборки» существует с версии 0.9.31.
149	151
150	152		### Добавление режимов release(окончательный релиз) и debug(отладка)
151	153
152	154		Наиболее распространенной задачей для проектов будет добавление простых режимов сборки окончательного релиза(release) и отладки(debug). Не забывайте всегда использовать режим сборки debug(отладки), потому что отладка не будет работать в режиме сборки окончательного релиза, а затем использовать режим сборки окончательного релиза только в окончательной версии приложения.
153	155
154	156		1. Перейдите к Project(Проект) / Project Options(Параметры проекта) / Compiler Options(Параметры компилятора)
155	157		2. Включите "Build Modes"(Режимы сборки) вверху. Появится комбобокс для режимов сборки и кнопка редактирования.
156	158		3. Нажмите на кнопку с надписью «...», чтобы открыть диалог режимов сборки.
157	159		4. Нажмите на кнопку "Create Debug and Release modes"(Создать режимы отладочной и конечной сборки). Это добавит два режима сборки "Debug" and "Release".
158	160		5. Закройте диалоговое окно
159	161
160	162		![](/wiki-images/d/d8/BuildModesAddedDebugAndRelease1.png)
161	163
162	164		Каждый режим сборки представляет собой полный набор параметров компилятора. Вы можете легко переключаться между режимами сборки либо с помощью комбинированного списка в верхней части параметров проекта, либо на главной панели инструментов IDE с помощью кнопки со стрелкой справа от кнопки Compile(Скомпилировать).
163	165
164	166		![](/wiki-images/1/16/BuildModeSelectorInIDEToolBar1.png)
165	167
166	168		После того, как мы выберем режим сборки Debug, все конфигурации в диалоге параметров проекта будут привязаны к этому режиму сборки. Вот страница по умолчанию Debugging(Отладка) в режиме Debug:
167	169
168	170		![](/wiki-images/f/ff/BuildModeDebugPageDebugging.png)
169	171
170	172		Когда мы выбираем режим сборки Release, все конфигурации в диалоге параметров проекта будут привязаны к этому режиму сборки. Вот страница по умолчанию Debugging(Отладка) в режиме Release:
171	173
172	174		![](/wiki-images/2/2d/BuildModeReleasePageDebugging.png)
173	175
174	176		### Выбор активного режима сборки
175	177
176	178		Можно выбрать активный в настоящий момент режим сборки либо в диалоговом окне "Project Options"(Параметры проекта), либо в главном окне IDE, в специальной кнопке с выпадающим списком, который появится только в том случае, если проект имеет более одного режима сборки, как можно увидеть на этом скриншоте:
177	179
178	180		![](/wiki-images/6/6f/Selecting_Build_Mode_Main_IDE_Windows.png)
179	181
180	182		### Макросы проекта
181	183
182	184		См. [[IDE Window: Compiler Options/ru\|здесь]], чтобы добавить собственные макросы или переопределить макросы LCLWidgetType.
183	185
184	186		## Обработка (Parsing)
185	187
186	188		Смотрите [Free Pascal - Online documentation](http://www.freepascal.org/docs.html)
187	189
188	190		### Режим синтаксиса (Syntax mode)
189	191
190	192		Выберите режим по умолчанию. Если модуль не содержит директивы {\$mode somemode}, выбранный режим будет использоваться по умолчанию.
191	193
192	194		Смотрите [Free Pascal - Online documentation](http://www.freepascal.org/docs.html)
193	195
194	196		### Параметры синтаксиса (Syntax Options)
195	197
196	198		- Операторы в стиле C (C Style Operators) (*=, +=, /= and -=)
197	199		- Включить код Assert (Include Assertion Code)
198	200		- Разрешить LABEL и GOTO (Allow LABEL and GOTO)
199	201		- INLINE в стиле C++ (C++ Styled INLINE)
200	202		- Макросы в стиле C (C Style Macros (global))
201	203		- Конструктор должен быть init (деструктор должен быть done) (Constructor name must be init (destructor must be done))
202	204		- Ключевое слово Static в объектах (Static Keyword in Objects)
203	205		- Использовать строки Ansi (Use Ansi Strings)
204	206
205	207		### Стиль ассемблера (Assembler style)
206	208
207	209		- -Rdefault по умолчанию
208	210		- -Ratt AT&T
209	211		- -Rintel Intel
210	212
211	213		## Код (Code)
212	214
213	215		Смотри [Free Pascal - Online documentation](http://www.freepascal.org/docs.html)
214	216
215	217		## Связывание (Linking)
216	218
217	219		![](/wiki-images/e/e9/CompilerOptions-Compilation_and_Linking.png)
218	220
219	221		Для настройки отладки см. [[Debugger Setup/ru\|Настройки проекта]]
220	222
221	223		## Отладка(Debugging)
222	224
223	225		![](/wiki-images/3/3f/CompilerOptions-Debugging.png)
224	226
225	227		## Вывод(сообщения) (Verbosity (Messages))
226	228
227	229		![](/wiki-images/8/83/CompilerOptions-Verbosity.png)
228	230
229	231		Смотри [Free Pascal - Online documentation](http://www.freepascal.org/docs.html). Примечание: добавление большого количество сообщений сильно замедляет процесс компиляции даже если большинство сообщений будет спрятано в окне сообщений.
230	232
231	233		## Сообщения (Messages)
232	234
233	235		![](/wiki-images/7/74/CompilerOptions-Messages.png)
234	236
235	237		(Появилась в версии 0.9.27) Эта страница позволяет контролировать какие сообщения компилятор будет показывать в Notes, Hints и Warnings. Необходимо, чтобы компилятор FP поддерживал переключатель -m (версия 2.2.2 или выше).
236	238
237	239		Также возможно указать язык текста сообщений (файл должен быть в кодировке Utf-8), чтобы видеть сообщения компилятора переведёнными без необходимости модифицировать файл конфигурации компилятора fpc.cfg.
238	240
239	241		Пример перевода файла сообщений можно найти \${LazarusDir}/fpc/\${FPCTARGET}/msg, например C:\Lazarus\fpc\2.2.3\msg
240	242
241	243		## Пользовательские параметры
242	244
243	245		![](/wiki-images/2/25/CompilerOptions-Custom_Options.png)
244	246
245	247		Обычно вы определяете здесь некоторые параметры компилятора. Например, вы можете определить в режиме сборки что-то вроде
246	248
247	249		``` pascal
248	250		-dRELEASE
249	251		```
250	252
251	253		Затем в режиме сборки будет скомпилирован только код, окруженный {\$IFDEF RELEASE} {\$ENDIF}. Это можно использовать в качестве альтернативы системе Macro, особенно если вы "переехали" с Delphi.
252	254
253	255		Пробелы в начале и в конце удаляются. Разрывы строк заменяются пробелом перед передачей компилятору. Ведущий пробел добавляется автоматически.
254	256
255	257		Среда IDE заменяет макросы IDE в пользовательских параметрах и анализирует параметры. Флаги, такие как `-dRelease`, передаются в codetools, поэтому редактор исходного кода знает их немедленно.
256	258
257	259		> Warning: Не добавляйте параметры пути -Fu, -Fi, -Fl, -FU, -o. Вместо этого используйте поля на странице [[IDE Window: Compiler Options/ru\|Пути]]. Среда IDE игнорирует пути в пользовательских параметрах. Она не обновляет их при добавлении или удалении файлов или при открытии проекта на другом хосте.
258	260
259	261		## Дополнения и перекрытия
260	262
261	263		Страница «Дополнения и перекрытия» существует с 1.1.
262	264
263	265		### Обзор
264	266
265	267		Страница содержит матрицу вариантов сборки.
266	268
267	269		![](/wiki-images/c/cd/CompilerAdditionsAndOverrides1.png)
268	270
269	271		Параметры «Пользовательские параметры», «Каталог вывода» и «Макросы IDE» в любой цели можно включать и выключать отдельно для каждого режима сборки.
270	272
271	273		Таким образом, для каждой цели есть Матрица с включающимися флажками.
272	274
273	275		Вертикальные слова в заголовке показывают все режимы сборки, которые в настоящее время определены, и этим они обозначают столбец в матрицах.
274	276
275	277		Справа от каждой строки любой матрицы дается описание типа (например, «Пользовательский», «OutDir» или «Макрос IDE») и значение включаемой опции.
276	278
277	279		### Типы вариантов сборки
278	280
279	281		Вариант сборки может
280	282
281	283		- установить IDE macro(макрос IDE). Значение должно иметь вид MacroName:=Value. Например, LCLWidgetType:=qt. Вы можете использовать макросы IDE в значении, но не в имени.
282	284		- добавить некоторые пользовательские параметры компилятора через Custom (например, добавить -O3). Вам не нужен ведущий пробел. Это добавляется автоматически. См. примечания по [[IDE Window: Compiler Options/ru\|пользовательским параметрам]].
283	285		- переопределить выходной каталог (-FU) через OutDir. Обратите внимание, что при использовании относительного каталога, такого как lib/\$(TargetOS), добавляется рабочий каталог цели, а не каталог проекта. Например, когда опция переопределяет выходной каталог пакета SynEdit, тогда выходной каталог synedit изменяется на \<lazarusdir\>/components/synedit/lib/\$(TargetOS).
284	286
285	287		Вы можете создать новую опцию, нажав кнопку Add(Добавить) над матрицей. Вы можете изменить тип опции в любое время.
286	288
287	289		### Включение параметров сборки в режимах сборки
288	290
289	291		Опция может быть включена с режимами сборки проекта. Вы можете включить опцию только в одном режиме сборки или нескольких из них. Каждая опция сборки имеет строку в матрице, каждый режим сборки имеет столбец в матрице. Каждая комбинация имеет флажок. Параметры сборки применяются сверху вниз.
290	292
291	293		Обратите внимание, что включение параметров в режимах сборки сеанса (хранящихся в .lps) не изменяет файл lpi. Эта информация хранится в файле lps. Вот почему эти чекбоксы имеют желтый фон.
292	294
293	295		Текущий активный режим и параметры сборки имеют зеленый фон.
294	296
295	297		Когда вы переименовываете режим сборки, также переносятся включенные состояния опций lpi и lps. Включенные состояния параметров IDE не переносятся. Например, когда опция IDE включена для режима debug и вы переименовываете режим в Test, тогда опция IDE все еще включена для режима debug для других проектов.
296	298
297	299		### Место хранения настроек сборки
298	300
299	301		Настройка может быть сохранена в
300	302
301	303		- проекте (.lpi)
302	304		- сеансе работы проекта (.lps)
303	305		- или в конфигурации IDE (environmentmentoptions.xml) - тогда он доступен для всех проектов
304	306
305	307		Параметры сборки применяются сверху вниз. Это означает, что сначала параметры сохраняются в IDE, затем параметры сохраняются в .lpi и, наконец, параметры сохраняются в сеансе работы.
306	308
307	309		С помощью кнопок «Вверх» и «Вниз» над матрицей вы можете перемещать параметры сборки и целевые объекты в другие группы хранения.
308	310
309	311		> Note: Опция в конфигурации IDE для режима debug применяется кj всем проектам с этим режимом. Например, когда вы открываете сторонний проект с режимом сборки debug, опция будет применена и предупреждения не будет. Это может сломать проект.
310	312
311	313		### Цели параметров сборки
312	314
313	315		Параметры сборки могут быть применены к проекту и/или к одному или нескольким пакетам. Вы можете ограничить область действия параметров сборки, чтобы они применялись только к определенным целям (проектам, пакетам). Параметры сборки сгруппированы по Targets(Целям). Targets(Цели) не чувствительны к регистру и допускают звездочку "*" для любого количества произвольных символов и знак вопроса "?" за один произвольный символ. Вы можете исключить цели, добавив минус "-". Чтобы отредактировать цель, нажмите позади 'Targets:'.
314	316
315	317		Примеры целей:
316	318
317	319		- ****: Звездочка "" - значит подходит всем. Опция применяется к проекту и всем пакетам. Это по умолчанию.
318	320		- LCL,Lazutils: Применимо только к пакетам "LCL" и "LazUtils"
319	321		- *dsgn,-syneditdsgn: Применимо ко всем пакетам, оканчивающимся на "dsgn", исключая "syneditdsgn".
320	322		- \#project: Это соответствует самому проекту. Опция применяется только к проекту, а не к используемым пакетам.
321	323		- \#ide: Это соответствует IDE. Опция применяется только к IDE, а не к установленным пакетам.
322	324
323	325		Вы можете иметь любое количество целей. Вы можете создать новую цель с помощью кнопки Add(Добавить) над матрицей. Вы можете перемещать цели с помощью кнопок вверх и вниз в другие хранилища. Все параметры сборки целевой группы также перемещены.
324	326
325	327		![](/wiki-images/8/85/Targets_project_options.png)
326	328
327	329		### Цвета в матрице
328	330
329	331		- Зеленый: текущий активный режим и опции
330	332		- Желтый: сохраненные в сеансе работы без изменения lpi
331	333		- Красный: ошибка синтаксиса
332	334
333	335		### Примеры для дополнений и перекрытий
334	336
335	337		- Добавьте параметры компилятора к пакетам, не затрагивая lpk. Например, вы можете добавить проверку диапазона -Cr с помощью опции custom в разделе Targets: *.
336	338		- Измените каталог вывода пакетов без затрагиванияя lpk. Например, путем добавления OutDir в поле Targets: *.
337	339		- Определите макросы IDE только для некоторых пакетов или только для проекта. Например, скомпилируйте LCL с флагом -dQT_NATIVE_DIALOGS, добавьте новую цель Targets: LCL, а затем добавьте пользовательский параметр.
338	340		- Добавьте параметры компилятора ко всем проектам с режимом сборки «debug», путем добавления параметров в группу хранения IDE.
339	341		- Измените каталог вывода пакета(ов) для всех проектов с режимом сборки «релиз». Добавьте опцию сборки к опциям, хранящимся в IDE.
340	342		- Объедините вышеперечисленное с сессиями, и вы сможете изменять сторонние проекты и пакеты, не касаясь их.
341	343
342	344		#### Изменение LCLWidgetType в версии 1.1 и выше
343	345
344	346		Этот параметр доступен только тогда, когда проект использует пакет LCL
345	347
346	348		Перейдите в Project(Проект) \> Project Options(Параметры проекта) \> Comiler Options(Параметры компилятора) \> Additions and Overrides(Дополнения и перекрытия) \> Set(Прсивоить) "LCLWidgetType".
347	349
348	350		![](/wiki-images/9/95/SetLCLWidgetTypeIn1_7.png)
349	351
350	352		#### Добавление флага в проект и все пакеты
351	353
352	354		> Note: Это изменяет проект (.lpi). Оно не изменяет файлы пакета (.lpk), но влияет на них при сборке проекта. Это также влияет на сборку IDE.
353	355
354	356		Перейдите к Additions and Overrides(Дополнениям и перекрытия). Нажмите кнопку Add(Добавить) и выберите Custom Option(Пользовательский параметр):
355	357
356	358		![](/wiki-images/f/fe/Addflagtoprojectsandpackages1.png)
357	359
358	360		Теперь вы должны увидеть "Targets: "(Цель: ) и новую опцию \[Custom\]. Она включена для текущего активного режима сборки и отключена для всех остальных. Targets: (Цель: ) означает, что это относится к проекту и всем пакетам.
359	361
360	362		![](/wiki-images/6/64/Addflagtoprojectsandpackages2.png)
361	363
362	364		Нажмите на ячейку \[справа от\] опции \[Custom\] и добавьте свой флаг. Например: -dSomeFlag.
363	365
364	366		![](/wiki-images/a/a9/Addflagtoprojectsandpackages3.png)
365	367
366	368		Вот так.
367	369
368	370		#### Добавление флага ко всем проектам и пакетам
369	371
370	372		Флаг из предыдущего абзаца активен только при загрузке проекта. Чтобы установить флаг для всех проектов, выберите опцию и нажмите кнопку «вверх» (зеленая стрелка вверх). Это перемещает параметр в группу "Stored in IDE"(Хранящиеся в IDE).
371	373
372	374		![](/wiki-images/e/e7/Addflagtoallprojectsandpackages1.png)
373	375
374	376		> Note: В среде IDE используются параметры режима сборки "default"(по умолчанию).
375	377
376	378		#### Изменение каталога вывода проекта и всех пакетов
377	379
378	380		Перейдите к Additions and Overrides(Дополнения и перекрытия). Нажмите кнопку Add(Добавить) и выберите Output Directory (-FU)(Каталог вывода (-FU)).
379	381
380	382		![](/wiki-images/7/7a/AddsAndOverridesOutDir1.png)
381	383
382	384		Теперь вы должны увидеть "Targets: "(Цели: ) и новый параметр «OutDir» со значением по умолчанию lib/\$(TargetCPU)-\$(TargetOS)/\$(BuildMode). Он включен для текущего активного режима сборки и отключен для всех остальных. "Targets: "(Цели: ) означает, что это относится к проекту и всем пакетам.
383	385
384	386		![](/wiki-images/6/6a/AddsAndOverridesOutDir2.png)
385	387
386	388		Например: щелкните ячейку \[справа от параметра OutDir\] и измените ее \[значение\] на lib/\$(FPCVer)/\$(TargetCPU)-\$(TargetOS). Это заставит IDE использовать разные каталоги вывода для каждой версии компилятора Free Pascal.
387	389
388	390		Если вы хотите использовать одни и те же выходные каталоги для всех ваших проектов, вы можете поместить опцию в \[раздел\] Stored in IDE(Хранящиееся в IDE). Щелкните в ячейке \[справа от\] параметра OutDir, чтобы выбрать строку. Затем используйте кнопку «Вверх» (стрелка вверх), чтобы переместить параметр.
389	391
390	392		Если вы хотите применить каталог вывода для всех пакетов, но не для проектов, измените значение Targets(Цели) с * на ,-#project*.
391	393
392	394		![](/wiki-images/e/e2/AddsAndOverridesAllPkgOutDir1.png)
393	395
394	396		> Note: Если пакет не поддерживает ваш каталог вывода, добавьте к Targets(Цели) значение -packagename. Например: *, - chmhelp.
395	397
396	398		Если вы хотите поместить выходные файлы пакета в подкаталоги проекта, измените OutDir на \$(ProjPath)/lib/\$(PkgName)/\$(TargetCPU)-\$(TargetOS)/\$(BuildMode). Обратите внимание на использование макросов \$(ProjPath) для каталога проекта и\$(PkgName) для предоставления каждому пакету своего собственного каталога.
397	399
398	400		![](/wiki-images/d/d1/OutputDirectoryOFAllPackagesIntoProjectDirectory.png)
399	401
400	402		Например, если каталог вашего проекта - C:\pascal\myapp, то пакет LCL будет скомпилирован в C:\pascal\myapp\lib\LCL\i386-win32\default.
401	403
402	404		#### Добавление флага в один пакет без изменения самого lpk
403	405
404	406		В этих примерах опция -vm4104 добавляется в пакет lazreport.
405	407
406	408		- Перейдите в Additions and Overrides(Дополнения и перекрытия).
407	409		- Нажмите на кнопку Add(Добавить) и выберите "New Target"(Новая цель). Вставляется новая строка с «Targets: »(Цели: )
408	410		- Нажмите на новую строку сразу \[справа от\] "Targets:"(Цели:). ***** теперь становится редактируемым.
409	411		- Измените \[текущее значение\] на имя пакета. В этом примере: lazreport. Нажмите Enter или нажмите на другую строку, чтобы закончить редактирование.
410	412		- При наведении указателя мыши на новую строку вы должны увидеть подсказку Apply to all packages matching the name "lazreport"(Применить ко всем пакетам с именем «lazreport»).
411	413		- Click on the Add button and select "Custom Option". A new row is inserted below the row Targets: lazreport. Note: You can move rows using the green arrows
412	414		- Нажмите кнопку Add(Добавить) и выберите "Custom Option"(Пользовательский параметр). Новая строка вставится ниже строки Targets: lazreport(Цели: lazreport).
413	415
414	416		> Note: Строки можно перемещать с помощью зеленых стрелок.
415	417
416	418		- Нажмите на новое пустое значение и измените его значение на -vm4104.
417	419
418	420		Эта опция сохранится в вашем текущем проекте (lpi) и добавится только, если вы скомпилируете этот проект. Если эта опция должна использоваться со всеми вашими проектами на вашем компьютере, используйте зеленые кнопки, чтобы переместить Targets: lazeport(Цели: lazeport) в Stored in IDE(Хранящиеся в IDE).
419	421
420	422		![](/wiki-images/6/68/AdditionsAndOverridesOptionForSinglePkg1.png)
421	423
422	424		## Компиляция (Compilation)
423	425
424	426		## Команды компилятора(Compiler Commands)
425	427
426	428		![](/wiki-images/4/48/CompilerOptions-Compiler_Commands.png)
427	429
428	430		### Создать Makefile (Create Makefile)
429	431
430	432		Включите эту опцию, если хотите, чтобы IDE создавала файл Makefile и Makefile.fpc перед каждой сборкой. В данный момент этот флаг используется только для пакетов, но не для проектов.
431	433
432	434		### Выполнить перед компиляцией (Execute before)
433	435
434	436		Настройте здесь команду, которая будет выполнена перед запуском компилятора.
435	437
436	438		Вызов при (Call on):
437	439
438	440		- компиляции (Compile) - выполняется при нормальной компиляции (F9).
439	441		- сборке (Build) - выполняется, когда происходит полная сборка. Например это может быть скрипт, который чистит каталоги.
440	442		- запуске (Run) - выполняется, когда выполняется быстрая компиляция. При запуске проекта, IDE проверяет нужно ли чего-нибудь компилировать. Если ничего компилировать не нужно, то IDE пропускает этап компиляции. Установите эту опцию, чтобы выполнять команду даже если этап компиляции был пропущен.
441	443
442	444		IDE может разбирать и фильтровать вывод этой команды и останавливаться при ошибках. Отметьте какие сообщения вы хотите видеть в IDE.
443	445
444	446		### Компилятор (Compiler)
445	447
446	448		Здесь указывается компилятор используемый проектом или пакетом. По умолчанию это макрос \$(CompPath), который заменяется версией компилятора из переменных окружения.
447	449
448	450		### Выполнить после компиляции (Execute after)
449	451
450	452		Настройте здесь команду, которая будет выполнена после того, как закончится работа компилятора. Смотри выше 'Выполнить перед компиляцией (Execute before)' для дополнительной информации.
451	453
452	454		Одним из удобных способов использования может быть автоматическое копирование кросс-скомпилированного исполняемого файла с вашего ПК на целевое устройство, например на Raspberry:
453	455
454		-	~~`scp "$TargetFile()" pi@raspberry:/home/pi/bin`~~
	456	+	```text
	457	+	scp "$TargetFile()" pi@raspberry:/home/pi/bin
	458	+	```
455	459
456	460		(И да, это работает даже без пароля, если вы создаете пару ключей с помощью ssh-keygen, а затем добавляете их в файл selected_keys вашей цели через "ssh-copy-id \[remoteuser@\]remotehost"; подробности см.\[https: //www.debian.org/devel/passwordlessssh здесь\])
457	461
458	462		## Унаследованный(Inherited)
459	463
460	464		> Note: Это было перенесено в Lazarus 1.1 в диалоговое окно Show Options(Показать параметры).
461	465
462	466		На этой странице показаны все параметры компилятора, унаследованные от пакетов. Пакеты наследуют опции через их свойство usage(использование) [[IDE Window: Package Options/ru\|опций пакета]].
463	467
464	468		Самый верхний узел показывает все унаследованные параметры, то есть сумму всех используемых пакетов.
465	469
466	470		Узлы ниже показывают унаследованные параметры каждого используемого пакета.
467	471
468	472		Вы можете просмотреть/отредактировать набор используемых пакетов для проекта в Инспекторе проектов. Вы можете просмотреть/отредактировать набор используемых пакетов для пакета в редакторе пакетов.
469	473
470	474		Для получения информации о пакетах в целом см. [[Lazarus Packages/ru\|пакеты Lazarus]].
471	475
472	476		## Использовать эти настройки по умолчанию для новых проектов
473	477
474	478		Установите этот флажок и нажмите Ok. Настройки будут сохранены в ~/.lazarus/compileroptions.xml (или в любом другом месте, указанном в качестве основного пути конфигурации). При создании нового проекта этот файл будет загружен для инициализации параметров компилятора. Эта функция существует с 0.9.29.
475	479
476	480		## Кнопки (Buttons)
477	481
478	482		### Тест (Test)
479	483
480	484		Эта кнопка запустит различные тесты и обнаружит основные ошибки настройки. Для fpc 2.2.0 сообщит о дублирующихся модулях. Предупреждения корректны, но вы можете игнорировать их, если не хотите использовать эти модули.
481	485
482	486		### Показать параметры (Show Options)
483	487
484	488		Открывает диалог и показывает текущие настройки параметров командной строки.
485	489
486	490		### Загрузка/Сохранение (Load/Save)
487	491
488	492		Открывает диалог для сохранение и/или загрузки текущих настроек компилятора из/в файла xml.
489	493
490	494		### Ok
491	495
492	496		Эта кнопка применяет выбранные настройки и закрывает диалог.
493	497
494	498		### Cancel
495	499
496	500		Эта кнопка откатывает на предыдущую версию настроек и закрывает диалог.
497	501
498	502		------------------------------------------------------------------------
499	503
500	504		------------------------------------------------------------------------
501	505
502	506		## Макросы IDE
503	507
504	508		![](/wiki-images/6/6c/CompilerOptions-IDE_Macros.png)
505	509
506	510		### Для \[версий с\] 0.9.29 по 1.0.x
507	511
508	512		Эта страница позволяет определить макросы и условия вашего проекта/пакета. В среде IDE уже есть много \[предопределенных\] [[IDE Macros in paths and filenames/ru\|макросов]]. Вы можете добавить свои собственные макросы, которые действительны при загрузке проекта/пакета. Условия позволяют устанавливать значения макросов в зависимости от целевой платформы и других макросов. Например, вы можете добавить опцию компоновщика при компиляции для macOS.
509	513
510	514		Используйте левую кнопку +, чтобы добавить новый макрос для проекта/пакета. Выберите макрос и нажмите среднюю кнопку +, чтобы добавить новое возможное значение. Фактическое значение макроса задается в условных выражениях ниже или в текущем проекте на странице build modes (меню IDE / Project / Project Options / Compiler options / Build Modes). Чтобы удалить значение или макрос, выберите его и нажмите кнопку -.
511	515
512	516		В условных выражениях используется язык сценариев, похожий на паскаль, и они редактируются в текстовом редакторе внизу страницы. Многие ярлыки работают как в редакторе исходного кода, включая завершение слова/идентификатора (по умолчанию: `Ctrl` + `Spase`).
513	517
514	518		Для получения дополнительной информации о макросах сборки и условных выражениях см. [[Macros and Conditionals]].
515	519
516	520		![](/wiki-images/5/52/Compileroptions_buildmacros1.png)
517	521
518	522		Эта страница существует с версии 0.9.29.
519	523
520	524		### Для \[версии\] 1.1 и выше
521	525
522	526		Эта страница доступна только для пакетов. Это позволяет пакетам определять свои собственные макросы IDE. В среде IDE уже есть много \[\[IDE_Macros_in_paths_and_filenames/ru\\|\[предопределенных\] макросов\]\].
523	527
524	528		Используйте левую кнопку +, чтобы добавить новый макрос для проекта/пакета. Выберите макрос и нажмите среднюю кнопку +, чтобы добавить новое возможное значение. Фактическое значение макроса задается в условных выражениях ниже или в текущем проекте на странице build modes ("режимы сборки") (меню IDE / Project / Project Options / Compiler options / Build Modes). Чтобы удалить значение или макрос, выберите его и нажмите кнопку -.
525	529
526	530		Для получения дополнительной информации о макросах сборки и условных выражениях см. [[Macros and Conditionals]].
527	531
528	532		## Прочее
529	533
530	534		См. [Free Pascal - Online documentation](http://www.freepascal.org/docs.html)
531	535
532	536		Обычно вы определяете здесь некоторые параметры компилятора. Например, вы можете определить в режиме сборки что-то вроде
533	537
534	538		``` pascal
535	539		-dRELEASE
536	540		```
537	541
538	542		Затем в режиме сборки будет скомпилирован только код, окруженный
539	543
540	544		``` pascal
541	545		{$ IFDEF RELEASE}
542	546		...
543	547		{$ ENDIF}
544	548		```
545	549
546	550		Это можно использовать в качестве альтернативы системе макросов, особенно если вы перешли с Delphi.
547	551
548	552		Пробелы в начале и в конце удаляются. Разрывы строк заменяются пробелом перед передачей компилятору. Ведущий пробел добавляется автоматически.
549	553
550	554		Среда IDE заменяет макросы IDE в пользовательских параметрах и анализирует параметры. Флаги, такие как `-dRelease`, передаются в codetools, поэтому редактор исходного кода узнает о них сразу.
551	555
552	556		> Warning: Не добавляйте параметры пути -Fu, -Fi, -Fl, -FU, -o. Вместо этого используйте поля на странице [[IDE Window: Compiler Options/ru\|Пути (Paths)]]. Среда IDE игнорирует пути в пользовательских параметрах. Она не обновляет их при добавлении или удалении файлов или при открытии проекта на другом хосте.
553	557
554	558		Нажав кнопку All options... ("Все параметры ..."), вы можете легко настроить параметры FPC:
555	559
556	560		![](/wiki-images/8/8b/Options.png)
557	561
558	562		---
559	563		From the Free Pascal wiki, page "IDE Window: Compiler Options/ru", as it stood on 2019-12-22 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