| | 711 | |
| | 712 | == Versiebeheer: releases en revisies == |
| | 713 | |
| | 714 | === Hoe werkt de SVN repository? === |
| | 715 | De SVN repository bevat twee directories: development met de actuele ontwikkelversie, en release met daarin stabiele releases van OpenAC. |
| | 716 | |
| | 717 | De AC's kunnen zelf wijzigingen in hun adapataties inleveren. Ze doen dit in de regel in de nieuwste release. Wanneer een AC een wijziging heeft ingeleverd, is dit te zien in de timeline van TRAC. Die houden we als ontwikkelaars dus nauwlettend in de gaten. Wekelijks worden wijzigingen door centra ingeleverd overgenomen in de development-tak. Als centra een oudere release in gebruik hebben, worden wijzigingen ook in de nieuwere releases overgenomen. Wanneer een centrum een wijzing indient en er is al een nieuwe release, krijgt men een waarschuwing dat de ingeleverde zaken niet automatisch beschikbaar zijn in de nieuwe release. |
| | 718 | |
| | 719 | Wijzigingen die in een release worden ingeleverd, moeten via een SVN merge worden opgenomen in de ontwikkeltak. |
| | 720 | |
| | 721 | === Maken van een OpenAC release === |
| | 722 | Je zit in een werkkopie van de tak 'development'. Doe nu de volgende stappen: |
| | 723 | |
| | 724 | * 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). |
| | 725 | * 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. |
| | 726 | * Draai de unit tests en fix zonodig |
| | 727 | * Loop het test script door |
| | 728 | * Merge door AC's gemaakte fixes op de vorige release in de development-tak |
| | 729 | * Test de wijzigingen zonodig |
| | 730 | * svn commit om de wijzigingen uit de merge in te leveren |
| | 731 | * Werk VERSIES.txt bij door de releasedatum aan de laatste versie toe te voegen en de omschrijving af te maken |
| | 732 | * Draai bin/clean en commit eventuele bestanden die nog geen eol-style LF hadden |
| | 733 | * Draai nog 1x de unit tests |
| | 734 | * svn commit |
| | 735 | * Draai bin/release 1.XXX om development te kopiëren naar de nieuwe release in SVN |
| | 736 | * Maak de adaptatiemap in de nieuwe release schrijfbaar voor centra door 3 regels te kopiëren in /usr/local/apache1/svn/etc/permissions |
| | 737 | * Stuur een release-bericht naar openac@fenac.nl. Denk daarbij goed na welke migraties er allemaal gebeuren bij deze nieuwe versie. |
| | 738 | |
| | 739 | === Maken van een nieuwe starter kit === |
| | 740 | 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. |
| | 741 | |
| | 742 | * Check de release uit waarvan de starterkit moet worden gemaakt. |
| | 743 | * 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. |
| | 744 | * 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. |
| | 745 | * Draai ./bin/makezip. Dit maakt een complete ZIP die goed door windows kan worden uitgepakt. |
| | 746 | * De zip is ongeveer 65MB. |
| | 747 | * Gebruik EnZIP voor het maken van de EXE: rechtermuis op starterkit.zip -> open with Enzip -> Create self extractor |
| | 748 | * Bij Message Box: nee, we willen geen message box. |
| | 749 | * Bij Folder: "OpenAC" |
| | 750 | * Title Caption: "OpenAC installatie" |
| | 751 | * Command: icon.bat |
| | 752 | * Selecteer het icon-bestand images/OpenAC-128x128.ico |
| | 753 | * In het laatste scherm geen opties veranderen |
| | 754 | * Upload het bestand naar "Downloads" op de TRAC site |
| | 755 | * Pas de links aan op de wiki-homepage en in de installatiehandleiding, zodat deze wijzen naar de meest recente starter kit. |