Changes between Version 13 and Version 14 of squeak_faq

Timestamp:

10/14/2013 04:10:16 PM (11 years ago)

Author:

willi.mueller

Comment:

improved SARInstaller answer

squeak_faq

@@ -461 +461 @@
 === Wie erstelle ich das SAR-Archiv für die Abgabe? ===
 
-Bei SARs handelt es sich nur um ZIPs mit etwas Smalltalk Quellcode (preamble, postscript Dateien). Ihr könnt sie einfach von Hand erstellen. Daher wäre es schön, wenn ihr einfach alles in ein ZIP packt, die 1-2 Zeilen Code zum Laden des MCZ Packages schreibt und dann gebündelt in einem SAR abgebt. Denkt daran, dass ihr auch Ressourcen wie Bilder und Audiodateien mit reinpackt und beim Installieren des SARs extrahiert.
-
-Hier findet ihr grundlegende Informationen und Tools, die euch bei der Erstellung helfen:
-
-[http://www.visoracle.com/squeak/faq/sar-installer.html SAR-Installer HowTo]
-
-[http://wiki.squeak.org/squeak/3324 SAR-Installer Dokumentation]
+Der Quelltext soll in Form eines SAR-Archives abgegeben werden, da so
+auch externe Ressourcen mit verpackt werden können.
+
+Da es sich bei einem SAR-File eigentlich nur um ein ZIP-File handelt
+(mit einer speziellen Preamble, die beim Installations-Vorgang
+ausgeführt wird), könnt ihr es direkt im Image erstellen. Als Beispiel
+hier ein Snippet, das wir für unser Koans-Projekt benutzt haben:
+
+{{{
+|package|
+
+package := 'Koans'.
+
+zip := ZipArchive new.
+mczStream := RWBinaryOrTextStream on: (String new: 10000).
+workingCopy := MCWorkingCopy forPackage: (MCPackage new name: package).
+version := workingCopy newVersion.
+version fileOutOn: mczStream.
+(zip addString: mczStream contents as: package , '.mcz') desiredCompressionLevel: 0.
+zip addString: 'self fileInMonticelloZipVersionNamed:
+    ''' , package , '.mcz''.' as: 'install/preamble'.
+zip writeToFileNamed: package , '.sar'.
+}}}
+
+Es schreibt einfach die aktuelle Working-Copy des Monticello-Packages
+"Koans" in das SAR-File. Dabei wird eine neue Monticello-Version eures
+Packages erstellt. Falls ihr noch externe Resourcen für euer Spiel
+benötigt, könnt ihr diese folgendermaßen zum Archiv hinzufügen.
+
+{{{
+|package folder|
+
+package := 'Koans'.
+folder := 'KoanResources'.
+
+zip := ZipArchive new.
+mczStream := RWBinaryOrTextStream on: (String new: 10000).
+workingCopy := MCWorkingCopy forPackage: (MCPackage new name: package).
+version := workingCopy newVersion fileOutOn: mczStream.
+(zip addString: mczStream contents as: package, '.mcz') desiredCompressionLevel: 0.
+zip addTree: Smalltalk imagePath match: [:e | e fullName startsWith:
+    Smalltalk imagePath , FileDirectory slash , folder].
+zip addString:  'self fileInMonticelloZipVersionNamed: ''' , package, '.mcz''.
+(self membersMatching: ''' , folder , FileDirectory slash , '*.*'') do: [ :f | self
+    extractMember: f].' as: 'install/preamble'.
+zip writeToFileNamed: package , '.sar'.
+}}}
+
+Hierbei werden alle Dateien im Unterverzeichnis "KoanResources" (im
+Contents/Resources Verzeichnis des Images) hinzugefügt und beim
+Installieren wieder extrahiert. Einzelne Dateien könnt ihr mittels "zip
+addFile: pathToFile as: fileName" hinzufügen.
+
+Weitere Informationen und Anleitungen siehe [http://wiki.squeak.org/squeak/3324 SARInstaller Dokumentation].
 
 
 === Welchen Umfang sollten die Projekte haben? ===
 
-Die Anforderungen, welche durch die Spiele umgesetzt werden sollen, reflektieren auch den Umfang des Projektes. Alle Projekte wurden so gewählt (oder von uns freigegeben), sodass sie einerseits mit 4 Studenten in der vorhandenen Zeit sehr gut realisierbar sind und andererseits auch ausreichend Raum lassen, um eine sehr gute Architektur zu entwickeln.
+Die Anforderungen, welche durch die Spiele umgesetzt werden sollen, reflektieren auch den Umfang des Projektes. Alle Projekte wurden so gewählt (oder von uns freigegeben), sodass sie einerseits mit 4 Studierende in der vorhandenen Zeit sehr gut realisierbar sind und andererseits auch ausreichend Raum lassen, um eine sehr gute Architektur zu entwickeln.
 
 Eine Zahl entsprechend der Menge an Quelltext lässt sich nur schwer bestimmen, da es von zu vielen Faktoren abhängt (Verwendung von Mustern, Kenntnis der Smalltalk Bibliothek, Benutzte Abstraktionen etc.). Falls es euch hilft: Wir hatten schon sehr gute Projekte, welche nur knapp 1.000 Zeilen geschrieben haben aber auch sehr gute mit mehr als 4.000 Zeilen. Versucht euch am Besten dazwischen einzupendeln und setzt euren Fokus lieber auf Qualität statt Quantität. Uns geht es in dieser Lehrveranstaltung vor allem darum, dass ihr lernt und versteht, was es heißt "schönen" Code zuschreiben.
 
 
+
 == Patterns ==
-
 
 === State und Strategy Pattern – Was ist der Unterschied? ===