Changes between Version 10 and Version 11 of Documentatie/Ontwikkelaar/Procedures/Release

Timestamp:

10/23/12 11:52:59 (14 years ago)

Author:

adriaan

Comment:

--

Documentatie/Ontwikkelaar/Procedures/Release

@@ -28 +28 @@
    * Ga op de TRAC-website onder "Timeline" naar de vorige release, en loop zorgvuldig de changesets na die sindsdien zijn ingevoerd, draai eventueel een DIFF. Dit gebeurt elke week maar moet vlak voor een release nog een keer worden herhaald, zodat op het moment dat de release note uitkomt, alle wijzigingen zijn overgenomen. Wat men daarna inlevert, moet men zelf weten (versiebeheer waarschuwt dan ook). Zie ook [wiki:Ontwikkelhandleiding/Source#Wijzigingenovernemen kopje wijzigingen overnemen] voor technische details.
    * Controleer of alle wijzigingen in de loop van de vorige release zijn overgenomen: development/bin/adaptatie-diff v1.XXX development (vergelijk laatste versie met development). Loop de diff door op vergeten change sets. Als er regelmatig met svn merge is gewerkt is dit wellicht overbodig.
- - '''Test''' - technische en functionele tests van huidige development versie.
+ - '''Test''' - technische en functionele tests van huidige development versie. Hiervoor moet je wel een werkende OpenAC configuratie-directory (bv. `.openac`) hebben.
    {{{
    python unittests.py --enable-all --no-adaptaties
@@ -59 +59 @@
 === Maken van een nieuwe starter kit ===
 
-[[NoteBox(warning, De OpenAC starter kit wordt nu met NSIS gemaakt. Deze documentatie is niet meer actueel.)]]
+De starterkit wordt gemaakt met NSIS ([http://nsis.sourceforge.net/Main_Page NullSoft Scriptable Installation System]). Die kan een paar configuratie-vragen stellen en OpenAC met een specifieke configuratie op een bepaalde plek installeren.
 
-De starter kit is in essentie een self-extracting ZIP van een release branch van OpenAC. Dit zijn de stappen die je moet doorlopen om een starter kit te maken. 
+Op de OpenAC server is `makensis` geinstalleerd. Soms zijn er Linux packages voor; op SourceForge is in ieder geval een `setup.exe` beschikbaar voor Windows. Om een starterkit te maken heb je een checkout van development nodig (of in ieder geval `development/bin`), makensis en een shell.
 
- * Check de release uit waarvan de starterkit moet worden gemaakt. 
- * Zorg dat de volgende elementen in de directory aanwezig zijn: directory Python25, en de 4 DLLs msvcpp71.dll, python25.dll, pythoncom25.dll en pywintypes25.dll. 
- * Draai '''./bin/clean'''. Dit ruimt tempfiles op en zet permissies goed, maar kan ook wijzigingen maken in bestanden. Doe een svn status en als er wijzigingen zijn, deze eerst committen. 
- * Draai '''./bin/makezip'''. Dit maakt een complete ZIP die goed door windows kan worden uitgepakt. 
- * De zip is ongeveer 100MB. 
- * Gebruik EnZIP voor het maken van de EXE: rechtermuis op starterkit.zip -> open with Enzip -> Create self extractor 
- * Bij Message Box: nee, we willen geen message box. 
- * Bij Folder: '''"OpenAC"'''
- * Title Caption: '''"OpenAC installatie"'''
- * Command: '''icon.bat '''
- * Selecteer het icon-bestand '''images/OpenAC-128x128.ico '''
- * In het laatste scherm geen opties veranderen 
- * Upload het bestand naar '''Downloads''' op de TRAC site 
- * Pas de links aan op de wiki-homepage en in de installatiehandleiding, zodat deze wijzen naar de meest recente starter kit. 
+De starterkit wordt gemaakt door het script `bin/starterkit.py`. Gebruik `--help` voor configuratie-opties bij het maken van de starterkit. Over het algemeen is dit voldoende:
 
+{{{
+bin/starterkit.py -v <VERSIE>
+}}}
+
+Waarbij VERSIE een '''inmiddels aangemaakte''' `release/` branch is. De "v" is optioneel, dus `-v 2.002` is hetzelfde als `-v v2.002`. Er wordt dan een checkout gemaakt van die versie, samen met de Python runtime, dan wordt van de template NSIS-file een specifiek installer-script gemaakt en met makensis tot een `starterkit.exe` gemaakt. Op de OpenAC server duurt dit ongeveer 20 minuten in totaal.
+
+De resulterende executable mag naar de downloads folder worden gekopieerd. Er worden MD5 en SHA1 checksums geprint voor gebruik in de release notes of op de starterkitpagina.