Feature/hotfix fixing release and package issues (#157)

* #154 Update packaging and build process for CryptoNet

- Set `<IsPackable>false</IsPackable>` in `CryptoNet.ExtShared.csproj`
  and `CryptoNet.Models.csproj` to prevent NuGet packaging.
- Bump version in `CryptoNet.csproj` from `3.0.0` to `3.1.9`.
- Add `<IncludeReferencedProjects>true</IncludeReferencedProjects>`
  to include referenced project outputs in the NuGet package.
- Add a target to explicitly include referenced DLLs in the package.
- Modify asset handling for `CryptoNetLogo-icon.png` to prevent
  copying to the output directory.
- Update `Directory.Build.Props` to conditionally set `<PathMap>`
  only when `$(SolutionDir)` is defined, avoiding malformed paths.

* #154 Update dependencies and project configurations

- Upgraded `Microsoft.CodeAnalysis.NetAnalyzers` to `10.0.100`.
- Upgraded `System.Text.Json` to `10.0.0` across all projects.
- Updated test dependencies: `Microsoft.NET.Test.Sdk`, `NUnit3TestAdapter`,
  `ReportGenerator`, `SharperHacks.CoreLibs.IO`, `CliWrap`, and `NUnit.Analyzers`.
- Added `Microsoft.Build` to `CryptoNet.UnitTests.csproj`.
- Enabled embedded debugging with `<DebugType>embedded</DebugType>`.
- Re-enabled `<GenerateDocumentationFile>` in `CryptoNet.csproj`.
- Centralized versioning in `Directory.Build.Props` and set version to `3.2.0`.
- Updated `TargetFramework` to `net8.0` in `Directory.Build.Props`.
- Adjusted project references and metadata for consistency.

* #154 Improve packaging, debugging, and validation processes

- Set `<IsPackable>false</IsPackable>` in `CryptoNet.ExtShared.csproj`
  and `CryptoNet.Models.csproj` to prevent standalone NuGet packing.
- Added `<DebugType>portable</DebugType>` and `<Deterministic>true</Deterministic>`
  for portable PDBs and deterministic builds.
- Downgraded `Microsoft.CodeAnalysis.NetAnalyzers` to 9.0.0 and
  `System.Text.Json` to 9.0.8 in `CryptoNet.ExtShared.csproj` for compatibility.
- Included `.pdb` and `.xml` files for `CryptoNet.ExtShared` and
  `CryptoNet.Models` in the NuGet package if they exist.
- Added NuGet validation script in `run_nuget_validation.ps1` to
  ensure package quality using `dotnet-validate`.

* #154 Enhance build settings and NuGet packaging metadata

Updated project files to improve NuGet packaging and SourceLink integration:
- Added `<IsPackable>false</IsPackable>` to prevent standalone NuGet packaging.
- Included repository metadata (`<RepositoryUrl>` and `<PublishRepositoryUrl>`).
- Enabled SourceLink and deterministic build settings with `<EmbedUntrackedSources>` and `<ContinuousIntegrationBuild>`.

Refined dependencies:
- Added `Microsoft.SourceLink.GitHub` (v8.0.0) for GitHub SourceLink support.
- Retained `Microsoft.CodeAnalysis.NetAnalyzers` (v9.0.0) for static analysis.

Removed obsolete properties and comments:
- Removed `_SkipUpgradeNetAnalyzersNuGetWarning` and outdated comments.

Updated `run_nuget_validation.ps1`:
- Added `dotnet clean`, `dotnet build`, and `dotnet pack` commands.
- Integrated `dotnet-validate` for NuGet package validation.

* #154 Simplify project build settings

Removed `<DebugType>portable>`, `<Deterministic>`,
`<ContinuousIntegrationBuild>`, and `<EmbedUntrackedSources>`
from `CryptoNet.ExtShared.csproj` and `CryptoNet.Models.csproj`.
These changes simplify the build configuration by removing
explicit settings for debug information, deterministic builds,
CI build flags, and SourceLink validation. Adjustments may
reflect a shift to default or external configurations.

* Update dependencies, versions, and target framework

- Updated `CryptoNet.ConsumerTest.csproj` to use `CryptoNet` version `3.1.12-preview.20251129.2241`.
- Removed the `<Version>` tag from `CryptoNet.ExtPack.csproj` (was `3.0.0`).
- Upgraded Visual Studio version in `CryptoNet.sln` to `18.3.11222.16`.
- Added `Directory.Build.Props` with updated versioning:
  - `<Version>`: `3.2.0` → `3.2.5`
  - `<FileVersion>`: `3.2.0.0` → `3.2.5.0`
  - `<AssemblyVersion>`: `3.2.0.0` → `3.2.5.0`
- Updated target framework in `Directory.Build.Props` to `net8.0`.

* Refactor preview tag format and add release script

Updated `cd-release-preview.yml` to simplify the regex for preview tag matching. Adjusted `run_release.ps1` to make `PreviewId` and `TagName` NuGet-compliant by removing dots and using the format `vX.Y.Z-previewYYYYMMDDHHmm`. Improved error messaging for version validation. Added `run_release.ps1` to the `DevOps` project in `CryptoNet.sln`.

Author: maythamfahmi

.github/workflows/cd-release-preview.yml

@@ -3,7 +3,7 @@ name: "2. Continuous Deployment (Release Preview)"
 on:
   push:
     tags:
-      - "v[0-9]+\\.[0-9]+\\.[0-9]+-preview.*"
+      - "v[0-9]+\\.[0-9]+\\.[0-9]+-preview*"
 
 jobs:
   build:

CryptoNet.ConsumerTest/CryptoNet.ConsumerTest.csproj

@@ -8,7 +8,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="CryptoNet" Version="3.1.0" />
+    <PackageReference Include="CryptoNet" Version="3.1.12-preview.20251129.2241" />
   </ItemGroup>
 
 </Project>

CryptoNet.ExtPack/CryptoNet.ExtPack.csproj

@@ -17,7 +17,6 @@
     <Company>itbackyard</Company>
     <Authors>Maytham Fahmi</Authors>
     <MinClientVersion>1.0.0</MinClientVersion>
-    <Version>3.0.0</Version>
     <Title>CryptoNet.ExtPack</Title>
     <Product>CryptoNet.ExtPack</Product>
     <RootNamespace>CryptoNet.ExtPack</RootNamespace>

CryptoNet.sln

@@ -1,6 +1,6 @@
 Microsoft Visual Studio Solution File, Format Version 12.00
-# Visual Studio Version 17
-VisualStudioVersion = 17.1.32407.343
+# Visual Studio Version 18
+VisualStudioVersion = 18.3.11222.16 d18.3
 MinimumVisualStudioVersion = 10.0.40219.1
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "CryptoNet", "CryptoNet\CryptoNet.csproj", "{8F85375C-A0DC-4B67-B934-F58ED4114F5A}"
 EndProject
@@ -16,11 +16,13 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "DevOps", "DevOps", "{1733D1
 		.github\workflows\cd-release.yml = .github\workflows\cd-release.yml
 		.github\workflows\ci.yml = .github\workflows\ci.yml
 		.github\workflows\code-coverage.yml = .github\workflows\code-coverage.yml
+		Directory.Build.Props = Directory.Build.Props
 		DockerBuild.ps1 = DockerBuild.ps1
 		Dockerfile = Dockerfile
 		RELEASE-NOTES = RELEASE-NOTES
 		run_codecoverage.ps1 = run_codecoverage.ps1
 		run_codecoverage.txt = run_codecoverage.txt
+		run_release.ps1 = run_release.ps1
 	EndProjectSection
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Info", "Info", "{6976E2ED-A139-48C5-A390-639F56A8B348}"

CryptoNet/CryptoNet.csproj

@@ -26,7 +26,9 @@
     <Copyright>Copyright © 2020</Copyright>
     <PublishRepositoryUrl>true</PublishRepositoryUrl>
     <EmbedUntrackedSources>true</EmbedUntrackedSources>
+    <IncludeSymbols>true</IncludeSymbols>
     <DebugType>embedded</DebugType>
+    <SymbolPackageFormat>snupkg</SymbolPackageFormat>
     <ContinuousIntegrationBuild>true</ContinuousIntegrationBuild>
     <_SkipUpgradeNetAnalyzersNuGetWarning>true</_SkipUpgradeNetAnalyzersNuGetWarning>
     <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
@@ -62,7 +64,7 @@
     <ProjectReference Include="..\CryptoNet.Models\CryptoNet.Models.csproj" PrivateAssets="all" />
   </ItemGroup>
 
-  <Target Name="IncludeReferencedDllsInPackage" BeforeTargets="GenerateNuspec">
+  <Target Name="IncludeReferencedDllsInPackage" AfterTargets="Build">
     <ItemGroup>
       <None Include="$(OutputPath)CryptoNet.ExtShared.dll">
         <Pack>true</Pack>

Directory.Build.Props

@@ -3,9 +3,9 @@
   <PropertyGroup>
     <Authors>Maytham Fahmi and Contributors</Authors>
     <Copyright>All Rights Reserved</Copyright>
-    <Version>3.2.0</Version>
-    <FileVersion>3.2.0.0</FileVersion>
-    <AssemblyVersion>3.2.0.0</AssemblyVersion>
+    <Version>3.2.5</Version>
+    <FileVersion>3.2.5.0</FileVersion>
+    <AssemblyVersion>3.2.5.0</AssemblyVersion>
   </PropertyGroup>
 
   <PropertyGroup>

run_release.ps1

@@ -14,14 +14,14 @@ if ($VersionNumber -notmatch '^\d+\.\d+\.\d+$') {
 }
 
 # Build preview suffix (valid SemVer identifiers, no leading zeros)
-$DatePart  = (Get-Date -Format "yyyyMMdd")   # e.g. 20250822
-$TimePart  = (Get-Date -Format "Hmm")        # e.g. 845 (not 0845, no leading zero!)
-$PreviewId = "$DatePart.$TimePart"           # → "20250822.845"
+$DatePart  = (Get-Date -Format "yyyyMMdd")   # e.g 20250822
+$TimePart  = (Get-Date -Format "Hmm")        # e.g 845 (not 0845, no leading zero!)
+$PreviewId = "$DatePart$TimePart"            # → "20250822845" (no dots!)
 
 # Construct the tag
 if ($IsPreview) {
-    # format: vX.Y.Z-preview.YYYYMMDD.HHmm
-    $TagName = "v$VersionNumber-preview.$PreviewId"
+    # format: vX.Y.Z-previewYYYYMMDDHHmm (NuGet-compliant)
+    $TagName = "v$VersionNumber-preview$PreviewId"
 } else {
     $TagName = "v$VersionNumber"
 }