From 5d725cc9e1719dd0da5bd0f57f21b7f5af6d0749 Mon Sep 17 00:00:00 2001 From: robert Date: Sun, 22 Mar 2009 01:31:51 +0000 Subject: [PATCH] add the rest of the slides for the build system --- maow-berlin2009-build/notes.txt | 2 - maow-berlin2009-build/slide_appfiles.html | 54 ++++++++++++++ maow-berlin2009-build/slide_buildapp.html | 62 ++++++++++++++++ maow-berlin2009-build/slide_docs.html | 60 +++++++++++++++ maow-berlin2009-build/slide_end.html | 11 +-- maow-berlin2009-build/slide_getstarted.html | 59 +++++++++++++++ maow-berlin2009-build/slide_introduction.html | 4 +- maow-berlin2009-build/slide_jarmaker.html | 61 +++++++++++++++ maow-berlin2009-build/slide_makefiles.html | 74 +++++++++++++++++++ maow-berlin2009-build/slide_mozconfig.html | 58 +++++++++++++++ maow-berlin2009-build/slide_reasons.html | 53 +++++++++++++ maow-berlin2009-build/slide_thesystem.html | 48 ++++++++++++ maow-berlin2009-sm2/notes.txt | 3 +- 13 files changed, 538 insertions(+), 11 deletions(-) delete mode 100644 maow-berlin2009-build/notes.txt create mode 100644 maow-berlin2009-build/slide_appfiles.html create mode 100644 maow-berlin2009-build/slide_buildapp.html create mode 100644 maow-berlin2009-build/slide_docs.html create mode 100644 maow-berlin2009-build/slide_getstarted.html create mode 100644 maow-berlin2009-build/slide_jarmaker.html create mode 100644 maow-berlin2009-build/slide_makefiles.html create mode 100644 maow-berlin2009-build/slide_mozconfig.html create mode 100644 maow-berlin2009-build/slide_reasons.html create mode 100644 maow-berlin2009-build/slide_thesystem.html diff --git a/maow-berlin2009-build/notes.txt b/maow-berlin2009-build/notes.txt deleted file mode 100644 index ca334b4..0000000 --- a/maow-berlin2009-build/notes.txt +++ /dev/null @@ -1,2 +0,0 @@ -surman-freedom-foto: -http://www.flickr.com/photos/28959625@N04/3324030644/in/set-72157614734249362/ \ No newline at end of file diff --git a/maow-berlin2009-build/slide_appfiles.html b/maow-berlin2009-build/slide_appfiles.html new file mode 100644 index 0000000..0f4111f --- /dev/null +++ b/maow-berlin2009-build/slide_appfiles.html @@ -0,0 +1,54 @@ + + + + + + Das Mozilla-Build-System - Anwendungs-Dateien + + + + + + + + + + + + +

MAOW Berlin 2009

+ Inhalt || + Beginn || + < Zurück | + Weiter > +

+ +

Dateien, die eine Anwendung implementieren muss

+ +

Genaue Details dazu würden den Rahmen hier sprengen, gute Beispiele + liefern Fennec sowie die anderen Mozilla-Anwendungen
Alle Dateien sind in mozilla-central/testapp/
Makefile.in ist das Haupt-Makefile, üblicherweise mit + einem app-Unterverzeichnis als letztes Element in DIRS
build.mk wird in das Haupt-Makefile des ganzen Build-Systems + eingebunden und setzt einige grundlegende Variablen wie TIERS + sowie Make-Ziele auf oberster Ebene des Systems
confvars.sh gibt Variablen für das + configure-Skript an
makefiles.sh enthält eine Liste von Makefiles, die von + configure frühzeitig generiert werden, was viel Zeit spart + (auch in extensions/testext/ unterstützt)
app/Makefile.in mit Befehlen zur Erstellung der + ausführbaren Anwendungsdatei und des Mac-dmg-Pakets, das alle Dateien + der Anwendung enthält (daher am Ende der Liste, alles nachher landet + nicht im dmg!)

+ + + + diff --git a/maow-berlin2009-build/slide_buildapp.html b/maow-berlin2009-build/slide_buildapp.html new file mode 100644 index 0000000..6abd4d4 --- /dev/null +++ b/maow-berlin2009-build/slide_buildapp.html @@ -0,0 +1,62 @@ + + + + + + Das Mozilla-Build-System - Anwendung bauen + + + + + + + + + + + + +

MAOW Berlin 2009

+ Inhalt || + Beginn || + < Zurück | + Weiter > +

+ +

XULRunner-Anwendung mit Extra-Erweiterung bauen

+ +

mozconfig: +

# mozconfig-testapp
+# objdir setzten, relativ zum Quellcode
+mk_add_options MOZ_OBJDIR=../objdir-testapp
+# zwei Projekte bauen: XULRunner und unser Anwendung
+mk_add_options MOZ_BUILD_PROJECTS="xulrunner testapp"
+ac_add_app_options xulrunner --enable-application=xulrunner
+ac_add_app_options testapp --enable-application=testapp
+ac_add_app_options testapp --with-libxul-sdk=../xulrunner/dist
+# Standard-Erweiterungen plus testext bauen
+ac_add_app_options testapp --enable-extensions=default,testext

Unsere Anwendung liegt in mozilla-central/testapp/
Unsere Erweiterung liegt in mozilla-central/extensions/testext/

Befehle zum "Bauen": +

cd mozilla-central
+MOZCONFIG=../mozconfig-testapp make -f client.mk build

XULRunner findet sich in objdir-testapp/xulrunner/dist/bin/, + die ausführbare Anwendung findet sich in + objdir-testapp/testapp/dist/bin/, inklusive der + vorinstallierten Erweiterung
mobile-browser (Fennec) + ist ein gutes Beispiel für eine XULRunner-Anwendung, die das + Build-System verwendet

+ + + + diff --git a/maow-berlin2009-build/slide_docs.html b/maow-berlin2009-build/slide_docs.html new file mode 100644 index 0000000..fc3bdf7 --- /dev/null +++ b/maow-berlin2009-build/slide_docs.html @@ -0,0 +1,60 @@ + + + + + + Das Mozilla-Build-System - Dokumente + + + + + + + + + + + + +

MAOW Berlin 2009

+ Inhalt || + Beginn || + < Zurück | + Weiter > +

+ +

Dokumente/Links zum Build-System

+ +

(Fast) alle hier aufgeführten Dokumente sind Englisch
MDC: + Build_Documentation - Übersicht und erste Anlaufstellen für + Build-Dokumentation
MDC: Wie das Build System in + Mozilla + und comm-central + funktioniert - einige Spezialitäten unserer Systeme +
MDC: + Firefox-Erweiterungen mit dem Build-System - an sich gut, aber etwas + veraltet (noch CVS, Firefox 1.5)
MDC: + XULRunner-Erweiterungen mit dem Build-System - etwas neuer, aber auch + noch mit CVS, mehr Details zu Dingen auf meiner vorigen Folie
How + the Build Works - noch etwas älterer Gastvortrag in der + Open-Source-Ausbildung am Seneca-Collage
mozilla.dev.builds + auf news.mozilla.org und + #developers auf irc.mozilla.org + für Fragen
Auf Deutsch: SeaMonkey + selbst gebaut von Jens Hatlak

+ + + + diff --git a/maow-berlin2009-build/slide_end.html b/maow-berlin2009-build/slide_end.html index b81a21e..9b0598e 100755 --- a/maow-berlin2009-build/slide_end.html +++ b/maow-berlin2009-build/slide_end.html @@ -10,7 +10,7 @@ - + @@ -21,11 +21,11 @@

MAOW Berlin 2009

Inhalt || Beginn || - < Zurück | + < Zurück | Weiter >

Offene Diskussion

Demo & Offene Diskussion

Danke für Ihre Aufmerksamkeit!

@@ -41,8 +41,9 @@ Es bleibt etwas Zeit fü eine Diskussion.

-Verbreiten Sie das Mozilla-Manifest! -
http://www.mozilla.org/about/manifesto +Zum Schluss: +
Auch wenn es manchmal kompliziert scheint - +
(: DON'T PANIC! :)

diff --git a/maow-berlin2009-build/slide_getstarted.html b/maow-berlin2009-build/slide_getstarted.html new file mode 100644 index 0000000..4030ee8 --- /dev/null +++ b/maow-berlin2009-build/slide_getstarted.html @@ -0,0 +1,59 @@ + + + + + + Das Mozilla-Build-System - Einsteig + + + + + + + + + + + + +

MAOW Berlin 2009

+ Inhalt || + Beginn || + < Zurück | + Weiter > +

+ +

Einstieg ins Build-System

+ +

DOM-Inspector, Venkman und ChatZilla sind gute Beispiel-Erweiterungen + für die Build-System-Einbindung
Verschiedene Werkzeuge + werden vorausgesetzt: MozillaBuild und Windows SDK(s) auf Windows; + Xcode, Mercurial, libIDL, autoconf213 auf Mac OS X und + div. Entwicklerpakete, inkl. autoconf 2.13, Python, Mercurial, GNU make usw. + auf Linux
Ein Compiler (gcc bzw. unter Windows MSVC, auch in der Gratis-Version) + wird für C/C++-Code usw. benötigt, das Packen einer reinen + XUL/JS-Erweiterung funktioniert auch ohne
Ein Mozilla-Code-Baum + ist notwendig (ca. 450 MB auf der Festplatte!): +
```
hg pull http://hg.mozilla.org/mozilla-central
```
+ alternativ dazu ein + comm-central-Baum + (SeaMonkey/Thunderbird/Sunbird, ca. 520 MB): +
```
hg pull http://hg.mozilla.org/comm-central
+cd comm-central
+python client.py checkout
```
+
Will man Mozilla-Anwendungen kompilieren, nochmal 230-300 MB pro Anwendung + (mit einem Code-Baum können mehrere Anwendungen kompiliert werden)

+ + + + diff --git a/maow-berlin2009-build/slide_introduction.html b/maow-berlin2009-build/slide_introduction.html index 58bc882..d932f87 100644 --- a/maow-berlin2009-build/slide_introduction.html +++ b/maow-berlin2009-build/slide_introduction.html @@ -11,7 +11,7 @@ - + @@ -22,7 +22,7 @@ Inhalt || Beginn || < Zurück | - Weiter > + Weiter >

Vorstellung

diff --git a/maow-berlin2009-build/slide_jarmaker.html b/maow-berlin2009-build/slide_jarmaker.html new file mode 100644 index 0000000..3425331 --- /dev/null +++ b/maow-berlin2009-build/slide_jarmaker.html @@ -0,0 +1,61 @@ + + + + + + Das Mozilla-Build-System - JAR-Maker + + + + + + + + + + + + +

MAOW Berlin 2009

+ Inhalt || + Beginn || + < Zurück | + Weiter > +

+ +

Der JAR-Maker und jar.mn-Dateien

+ +

Liegt parallel zu einem Makefile eine jar.mn-Datei + (JAR-Manifest) + vor, wird sie automatisch abgearbeitet

mozilla-central/extensions/testext/jar.mn: +

testext.jar:
+# Zeilen, die mit % beginnen, werden in chrome.manifest geschrieben
+# Weitere %-Zeichen darin werden durch URL zur .jar-Datei ersetzt
+% content testext %content/testext/ xpcnativewrappers=yes
+% overlay chrome://browser/content/browser.xul chrome://testext/content/testextOverlay.xul
+# Datei aus dem lokalen Verzeichnis an den angegeben Ort in der .jar schreiben
+  content/testext/testext.xul
+# Zeilen, die mit * beginnen, lassen Dateien durch einen Text-Präprozessor laufen
+* content/testext/testext.js
+# Datei aus einem Unterverzeichnis (oder mit anderm Namen) beziehen
+  content/testext/testextOverlay.xul        (overlays/testextOverlay.xul)
+% skin testext classic/1.0 %skin/testext/
+  skin/testext/testext.css                  (skin/classic/testext.css)
+

Der Text-Präprozessor kann an vielen Stellen im Build-System + eingesetzt werden, um Variablen in div. Dateien zu schleusen, beim Bauen auf + verschiedenen Plattformen verschiedenen Code zu aktivieren, usw.
locales funktionieren genauso, aber ich hatte im Makefile auf + der letzten Folie ein Unterverzeichnis dafür angegeben

+ + + + diff --git a/maow-berlin2009-build/slide_makefiles.html b/maow-berlin2009-build/slide_makefiles.html new file mode 100644 index 0000000..8c51d7b --- /dev/null +++ b/maow-berlin2009-build/slide_makefiles.html @@ -0,0 +1,74 @@ + + + + + + Das Mozilla-Build-System - Makefiles + + + + + + + + + + + + +

MAOW Berlin 2009

+ Inhalt || + Beginn || + < Zurück | + Weiter > +

+ +

Makefile-Regeln, der Kern der Sache

+ +

Makefiles enthalten die Regeln für den Bau jeglichen Codes (Makefile + im "objdir" wird aus Makefile.in in Quellcode-Verzeichnis erzeugt)

mozilla-central/extensions/testext/Makefile.in: +

# [...Lizenz-Kopf...]
+DEPTH=../..
+topsrcdir=@top_srcdir@
+srcdir=@srcdir@
+VPATH=@srcdir@
+
+# Allgemeine Konfigurations-Variablen importieren
+include $(DEPTH)/config/autoconf.mk
+
+# Build-System-interner Name des Moduls (der Erweiterung)
+MODULE                 = testext
+# Name des Verzeichnisses in xpi-stage/ (normalerweise gleich wie MODULE)
+XPI_NAME               = testext
+# Einträge aus paralleler jar.mn kommen in Erweiterungs-eigenes chrome.manifest
+USE_EXTENSION_MANIFEST = 1
+# Haupt-Makefile der Erweiterung mit dieser ID (wie in install.rdf angegeben)
+INSTALL_EXTENSION_ID   = testext@example.org
+# Dateiname der fertigen XPI-Datei in xpi-stage
+XPI_PKGNAME            = testext-$(MOZ_APP_VERSION)
+
+# Dateien, die in das XPI-Paket kopiert werden sollen
+DIST_FILES = install.rdf
+
+# Unterverzeichnisse, in denen weitere Makefiles enthalten sind
+DIRS = locales subtest
+
+# zu installierende XPCOM-Komponenten
+EXTRA_COMPONENTS = components/testext-service.js
+
+# rules.mk verwendet die Variablen und macht die eigentliche Arbeit
+include $(topsrcdir)/config/rules.mk

MODULE und XPI_NAME sollten in jedem Makefile + der Erweiterung angegeben werden, damit Datieen im XPI landen

+ + + + diff --git a/maow-berlin2009-build/slide_mozconfig.html b/maow-berlin2009-build/slide_mozconfig.html new file mode 100644 index 0000000..9f22147 --- /dev/null +++ b/maow-berlin2009-build/slide_mozconfig.html @@ -0,0 +1,58 @@ + + + + + + Das Mozilla-Build-System - mozconfig + + + + + + + + + + + + +

MAOW Berlin 2009

+ Inhalt || + Beginn || + < Zurück | + Weiter > +

+ +

Die Einstellungen - mozconfig

+ +

Eine mozconfig-Datei enthält alle Einstellungen für + einen Build-System-Durchlauf: +

# mozconfig-testext
+# objdir setzten, relativ zum Quellcode
+mk_add_options MOZ_OBJDIR=../objdir-testext
+# nur testext-Erweiterung bauen
+ac_add_options --enable-application=extensions
+ac_add_options --enable-extensions=testext
+# Dieses Beispiel braucht keinen Compiler
+ac_add_options --disable-compile-environment

Unsere Erweiterung liegt in mozilla-central/extensions/testext/

Befehle zum "Bauen": +

cd mozilla-central
+MOZCONFIG=../mozconfig-testext make -f client.mk configure
+cd ../objdir-testext
+make -C extensions

Das fertige XPI-Paket findet sich in + objdir-testext/dist/xpi-stage/ und eine "vorinstallierte" + Version in objdir-testext/dist/bin/extensions

+ + + + diff --git a/maow-berlin2009-build/slide_reasons.html b/maow-berlin2009-build/slide_reasons.html new file mode 100644 index 0000000..0fb0654 --- /dev/null +++ b/maow-berlin2009-build/slide_reasons.html @@ -0,0 +1,53 @@ + + + + + + Das Mozilla-Build-System - Gründe; + + + + + + + + + + + + +

MAOW Berlin 2009

+ Inhalt || + Beginn || + < Zurück | + Weiter > +

+ +

Erweiterungen/XULapps & Build-System

+ +

Warum das Build-System für Erweiterungen + oder XULRunner-Anwendungen verwenden?

Falls C++-Komponenten vorhanden sind oder benötigt werden (sollten + aber vermieden werden)
Erweiterungen können sich in selbstkompilierte Anwendung + vorinstallieren
XULRunner-Anwendungen können direkt ausführbare Dateien oder sogar + Installationsprogramme erstellen
Nutzen der gleichen Verfahren, die Mozilla-Anwendungen verwenden
Erlaubt Zugriff auf eine Menge von Funktionen/Skripten, die man nicht + selbst schreiben oder warten muss
Erlaubt einfachen Einbau der Erweiterungsfunktionalitäten in eine + komplette Mozilla-Anwendung, z.B. wenn man eine veränderte (und + umbenannte) Version von Firefox zusammenstellen will oder die Erweiterung + als Bestandteil in SeaMonkey eingebaut werden soll.

+ + + diff --git a/maow-berlin2009-build/slide_thesystem.html b/maow-berlin2009-build/slide_thesystem.html new file mode 100644 index 0000000..72d677f --- /dev/null +++ b/maow-berlin2009-build/slide_thesystem.html @@ -0,0 +1,48 @@ + + + + + + Das Mozilla-Build-System - Das System + + + + + + + + + + + + +

MAOW Berlin 2009

+ Inhalt || + Beginn || + < Zurück | + Weiter > +

+ +

Das Build-System

+ +

"Baut" eine gesamte Mozilla-basierende Anwendung (Firefox, Thunderbird, + SeaMonkey, usw.) inklusive "eingebauter" Erweiterungen, wenn vorhanden
Gleiches System auf allen Plattformen, die Mozilla unterstützt (Windows, + MacOS X, Linux, OS/2, Solaris, ...)
Derzeit großteils auf GNU make aufgebaut, inkl. Unix-Shell-Kommandos, + etwas autoconf (2.13!), einige Perl- und Python-Skripte
Schlechte Dokumentation der Interna, eine Menge sehr komplexer Skripte und + alter Code, niemand versteht alle Teile
DON'T PANIC! - Man muss nicht alle Details verstehen, um es zu verwenden, + die Bedienung ist (meist) durchaus verständlich
Aktuelle Entwicklung: pymake, + soll alles auf Python-Basis vereinheitlichen und vereinfachen

+ + + diff --git a/maow-berlin2009-sm2/notes.txt b/maow-berlin2009-sm2/notes.txt index ca334b4..aef00c6 100644 --- a/maow-berlin2009-sm2/notes.txt +++ b/maow-berlin2009-sm2/notes.txt @@ -1,2 +1 @@ -surman-freedom-foto: -http://www.flickr.com/photos/28959625@N04/3324030644/in/set-72157614734249362/ \ No newline at end of file +https://developer.mozilla.org/en/Extensions_support_in_SeaMonkey_2 \ No newline at end of file -- 2.35.3