Codetools/de: what changed
Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | - | ||
| 1 | + | ## Contents | |
| 2 | 2 | ||
| 3 | - | ||
| 3 | + | * 1 Was sind die CodeTools | |
| 4 | + | * 2 Verwendung der CodeTools ohne die IDE (gut für Testzwecke) | |
| 5 | + | * 3 Verwendung der CodeTools in der IDE mit dem IDEIntf | |
| 6 | + | * 4 Codetools-Regeln für FPC-Quelltexte | |
| 7 | + | * 4.1 Gebrauch von testfpcsrcunitrules | |
| 8 | + | * 4.2 Beispiel für testfpcsrcunitrules | |
| 9 | + | * 4.3 Doppelte Quelltextdateien | |
| 10 | + | * 5 Wie die CodeTools Quelltexte untersuchen, abhängig von einem Kompiler | |
| 11 | + | * 6 Clean Position und Kursorposition | |
| 12 | + | * 7 Einfügen, Löschen und Ersetzen - der TSourceChangeCache | |
| 13 | + | * 7.1 Verwendung | |
| 14 | + | * 7.2 BeginUpdate/EndUpdate | |
| 15 | + | * 7.3 Speichern Sie die Änderungen auf Disk | |
| 16 | + | * 8 Links | |
| 4 | 17 | ||
| 5 | - | ||
| 18 | + | # Was sind die CodeTools | |
| 6 | 19 | ||
| 7 | - | ||
| 8 | - | ||
| 20 | + | Die CodeTools sind ein Lazarus-Package mit Werkzeugen zum Parsen, Untersuchen, Bearbeiten und Refaktorieren von Pascal-Quelltexten. Die CodeTools sind ein Modul für sich und unter der GPL lizensiert. Zahlreiche Beispiele, wie Sie die CodeTools in Ihren eigenen Programmen einsetzen können, finden Sie unter 'components/codetools/examples'. | |
| 9 | 21 | ||
| 10 | - | ||
| 22 | + | svn: | |
| 11 | 23 | ||
| 12 | - | ||
| 24 | + | * Lazarus: <http://svn.freepascal.org/svn/lazarus/trunk> | |
| 25 | + | * Nur CodeTools: <http://svn.freepascal.org/svn/lazarus/trunk/components/codetools> | |
| 13 | 26 | ||
| 14 | - | ||
| 27 | + | # Verwendung der CodeTools ohne die IDE (gut für Testzwecke) | |
| 15 | 28 | ||
| 16 | - | ||
| 29 | + | Sie können die CodeTools ohne die IDE verwenden. Dies kann zum Testen eines neuen Werkzeugs genutzt werden. Ein einfaches Beispiel ist | |
| 30 | + | ``` | |
| 31 | + | <lazarusdir>/components/codetools/examples/methodjumping.lpi | |
| 32 | + | ``` | |
| 17 | 33 | ||
| 18 | - | ||
| 19 | - | ||
| 20 | - | ||
| 21 | - | ||
| 22 | - | ||
| 34 | + | Um die _find declaration_ zu testen, müssen die CodeTools die Quellen analysieren, besonders die RTL- und FCL-Quellen. Die Beispiele benutzen folgende Umgebungsvariablen: | |
| 23 | 35 | ||
| 24 | - | ||
| 36 | + | * FPCDIR: der Pfad zu den FPC-Quelltexten, die Vorgabe ist _~/freepascal/fpc_. | |
| 37 | + | * PP: der Pfad zum ausführbaren Kompiler (/usr/bin/fpc oder /usr/bin/ppc386 oder C:\lazarus\ppc386.exe). Die CodeTools müssen den Kompiler nach den Einstellungen fragen. Als Vorgabe wird mittels der Variablen 'PATH' nach 'fpc' gesucht. | |
| 38 | + | * FPCTARGETOS: weist die CodeTools an, nach einem weiteren Betriebssystem zu suchen ("cross compiling"). Zum Beispiel: linux, freebsd, darwin, win32, win64, wince | |
| 39 | + | * FPCTARGETCPU: sucht nach einer anderen CPU. Zum Beispiel: i386, powerpc, x86_64, arm, sparc | |
| 40 | + | * LAZARUSDIR: der Pfad zu den Lazarus-Quelltexten. Wird nur benötigt, wenn Sie diese untersuchen wollen. | |
| 25 | 41 | ||
| 26 | - | ||
| 42 | + | FPC ist ein sehr komplexes Projekt mit vielen Suchpfaden, Include-Dateien und Makros. Die CodeTools müssen alle diese Pfade und Makros kennen, um diesen Dschungel zu analysieren. Um dies alles einfach einzurichten, enthalten die CodeTools vordefinierte Schablonen für FPC-, Lazarus-, Delphi- und Kylix-Quellverzeichnisse. Betrachten Sie für ein _find declaration_ folgendes Beispiel | |
| 43 | + | ``` | |
| 44 | + | <lazarusdir>/components/codetools/examples/finddeclaration.lpi | |
| 45 | + | ``` | |
| 27 | 46 | ||
| 28 | - | ||
| 47 | + | Weil die FPC-Quellen mehrere Versionen einiger Units enthalten und die FPC-Quellen oft geändert werden, verwenden die CodeTools keine starre Pfadtabelle. Stattdessen scannen sie zuerst die gesamte FPC Verzeichnisstruktur und versuchen mittels einiger Regeln herauszufinden, welche Quelle die richtige ist für das gegenwärtige ZielOS und ZielCPU. Dieser Scan kann eine Weile dauern. Alle Beipiele speichern das Ergebnis in **codetools.config** , damit diese Suche beim nächsten Start übersprungen wird. | |
| 29 | 48 | ||
| 30 | - | ||
| 49 | + | Wann immer die FPC-Quellen verschoben wurden oder eine Unit umbenannt wurde, löschen Sie einfach die Datei **codetools.config**. Die Lazarus-IDE hat ihre eigene Konfigurationsdatei und erledigt den Rescan, wann immer das Compiler executable geändert wurde oder der Benutzer dies erzwingt mit 'Einstellungen > FPC-Quelltextverzeichnis neu einlesen'. | |
| 31 | 50 | ||
| 32 | 51 | # Verwendung der CodeTools in der IDE mit dem IDEIntf | |
| 33 | 52 | ||
| 34 | - | ||
| 53 | + | Siehe das <lazarusdir>/examples/idequickfix/quickfixexample.lpk Package. Es demonstriert: | |
| 35 | 54 | ||
| 36 | - | ||
| 37 | - | ||
| 38 | - | ||
| 39 | - | ||
| 40 | - | ||
| 41 | - | ||
| 42 | - | ||
| 43 | - | ||
| 44 | - | ||
| 45 | - | ||
| 55 | + | * Wie man ein IDE-Package schreibt. Wenn Sie es installieren, wird es ein Quick-Fix-Element registrieren. | |
| 56 | + | * Wie man ein Quick-Fix-Element schreibt für die Compilermeldung 'Parameter "Sender" not used' | |
| 57 | + | * Wie man die CodeTools verwendet, um | |
| 58 | + | * eine Unit zu analysieren | |
| 59 | + | * Dateiname, Zeile, Spalte in eine CodeTools Quelltextposition umzuwandeln | |
| 60 | + | * ein CodeTools-Element an der Cursorposition zu finden | |
| 61 | + | * ein 'procedure'-Element und das 'begin..end'-Element zu finden | |
| 62 | + | * für eine Anweisung eine günstige Einfügeposition am Anfang eines 'begin..end'-Blocks zu ermitteln | |
| 63 | + | * die Einrückung einer Zeile zu erhalten, damit sich die neue Zeile in die Prozedur einfügt | |
| 64 | + | * Code einzufügen mit den CodeTools | |
| 46 | 65 | ||
| 47 | 66 | # Codetools-Regeln für FPC-Quelltexte | |
| 48 | 67 | ||
| 49 | - | ||
| 68 | + | Wenn die CodeTools die Quelltexte nach einer FPC ppu-Datei durchsuchen, verwenden sie einen Satz von Regeln. Sie können Ihre eigenen Regeln Schreiben, aber normalerweise werden Sie die Standardregeln benutzen, die in der der Includedatei 'components/codetools/fpcsrcrules.inc' festgelegt sind. Sie können die Regeln testen mit dem Befehlszeilenwerkzeug: components/codetools/examples/testfpcsrcunitrules.lpi. | |
| 50 | 69 | ||
| 51 | 70 | ## Gebrauch von testfpcsrcunitrules | |
| 52 | - | ||
| 53 | - | ||
| 54 | - | ||
| 71 | + | ``` | |
| 72 | + | Gebrauch: lazarus/components/codetools/examples/testfpcsrcunitrules -h | |
| 73 | + | ||
| 55 | 74 | -c <compiler file name>, --compiler=<compiler file name> | |
| 56 | 75 | Vorgabe ist es, die Umgebungsvariable PP zu benutzen. | |
| 57 | 76 | Wenn nicht angegeben, suche nach fpc | |
| 58 | - | ||
| 77 | + | ||
| 59 | 78 | -T <target OS>, --targetos=<target OS> | |
| 60 | 79 | Vorgabe ist es, die Umgebungsvariable FPCTARGET zu benutzen. | |
| 61 | 80 | Wenn nicht angegeben, nimm die Vorgabe des Kompilers. | |
| 62 | - | ||
| 81 | + | ||
| 63 | 82 | -P <target CPU>, --targetcpu=<target CPU> | |
| 64 | 83 | Vorgabe ist es, die Umgebungsvariable FPCTARGETCPU zu benutzen. | |
| 65 | 84 | Wenn nicht angegeben, nimm die Vorgabe des Kompilers. | |
| 66 | - | ||
| 85 | + | ||
| 67 | 86 | -F <FPC source directory>, --fpcsrcdir=<FPC source directory> | |
| 68 | 87 | Vorgabe ist es, die Umgebungsvariable FPCDIR zu benutzen. | |
| 69 | 88 | Es gibt keine andere Vorgabe. | |
| 70 | - | ||
| 89 | + | ||
| 71 | 90 | -u <unit name>, --checkunit=<unit name> | |
| 72 | 91 | Schreibe einen detailierten Bericht über diese Unit. | |
| 92 | + | ``` | |
| 73 | 93 | ||
| 74 | 94 | ## Beispiel für testfpcsrcunitrules | |
| 75 | 95 | ||
| 76 | - | ||
| 77 | - | ||
| 78 | - | ||
| 96 | + | Öffnen Sie die Datei 'testfpcsrcunitrules.lpi' in der IDE und kompilieren Sie sie. Starten Sie dann das Werkzeug in einer Befehlszeile/Konsole: | |
| 97 | + | ``` | |
| 98 | + | ./testfpcsrcunitrules -F ~/fpc/sources/2.5.1/fpc/ | |
| 99 | + | ``` | |
| 79 | 100 | ||
| 80 | - | ||
| 101 | + | Dadurch erfahren Sie, welcher Kompiler benutzt wird, welcher Kompiler ausgeführt wird, welche Konfigurationsdateinen getestet und analysiert wurden, Sie werden gewarnt über doppelte Units im FPC-Suchpfad und doppelte Quelltextdateien für die selbe Unit. | |
| 81 | 102 | ||
| 82 | 103 | ## Doppelte Quelltextdateien | |
| 83 | 104 | ||
| 84 | - | ||
| 85 | - | ||
| 86 | - | ||
| 87 | - | ||
| 88 | - | ||
| 105 | + | Angenommen, Sie finden heraus, dass die CodeTools für das Ziel 'wince/arm' den falschen Quelltext der Unit _mmsystem_ öffnen. Starten Sie das Werkzeug mit dem Parameter '-u': | |
| 89 | 106 | ||
| 90 | - | ||
| 91 | - | ||
| 92 | - | ||
| 93 | - | ||
| 107 | + | ./testfpcsrcunitrules -F ~/fpc/2.5.1/fpc/ -T wince -P arm -u mmsystem | |
| 94 | 108 | ||
| 95 | - | ||
| 109 | + | Dadurch erhalten Sie einen detaillierten Bericht darüber, wo diese Unit gefunden wurde und welches Score jede Quelltextdatei erzielt hat. Zum Beispiel: | |
| 110 | + | ``` | |
| 111 | + | Unit report for mmsystem | |
| 112 | + | WARNING: mmsystem is not in PPU search path | |
| 113 | + | GatherUnitsInFPCSources UnitName=mmsystem File=packages/winunits-base/src/mmsystem.pp Score=11 | |
| 114 | + | GatherUnitsInFPCSources UnitName=mmsystem File=packages/winceunits/src/mmsystem.pp Score=11 => duplicate | |
| 115 | + | ``` | |
| 96 | 116 | ||
| 97 | - | ||
| 117 | + | Dies bedeutet, dass es zwei Quelltextdateien mit dem selben Score gibt, sodass die CodeTools die erste genommen haben. Die letzte im Verzeichnis 'winceunits' ist für das Ziel 'wince' und die erste ist für 'win32' und 'win64'. | |
| 98 | 118 | ||
| 99 | - | ||
| 119 | + | Öffnen Sie jetzt die Regeldatei 'fpcsrcrules.inc'. | |
| 100 | 120 | ||
| 101 | - | ||
| 121 | + | Regeln arbeiten so: | |
| 122 | + | ``` | |
| 102 | 123 | Score:=10; | |
| 103 | - | ||
| 104 | - | ||
| 124 | + | Targets:='wince'; | |
| 125 | + | Add('packages/winceunits'); | |
| 105 | 126 | ``` | |
| 106 | 127 | ||
| 107 | - | ||
| 128 | + | Das **Add** fügt eine Regel hinzu für alle Dateien, die mit 'packages/winceunits' beginnen. Zum Score all dieser Dateien wird 10 addiert. **Targets** ist eine durch Kommas getrennte Liste von Zielbetriebssystemen und/oder Zielprozessoren. Beispielsweise: Targets='wince,linux,i386' bedeutet: wende diese Regel auf das ZielOS 'wince' oder 'linux' und auf die ZielCPU i386 an. | |
| 108 | 129 | ||
| 109 | 130 | # Wie die CodeTools Quelltexte untersuchen, abhängig von einem Kompiler | |
| 110 | 131 | ||
| 111 | - | ||
| 112 | - | ||
| 113 | - | ||
| 132 | + | Ein Kompiler ist dazu optimiert den Code linear zu durchlaufen und die benötigten Units und Includedateien dann zu laden, wenn er einen uses-Abschnitt oder eine Direktive findet. Die CodeTools sind dazu optimiert, nur Teile des Codes zu untersuchen. Beispielsweise braucht der Sprung von einer Methodendeklaration zum Methodenrumpf nur die Unit und ihre Includedateien. Wenn die CodeTools eine Deklaration suchen, dann suchen sie rückwärts. Das bedeutet, sie starten die Suche in den lokalen Variablen und dann oberhalb in der Implementation. Wenn sie einen uses-Abschnitt vorfinden, suchen sie den Bezeichner im Abschnitt 'interface' der Units. Wird der Bezeichner gefunden, halten sie an. Das Ergebnis und einige Zwischenschritte werden gecached. Weil oftmals nur einige interface-Abschnitte durchsucht werden müssen, wird ein einzelner Bezeichner rasch gefunden. | |
| 114 | 133 | ||
| 115 | - | ||
| 116 | - | ||
| 117 | - | ||
| 118 | - | ||
| 119 | - | ||
| 134 | + | Die CodeTools durchsuchen einen Quelltext nicht in einem Durchgang wie ein Kompiler, sondern in mehreren Durchgängen, abhängig von den Erfordernissen der aktuellen Funktion: | |
| 120 | 135 | ||
| 121 | - | ||
| 136 | + | * Zuerst wird ein Quelltext in einen TCodeBuffer geladen. Die IDE benutzt diesen Schritt, um die Kodierung in UTF8 zu ändern. Die Dateien werden im Speicher gehalten und nur nachgeladen, wenn sich das Änderungsdatum ändert oder eine Datei manuell umgeändert wird. Es gibt einige Tools und Funktionen die direkt mit dem Puffer arbeiten. | |
| 137 | + | * Die nächste Ebene ist das Untersuchen einer Unit oder Includedatei. Eine Unit muss vom Anfang an durchlaufen werden, deshalb versuchen die CodeTools die Hauptdatei herauszufinden, die erste Datei einer Unit. Dabei suchen sie in der ersten Zeile nach einer Direktive, wie {%MainUnit ../lclintf.pp}. Falls diese nicht existiert, wird der 'includelink cache' durchsucht. Die IDE speichert diesen Cache auf dem Laufwerk, so lernt die IDE mit der Zeit dazu. | |
| 138 | + | * Nachdem die Hauptdatei gefunden wurde, scannt TLinkScanner den Quelltext. Er verarbeitet Kompilerdirektiven, wie Include-Direktiven und 'if-else'-Direktiven. Dem Scanner kann ein Bereich übergeben werden, beispielsweise um nur das Interface einer Unit zu durchsuchen. Der Scanner erzeugt den **clean source**. Der 'clean source' besteht aus allen Includedateien und befreit von sämtlichen übersprungenen Codestellen aus den 'else'-Teilen. Er erzeugt auch eine Liste von **links** , die den 'clean source' und die realen Quelltextdatein verbinden. Der 'clean source' ist jetzt Pascal. Beachten Sie: es gibt auch Tools, um eine einzelne Quelle nach allen Direktiven zu durchsuchen und einen Direktivenbaum zu erstellen. | |
| 139 | + | * Nach dem Erzeugen des 'clean source' untersucht ein TCodeTool diesen und erstellt einen Baum von 'TCodeTreeNode'-Elementen. Auch hier ist eine Bereichsangabe möglich. Dieser Parser überspringt einige Teile, zum Beispiel 'class members', 'begin..end'-Blocks und Parameterlisten. Viele Tools brauchen diese nicht. Diese Unterknoten werden nur bei Bedarf erzeugt. Ein TCodeTreeNode hat einen Bereich StartPos..EndPos, welche 'clean positions' sind, also Positionen im 'clean source'. Es gibt nur Knoten für die wichtigen Teile. Knoten für jedes Detail zu erstellen würde mehr Speicher benötigen als der Quelltext selbst und ist auch selten erforderlich. Zahlreiche Funktionen sind dazu da, die Details herauszufinden. Ob beispielsweise eine Funktion der Aufrufskonvention 'cdecl' entspricht. | |
| 140 | + | * Wird ein Bezeichner gesucht, dann speichert die Suche die gefundenen Basistypen und erzeugt Caches für alle Bezeichner aus dem Interface-Abschnitt. | |
| 122 | 141 | ||
| 123 | - | ||
| 142 | + | Jede Ebene hat ihre eigenen Caches, die vor dem Aufruf einer Funktion geprüft und aktualisiert werden müssen. Viele High-level-Funktionen, auf die mittels 'CodeToolBoss' zugegriffen werden kann, machen das automatisch. Für andere liegt die Verantwortung beim aufrufenden Prozess. | |
| 124 | 143 | ||
| 125 | - | ||
| 144 | + | Ein Beispiel dafür: | |
| 126 | 145 | ||
| 127 | - | ||
| 146 | + | unti1.pas: | |
| 147 | + | ``` | |
| 128 | 148 | unit Unit1; | |
| 129 | - | ||
| 130 | - | ||
| 131 | - | ||
| 132 | - | ||
| 133 | - | ||
| 134 | - | ||
| 135 | - | ||
| 136 | - | ||
| 137 | - | ||
| 149 | + | {$I settings.inc} | |
| 150 | + | interface | |
| 151 | + | uses | |
| 152 | + | {$IFDEF Flag} | |
| 153 | + | unix, | |
| 154 | + | {$ELSE} | |
| 155 | + | windows, | |
| 156 | + | {$ENDIF} | |
| 157 | + | Classes; | |
| 138 | 158 | ``` | |
| 139 | 159 | ||
| 140 | - | ||
| 141 | - | ||
| 142 | - | ||
| 160 | + | settings.inc: | |
| 161 | + | ``` | |
| 143 | 162 | {%MainUnit unit1.pas} | |
| 144 | - | ||
| 163 | + | {$DEFINE Flag} | |
| 145 | 164 | ``` | |
| 146 | 165 | ||
| 147 | - | ||
| 148 | - | ||
| 149 | - | ||
| 166 | + | clean source: | |
| 167 | + | ``` | |
| 150 | 168 | unit Unit1; | |
| 151 | - | ||
| 152 | - | ||
| 153 | - | ||
| 154 | - | ||
| 155 | - | ||
| 156 | - | ||
| 157 | - | ||
| 158 | - | ||
| 169 | + | {$I settings.inc}{%MainUnit unit1.pas} | |
| 170 | + | {$DEFINE Flag} | |
| 171 | + | interface | |
| 172 | + | uses | |
| 173 | + | {$IFDEF Flag} | |
| 174 | + | unix, | |
| 175 | + | {$ELSE}{$ENDIF} | |
| 176 | + | Classes; | |
| 159 | 177 | ``` | |
| 160 | 178 | ||
| 161 | - | ||
| 179 | + | ||
| 180 | + | Tipp: Um eine Unit einfach zu durchlaufen und die Knoten zu erstellen, verwenden Sie **CodeToolBoss.Explore**. | |
| 162 | 181 | ||
| 163 | 182 | # Clean Position und Kursorposition | |
| 164 | 183 | ||
| 165 | - | ||
| 184 | + | Es gibt verschiedene Methoden, um in den CodeTools eine Position zu definieren. | |
| 166 | 185 | ||
| 167 | - | ||
| 186 | + | Die absolute Position bezieht sich auf den Quelltext als Zeichenkette und beginnt bei 1. Beispielsweise hält ein TCodeBuffer den Dateiinhalt als Zeichenkette in der Eigenschaft 'Source'. Die Positionen der Einfügemarke oder des Kursors sind als X,Y gegeben, wobei Y die Zeilennummer ist (bei 1 beginnend) und X die Spaltennummer (bei 1 beginnend). Ein TCodeBuffer stellt zum Umwandeln die Funktionen **LineColToPosition'_und_** _AbsoluteToLineCol_ zur Verfügung. Wenn Sie mit mehreren Quelltextdateinen arbeiten, wie einer Unit, die aus verschiedenen Includedateien bestehen kann, dann bezieht sich 'Clean Position' auf die absolute Position im bereinigten Code **Src**. Src ist eine Zeichenkette und Clean Positions beginnt bei 1. Die Kursorpositionen werden angegeben als TCodeXYPosition (Code,X,Y). Ein TCodeTool stellt zum Umwandeln die Funktionen **CaretToCleanPos** , **CleanPosToCaret** zur Verfügung. | |
| 168 | 187 | ||
| 169 | 188 | # Einfügen, Löschen und Ersetzen - der TSourceChangeCache | |
| 170 | 189 | ||
| 171 | - | ||
| 190 | + | Wenn Sie Änderungen am Quelltext einer Unit (oder ihrer Includedateien) vornehmen, sollten Sie dazu 'CodetoolBoss.SourceChangeCache' benutzen, weil: | |
| 172 | 191 | ||
| 173 | - | ||
| 174 | - | ||
| 175 | - | ||
| 176 | - | ||
| 177 | - | ||
| 178 | - | ||
| 179 | - | ||
| 180 | - | ||
| 181 | - | ||
| 192 | + | * Einfache Anwendung. Verbinden, ersetzen, ersetzen, ... anwenden. Siehe unten. | |
| 193 | + | * Sie benutzen 'cleanpos' wie durch den Knotenbaum gegeben ODER Sie benutzen die direkten Positionen in einer Datei. | |
| 194 | + | * Sie können 'Replace' zum Einfügen und Löschen benutzen. Dies löst automatisch Ereignisse aus, wodurch verbundene Editoren über Veränderungen benachrichtigt werden. | |
| 195 | + | * Es können automatisch benötigte Leerzeichen eingefügt werden, ebenso Zeilenendezeichen oder Leerzeilen vor doer nach jedem Replace. Zum Beispiel definieren Sie, dass jeweils eine Leerzeile voran gehen soll. Der SourceChangeCache prüft, was eingefügt werden soll, wie viel Platz bereits dort ist und wird den notwendigen Platz einfügen. | |
| 196 | + | * Er überprüft, ob der Bereich für Ersetzen/Löschen beschreibbar ist. | |
| 197 | + | * Sie können mehrfache Ersetzungen vornehmen und Sie steuern, wann diese angewendet werden. Bedenken Sie dabei, dass das Einfügen von Code bedeutet, dass der untersuchte Baum ungültig wird und neu erstellt werden muss. | |
| 198 | + | * Mehrfache Ersetzungen werden auf Überschneidungen geprüft. Zum Beispiel erhalten Sie beim Einfügen in der Mitte eines gelöschten Codes eine Fehlermeldung. | |
| 199 | + | * Mehrfache Ersetzungen an der selben Stelle werden reihenweise abgearbeitet (nach dem FIFO-Prinzip). | |
| 200 | + | * Sie können verschiedene Funktionen zum Bearbeiten von Code zu einer größeren Funktion kombinieren. Siehe unten. | |
| 182 | 201 | ||
| 183 | 202 | ## Verwendung | |
| 184 | 203 | ||
| 185 | - | ||
| 186 | - | ||
| 187 | - | ||
| 188 | - | ||
| 189 | - | ||
| 190 | - | ||
| 191 | - | ||
| 192 | - | ||
| 193 | - | ||
| 194 | - | ||
| 195 | - | ||
| 196 | - | ||
| 197 | - | ||
| 198 | - | ||
| 199 | - | ||
| 200 | - | ||
| 201 | - | ||
| 202 | - | ||
| 203 | - | ||
| 204 | - | ||
| 205 | - | ||
| 206 | - | ||
| 207 | - | ||
| 208 | - | ||
| 204 | + | Der SourceChangeCache arbeitet mit einer Unit, deshalb müssen Sie ein TCodeTool nehmen und eine Unit/Includedatei damit scannen. Zum Beispiel: | |
| 209 | 205 | ``` | |
| 206 | + | // Schritt 1: lade die Datei und untersuche sie | |
| 207 | + | Code:=CodeToolBoss.LoadFile(Filename,false,false); | |
| 208 | + | if Code=nil then | |
| 209 | + | raise Exception.Create('loading failed '+Filename); | |
| 210 | + | if not CodeToolBoss.Explore(Code,Tool,false) then | |
| 211 | + | ...;// Fehler beim Untersuchen ... | |
| 212 | + | ||
| 213 | + | // Schritt 2: verbinde mit dem SourceChangeCache | |
| 214 | + | CodeToolBoss.SourceChangeCache.MainScanner:=Tool.Scanner; | |
| 215 | + | ||
| 216 | + | // Schritt 3: nimm Replace zum Einfügen und/oder Löschen von Code. | |
| 217 | + | // Die beiden ersten Parameter sind die benötigten Leerzeichen vor und hinter der Einfügestelle. | |
| 218 | + | // FromPos, ToPos legen den gelöschten/ersetzten Bereich in CleanPos-Positionen fest. | |
| 219 | + | // NewCode ist die Zeichenkette des neuen Codes. Verwenden Sie '' zum Löschen. | |
| 220 | + | if not CodeToolBoss.SourceChangeCache.Replace(gtNone,gtNone,FromPos,ToPos,NewCode) then | |
| 221 | + | exit; // z.B. Quelltext ist nicht beschreibbar oder ein vorangegangenes Ersetzen hat diese Stelle gelöscht | |
| 222 | + | ...einige weitere Ersetzungen... | |
| 223 | + | ||
| 224 | + | // Schritt 4: wende die Änderungen an | |
| 225 | + | if not CodeToolBoss.SourceChangeCache.Apply then | |
| 226 | + | exit; // Anwendung wurde abgebrochen | |
| 227 | + | ``` | |
| 210 | 228 | ||
| 211 | 229 | ## BeginUpdate/EndUpdate | |
| 212 | 230 | ||
| 213 | - | ||
| 214 | - | ||
| 215 | - | ||
| 216 | - | ||
| 217 | - | ||
| 218 | - | ||
| 219 | - | ||
| 220 | - | ||
| 221 | - | ||
| 222 | - | ||
| 223 | - | ||
| 224 | - | ||
| 225 | - | ||
| 226 | - | ||
| 227 | - | ||
| 228 | - | ||
| 229 | - | ||
| 230 | - | ||
| 231 | - | ||
| 232 | - | ||
| 233 | - | ||
| 234 | - | ||
| 231 | + | BeginUpdate/EndUpdate verzögert die Anwendung. Dies ist nützlich, wenn Sie verschiedene Code ändernde Funktionen kombinieren. Zum Beispiel: | |
| 235 | 232 | ||
| 236 | - | ||
| 237 | - | ||
| 238 | - | ||
| 233 | + | Sie wollen die Unit scannen, fügen eine Unit in der uses-Klausel des Interface-Bereichs hinzu und entfernen die Unit aus der uses-Klausel des Implementation-Bereichs. Die zwei Funktionen 'AddUnitToMainUsesSection' und 'RemoveUnitFromUsesSection' benutzen 'Apply', ändern den Quelltext, sodass die zweite Funktion die Unit ein zweites Mal scannen würde. Weil aber beide Funktionen voneinander unabhängig sind (Sie verändern verschiedene Teile des Quelltextes) können Sie beide miteinander kombinieren und nur einen Scan machen: | |
| 239 | 234 | ``` | |
| 235 | + | // Schritt 1: durchsuche die Unit und verbinde mit SourceChangeCache | |
| 236 | + | if not CodeToolBoss.Explore(Code,Tool,false) then | |
| 237 | + | ...;// Fehler beim Untersuchen ... | |
| 238 | + | CodeToolBoss.SourceChangeCache.MainScanner:=Tool.Scanner; | |
| 239 | + | ||
| 240 | + | // Schritt 2: verzögere die Anwendung | |
| 241 | + | CodeToolBoss.SourceChangeCache.BeginUpdate; | |
| 242 | + | ||
| 243 | + | // Schritt 3: füge die Unit zum Interface-Bereich hinzu | |
| 244 | + | // AddUnitToMainUsesSection würde angewendet und den Code ändern | |
| 245 | + | // Wegen BeginUpdate finden die Änderungen noch nicht statt, werden aber in SourceChangeCache gespeichert | |
| 246 | + | if not Tool.AddUnitToMainUsesSection('Classes','',CodeToolBoss.SourceChangeCache) then exit; | |
| 247 | + | ||
| 248 | + | // Schritt 4: entferne die Unit aus dem Implementation-Bereich | |
| 249 | + | // Ohne BeginUpdate würde RemoveUnitFromUsesSection die Unit erneut scannen | |
| 250 | + | if Tool.FindImplementationUsesSection<>nil then | |
| 251 | + | if not Tool.RemoveUnitFromUsesSection(Tool.FindImplementationUsesSection,'Classes',CodeToolBoss.SourceChangeCache) then exit; | |
| 252 | + | ||
| 253 | + | // Schritt 5: wende alle Änderungen an | |
| 254 | + | if not CodeToolBoss.SourceChangeCache.EndUpdate then | |
| 255 | + | exit; // Anwendung wurde abgebrochen | |
| 256 | + | ``` | |
| 240 | 257 | ||
| 241 | - | ||
| 258 | + | BeginUpdate/EndUpdate arbeiten mit einem Zähler, wenn Sie also BeginUpdate zwei Mal aufrufen, müssen Sie auch EndUpdate zwei Mal aufrufen. Dies bedeutet, dass Sie obiges Beispiel in eine Funktion stellen und mit einer weiteren Funktion kombinieren können. | |
| 242 | 259 | ||
| 243 | 260 | ## Speichern Sie die Änderungen auf Disk | |
| 244 | 261 | ||
| 245 | - | ||
| 262 | + | Die obigen Änderungen werden nur in den Codepuffern gemacht und diese Puffer als 'verändert' markiert. Um die Änderungen auf Disk zu speichern, müssen Sie für jeden veränderten Puffer 'Save' aufrufen. | |
| 246 | 263 | ||
| 247 | - | ||
| 248 | - | ||
| 264 | + | * Die Puffer, die mit dem nächsten Apply/EndUpdate geändert werden liegen in 'SourceChangeCache.BuffersToModify' und 'BuffersToModifyCount'. | |
| 265 | + | * Die Ereignisse 'SourceChangeCache.OnBeforeApplyChanges/OnAfterApplyChanges' werden von CodeToolBoss benutzt, der sie mit seinen eigenen 'OnBeforeApplyChanges/OnAfterApplyChanges' verbindet. Die Lazarus-IDE setzt diese Ereignisse und öffnet automatisch die geänderten Dateien im Quelltexteditor, dadurch scheinen alle Änderungen in der Undo-Liste von Synedit auf. | |
| 249 | 266 | ||
| 250 | 267 | # Links | |
| 251 | 268 | ||
| 252 | - | ||
| 253 | - | ||
| 254 | - | ||
| 269 | + | * [[Lazarus IDE Tools/de|Lazarus IDE Tools (deutsch)]] \- Ein Tutorial über die eingebauten Werkzeuge der Standard-IDE. | |
| 270 | + | * [[Cody]] \- ein IDE-Package mit fortgeschrittenen CodeTools. | |
| 271 | + | * [[Extending the IDE/de|Erweitern der IDE (deutsch)]] \- Wie Sie Ihre eigenen CodeTool-Plugins für die IDE schreiben. | |
| 255 | 272 | ||
| 256 | 273 | --- | |
| 257 | - | ||
| 274 | + | *From the Free Pascal wiki, page "Codetools/de", as the Internet Archive kept it on 2023-06-07. 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).* |