Seal.Net
Dette dokument beskriver hvordan man kommer i gang med at tilpasse eller videreudvikle Seal.Net ud fra kildeteksten.
Der forudsættes erfaring med .net-udvikling og brug af open source projekter. Læs også 2. Building, der er rettet med at bygge og release biblioteket, men hvis beskrivelse af teknisk setup ikke gentages her.
Afhængigheder
Seal.Net er bygget på .net platformen, og kræver version 4.6.2.
Seal.Net projektet ligger på nspop svn-repository på følgende adresse: https://svn.nspop.dk/svn/libraries/seal/net/
Seal.Net er et standard Visula Studio 2015 projekt, og har følgende struktur:
❍ Indeholder kildekode for selve biblioteket
❍ Typer der beskriver alle security headers som er defineret i Den Gode Webservice.
❍ Indeholder unit- og integrationstests
❍ Indeholder al dokumentation som krævet på https://www.nspop.dk/display/public/web/Dokumentationskrav+for+NSP-platformen
❍ Indeholder scripts til at bygge med.
❍ Indeholder eksterne NuGet pakker. Dette dir skal heller ikke ligge i Subversion.
Der laves et svn update og det tjekkes at alle tests kører.
Herefter skal der laves et tag i svn for den pågældende revision med følgende form: release-<major>.<minor>.<patch>
En NuGet pakke kan bygges med følgende kommando:
dotnet pack -c release --include-symbols -p:Version=1.2.3 |
Specifikt for .NET Framework
Unit- og integrationstests er placeret under SealTest/, og følger den samme pakkestruktur som de klasser der testes. Der anvendes normal NUnit til at implementere tests. Tests køres i Visual Studio som normalt. Så vidt muligt navngives testmetoder efter deres hensigt – dvs. f.eks. testConditionShouldBeTrue() i stedet for test1().
For at få projektets testsuite til at køre skal følgende certifikater importeres i trust store.
I Windows importeres disse som trusted root certification authorities med MMC:
Specifikt for .NET Framework med FMK integrationstest
Følgende kommando køres
netsh http add urlacl url=http://+:1010/FMK/ user=DOMAIN\user
hvor DOMAIN\user f.eks. kan aflæses ved at tilgå Control Panel → User Accounts → Configure advanced user profile properties (på Windows 10).
Der er udarbejdet en "Kom Godt i Gang Guide", til at hjælpe udviklere i gang, med at udvikle systemer, der benytter sig af Seal.Net. Guiden findes via linket:
https://www.nspop.dk/display/public/web/SEAL.NET+-+Leverancebeskrivelse