...

Seal.Net er bygget på '.NET Standard 2.0'.

Seal.Net

...

Koden findes i bitbucket:

https://

...

git.nspop.dk/

...

projects/LIB/

...

repos/seal

...

.net/browse

Projektstruktur

Seal.NET er et standard .NET library projekt og indeholder følgende:

...

^❍ Indeholder ældre dokumentation. Findes af historiske årsager.

Installation af .

...

Releases

NET

https://dotnet.microsoft.com/en-us/download

Der skal installeres en version 9 af .NET:

Start med at hente seneste version herfra:

https://dotnet.microsoft.com/en-us/download/dotnet/9.0

Installér herefter den downloadede gz-fil:

mkdir -p $HOME/dotnet && tar zxf dotnet-sdk-<version>-linux-x64.tar.gz -C $HOME/dotnet 
export DOTNET_ROOT=$HOME/dotnet 
export PATH=$PATH:$HOME/dotnet

Tilføj evt. de to sidste linjer til ~/.bashrc

Byg Seal.NET

Verificer at versionen af .NET er '9.x.y', som er den version SealTest projektet benytter - Seal projektet (som SealTest bruger) er “ligeglad”, da den compiler mod .NET Standard 2.0, som er kompatibel med alle versioner:

dotnet --version

Byg nu Seal.NET:

dotnet build

Kør tests

Inden testene kan afvikles skal følgende certifikater installeres i truststore:

Ubuntu:

sudo apt-get install -y ca-certificates
sudo cp SealTest/Resources/oces3/ca.cer /usr/local/share/ca-certificates/ca.crt
sudo cp SealTest/Resources/SelfSigned.crt /usr/local/share/ca-certificates
sudo update-ca-certificates

Windows:

Importer certifikaterne som Trusted Root Certification Authority med MMC.

Herefter kan alle tests nu afvikles:

dotnet test

Denne kommando bygger først alle projekter, og kører derefter tests.

Releases

Tjek at alle tests kører igennem, og få feature branch merged ind på mainDer laves et svn update og det tjekkes at alle tests kører.

Herefter skal der laves et tag i svn git (på main branch) for den pågældende revision på formen 'release-<major>.<minor>.<patch>':

svngit cp https://svn.nspop.dk/svn/libraries/seal/net/trunk/ https://svn.nspop.dk/svn/libraries/seal/net/tags/tag -a release-X.Y.Z/ -m "Tag X.Y.ZSDS-XXXX"

Hvor X.Y.Z skal rettes til versionen.

Lav et checkout af det nyoprettede tag, og lav en mappe i roden af projektet der hedder "Release".

, og beskeden til SDS-sagsnummer i Jira.

Opret herefter en release branch, og byg NuGet pakken Byg en NuGet pakke - se nedenunder (det er denne pakke som uploades til nuget.org, som gør Seal.Net tilgængelig for andre).Lig den ind i "Release" mappen og commit denne mappe på tagget. På denne måde bliver den generede NuGet pakke en del af releaset.

NuGet link til Seal.NET: https://www.nuget.org/packages/Seal.net

Byg af NuGet pakke

En NuGet pakke kan bygges med følgende kommando:

dotnet pack -c release --include-symbols -p:Version=1.2.3

Lig den ind i "Release" mappen og commit denne mappe på tagget:

git add -f ./Seal/bin/Release/Seal.net.X.Y.Z.nupkg
git add -f ./Seal/bin/Release/Seal.net.X.Y.Z.symbols.nupkg

commit -m "SDS-XXXX: nuget pakker tilføjet"
git push

Release note for pakken skrives ind i 'ReleaseNotes.txt'. Projektfilen ('Seal.csproj') er konfigureret til at læse fra denne fil når den pakkes til en NuGet pakke. Der er ikke lavet en aftale om at dette skal gøres, så det er ikke et krav.

Kort om referencer ved byg af NuGet

For at inkludere refererede projekter som dll (DgwsTypes i dette tilfælde) i den genererede NuGet-pakke, er NuGet pakken Teronis.MSBuild.Packaging.ProjectBuildInPackage refereret i Seal-projektet. Når der sættes 'PrivateAssets="all"' på en projekt-reference (i 'Seal.csproj'), vil den automatisk ligge dll og evt. pdb filer fra projektet ind i den genererede pakke.

Dette gøres da .NET pakker eksterne afhængigheder som NuGet referencer, men man har valgt at ligge dem ind direkte som en lokal dll før i tiden. Da DgwsTypes ligger på nuget.org, kan den erstattes af en NuGet reference, og da dette er understøttet af .NET, er det nok at foretrække på sigt.

Specifikt for .NET Framework

1.  Opdater versionsnummeret i Seal/Properties/AssemblyInfo.cs (det bestemmer versionsnummerert i nuget pakken).
2. MSBuild seal\Seal.csproj /property:Configuration=Release
   1. Hvis man får en fejl omkring certifikater, gør da følgende
              sn -i DgwsTypes\DgwsTypesStrongName.pfx med den VS_KEY der nævnes (pw: DgwsTypesPassword)
              byg igen, du får nu sikkert en ny fejl med ny VS_KEY
              sn -i Seal\Seal.NetStrongName.pfx med den VS_KEY der nævnes (pw: Seal.NetPassword)
              byg igen, skulle gerne være uden fejl nu
3. nuget pack Seal\Seal.csproj -properties Configuration=Release -Symbols -SymbolPackageFormat snupkg

Tests

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, eller med dotnet cli (dotnet test).

Opsætning af udviklingsmiljø

Koden findes i svn:

https://svn.nspop.dk/svn/libraries/seal/net/trunk/

For at få projektets testsuite til at køre skal følgende certifikater importeres i trust store på den computer man vil afvikle testene på.

I Windows importeres de som trusted root certification authorities med MMC.

I Linux kan ca-certificates cli benyttes til at importere dem.

• SealTest/Resources/oces3/devtest4/FOCES_gyldig.crt (password: Test1234)
  
• SealTest/Resources/SelfSigned.crt

Specifikt for .NET Framework med FMK integrationstests (gælder kun Seal.NET 4.x.y og ældre)

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).