TLCGen zelf compileren

Omdat TLCGen open source software is (beschikbaar onder de MIT licentie), is het mogelijk de applicatie zelf te compileren. TLCGen heeft zich ontwikkeld tot een relatief uitgebreide applicatie die bestaat uit diverse, min of meer losse onderdelen. Het proces van compileren is evenwel relatief ongecompliceerd.

Merk op: de applicatie wordt tevens automatisch gebouwd met behulp van AppVeyor. Daarom is er – indien er geen compileerfouten zijn – altijd een binary beschikbaar van de allerlaatste stand van de code: https://ci.appveyor.com/project/mennowo/tlcgen/build/artifacts. Deze binary is niet digitaal ondertekend door CodingConnected (wat voor de versie op de website wel geldt).

Deze tutorial vooronderstelt:

• Microsoft Visual Studio 2017 is geïnstalleerd (dit mag de gratis community versie zijn, TLCGen wordt daarin zelfs ontwikkeld)
  • Let op! Met oudere versies van Visual Studio kan de software niet worden gecompileerd
• Basis kennis van compileren van software met Visual Studio
• Basis kennis van het werken met git is behulpzaam, maar niet onontbeerlijk

De broncode ophalen

Om TLCGen te compileren hebben we de broncode van de applicatie nodig. Deze is beschikbaar via github (https://github.com/mennowo/TLCGen/).

De eenvoudigste methode is om een kopie van de broncode te downloaden als zip file.

• Klik hiertoe op de knop “Clone or download” en kies “Download ZIP”
  

  

• Sla de zip file op, en pak die vervolgens uit.

Een alternatieve methode is de code te clonen direct in Visual Studio. Het effect is hetzelfde: de broncode komt op de lokale schijf te staan. Een voordeel aan het clonen is, dat later met een druk op de knop de laatste stand van de code kan worden binnengehaald.

• Kies in Visual Studio het menu “Team” > “Manage Connections…”
• Klik bij “Local repositories” op “Clone” en vul de link in van Github die verschijnt na klikken op “Clone or download”
• Vul de gewenste lokale map in
• Klik op “Clone”
  

  

• De code wordt nu binnengehaald

TLCGen compileren

Compileren van TLCGen is in principe eenvoudig. Ervan uitgaande dat de benodigde elementen van Visual Studio geïnstalleerd zijn (.NET development incl. .NET SDK versie 4.6.1), is het een twee-stappen-plan: 1) binnenhalen van afhankelijkheden, 2) compileren van de applicatie. Hieronder volgt een uitgebreidere uitleg:

• Open in de map TLCGende solution “TLCGen.sln”
• Open nu de Package manager console via het menu “Tools” > “NuGet package manager” > “Package manager console”
  

  

• TLCGen maakt voor beheer van benodigde libraries gebruik van de package manager Paket. Voer daarom in “.paket/paket.exe restore” en druk op enter
• Kies nu “Rebuild Solution” in het menu “Build”, of start de applicatie met CTRL+F5
• Een opmerking inzake de opbouw van de applicatie: het project “TLCGen.Dependencies” levert één enkele dll op. Dit is een library met een veelheid aan namespaces, alle met afzonderlijke functionaliteiten en doeleinden. Dit zit allemaal in één project, omdat dit handig is bij ontwikkelen van plugins, omdat er niet een veelvoud aan referenties behoeft te worden toegevoegd. Alle project binnen de solution TLCGen verwijzen naar de release versie van TLCGen.Dependencies.dll. Het project TLCGen.Dependencies is zo ingesteld, dat bij bouwen van de Debug versie, de resulterende dll wordt gekopieerd naar de map Release, zodat de verwijzingen kloppen.

Klaar!