Changes between Version 12 and Version 13 of Documentatie/Beheerder/Modules/ProtocolHandler

Timestamp:

Jul 6, 2023 4:01:17 PM (3 years ago)

Author:

raymond

Comment:

--

Documentatie/Beheerder/Modules/ProtocolHandler

@@ -43 +43 @@
 De eerste stap voor het oplossen van installatie problemen is controleren van het Windows applicatielogboek. Hierin schrijft de protocol handler zijn logberichten weg. De volgende stap is controleren van het OpenAC logbestand. 
 
+== 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:
+  a. in `OpenACProtocolhandler\AssemblyInfo.cs` (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.
+
+
+
+
+
+
+