LazUpdater Handbuch V1.0.0 - cc-by - Ingo Steiniger 07.01.2011
Inhalt 1 Voraussetzungen................. oraussetzungen........................................ .............................................. .............................................. .................................................................3 ..........................................3 1.1 Windows................. Windows........................................ .............................................. .............................................. .................................................................. ..............................................3 ...3 1.2 Linux.................................. Linux......................................................... .............................................. .............................................. .............................................. ................................... ............33 1.3 MacOS................................ MacOS....................................................... .............................................. .............................................. ..................................................... ..................................3 ....3 2 Oberfläche............................... Oberfläche...................................................... .............................................. .............................................. .................................................. .....................................4 ..........4 2.1 Überblick.................................. Überblick......................................................... .............................................. ..................................................................... ...................................................4 .....4 2.1.1 Profilverwaltung................................... Profilverwaltung.......................................................... .............................................. .............................................. ................................4 .........4 2.1.2 Tabelle der Aufgaben.......................................... Aufgaben................................................................. ..................................................... ........................................5 ..........5 2.1.3 Revisionen............................ Revisionen................................................... .............................................. .............................................. ................................................5 .........................5 2.2 Start....................................... Start............................................................... ............................................... .............................................. ......................................................6 ...............................6 2.2.1 Los..................................... Los............................................................ .............................................. .............................................. ...................................................6 ............................6 2.2.2 Stopp.................................... Stopp........................................................... .............................................. ................................................................... ................................................7 ....7 2.2.3 Zeige Log...................................... Log............................................................. .............................................. ..............................................................7 .......................................7 2.2.4 Ausgabe Speichern.......................... Speichern................................................. .............................................. .............................................. ................................... ..............7 ..7 2.2.5 Über...................................... Über............................................................. .............................................. .............................................. ................................................7 .........................7 2.2.6 Ausgabe.......................... Ausgabe................................................. .............................................. .............................................. ......................................................7 ...............................7 2.3 FPC.................................... FPC........................................................... .............................................. .............................................. .................................................. ...................................8 ........8 2.3.1 Aktualisieren............................ Aktualisieren................................................... .............................................. ............................................................. ............................................8 ......8 2.3.2 Pfad für die FPC-Sourcen........................... FPC-Sourcen.................................................. .............................................. .................................... .........................8 ............8 2.3.3 CheckOut-URL für FPC.................................... FPC........................................................... .............................................. ..........................................9 ...................9 2.3.4 Optionen für „svn update“..................................... update“............................................................ ................................................ .....................................9 ............9 2.3.5 Erstellen..................................... Erstellen............................................................ .............................................. ................................................... ......................................... ..............9 .9 2.3.6 Optionen für „Make“............................. „Make“.................................................... ..................................................................... .....................................................9 .......9 2.3.7 Immer......................................... Immer................................................................ .............................................. .............................................. ...................................... ...................9 ....9 2.3.8 Installieren.................................... Installieren........................................................... .............................................. .............................................. ......................................10 ...............10 2.3.9 Pfad zum FPC-Installations-Verzeichnis(„INST FPC-Installations-Verzeichnis(„INSTALL_PREFIX=“)....... ALL_PREFIX=“).................................10 ..........................10 2.3.10 Optionen für „make install“........................................... install“.................................................................. ......................................... .........................10 .......10 2.4 Lazarus............................... Lazarus...................................................... .............................................. .............................................. ........................................................11 .................................11 2.4.1 Aktualisieren............................ Aktualisieren................................................... .............................................. .............................................. ...........................................1 ....................111 2.4.2 Pfad für Lazarus .......................................................... ................................................................................. ............................................. .............................11 .......11 2.4.3 CheckOut-URL für Lazarus ...................................................... ............................................................................. ................................... ...............12 ...12 2.4.4 Optionen für „svn update“ ................................................ ........................................................................................ ..............................................12 ......12 2.4.5 Lazarus mit „make“ erstellen ........................................... .................................................................. ...............................................12 ........................12 2.4.6 Optionen für „Make“ ........................................... .................................................................. .......................................... ................................ .................12 ....12 2.4.7 Lazarus mit „LazBuild“ erstellen .............................................................. ....................................................................................12 ......................12 2.4.8 Optionen für „LazBuild“ ....................................................... .............................................................................. ..........................................13 ...................13 2.4.9 Immer nach FPC ............................................ ................................................................... .......................................................... ..........................................13 .......13 2.4.10 Immer ............................................. .................................................................... ............................................... ........................................................13 ................................13 2.4.11 2.4.11 Strip....................................... Strip.............................................................. .............................................. .............................................. ...................................... ....................13 .....13 2.5 Werkzeuge.......................... erkzeuge................................................. .............................................. .............................................. .............................................. .................................14 ..........14 2.6 Konfigurationsdatei......................... Konfigurationsdatei................................................. ............................................... ..................................................... .........................................14 ...........14 2.6.1 PATH erweitern................................... erweitern.......................................................... ............................................... ......................................................15 ..............................15 2.6.2 Erstelle Sym-Links............................... Sym-Links...................................................... .............................................. .............................................. ..............................15 .......15 2.6.3 XXX-Binärdatei................................ XXX-Binärdatei....................................................... ............................................... ........................................................16 ................................16 3 Praktische Beispiele................................. Beispiele........................................................ .............................................. .............................................. ..........................................17 ...................17 3.1 Vorhandene SVN-Installation aktualisieren............................ aktualisieren................................................... .................................................17 ..........................17 3.2 Neue SVN-Installation erstellen................................................ erstellen....................................................................... ......................................... .......................17 .....17 4 FAQ....................................... AQ.............................................................. .............................................. .............................................. ............................................... ..................................... .............19 19 1
2
1 Voraussetzungen LazUpdater selbst hat keine besonderen Systemvoraussetzungen, aber damit das herunterladen und anschließende kompilieren funktioniert, müssen einige Voraussetzungen erfüllt sein.
1.1 Windows •
•
•
SVN -Client: LazUpdater benutzt das Kommandozeilenprogramm „svn“ um die Quellen herunter zu laden. Das Paket Silk-SVN wurde erfolgreich getestet und kann unter http://www.sliksvn.com/en/download heruntergeladen werden. Entwicklerwerkzeuge: Zum erstellen von Binärdateien sind mehrere Programme notwendig, welche nicht direkt vom FPC-/Lazarus-Projekt gepflegt werden. Sie können von http://svn.freepascal.org/svn/fpcbuild/trunk/install/binw32/ heruntergeladen werden. Das Zielverzeichnis auf der Festplatte sollte anschließend der Umgebungsvariable PATH hinzugefügt werden. Bootstrap-Compiler: Ist noch keine FPC-Installation auf dem System vorhanden, dann wird ein Compiler benötigt. Dieser kann von ftp://ftp.freepascal.org/pub/fpc/dist/2.4.2/bootstrap/ heruntergeladen und anschließend entpackt werden.
1.2 Linux •
•
•
SVN-Client: Es wird das Paket „subversion“ benötigt. Entwicklerwerkzeuge und -bibliotheken: Unter Ubuntu 10.10 konnte ich folgende Abhängigkeiten erkennen: make, libatk1.0-0 (>=1.29.3), libc6 (>=2.2.5), libcairo2 (>=1.2.4), libgdk-pixbuf2.0-0 (>=2.21.6), libglib2.0-0 (>=2.12.0), libgtk2.0-0 (>=2.8.0), libpango1.0-0 (>=1.14.0), libx11-6, libgtk2.0-dev, libogg-dev, libvorbis-dev, a52dec-dev, libdts-dev, libmad0-dev, libmodplug-dev Bootstrap-Compiler: Ist noch keine FPC-Installation auf dem System vorhanden, dann wird ein Compiler benötigt. Dieser kann von ftp://ftp.freepascal.org/pub/fpc/dist/2.4.2/bootstrap/ heruntergeladen und anschließend entpackt werden.
1.3 MacOS •
•
•
3
Xcode-Tools: Diese Paket enthält alle benötigten Entwicklerwerkzeuge und -bibliotheken und den SVN-Client. Es befindet sich auf der MacOS-InstallationsDVD. Fpc-xcode-
.pkg: Enthält zusätzliche Templates für die Xcode-Tools. Es ist im fpc.-macos.dmg enthalten und kann unter http://sourceforge.net/projects/freepascal/files/Mac%20OS%20X/ heruntergeladen werden. Bootstrap-Compiler: Ist noch keine FPC-Installation auf dem System vorhanden, dann wird ein Compiler benötigt. Dieser kann von ftp://ftp.freepascal.org/pub/fpc/dist/2.4.2/bootstrap/ heruntergeladen und anschließend entpackt werden.
2 Oberfläche In diesem Kapitel wird die Oberfläche und Funktionsweise von LazUpdater beschrieben.
2.1 Überblick
Der Kopf von LazUpdater besteht aus der Profilverwaltung, einer Tabelle der Aufgaben und Informationen über die installierte Revision, von Lazarus und FPC. Diese Übersicht ist jederzeit sichtbar.
2.1.1 Profilverwaltung Mit den Profilen lassen sich verschieden Installationen und Installations-/Updateeinstellungen verwalten. Man kann z.B. eine Installation der aktuellen Entwicklerversion ( trunk ) und eine andere Installation der letzten stabilen Version mit Updates ( fixes ) einrichten. Die Namen der Profile sind frei wählbar. Gespeichert werden die Profile beim beenden von LazUpdater, beim Wechsel des Profils und beim Start der Aktualisierung.
4
2.1.2 Tabelle der Aufgaben Die Tabelle listet alle Aufgaben auf, die zur Erledigung anstehen und in welchem Stadium sich die Aufgabe befindet. Die Tabelle wird ständig aktualisiert um jederzeit zu sehen, was LazUpdater tut oder vor hat. Während einer Aktualisierung ändert sich die Farbe der jeweiligen Aufgabe, abhängig vom Status. Folgende Farben werden verwendet. Schwarz – breit Blau – in Arbeit Grün – erledigt Gelb – unverändert Grau - übersprungen Rot – Fehler
2.1.3 Revisionen Unterhalb des LazUpdater-Logos wird angezeigt welche SVN-Revision, in dem Quellcodeverzeichnis von FPC bzw. Lazarus, gefunden wurde. Dafür wird die Datei entries , im .svn-Verzeichnis im Basisverzeichnis des Quellcodes, ausgewertet. Die Revisionsnummer ändert, während einer Aktualisierung, die Farbe von schwarz zu grün, wenn eine neue Revision heruntergeladen wurde. Wurde keine Revision erkannt, erscheint eine rote Null.
5
2.2 Start
Diese Seite steuert den Aktualisierungsvorgang und verwaltet die erzeugte Ausgabe.
2.2.1 Los Startet den Aktualisierungsvorgang. Dabei wird als erstes das aktuelle Profil gespeichert. Anschließend wird überprüft, ob die Einstellungen komplett sind. Soll eine Lazarusinstallation aktualisiert werden, wird eine Warnung ausgegeben, dass Lazarus geschlossen sein muss. Jetzt werden die Aufgaben abgearbeitet und deren Ausgaben in Ausgabe angezeigt. [INFO] Die Kommandozeilenbefehle der Aufgaben, werden mit TProcess ausgeführt und die Ausgabe in das TMemo umgeleitet.
6
2.2.2 Stopp Bricht den aktuell laufenden Prozess ab. ACHTUNG! Wenn man einen Aktualisierungsvorgang ( svn update) abbricht, führt das üblicherweise dazu, dass die Versionsverwaltung zerstört wird. Das kann meist nur mit einem erneuten, kompletten Download der Quelltexte berichtigt werden. Wird ein „Erstellen“-Vorgang ( make) abgebrochen, dann kann es passieren, dass dieser im Hintergrund dennoch weiter läuft. Der Grund sind von dem Hauptprozess gestartete Kindprozesse. Der Stopp-knopf kann immer nur den Hauptprozess stoppen. Deshalb sollte dieser Knopf nur benutzt werden, wenn man sich der Konsequenzen bewusst ist. [INFO] Entspricht TProcess.Terminate;
2.2.3 Zeige Log Zeigt die Änderungen, die am Quelltext vorgenommen wurden. Wurde der Quelltext von FPC und/oder Lazarus aktualisiert, an einer grünen Revisionsnummer zu erkennen, werden die Änderungen unter Ausgabe aufgelistet. [INFO] Entspricht svn log -r:
2.2.4 Ausgabe Speichern Speichert den Inhalt von Ausgabe in eine Textdatei. Nachdem ein Speicherort und Dateiname ausgewählt wurde, wird der komplette Inhalt von Ausgabe in diese Datei gespeichert.
2.2.5 Über Informationen über LazUpdater werden angezeigt.
2.2.6 Ausgabe Zeigt die Ausgaben der laufenden Aufgabe an. Die Ausgaben sind üblicherweise sehr detailliert und daher sehr lang. Über das Kontextmenü (rechte Maustaste) stehen 2 Optionen zur Verfügung. Kopieren: kopiert den markierten Text in die Zwischenablage Zeilenumbruch: Ist diese Option aktiviert, wird der Text automatisch in das Fenster eingepasst.
Andernfalls erscheint ein horizontaler Scrollbalken.
7
2.3 FPC
Diese Seite beinhaltet alle Pfadangaben und Parameter die zum installieren oder aktualisieren von FPC notwendig sind.
2.3.1 Aktualisieren Abhängig davon ob unter Pfad für die FPC-Sourcen eine versionierte Installation von FPC gefunden wird, wird Aufgabe FPC aktualisieren bzw. FPC auschecken aktiviert. Diese Aufgabe lädt den (die Änderungen am) Quellcode von FPC herunter. Gibt es zum Zeitpunkt der Aktualisierung keine Änderungen am Quelltext, werden die weiteren Aufgaben dieser Seite übersprungen. Ist die Option deaktiviert, können keine anderen Einstellungen auf dieser Seite geändert werden. [Info] Entspricht svn update bzw. svn checkout
2.3.2 Pfad für die FPC-Sourcen Hier wird eingetragen, wo der Quellcode von FPC liegt bzw. gespeichert werden soll. Mit dem Knopf dahinter [..] kann ein Verzeichnis ausgewählt werden. Ist der Pfad falsch, das Verzeichnis leer oder der Quellcode nicht versioniert, wird die Revisionsnummer rot und auf 0 gesetzt. Außerdem lautet die Aufgabe dann FPC auschecken und das nächste Eingabefeld CheckOut-URL für FPC wird aktiviert. Beim Auschecken wird das angegebene Verzeichnis angelegt, sollte es noch nicht existieren.
8
2.3.3 CheckOut-URL für FPC In dieses Eingabefeld wird die komplette Internetadresse eingetragen, aus welcher der Quellcode bei einem Checkout und den späteren Updates, bezogen werden soll. Das Eingabefeld muss für einen Checkout ausgefüllt sein. Bei einem Update ist es irrelevant. Gängige URLs sind: Entwicklerversion: http://svn.freepascal.org/svn/fpc/trunk derzeitige stabile Version*: http://svn.freepascal.org/svn/fpc/tags/release_2_4_2/ derzeitige stabile Version mit Fixes: http://svn.freepascal.org/svn/fpc/branches/fixes_2_4/ *bei dieser Version gibt es keine Veränderungen mehr, auch wenn sich die Revisionsnummer erhöht.
2.3.4 Optionen für „svn update“ Hier können zusätzliche Parameter, für den Befehl svn update/ svn ceckout, hinterlegt werden. z.B. -r16724 bringt den Quellcode auf den Stand der Revision 16724 oder --accept theirs-full weist svn an ohne Rückfrage bei Unstimmigkeiten, zwischen dem Quellcode auf der Festplatte und dem im Internet, den Quellcode aus dem Internet herunter zu laden. Mehr Informationen findet man unter http://svnbook.red-bean.com/.
2.3.5 Erstellen Aktiviert die Aufgabe FPC erstellen . Diese Aufgabe kompiliert die Quelldateien innerhalb der Ordnerstruktur des Quellcodes. [Info] Entspricht make
2.3.6 Optionen für „Make“ Hier können die Parameter, für den Befehl make, hinterlegt werden. Ist das Eingabefeld leer, wird automatisch clean all als Parameter übernommen. Mehr Informationen findet man unter http://wiki.freepascal.org/buildfaq.
2.3.7 Immer Erzwingt die Aufgabe FPC erstellen, auch wenn keine Änderung am Quelltext erfolgte. Ist die Option aktiv, wird das, in der Tabelle der Aufgaben, angezeigt.
9
2.3.8 Installieren Aktiviert die Aufgabe FPC installieren. Damit der FPC alle seine Dateien findet, benötigt er eine spezielle Ordnerstruktur. Diese Aufgabe erstellt diese Struktur, unterhalb von Pfad zum FPC-Installations-Verzeichnis und kopiert die bereits kompilierten Daten hinein. [Info] Entspricht make install INSTALL_PREFIX=< Pfad zum FPC-Installations-Verzeichnis>
2.3.9 Pfad zum FPC-Installations-Verzeichnis(„INSTALL_PREFIX=“) Hier wird eingetragen in welches Verzeichnis die Binärdateien installiert werden sollen. ACHTUNG! Ist das Eingabefeld leer, wird in den Standardordner (C:\PP bzw. /usr) installiert. Dieser Ordner benötigt eventuell Administratorrechte. Mit dem Knopf [..] dahinter, kann ein Verzeichnis ausgewählt werden.
2.3.10
Optionen für „make install“
Parameter für den Befehl make install können hier hinterlegt werden.
10
2.4 Lazarus
Diese Seite beinhaltet alle Pfadangaben und Parameter die zum installieren oder aktualisieren von Lazarus notwendig sind.
2.4.1 Aktualisieren Abhängig davon ob unter Pfad für Lazarus eine versionierte Installation von Lazarus gefunden wird, wird Aufgabe Lazarus aktualisieren bzw. Lazarus auschecken aktiviert. Diese Aufgabe lädt den (die Änderungen am) Quellcode von Lazarus herunter. Gibt es zum Zeitpunkt der Aktualisierung keine Änderungen am Quelltext, werden die weiteren Aufgaben dieser Seite übersprungen. Ist die Option deaktiviert, können keine anderen Einstellungen auf dieser Seite geändert werden. [Info] Entspricht svn update bzw. svn checkout
2.4.2 Pfad für Lazarus Hier wird eingetragen, wo der Quellcode von Lazarus liegt bzw. gespeichert werden soll. Mit dem Knopf dahinter [..] kann ein Verzeichnis ausgewählt werden. Ist der Pfad falsch, das Verzeichnis leer oder der Quellcode nicht versioniert, wird die Revisionsnummer rot und auf 0 gesetzt. Außerdem lautet die Aufgabe dann Lazarus auschecken und das nächste Eingabefeld CheckOut-URL für Lazarus wird aktiviert. Beim Auschecken wird das angegebene Verzeichnis angelegt, sollte es noch nicht existieren.
11
2.4.3 CheckOut-URL für Lazarus In dieses Eingabefeld wird die komplette Internetadresse eingetragen, aus welcher der Quellcode bei einem Checkout und den späteren Updates, bezogen werden soll. Das Eingabefeld muss für einen Checkout ausgefüllt sein. Bei einem Update ist es irrelevant. Gängige URLs sind: Entwicklerversion: http://svn.freepascal.org/svn/lazarus/trunk derzeitige stabile Version*: http://svn.freepascal.org/svn/lazarus/tags/lazarus_0_9_28_2/ derzeitige stabile Version mit Fixes: http://svn.freepascal.org/svn/lazarus/branches/fixes_0_9_28/ *bei dieser Version gibt es keine Veränderungen mehr, auch wenn sich die Revisionsnummer erhöht.
2.4.4 Optionen für „svn update“ Hier können Parameter, für den Befehl svn update / svn ceckout, hinterlegt werden. z.B. -r28890 bringt den Quellcode auf den Stand der Revision 28890 oder --accept theirs-full weist svn an ohne Rückfrage bei Unstimmigkeiten, zwischen dem Quellcode auf der Festplatte und dem im Internet, den Quellcode aus dem Internet herunter zu laden. Mehr Informationen findet man unter http://svnbook.red-bean.com/.
2.4.5 Lazarus mit „make“ erstellen Aktiviert die Aufgabe Lazarus erstellen. Diese Aufgabe kompiliert die Quelldateien innerhalb der Ordnerstruktur des Quellcodes. [Info] Entspricht make
2.4.6 Optionen für „Make“ Hier können zusätzliche Parameter, für den Befehl make, hinterlegt werden. Ist das Eingabefeld leer, wird automatisch clean all als Parameter übernommen. Mehr Informationen findet man unter http://wiki.freepascal.org/buildfaq.
2.4.7 Lazarus mit „LazBuild“ erstellen Aktiviert die Aufgabe Lazarus mit LazBuild erstellen . Diese Aufgabe kompiliert die Quelldateien innerhalb der Ordnerstruktur des Quellcodes. Im Gegensatz zu make, erstellt lazbuild alle installierten Packages. [Info] Entpricht make 12
2.4.8 Optionen für „LazBuild“ Hier können zusätzliche Parameter, für den Befehl lazbuild , hinterlegt werden. Ist das Eingabefeld leer, wird automatisch -B --build-ide= als Parameter übernommen. Mehr Informationen findet man in der Manpage (z.B. unter http://web.iesrodeira.com/cgi bin/man/man2html?lazbuild+1).
2.4.9 Immer nach FPC Führt die Aufgaben Lazarus erstellen und/oder Lazarus mit LazBuild erstellen aus, auch wenn keine Aktualisierung für Lazarus gefunden, jedoch FPC neu erstellt und installiert wurde.
2.4.10
Immer
Führt die Aufgaben Lazarus erstellen und/oder Lazarus mit LazBuild erstellen aus, auch wenn keine Aktualisierung für Lazarus oder FPC gefunden wurde.
2.4.11
Strip
Aktiviert die Aufgabe Lazarus-Binärdateien strippen. Unter strippen versteht man die Debuggersymbole, aus den ausführbaren Binärdateien, zu entfernen. Damit kann die Dateigröße enorm verringert werden. Mehr Informationen findet man unter http://wiki.freepascal.org/Size_Matters/de. [Info] Enspricht strip –strip-all lazarus / startlazarus / lazbuild
13
2.5 Werkzeuge
Diese Seite beinhaltet einige Werkzeuge zum verwalten der Installation(en).
2.6 Konfigurationsdatei Hier kann die Konfigurationsdatei von FPC bearbeitet, neu erstellt oder gelöscht werden. Werden mehrere Dateien angezeigt, wird gewöhnlich die oberste vom Compiler gelesen. Mehr Informationen findet man in der Manpage (z.B. unter http://linux.die.net/man/5/fpc.cfg).
Mit bearbeiten wird die gewählte Datei, in einem minimalistischen Texteditor, geöffnet und kann verändert werden. Entspricht einem Doppelklick auf die gewünschte Datei in der Liste. Mit löschen wird die gewählte Datei von der Festplatte entfernt. 14
Mit neu erstellen wird eine Vorlage, in welcher die Pfade der FPC-Installation bereits angepasst sind,in dem Editor geöffnet.
Der Editor bietet grundlegende Möglichkeiten, die Datei zu bearbeiten und zu speichern. Mit speichern als... kann der Dateiname und -pfad frei gewählt werden. Mit speichern wird die Datei unter dem ursprünglichen Namen gespeichert bzw. neue Dateien im Compilerpfad abgelegt.
2.6.1 PATH erweitern Erweitert die Umgebungsvariable PATH um den Pfad des bin-Verzeichnisses, des aktuell eingestellten FPC-Installationspfad. Damit wird der Compiler automatisch gefunden und muss nicht unter FPC-Binärdatei angegeben werden. Das ist nur notwendig, wenn man FPC auch außerhalb von Lazarus, z.b. auf der Kommandozeile nutzen möchte. Nach der Ausführung der Funktion, muss LazUpdater neu gestartet werden (Windows) bzw. ein erneuter Login erfolgen(Linux/MacOS).
2.6.2 Erstelle Sym-Links Unter Windows ist dieser Punkt nicht verfügbar, da nicht nötig. Erstellt symbolische Links des/der Compiler/s ins bin-Verzeichnis von FPC. Sind die/der Symlink nicht vorhanden, funktioniert FPC nicht.
15
2.6.3 XXX-Binärdatei Die angegebenen Programme können hier explizit ausgesucht werden. Damit ist es möglich Programmversionen zu nutzen, die nicht im PATH liegen. Sind die Eingabefelder leer, wird die erste Datei im PATH genutzt. Eine Ausnahme bildet LazBuild, da diese im Lazarusverzeichnis liegt, welcher für gewöhnlich nicht im PATH ist. Hier wird die Datei lazbuild im Pfad für Lazarus ausgeführt. Mit dem Knopf dahinter [..] kann die Datei ausgewählt werden.
16
3 Praktische Beispiele In diesem Kapitel wird, anhand typischer Situationen, die Bedienung von LazUpdater erklärt.
3.1 Vorhandene SVN-Installation aktualisieren Es ist bereits eine Installation von FPC und Lazarus, auf Basis der Quellen aus dem SVN, vorhanden? Dann wird wie folgt vorgegangen. •
•
•
•
•
•
Zunächst werden die Haken Aktualisieren , Erstellen und Installieren auf der Seite FPC aktiviert. Dann werden der Pfad für den FPC-Sourcen und der Pfad zum FPC-InstallationsVerzeichnis eingetragen. Parameter für die einzelnen Aufgaben können in die Optionsfelder eingetragen werden. Auf die gleiche Weise wird die Seite Lazarus bearbeitet. Wird ein spezieller Compiler benötigt, so kann er, auf der Seite Werkzeuge, eingetragen werden. Jetzt können die getroffenen Einstellungen mit Speichern als als neues Profil angelegt werden. Abschließend wird mit dem Knopf Los auf der Seite Start das Update gestartet. Bei zukünftige Updates muss lediglich überprüft werden, ob das richtige Profil geladen ist und der Knopf Los betätigt werden.
3.2 Neue SVN-Installation erstellen Es ist bereits eine nicht versionierte Installation von FPC und Lazarus vorhanden und es soll eine zusätzliche Installation, auf Basis der Quellen aus dem SVN, erstellt werden. •
•
•
•
•
•
17
Zunächst werden die Haken Aktualisieren , Erstellen und Installieren auf der Seite FPC aktiviert. Dann werden der Pfad für den FPC-Sourcen und der Pfad zum FPC-InstallationsVerzeichnis eingetragen. Außerdem muss die CheckOut-URL für FPC eingetragen werden. Parameter für die einzelnen Aufgaben können in die Optionsfelder eingetragen werden. Auf der Seite Lazarus sollten keine Aufgaben aktiviert sein. Wird ein spezieller Compiler benötigt, so kann er, auf der Seite Werkzeuge, eingetragen werden. Jetzt wird mit dem Knopf Los auf der Seite Start der Checkout für FPC gestartet. Wurde FPC erfolgreich erstellt und installiert, sollte mit dem Knopf Konfigurationsdatei auf der Seite Werkzeuge eine neue Konfigurationsdatei für FPC erstellt werden. Außerdem sollte die FPC-Binärdatei auf den neu erstellten FPC umgestellt werden. Nun werden die Aufgaben Aktualisieren und Lazarus mit „make“ erstellen , auf der Seite Lazarus, aktiviert und die CheckOut-URL für Lazarus , sowie der Pfad für Lazarus eingetragen. Jetzt können die getroffenen Einstellungen mit Speichern als als neues Profil angelegt werden.
•
•
Abschließend wird mit dem Knopf Los auf der Seite Start der Checkout für Lazarus gestartet. Sollten zu diesem Zeitpunkt bereits Aktualisierungen für FPC vorliegen, werden diese eingespielt und FPC neu erstellt. Bei zukünftige Updates muss lediglich überprüft werden, ob das richtige Profil geladen ist und der Knopf Los betätigt werden.
18
4 FAQ F: In einer älteren Version von LazUpdater hatte ich die Möglichkeit Nachrichten an den laufenden Prozess zu schicken. Warum geht das jetzt nicht mehr?
A: Diese Funktion hat nur unter bestimmten Voraussetzungen funktioniert (GTK2 mit asynchroner Ausgabe). Deshalb wurde es in der Version 1.0.0 deaktiviert. Sollte die Funktion jedoch benötigt werden, kann LazUpdater mit dem Parameter -async gestartet und die Funktion unter Werkzeuge/benutze asynchrone Ausgabe aktiviert werden. F: Ich möchte LazUpdater gern in eine andere Sprache übersetzten. Was muss ich tun?
A: Das ist technisch gesehen nicht schwer. Im Verzeichnis languages liegt die Datei lazupdater.po diese muss kopiert und in lazupdater..po umbenannt werden. Das entspricht dem zweistelligen Sprachkürzel, z.B. de für deutsch oder es für spanisch. Anschließend kann diese neue Sprachdatei mit einem geeigneten Werkzeug, wie POEdit, oder einem einfachen Texteditor bearbeitet werden. F: Wie kann ich eine andere Sprache wählen?
A: LazUpdater erkennt automatisch die im System eingestellte Sprache und benutzt die entsprechende po-Datei im Verzeichnis languages . Um diese Automation zu umgehen kann LazUpdater mit dem Parameter -l gestartet werden. Das entspricht dem zweistelligen Sprachkürzel, z.B. de für deutsch oder es für spanisch. F: Warum kann ich „erstellen“ nur auswählen, wenn ich „aktualisieren“ gewählt habe?
A: LazUpdater wurde konzipiert, den typischen Ablauf eines Updatevorgangs nachzubilden. Das bedeutet, erst die Quellen zu aktualisieren, dann das Programm zu kompilieren und abschließend, wenn nötig, zu installieren. Daraus ergab sich die Reihenfolge und der Zwang diese Reihenfolge einzuhalten, damit man nichts vergisst. Man kann jedoch das aktualisieren unterbinden, in dem man mit -r eine feste Revision angibt. Zusätzlich kann man den Punkt immer aktivieren und damit das kompilieren erzwingen, obwohl sich die Revision nicht verändert hat.
19