IDE Window: Compiler Options/de: what changed

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

Old	New		Line
1	1		## Erstellmodi
2	2
3	3		### Hinzufügen, Löschen und Aktivieren von Erstellmodi
4	4
5	5		Diese Möglichkeit gibt es nur für Projekte, nicht für Packages.
6	6
7	7		Erstell Modi erlauben es für ein Projekt verschiedene Compilereinstellungen zu speichern. So können zum Beispiel für die Entwicklung (Debugging) andere Compilereinstellungen verwendet werden als für die endgültige Version. Zwischen diesen Einstellungen können Sie dann in der IDE per Mausklick wechseln.
8	8
9	9		Anmerkung: If you want to pass some options depending on the platform, for example passing some extra linker options under macOS, please take a look at Build Macros.
10	10
11	11		The first grid on the top of the page contains the list of build modes with three columns.
12	12
13	13		The first column shows which mode is currently active. When you activate another mode, all compiler options pages will load the settings of the new mode, including the macro values on the build modes page. There is always only one mode active and you can only edit the properties of one mode at a time. Which mode is active is stored in the session file (lps). The default mode is the first mode.
14	14
15	15		If your project stores the session in a separate lps file (see Project options / Session / Save session info in), you can store extra modes in the session, so that each developer can have her own set of modes. In this case the second column shows where the mode is stored, in the lpi or the lps (in session). Keep in mind that the first mode is the default mode for the project, so it must be stored in the project, not in the session file.
16	16
17	17		The last column is the name of the mode. It is an arbitrary string, so you can give it a short name or a whole sentence.
18	18
19	19		- The plus button adds a new mode, by duplicating the currently active one and activates it.
20	20		- The minus button delete the currently selected mode. There must be at least one mode. If you delete the first mode, which is the default mode, the second mode automatically becomes the default mode.
21	21		- The up, down buttons allows to reorder the modes.
22	22		- The rightmost button shows the differences between build modes.
23	23
24	24		Hinweis:: Once you added another build mode there will be a new button in the IDE main bar to quickly switch the currently active mode.
25	25
26	26		Anmerkung:: Wenn sie ein neues Projekt mit einer alten IDE öffnen, dann sehen sie nur den Vorgabemodus. Wenn sie das Projekt mit der alten IDE speichern, dann gehen alle anderen Modi, alle Makros und conditionals verloren.
27	27
28	28		Erstellmodi existieren seit Version 0.9.31.
29	29
30	30		### Hinzufügen eines Release- und eines Debugmodus
31	31
32	32		Die häufigste Aufgabe für Projekte ist das Hinzufügen eines einfachen Release- und Debug-Erstellungsmodus. Denken Sie daran, immer auch einen Debug-Erstellungsmodus zu verwenden, da das Debuggen im Release-Erstellungsmodus nicht funktioniert und dann nur in der endgültigen Version der Anwendung den Release-Erstellungsmodus verwenden.
33	33
34	34		Der erste Schritt zum Hinzufügen dieser Erstellungsmodi ist das Aufrufen des Projektoptionsdialogs des Projekts. Vergewissern Sie sich dort, dass Sie über zwei Erstellungsmodi verfügen. Ein sogenannten Release- und ein anderes als Debug-Modus. Standardmäßig gibt es dort immer einen Erstellungsmodus. Klicken Sie in diesem Dialogfeld einmal auf die Schaltfläche +, um einen weiteren Modus hinzuzufügen, und benennen Sie die Erstellungsmodi um, indem Sie auf deren Namen doppelklicken. Stellen Sie als Nächstes sicher, dass Sie den Debug-Erstellungsmodus auswählen, damit er dann konfiguriert werden kann.
35	35
36	36		![](/wiki-images/4/4c/Build_Mode_Debug.png)
37	37
38	38		Once we select the debug build mode, all configurations from the project options dialog will be specific to this build mode. The most important configuration to set for this build mode is the Linking options, which should enable GDB debugging, as is the default for Lazarus projects, like in this screenshot:
39	39
40	40		![](/wiki-images/e/e1/Build_Mode_Debug_Linking.png)
41	41
42	42		To configure the release build mode we should go back to the Build Modes section and activate the release build mode:
43	43
44	44		![](/wiki-images/8/8d/Build_Mode_Release.png)
45	45
46	46		And for this build mode also go to the linking section and deactivate generating debug info:
47	47
48	48		![](/wiki-images/3/32/Build_Mode_Release_Linking.png)
49	49
50	50		Now just remember to go back to the Build Modes tab and set the debug build mode as the active one while developing the application and only use the release when making releases.
51	51
52	52		### Den aktiven Erstellmodus auswählen
53	53
54	54		One can select the currently active build mode either in the "Project Options" dialog or in the main IDE Window, in a special button with a drop down which will appear only if the project has more then 1 build mode, as one can see in this screenshot:
55	55
56	56		![](/wiki-images/6/6f/Selecting_Build_Mode_Main_IDE_Windows.png)
57	57
58	58		### Projektmakros
59	59
60	60		The second grid at the bottom of the page shows the project macro values. Anmerkung: Dabei handelt es sich um Lazarus-Makros, nicht um FPC-Makros.
61	61
62	62		They are simple name, value pairs. Macros can be used in all file names and search paths of the project. Almost all macros have default values so you will only define macros here if you want to override the default. For example a macro macro1 can be used in the Other unit files by inserting the text \$(macro1). This macro will then be replaced by the value.
63	63
64	64		Packages can define macros which can be set (overriden) by the project.
65	65
66	66		Default value: Setting a macro value to an empty value is not the same as using the default value. To use the default value of a macro, delete the macro from the list.
67	67
68	68		Delete a macro: A macro can be deleted from the list by changing the name to (none) or empty.
69	69
70	70		You can set macros depending on other macros on the page Build Macros.
71	71
72	72		For more details about build macros and conditionals see [[Macros and Conditionals]].
73	73
74	74		Projektmakros existieren seit Version 0.9.29.
75	75
76	76		#### Widget type
77	77
78	78		In Lazarus 1.0 and later, you use macros to change the widget set of the project. Click on the combo box in the Macro name cell and select LCLWidgetType. The Macro value then shows a combobox where you can select the desired widgetset. If you want to revert to the default widget type, you can delete the two cells again.
79	79
80	80		The screenshot below shows how to select qt widgetset: ![](/wiki-images/4/4e/BuildModes_DebugRelease_Widgetqt.png)
81	81
82	82		## Pfade
83	83
84	84		Hier sind die allgemeinen Regeln für die Suchpfade:
85	85
86	86		- Relative Pfade werden mit dem Projekt- oder Package-Verzeichnis (wo die .lpi/.lpk Datei ist) erweitert.
87	87		- Diese Pfade werden zu den Suchpfaden hinzugefügt. Sie ersetzen sie nicht.
88	88		- Die IDE hat einen Satz von Suchpfaden für jedes Verzeichnis. Das bedeutet, dass ein Package Suchpfade haben kann, die sich von denen des aktiven Projekts unterscheiden.
89	89		- Wenn ein Package oder Projekt ein Package verwendet, bindet es auch die zugehörigen Suchpfade ein. Sie können die geerbten Suchpfade sehen auf der #Vererbt Seite.
90	90		- Wenn Sie das Lazarus Package-System verwenden, müssen Sie nur höchst selten Suchpfade per Hand eingeben.
91	91		- Der FreePascal Compiler hat eine eigene Konfigurationsdatei (Vorgabe: /etc/fpc.cfg), welche einen Satz von Suchpfaden zu den FPC .ppu - Dateien definiert. Zum Beispiel um die FPC Units der RTL oder FCL wie 'classes', 'sysutils' zu finden. Fügen Sie hier keine Suchpfade zu der Quelltextdateien (.pas, .inc) hinzu.
92	92		- Suchpfade werden durch ein Semikolon ';' getrennt.
93	93		- Führende und nachlaufende Leerzeichen werden von der IDE ignoriert und automatisch entfernt. Die IDE normalisiert die Suchpfade und fügt das Pfadbegrenzungszeichen hinzu (Windows: \\, alle anderen: /). Suchpfade werden automatisch für das aktuelle Betriebssystem konvertiert, wenn eine .lpi oder .lpk Datei geöffnet wird.
94	94		- Sie können Makros verwenden. Zum Beispiel \$(TargetCPU). Siehe [[IDE Macros in paths and filenames/de\|IDE Makros in Pfaden und Dateinamen]].
95	95		- Wenn Sie nicht einen Suchpfad verwenden wollen, der von einem benutzten Package geerbt wurde, müssen Sie die Compilereinstellungen des benutzten Packages ändern.
96	96		- Die IDE hat einen Satz von Pfad-Einstellungen pro Verzeichnis:
97	97		- Jedes Verzeichnis im Unit-Suchpfad des Projekts erhält alle Projekt-Suchpfade.
98	98		- Jedes Verzeichnis im Unit-Suchpfad des Packages erhält alle Package-Suchpfade.
99	99		- Andere Verzeichnisse erhalten die Projekt-Suchpfade. Wenn der Projekt-Suchpfad den '.' enthält, sieht das Verzeichnis auch das Projektverzeichnis.
100	100		- Die Verwendung von "uses unitname in 'filename'" wirkt sich nicht auf die anderen Suchpfade aus.
101	101
102	102		### Andere Units (-Fu)
103	103
104	104		Dies ist der Suchpfad für die Pascal Units (.ppu, .pp, .pas, .p) des Projekts oder Packages. Schauen Sie auf den Fenstertitel, um zu erfahren welches (aktiv ist). Dieser Pfad wird an den FreePascal Compiler übergeben, welcher ihn zu seinem Unit-Pfad hinzufügt.
105	105
106	106		- Das Hinzufügen und Entfernen von Units zum Projekt/Package führt zu einer automatischen Nachfrage, ob der Unit-Pfad angepasst werden soll.
107	107		- Dieser Suchpfad enthält die Verzeichnisse ihres Projekts (oder Packages), welche die .pas, .pp oder .p Dateien enthalten.
108	108		- VORSICHT: Fügen Sie keine Verzeichnisse von verwendeten Lazarus-Packages zu diesem Pfad hinzu. Andernfalls wird FPC die .ppu-Dateien des Packages neu erstellen und sie in ihrem Projektverzeichnis ablegen. Dies führt zu mehrfachen .ppu Versionen und Sie werden seltsame 'Can not find unit' Fehler erhalten.
109	109
110	110		Zum Beispiel: Fügen Sie keine FPC oder LCL Quellverzeichnisse zu diesem Suchpfad hinzu.
111	111
112	112		- Wenn Sie einige Units in Ihren Projekten gemeinsam verwenden wollen, sollten Sie ein Package für sie erzeugen. Es ist einfach.
113	113
114	114		### Include-Dateien (-Fi)
115	115
116	116		Dies ist der Suchpfad für die Include-Dateien (z.B. .inc oder .lrs Dateien). Dieser Pfad wird an den FreePascal Compiler gegeben, welcher ihn zu seinem Include-Pfad hinzufügt, der von den Include-Direktiven wie {\$I filename.inc} oder {\$INCLUDE filename.inc} verwendet wird.
117	117
118	118		### Bibliotheken (-FI)
119	119
120	120		Dies ist der Suchpfad für Bibliotheken (.dll oder .so oder .a Dateien).
121	121
122	122		### Unit-Ausgabeverzeichnis (-FU)
123	123
124	124		Dies ist das Verzeichnis, in dem der Compiler alle Ausgabedateien (Compilerschalter -FU) wie .ppu, .o oder .rst Dateien ablegt. Wenn Sie die \$R Direktive für die .lfm Dateien verwenden, werden auch die .lfm Dateien dorthin kopiert.
125	125
126	126		Ein bekanntes Anwendungsbeispiel ist ein Ausgabeverzeichnis namens units, und dazu ein extra Unterverzeichnis für die Ziel-CPU und das Zielbetriebssystem. Zum Beispiel:
127	127
128		-	~~` units/$(TargetCPU)-$(TargetOS)`~~
	128	+	```text
	129	+	units/$(TargetCPU)-$(TargetOS)
	130	+	```
129	131
130	132		Anmerkungen:
131	133
132	134		- Wenn das Unit-Ausgabeverzeichnis leer ist, wird Lazarus nicht den -FU Schalter an den Compiler übergeben. Der Compiler nimmt dann den -FE Schalter. Siehe [[IDE Window: Project Options\|Project target file]]
133	135		- Packages vererben normalerweise ihr Ausgabeverzeichnis an andere Packages via die 'usage' Einstellungen. Sie brauchen keine Package-Pfade manuell zu Ihrem Projekt hinzufügen.
134	136
135	137		### Ziel-Dateiname (-o)
136	138
137	139		Anmerkung: Dies existiert nur für Projekte, nicht für Packages.
138	140
139	141		Set here the filename of the generated executable. If the file is relative it will be expanded with the project directory (where the .lpi file is). If no file is given the executable is put into the unit output directory and has the name of the main source file name (usually the .lpr file) without the extension. If no extension is given, the default extension for the platform is added (e.g. .exe for MS Windows, none for others). When a new project was not yet saved and is built the IDE saves the files to the test directory. The relative files are then relative to this directory.
140	142
141	143		Lazarus passes the compiler switch
142	144
143	145		- -o um den Ziel-Dateinamen zu definieren
144	146		- -FE wenn sich der Ziel-Dateiname nicht im Projektverzeichnis (Verzeichnis mit der .lpi Datei) befindet
145	147		- -FU wenn das Unit-Ausgabeverzeichnis nicht leer ist
146	148
147	149		If the target file name is in another directory (not the directory of the .lpi file), Lazarus will pass the -FE switch to the compiler to make sure that the secondary files, like .o and .rst are put into the same directory. If you cleared the unit output directory then the IDE will not pass the -FU switch and the compiler will generate the .ppu/.o files of the units in the target directory too.
148	150
149	151		If you cleared the unit output directory and your project target file is in the project directory, then neither -FU nor -FE is passed to the compiler and the compiler will work Delphi compatible and generate the .ppu/.o file of each unit in the same directory as the unit.
150	152
151	153		#### Konventionen anwenden
152	154
153	155		Mit der Aktivierung werden verschiedene Namenskonventionen (abhängig von der Zielplattform) angewendet.
154	156
155	157		- Windows: Bei einem Programm wird die .exe-Erweiterung angehängt, bei einer Bibliothek .dll.
156	158		- Unix (z.B. Linux, BSD, Darwin/macOS): Bei einer Bibliothek wird der Name kleingeschrieben und wenn der Name nicht mit 'lib' beginnt, wird lib vorangestellt.
157	159		- Linux, BSD: Wenn es eine Bibliothek ist, wird .so angehängt.
158	160		- Darwin/macOS: Wenn es eine Bibliothek ist, wird .dylib angehängt.
159	161
160	162		### Andere Quellen
161	163
162	164		Dies ist der Suchpfad für Pascal Unit-Quellen, der nur von der IDE verwendet wird und nicht vom Compiler. Normalerweise lassen Sie dies leer. Er ist nur dann nützlich, wenn Sie die .ppu-Dateien ohne Lazarus erzeugen.
163	165
164	166		Beispiel: Sie haben ein Verzeichnis mit Quellen und ein Verzeichnis mit den dazugehörigen .ppu Dateien und Sie können oder wollen kein Lazarus-Package erzeugen. Sie fügen das .ppu Verzeichnis zum 'Andere Unitdateien' Pfad hinzu und das .pas Verzeichnis zum 'Andere Quellen' Pfad. Auf diese Weise wird der Compiler die .ppu Dateien verwenden und nicht versuchen, sie jedes Mal neu zu erstellen. Und die IDE wird die Quellen finden und Find Declaration funktioniert.
165	167
166	168		### Zusätzlicher Debuggerpfad
167	169
168	170		Diese Verzeichnisse werden zum Suchpfad des IDE-Debuggers hinzugefügt, wenn er nach Quelldateien sucht (Units und Include Dateien).
169	171
170	172		## Konfiguration und Ziele
171	173
172	174		### Konfigurationsdateien
173	175
174	176		### Zielplattform
175	177
176	178		- Ziel-Betriebssystem
177	179		- Ziel-CPU-Familie
178	180		- Zielprozessor
179	181
180	182		## Parsen
181	183
182	184		Siehe [Free Pascal - Onlinedokumentation](http://www.freepascal.org/docs.html)
183	185
184	186		### Syntax-Modus
185	187
186	188		Wählen sie hier den Vorgabemodus. Wenn eine Unit keine {\$mode irgendeinmodus} Direktive enthält, wird dies als Vorgabe verwendet.
187	189
188	190		Siehe [Free Pascal - Online documentation](http://www.freepascal.org/docs.html)
189	191
190	192		### Syntaxeinstellungen
191	193
192	194		- C-artige Operatoren (*=, +=, /= und -=)
193	195		- Assertionen verwenden
194	196		- LABEL und GOTO zulassen
195	197		- C++-artige Inlineanweisungen
196	198		- C-artige Makros (global)
197	199		- TP/BP 7.0 kompatibel
198	200		- Name des Konstruktors muss 'init' sein (Destruktor muss 'done' heißen)
199	201		- 'static'-Schlüsselwort in Objekten
200	202		- Ansi-Strings verwenden
201	203
202	204		### Assembler-Stil
203	205
204	206		- -R\<x\> assembler reading style:
205	207		- -Rdefault use default assembler
206	208		- -Ratt read AT&T style assembler
207	209		- -Rintel read Intel style assembler
208	210
209	211		## Kompilieren und Linken
210	212
211	213		Siehe [Free Pascal - Onlinedokumentation](http://www.freepascal.org/docs.html)
212	214
213	215		- Optimierungen
214	216		- Andere Optimierungen
215	217		- Unit-Stil
216	218		- Heap- und Stackgrößen
217	219		- Linken
218	220
219	221		## Debuggen
220	222
221	223		Siehe [Free Pascal - Onlinedokumentation](http://www.freepascal.org/docs.html)
222	224
223	225		- Überprüfungen
224	226		- Info für GDB
225	227		- Andere Debugger-Optionen
226	228
227	229		## Ausführlichkeit
228	230
229	231		- Compilerausgaben
230	232		- Abbruch nach Fehlerzahl
231	233
232	234		## Meldungen
233	235
234	236		Siehe [Free Pascal - Onlinedokumentation](http://www.freepascal.org/docs.html) Note that adding a lot of verbosity slows down the parsing of the compiler out much, sogar wenn die meisten Nachrichten im Nachrichtenfenster verborgen werden.
235	237
236	238		## Andere
237	239
238	240		Siehe [Free Pascal - Onlinedokumentation](http://www.freepascal.org/docs.html)
239	241
240	242		- Bedingungen
241	243		- Benutzerdefinierte Einstellungen
242	244
243	245		## IDE Makros
244	246
245	247		This page allows to define your project/package specific macros and conditionals. The IDE already provides a lot of [[IDE Macros in paths and filenames\|macros]]. You can add your own macros that are valid when the project/package is loaded.
246	248
247	249		Conditionals allow to set macro values depending on target platform and other macros. For example you can add a linker option when compiling for macOS.
248	250
249	251		Use the left + button to add a new macro for the project/package. Select a macro and click on the middle + button to add a new possible value. The actual value of a macro is set in the conditionals below, or by the current project on the build modes page (IDE menu / Project / Project Options / Compiler options / Build Modes). To delete a value or a macro, select it and click on the - button.
250	252
251	253		The conditionals use a scripting language similar to pascal and are edited in the text editor at the bottom of the page. Many short cuts work like in the source editor, including word/identifier completion.
252	254
253	255		For more details about build macros and conditionals see [[Macros and Conditionals]].
254	256
255	257		![](/wiki-images/5/52/Compileroptions_buildmacros1.png)
256	258
257	259		Build macros and conditionals exist since 0.9.29.
258	260
259	261		## IDE Makrowerte
260	262
261	263		## Vererbt
262	264
263	265		Diese Seite zeigt alle Compilereinstellungen, die von Packages geerbt wurden. Packages erben Optionen über ihre 'usage' Optionen.
264	266
265	267		The topmost node shows all inherited options, that is the sum of all used packages.
266	268
267	269		The nodes below show the inherited options of each use package.
268	270
269	271		## Compiler-Kommandos
270	272
271	273		### Makedatei anlegen
272	274
273	275		Aktivieren sie es, wenn die IDE vor jedem Erstellen ein Makefile und eine Makefile.fpc anlegen soll. Dies wird gegenwärtig nur für Packages unterstützt, nicht für Projekte.
274	276
275	277		### Vorher ausführen
276	278
277	279		Richten sie hier einen Befehl ein, der vor dem Starten des Compilers ausgeführt wird.
278	280
279	281		Aufruf an:
280	282
281	283		- Kompilieren - ausführen bei normalem Kompilieren (F9).
282	284		- Neu kompilieren - ausführen, wenn alles neu erstellt wird. This could for example a script to clean up.
283	285		- Start - ausführen bei schnellem Kompilieren. Wenn ein Projekt gestartet wird, prüft die IDE, ob eine Neuerstellung notwendig ist. Wenn keine Neuerstellung notwendig ist, überspringt die IDE den Kompilierungsschritt. Setzen sie diese Option, um den Befehl immer auszuführen, sogar wenn der Kompilierungsschritt übersprungen wird.
284	286
285	287		Die IDE kann den Output des Befehls ndos analysieren und filtern und bei Fehlern stoppen. Aktivieren sie die Einstellungen, welche Meldungen die IDE überwachen soll.
286	288
287	289		### Compiler
288	290
289	291		Dies ist der Compiler-Pfad, der vom Projekt oder Package verwendet wird. Voreinstellung ist das Makro \$(CompPath), das durch den Compiler-Dateinamen in den Umgebungseinstellungen ersetzt wird.
290	292
291	293		### Nachher ausführen
292	294
293	295		Richten Sie hier einen Befehl ein, der nach dem Starten des Compilers ausgeführt wird. Siehe oben 'Vorher ausführen' für Details.
294	296
295	297		Eine nützliche Anwendung wäre beispielsweise, sich eine fremdkompilierte (cross-compiled) ausführbare Datei auch immer gleich automatisch vom PC auf die Zielhardware, etwa einen Raspberry, kopieren zu lassen:
296	298
297	299		scp "\$TargetFile()" pi@raspberry:/home/pi/bin
298	300
299	301		(Das kann tatsächlich sogar ohne Kennworteingabe geschehen, wenn man sich mit "ssh-keygen" ein Schlüsselpaar erzeugt und den öffentlichen Schlüssel dann der Datei authorized_keys des Empfängersystems hinzufügt, indem man "ssh-copy-id \[remoteuser@\]remotehost" aufruft; Details finden sich z.B. [hier](https://wiki.debian.org/de/SSH#SSH_ohne_Passwort))
300	302
301	303		## Diese Einstellungen gelten als Vorgabe für neue Projekte
302	304
303	305		Kreuzen Sie diese Checkbox an und klicken Sie auf OK. Die Einstellungen werden gespeichert in ~/.lazarus/compileroptions.xml (oder welchen primären Konfigurationspfad Sie auch immer haben). Wenn Sie ein neues Projekt erzeugen, wird diese Datei geladen und initialisiert die Compilereinstellungen. Dieses Merkmal existiert seit Version 0.9.29.
304	306
305	307		## Buttons
306	308
307	309		### Hilfe
308	310
309	311		Ruft die englische Version dieser Seite auf.
310	312
311	313		### Einstellungen anzeigen
312	314
313	315		Öffnet einen Dialog, der die aktuellen Kommandozeilenparameter anzeigt.
314	316
315	317		### Test
316	318
317	319		Dies wird verschiedene Tests starten, um übliche Konfigurationsfehler zu finden. Bei FPC 2.2.0 wird vor einigen doppelten Units gewarnt. Die Warnungen sind korrekt. Aber sie können diese ignorieren, wenn sie die betroffenen Units nicht verwenden.
318	320
319	321		### Laden/Speichern
320	322
321	323		Öffnet einen Dialog zum speichern/öffnen der aktuellen Compilereinstellungen in/aus einer XML Datei.
322	324
323	325		### OK
324	326
325	327		Wendet die Änderungen an und beendet den Dialog.
326	328
327	329		### Abbrechen
328	330
329	331		Macht alle Änderungen rückgängig und beendet den Dialog.
330	332
331	333		---
332	334		From the Free Pascal wiki, page "IDE Window: Compiler Options/de", 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