Howto for building an installer, german language.
authorJan-Oliver Wagner <jan@intevation.de>
Thu, 9 Mar 2006 15:28:24 +0000 (15:28 +0000)
committerJan-Oliver Wagner <jan@intevation.de>
Thu, 9 Mar 2006 15:28:24 +0000 (15:28 +0000)
doc/website/build-installer-de.htm4 [new file with mode: 0644]

diff --git a/doc/website/build-installer-de.htm4 b/doc/website/build-installer-de.htm4
new file mode 100644 (file)
index 0000000..71f039b
--- /dev/null
@@ -0,0 +1,139 @@
+m4_dnl -*-html-*-
+m4_include(`template.m4')
+m4_dnl $Id$
+
+m4_define(`DE')
+m4_define(`EN_FILE', `build-installer.html')
+PAGE_START
+
+<h1>Installationspaket herstellen</h1>
+
+Der Bau eines neuen gpg4win Installationspaketes ist
+weitestgehend automatisiert.
+
+<p>
+Was man benötigt: Ein Debian GNU/Linux 3.1 'sarge' system.
+Dafür ist die nachfolgende Anleitung getestet.
+Prinzipiell sind auch andere Systeme, ggf. mit
+ein bischen Anpassungsarbeit, möglich.<br>
+Desweiteren mindestens 50 MByte Platz auf der
+Festplatte und eine halbwegs schnelle Internetanbindung
+da ca. 20 MByte heruntergeladen werden müssen.
+</p>
+
+<p>
+Typische Aufgaben:
+<ul>
+<li> Einzelkomponenten aktualisieren (gelegentlich, ca. 1-4 Stunden)
+</ul>
+</p>
+
+<h2>Ein neues Installationspaket herstellen</h2>
+
+Das Zeichen '#' steht für Kommandos die als Administrator (root)
+durchgeführt werden müssen, '$' für einen normalen Benutzer.
+
+<ol>
+<li> Notwendige Pakete auf dem Debian GNU/Linux 3.1 installieren:<br>
+     <em># apt-get install mingw32 nsis stow unzip texinfo imagemagick</em><br>
+     <em># apt-get install tetex-bin gs-common hyperlatex<br>
+
+<li> Die Quellen anonym (also ohne Schreibrechte) holen:<br>
+     <em>$ svn checkout https://svn.wald.intevation.org/gpg4win/trunk/</em><br>
+     oder das Quelltextpaket gpg4win-n.n.n.tar.gz herunterladen, auspacken
+     und in das Verzeichnis gpg4win-n.n.n wechseln. Wir empfehlen, mit der
+     SVN version zu arbeiten wenn Sie mehr als nur ein Modul aktualisieren
+     wollen.
+
+<li> Alle notwendigen gpg4win-Module aus dem Internet herunterladen:<br>
+     <em>$ cd packages</em><br>
+     <em>$ sh download.sh</em><br>
+     (dauert nun eine Weile, besonders beim ersten mal)<br>
+     <em>$ cd ..</em><br>
+
+<li> Falls Sie mit der SVN-Version arbeiten:<br>
+     <em>$ AUTOMAKE_SUFFIX=-1.9 ./autogen.sh</em><br>
+     <em>$ ./configure --enable-maintainer-mode --host=i586-mingw32msvc</em><br>
+     ansonsten:<br>
+     <em>$ ./configure --host=i586-mingw32msvc</em><br>
+
+<li> Nun das gpg4win Installationpaket bauen:<br>
+     <em>$ make</em>
+</ol>
+
+<p>
+Das war es schon. Das fertige Installationspaket liegt unter:<br>
+<em>src/gpg4win-n.n.n.exe</em><br>
+Das zugehörige Quelltextpaket (mit den Quelltexten sämtlicher Module, sehr gross!) unter:<br>
+<em>src/gpg4win-src-n.n.n.exe</em><br>
+
+<h2>Ein einzelnes Modul für gpg4win aktualisieren</h2>
+
+Hierfür sollte man schon einmal ein Installationspaket wie oben beschreiben
+hergestellt haben.
+
+<ol>
+<li> (Beschreibung fehlt noch)
+</ol>
+
+<h2>Ein neues Modul in gpg4win einbauen</h2>
+
+Hierfür sollte man schon einmal ein Installationspaket wie oben beschreiben
+hergestellt haben und dabei die Version aus SVN benutzt haben.
+
+<ol>
+<li>Für Ihr neues Modul 'MYMOD' erstellen Sie zunächst Konstanten
+    in der Datei include/config.nsi.in indem Sie folgende drei
+    Zeilen hinzufügen:<br>
+    <em>@HAVE_PKG_MYMOD@</em><br>
+    <em>!define gpg4win_pkg_mymod @gpg4win_pkg_mymod@</em><br>
+    <em>!define gpg4win_pkg_mymod_version @gpg4win_pkg_mymod_version@</em><br>
+    Sie finden in der Datei genügend Beispiele, z.B. 'HAVE_PKG_WINPT'.
+
+<li>Das NSIS Installations-Skript<br>
+    <em>src/inst-mymod.nsi</em><br>
+    schreiben. Im selben Verzeichnis liegen viele Beispiele
+    an denen man sich orientieren kann.
+
+<li>Das NSIS Deinstallations-Skript<br>
+    <em>src/uninst-mymod.nsi</em><br>
+    schreiben. Im selben Verzeichnis liegen viele Beispiele
+    an denen man sich orientieren kann.
+
+<li>Das NSIS Haupt-Skript<br>
+    <em>src/inst-sections.nsi</em><br>
+    um MYMOD erweitern. Orientieren Sie sich einfach an den
+    schon existierenden Einträgen und den Hilfe-Kommentaren.
+
+<li>Nun tragen Sie in die Datei<br>
+    <em>configure.ac</em><br>
+    Vorschriften zur Integration in den Bauprozess ein.
+    Dafür können Sie die Makros aus der Datei<br>
+    <em>m4/gpg4win.m4</em><br>
+    verwenden. Durch die bereits integrierten Module
+    sind bereits zahlreiche Beispiele gegeben. Hauptsächlich
+    muss unterschieden werden ob das Modul Cross-Compiliert
+    oder als einfaches bereits andersweitig
+    für Windows kompiliertes Binärobjekt integriert werden soll.
+
+<li>Jetzt noch die Anweisungen für das automatische Herunterladen
+    in die Datei<br>
+    <em>packages/packages.current</em><br>
+    eintragen. Auch hier finden sich ausreichend Beispiele.
+
+<li>gpg4win muss für das neue Modul erneut konfiguriert werden:<br>
+     <em>$ AUTOMAKE_SUFFIX=-1.9 ./autogen.sh</em><br>
+     <em>$ ./configure --enable-maintainer-mode --host=i586-mingw32msvc</em><br>
+
+<li>Der letzte Schritt ist der Bau des Installationpaketes:<br>
+     <em>$ make</em>
+</ol>
+
+<p>
+Das fertige Installationspaket liegt unter:<br>
+<em>src/gpg4win-n.n.n.exe</em><br>
+Das zugehörige Quelltextpaket (mit den Quelltexten sämtlicher Module, sehr gross!) unter:<br>
+<em>src/gpg4win-src-n.n.n.exe</em><br>
+</p>
+
+PAGE_BOXES