Releases

TOC(heading=Inhoudsopgave)? TOC(heading=Hoofdstukken, sectionindex, compact, depth=2, Documentatie/Ontwikkelhandleiding/*)?

NoteBox(note, OpenAC werkt niet meer met een time-based release, maar met een feature-based release. Zie de [wiki:Releases releases] pagina voor informatie over welke features geselecteerd zijn voor welke release. De procedure met twee pilot-AC's blijft behouden.)?

• De releasedatum is de datum dat de acceptatieversie wordt aangemaakt door de development-branch te kopiëren naar een release-branch. De releasedata vallen in principe op 31-3, 30-6, 25-9 en 15-12 (4x per jaar).
• 5e week voor releasedatum: scope bepalen, ontwerpjes maken
• 4e en 3e week voor releasedatum: bespreken ontwerpjes voor de grotere tickets, tickets afwerken
• 2e week voor releasedatum: testen (en soms nog wat losse eindjes ontwikkelwerk), 2 pilot-AC's zoeken
• week voor releasedatum: documenteren, changes overnemen en live (zie hieronder)
• week na releasedatum: test bij 2 pilot-AC's, changes overnemen, bericht productieversie live

Testen en maken van een OpenAC release

Je zit in een werkkopie van de tak 'development'. Doe nu de volgende stappen:

• Splash - de splash-screen controleren en bijwerken. Uit ticket #2454:
  • Open images/splash.xcf met GIMP,
  • Werk copyrightboodschap bij, dus (C) 2004 - 2010. Klik op de layer achtergrond om die onzichtbaar te maken. Klik dan op het tekst-tool icoon (vette A in de toolbox). Dubbel-klik op het tekstveld dat nog een beetje zichtbaar is, dialoog verschijnt. Pas de tekst aan.
  • Sla op,
  • Sla op als splash.png, File -> Save As -> Vul filenaam in. Je moet nog kiezen om de PNG plat te slaan (merge visible layers).
  • Controleer met een andere plaatjes-viewer dat de splash nu klopt.
  • Commit de gewijzigde twee bestanden.
• Merge - wijzigingen coordineren zodat development acht de laatste wijzigingen bevat.
  • 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 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.

  python unittests.py --enable-all --no-adaptaties
  python unittests.py --with-adaptaties
  

  • Draai de unit tests en fix zonodig, python unittests.py --enable-all . De unit tests vormen een automatische test die al ruime tijd voor alle releases wordt gedraaid. Deze test simuleert voor elk van de adaptaties een login en "drukt" vervolgens achtereenvolgens alle knoppen van het startscherm in. De unit test maakt gebruik van lege, standalone sqlite3-databases.
  • Draai de systeemtest. De systeemtest vormt een automatische back-to-back test voor de academische huizen. Deze voeren we bij elke release uit. In overleg met academische huizen wordt het testrapport overlegd, maar meestal blijft dit intern. TODO: hoe draai je de systeemtest?
  • Loop het test protocol door. Dit is een (gebruikers-)functionele test van OpenAC.
• Opschonen - de source code helemaal netjes maken voor release.

  sh bin/clean
  python unittests.py --enable-all
  svn commit
  

  • Werk VERSIES.txt bij door de releasedatum aan de laatste versie toe te voegen en de omschrijving af te maken. Daardoor verschijnt het in de beschikbare versies lijst van de ACs.
  • Draai bin/clean en commit eventuele bestanden die nog geen eol-style LF hadden.
  • Draai nog 1x de unit tests, python unittests.py --enable-all
  • Doe nog eens reindent om de code style recht te trekken, python bin/reindent.py `find . -name *.py`
• Branch - in SVN de branch maken
  • Draai bin/release 1.XXX om development te kopiëren naar de nieuwe release in SVN.
  • Maak de adaptatiemap in de nieuwe release schrijfbaar voor centra door 3 regels te kopiëren in de TRAC configuratie. Zie daarvoor de TRAC configuratie wiki elders.
• Test nogmaals - of het na de branch nog doet.
  • Check de nieuwe versie uit en controleer nogmaals dat het -- nu als eigen release -- nog steeds start. Loop nogmaals cluchtig het test protocol door.
  • Start een eerdere versie op, ga naar versiebeheer en controleer dat (1) de nieuwe release in de versies lijst staat en (2) opschakelen naar de nieuwe release kan.
• Announce - maak de nieuwe versie bekend
  • Maak een nieuwe starterkit.
  • Stuur een release-bericht naar openac@…. Denk daarbij goed na welke migraties er allemaal gebeuren bij deze nieuwe versie.

Maken van een nieuwe starter kit

NoteBox(warning, De OpenAC starter kit wordt nu met NSIS gemaakt. Deze documentatie is niet meer actueel.)?

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.

• 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.