[[TOC(heading=Protocolhandler builden)]]
[[TOC(heading=OpenAC3, sectionindex, compact, depth=3, allactive, Documentatie/Ontwikkelaar/OpenAC3/)]]
[[TOC(heading=Ontwikkelaar, sectionindex, compact, depth=2, allactive, Documentatie/Ontwikkelaar/)]]
[[TOC(heading=Documentatie, sectionindex, compact, depth=1, allactive, Documentatie/)]]

== Maken van een nieuwe Protocolhandler build ==

=== Maak nieuwe build: ===
1. Kies in Visual Studio bovenaan in de dropdown list voor project `OpenACProtocolhandler`.
2. Verhoog het versienummer op twee plaatsen (gebruik hetzelfde versienummer):
  a. in `OpenACProtocolhandler\AssemblyInfo.cs`, in regel: `public const string Version = "1.8";` (na versie 1.9 komt versie 1.10, etc.)
  b. in `OpenACProtocolhandler\Setup\OpenACProtocolHandler.iss`, in regel: `#define MyAppVersion "1.8"`
3. Kies in de Visual Studio menubalk voor Build -> Publish.
4. Klik button `Publish`.
5. Het resultaat van de publish actie is een aantal dll's, .json files, een .exe en wat .pdb files. Deze komen terecht in map `OpenACProtocolHandler\bin\Release\netcoreapp3.1\publish`.

=== Maak een installatiepackage met //Inno Setup//: ===

1. //Inno Setup// kun je via onderstaande links downloaden. Gebruik versie 6.2.0.\\
  https://jrsoftware.org/isdl.php\\
  https://files.jrsoftware.org/is/6/
2. De //Inno Setup Compiler// gebruikt een script en dit script gebruikt environment variable `WORKSPACE`.\\
  Deze variabele moet wijzen naar de root map van je Visual Studio projecten.\\
  Als dit het pad naar het script is: `C:\Projecten\OpenACWebCore\OpenACProtocolHandler\Setup\OpenACProtocolHandler.iss`,\\
  dan moet de `WORKSPACE` variabele zijn: `C:\Projecten`.\\
  Stel de `WORKSPACE` variabele in met `setx` vanaf een command prompt: `setx WORKSPACE "C:\Projecten"`\\
  Sluit hierna de command prompt en open een nieuwe om te controleren of de variabele goed is ingesteld met: `echo %WORKSPACE%`
3. Open bestand `OpenACProtocolHandler.iss` in de //Inno Setup Compiler//.\\
  N.B. Als je net de environment variabele hebt aangemaakt, start dan de //Inno Setup Compiler// door in de Windows Explorer te dubbelklikken op de .iss file. Als je vanuit Visual Studio de .iss file opent in de //Inno Setup Compiler//, dan is de nieuwe environment variabele nog niet beschikbaar. (Wel nadat je Visual Studio opnieuw gestart hebt.)
4. Kies in de menubalk voor Build -> Compile.
5. //Inno Setup Compiler// creëert een map `Output` naast het `OpenACProtocolHandler.iss` script:
  `OpenACWebCore\OpenACProtocolHandler\Setup\Output`
6. In de map `Output` staat het nieuwe installatiebestand `OpenACProtocolHandlerSetup.exe`.
7. Open de Properties van deze .exe en kijk op tabblad 'Details' of het versienummer klopt.
8. Zip deze .exe naar `OpenACProtocolHandlerSetup.zip`.

=== Wiki updaten: ===

1. Vervang de bestaande .zip file in de Wiki door de nieuwe .zip file.
2. Ga naar https://www.fenac.nl/openac/wiki/Documentatie/Beheerder/Modules/ProtocolHandler
3. Klik onderaan op button `Attach file`.
4. Kies de nieuw gemaakte .zip file.
5. Vink aan `Replace existing attachment of the same name`.
6. Klik op button `Add attachment`.

=== Installeer de nieuwe protocolhandler ook zelf: ===

1. In //Inno Setup Compiler 6.2.0// klik op de Run button.