Windows-installer: verschil tussen versies

Uit EekBoek
Naar navigatie springenNaar zoeken springen
(Hoe bouw ik een installer voor EekBoek voor Windows)
 
k (Syntactische aanpassingen)
 
(14 tussenliggende versies door 2 gebruikers niet weergegeven)
Regel 1: Regel 1:
'''Deze pagina beoogt een dump te zijn van het maken van een self-installing package voor EekBoek voor Windows.
'''Deze pagina beoogt een dump te zijn van het MAKEN van een self-installing package voor EekBoek voor Windows.


''Work in progress, deze pagina is nog niet volledig of getest.
Kies voor x86 (32 bit) of x64 (64 bit). Ik noem steeds de 64 bit variant. Aanpassen waar gewenst. (x64 -> x86)
 
== Download en installeer cygwin ==
 
[http://www.cygwin.com/ Cygwin] is een UNIX emulator onder Windows. Het maakt allerlei (command-line-)utilities beschikbaar, zoals zip, unzip, git etc.
 
Installeer vanaf http://www.cygwin.com/
 
http://cygwin.com/setup.exe


Kies voor x86 (32 bit) of x64 (64 bit). Ik noem steeds de 64 bit variant. Aanpassen waar gewenst. (x64 -> x86)
Kies in ieder geval zip en unzip (uit de categorie archive) en git (uit de categorie devel).


Cygwin installeert ook een versie van Perl, die we niet gaan gebruiken.


== Download en installatie CitrusPerl ==
== Download en installateer CitrusPerl ==


* Download CitrusPerl (van http://www.citrusperl.com/download/CitrusPerl/).  Kies voor de 20812 versie, 209xx werkt nog niet.
* Download CitrusPerl (van http://www.citrusperl.com/download/CitrusPerl/).  Kies voor de 20812 versie, 209xx werkt nog niet.


http://www.citrusperl.com/download/CitrusPerl/citrusperl-standard-51402-20812-msw-x64-014.zip
http://www.citrusperl.com/download/CitrusPerl/citrusperl-standard-51402-20812-msw-x64-014.zip


* Sla de zipfile op, en pak de zipfile uit, bijvoorbeeld in de c:\eekboek directory. Er onstaat een directory:  
* Sla de zipfile op, en pak de zipfile uit, bijvoorbeeld in de c:\eekboek directory. Er onstaat een directory:  


C:\eekboek\citrusperl-standard-51402-20812-msw-x64-014\CitrusPerl\
C:\eekboek\citrusperl-standard-51402-20812-msw-x64-014\CitrusPerl\


* Start de tool citrusutils, in  
* Start de tool citrusutils, in  


C:\eekboek\citrusperl-standard-51402-20812-msw-x64-014\CitrusPerl\bin\citrusutils.exe
C:\eekboek\citrusperl-standard-51402-20812-msw-x64-014\CitrusPerl\bin\citrusutils.exe


* Hiermee zetten we een aantal paden goed, en installeren we mingw (de GCC compiler, benodigd vanwege dmake.exe).
* Hiermee zetten we een aantal paden goed, en installeren we MinGW (de GCC compiler voor Windows, benodigd vanwege dmake.exe).


*In het eerste tabblad: klik SET GCC en kies voor de bovenste optie, "download the binary MinGW distribution used to build this"
* In het eerste tabblad: klik SET GCC en kies voor de bovenste optie, "download the binary MinGW distribution used to build this"


* Selecteer een pad om uit te pakken en neer te zetten, bijvoorbeeld C:\eekboek\mingw-x64\
* Selecteer een pad om uit te pakken en neer te zetten, bijvoorbeeld C:\eekboek\mingw-x64\
Regel 35: Regel 44:
* Maak een directory c:\eekboek\builddir64\
* Maak een directory c:\eekboek\builddir64\


* start een terminal vanuit CitrusPerl, door
* start een terminal vanuit CitrusPerl, door het volgende te runnen:
 
C:\eekboek\citrusperl-standard-51402-20812-msw-x64-014\CitrusPerl\bin\citrusterm.bat
 
binnen deze terminal de volgende commando's:
 
<code>
cpan Term::ReadKey (eenmalig, dit geeft een hele lijst met output, en moet eindigen met OK)
cd c:\eekboek\builddir64\
git clone -b btwcodes git://eekboek.git.sourceforge.net/gitroot/eekboek/eekboek
cd eekboek
make bootstrap
perl Build.PL
Build
Build test
</code>
 
Als je een alleen re-build van een nieuwere versie doet:
 
<code>
cd c:\eekboek\builddir64\eekboek
git pull
make bootstrap
perl Build.PL
Build
Build test
</code>
<
Noot: een aantal tests faalt, dat komt doordat er geen externe database server beschikbaar is, en doordat er files ontbreken.
 
Om naar een bepaalde versie te springen:
<code>
git checkout tags/R02_01_06
</code>
 
Een voorbeeld van het resultaat:
 
<code>
Test Summary Report
-------------------
t\93_ivp_en.t      (Wstat: 65280 Tests: 11 Failed: 0)
  Non-zero exit status: 255
  Parse errors: Bad plan.  You planned 129 tests but ran 11.
Files=11, Tests=464, 258 wallclock secs ( 0.14 usr +  0.00 sys =  0.14 CPU)
Result: FAIL
Failed 1/11 test programs. 0/464 subtests failed.
</code>
 
Hoewel er dus fouten zijn, gaan we toch door.
 
Mocht je EekBoek niet willen inpakken, maar zelf willen gebruiken, dan kun je hier stoppen.
 
== Het packagen van EekBoek ==
 
=== Download en installeer Cava ===
 
* Download Cava, een Perl packager:
 
<<Voor de 32 bit variant heb ik versie 72 gebruikt!, nu versie 76>>
 
http://www.citrusperl.com/download/CavaPackager/cava-packager-msw-x64-2-0-76.exe
 
Run de installer, als administrator (rechtsklikken, Run as Administrator), omdat anders de benodigde directory's niet kunnen worden aangemaakt.
 
Helaas heeft de maker van deze installer dit programma niet ondertekend. (zie ook de todo...)
 
 
=== Download en installeer InnoSetup ===
 
Er is geen aparte 64-bit versie van InnoSetup.
 
* Download InnoSetup van http://www.jrsoftware.org/isdl.php
 
Ik heb gekozen voor de unicode verie, van een Nederlandse mirror:
 
http://www.jrsoftware.org/download.php/is-unicode.exe?site=2
 
Voer het bestand uit, accepteer de licentie en de locatie. Aan het einde is het niet nodig om innosetup te starten. Het wordt door Cava onderwater gebruikt.
 
 
=== Inpakken met Cava ===


C:\eekboek\citrusperl-standard-51402-20812-msw-x64-014\CitrusPerl\bin\citrusterm.bat te runnen.
Start Cava Packager 2.0 vanuit het start menu. Er kunnen helaas geen 64-bit en 32-bit varianten tegelijk geïnstalleerd zijn.


binnen deze terminal de volgende commando's
<hier de opmerkingen van Johan toevoegen>


cpan Term::ReadKey (eenmalig, dit geeft een hele lijst met output, en moet eindigen met OK)
zipfile van Johan uitgepakt als c:\eekboek\ebcava64


cd c:\eekboek\builddir64\
innosetup file verwijderd.


git clone -b btwcodes git://eekboek.git.sourceforge.net/gitroot/eekboek/eekboek
Cava opstarten. Cava file (c:\eekboek\ebcava64\cava20.cpkgproj) openen


cd eekboek
Interpreter goedzetten in menu EekBoek, laatste tab.


wijzig 2>/dev/null in 2>nul op regel 26 (tenzij Johan iets slims bedenkt!)
(C:\eekboek\citrusperl-standard-51402-20812-msw-x64-014\CitrusPerl\bin\perl.exe)
Klaagt ergens over..


make bootstrap
Voeg hier ook
c:\eekboek\builddir64\eekboek\lib\
en
C:\eekboek\builddir64\eekboek\lib\EB\CPAN
toe aan "extra module search paths"


<er missen een aantal files, dat is bekend>
Menu scripts -> script locatie goedzetten voor beide scripts. c:\eekboek\builddir64\eekboek\scripts


perl Build.PL
Menu resources -> toevoegen met knop ... C:\eekboek\builddir64\eekboek\lib\EB\res


Build
Menu user -> toevoegen met knop ... C:\eekboek\builddir64\eekboek\lib\EB\user


Build test
Menu installer -> check 'require administrator privileges to install'


<een aantal test faalt, dat komt doordat er geen externe database server beschikbaar is, en doordat er files missen>
Menu build -> rechtsbovenaan zit een knopje waar 'scan and build' als helptext bij verschijnt. Druk op die knop.


In C:\eekboek\ebcava64\release\EekBoek staat een installatie, die je snel kan proberen.


== Download en installatie Cava ==
In C:\eekboek\ebcava64\installer\ staat de gewenste installer.


* Download Cava
< laatst uitgevoerd op 30-08-2012 met versie 2.1.4 >


[[Voor de 32 bit variant heb ik versie 72 gebruikt!]]


http://www.citrusperl.com/download/CavaPackager/cava-packager-msw-x64-2-0-76.exe
=== ToDo ===


Run de installer, als administrator (rechtsklikken, Run as Administrator), anders kunnen de benodigde directories niet worden aangemaakt.
1) De installer in unsigned. Dat betekent dat de auteur als unknown staat en Windows je afraadt dit te installeren.  


Hiervoor is een certificaat nodig. Het is me nog niet duidelijk (genoeg) hoe dit te doen.


== Download en installatie Cava ==
2) Er moet nog een installatie pagina komen, hoe je deze files installeert. Zou zichzelf moeten wijzen, als er een download pagina is. Feitelijk: downloaden en dubbelklikken, accepteren dat de auteur onbekend is.


* Download Cava
3) In ebcava kan nog een licentie text worden opgegeven.

Huidige versie van 10 dec 2012 om 21:32

Deze pagina beoogt een dump te zijn van het MAKEN van een self-installing package voor EekBoek voor Windows.

Kies voor x86 (32 bit) of x64 (64 bit). Ik noem steeds de 64 bit variant. Aanpassen waar gewenst. (x64 -> x86)

Download en installeer cygwin

Cygwin is een UNIX emulator onder Windows. Het maakt allerlei (command-line-)utilities beschikbaar, zoals zip, unzip, git etc.

Installeer vanaf http://www.cygwin.com/

http://cygwin.com/setup.exe

Kies in ieder geval zip en unzip (uit de categorie archive) en git (uit de categorie devel).

Cygwin installeert ook een versie van Perl, die we niet gaan gebruiken.

Download en installateer CitrusPerl

http://www.citrusperl.com/download/CitrusPerl/citrusperl-standard-51402-20812-msw-x64-014.zip
  • Sla de zipfile op, en pak de zipfile uit, bijvoorbeeld in de c:\eekboek directory. Er onstaat een directory:
C:\eekboek\citrusperl-standard-51402-20812-msw-x64-014\CitrusPerl\
  • Start de tool citrusutils, in
C:\eekboek\citrusperl-standard-51402-20812-msw-x64-014\CitrusPerl\bin\citrusutils.exe
  • Hiermee zetten we een aantal paden goed, en installeren we MinGW (de GCC compiler voor Windows, benodigd vanwege dmake.exe).
  • In het eerste tabblad: klik SET GCC en kies voor de bovenste optie, "download the binary MinGW distribution used to build this"
  • Selecteer een pad om uit te pakken en neer te zetten, bijvoorbeeld C:\eekboek\mingw-x64\
  • Klik ook eenmaal op de knop met de twee pijltjes onder de SET GCC button. (Niet zeker of dat nodig is).
  • Sluit de CitrusUtils applicatie af.


Download en bouw EekBoek

  • Maak een directory c:\eekboek\builddir64\
  • start een terminal vanuit CitrusPerl, door het volgende te runnen:
C:\eekboek\citrusperl-standard-51402-20812-msw-x64-014\CitrusPerl\bin\citrusterm.bat

binnen deze terminal de volgende commando's:

cpan Term::ReadKey (eenmalig, dit geeft een hele lijst met output, en moet eindigen met OK)
cd c:\eekboek\builddir64\
git clone -b btwcodes git://eekboek.git.sourceforge.net/gitroot/eekboek/eekboek
cd eekboek
make bootstrap
perl Build.PL 
Build 
Build test 

Als je een alleen re-build van een nieuwere versie doet:

cd c:\eekboek\builddir64\eekboek
git pull
make bootstrap
perl Build.PL 
Build 
Build test 

< Noot: een aantal tests faalt, dat komt doordat er geen externe database server beschikbaar is, en doordat er files ontbreken.

Om naar een bepaalde versie te springen:

git checkout tags/R02_01_06

Een voorbeeld van het resultaat:

Test Summary Report
-------------------
t\93_ivp_en.t       (Wstat: 65280 Tests: 11 Failed: 0)
  Non-zero exit status: 255
  Parse errors: Bad plan.  You planned 129 tests but ran 11.
Files=11, Tests=464, 258 wallclock secs ( 0.14 usr +  0.00 sys =  0.14 CPU)
Result: FAIL
Failed 1/11 test programs. 0/464 subtests failed.

Hoewel er dus fouten zijn, gaan we toch door.

Mocht je EekBoek niet willen inpakken, maar zelf willen gebruiken, dan kun je hier stoppen.

Het packagen van EekBoek

Download en installeer Cava

  • Download Cava, een Perl packager:

<<Voor de 32 bit variant heb ik versie 72 gebruikt!, nu versie 76>>

http://www.citrusperl.com/download/CavaPackager/cava-packager-msw-x64-2-0-76.exe

Run de installer, als administrator (rechtsklikken, Run as Administrator), omdat anders de benodigde directory's niet kunnen worden aangemaakt.

Helaas heeft de maker van deze installer dit programma niet ondertekend. (zie ook de todo...)


Download en installeer InnoSetup

Er is geen aparte 64-bit versie van InnoSetup.

Ik heb gekozen voor de unicode verie, van een Nederlandse mirror:

http://www.jrsoftware.org/download.php/is-unicode.exe?site=2

Voer het bestand uit, accepteer de licentie en de locatie. Aan het einde is het niet nodig om innosetup te starten. Het wordt door Cava onderwater gebruikt.


Inpakken met Cava

Start Cava Packager 2.0 vanuit het start menu. Er kunnen helaas geen 64-bit en 32-bit varianten tegelijk geïnstalleerd zijn.

<hier de opmerkingen van Johan toevoegen>

zipfile van Johan uitgepakt als c:\eekboek\ebcava64

innosetup file verwijderd.

Cava opstarten. Cava file (c:\eekboek\ebcava64\cava20.cpkgproj) openen

Interpreter goedzetten in menu EekBoek, laatste tab.

(C:\eekboek\citrusperl-standard-51402-20812-msw-x64-014\CitrusPerl\bin\perl.exe) Klaagt ergens over..

Voeg hier ook c:\eekboek\builddir64\eekboek\lib\ en C:\eekboek\builddir64\eekboek\lib\EB\CPAN toe aan "extra module search paths"

Menu scripts -> script locatie goedzetten voor beide scripts. c:\eekboek\builddir64\eekboek\scripts

Menu resources -> toevoegen met knop ... C:\eekboek\builddir64\eekboek\lib\EB\res

Menu user -> toevoegen met knop ... C:\eekboek\builddir64\eekboek\lib\EB\user

Menu installer -> check 'require administrator privileges to install'

Menu build -> rechtsbovenaan zit een knopje waar 'scan and build' als helptext bij verschijnt. Druk op die knop.

In C:\eekboek\ebcava64\release\EekBoek staat een installatie, die je snel kan proberen.

In C:\eekboek\ebcava64\installer\ staat de gewenste installer.

< laatst uitgevoerd op 30-08-2012 met versie 2.1.4 >


ToDo

1) De installer in unsigned. Dat betekent dat de auteur als unknown staat en Windows je afraadt dit te installeren.

Hiervoor is een certificaat nodig. Het is me nog niet duidelijk (genoeg) hoe dit te doen.

2) Er moet nog een installatie pagina komen, hoe je deze files installeert. Zou zichzelf moeten wijzen, als er een download pagina is. Feitelijk: downloaden en dubbelklikken, accepteren dat de auteur onbekend is.

3) In ebcava kan nog een licentie text worden opgegeven.