feat!: update target frameworks, merge IAsyncParseNodeFactory, and remove obsolete APIs (#708)

Update target frameworks to net8.0 and net10.0 (drop net5.0 and net6.0),
merge IAsyncParseNodeFactory into IParseNodeFactory, remove synchronous
deserialization methods from KiotaSerializer, migrate to central package
management, and add a v1.x to v2.x upgrade guide.

feat!: update target frameworks to net8.0 and net10.0, drop net5.0 and net6.0
  BREAKING-CHANGE: net5.0 and net6.0 TFMs dropped; net8.0 and net10.0 added.
  Source-Link: cc3ca4b

fix: resolve trim analysis warnings and pin PublicApiAnalyzers to net8.0
  Source-Link: c017c65

chore: migrate to central package management via Directory.Packages.props
  Source-Link: a0651aa

ci: update ESRP signing SDK install to .NET 8 and add .NET 10
  Source-Link: 6ab1ad2

fix(build): update package version lower bounds from 6.0 to 8.0
  Source-Link: 61a76e6

refactor(abstractions)!: merge IAsyncParseNodeFactory into IParseNodeFactory
  BREAKING-CHANGE: IAsyncParseNodeFactory removed; implement IParseNodeFactory.GetRootParseNodeAsync directly.
  Source-Link: 1836a32

refactor(abstractions)!: remove synchronous Deserialize and DeserializeCollection from KiotaSerializer
  BREAKING-CHANGE: Use DeserializeAsync/DeserializeCollectionAsync instead.
  Source-Link: 1836a32

refactor(serialization): update JsonParseNodeFactory, FormParseNodeFactory, and TextParseNodeFactory for unified IParseNodeFactory
  Source-Link: 1836a32

refactor(abstractions)!: remove deprecated single-param MultipartBody.GetPartValue and RemovePart overloads
  BREAKING-CHANGE: GetPartValue<T>(string) and RemovePart(string) removed; use the overloads that accept (partName, contentType).
  Source-Link: 1836a32

fix(ci): use glob pattern for timestamped coverlet coverage report paths
  Source-Link: 1836a32

build(http): bump System.Net.Http.WinHttpHandler lower bound to [10.0,) for net462
  Source-Link: c126a66

docs: add v1.x to v2.x upgrade guide
  Source-Link: 713273d

docs: enhance upgrade guide with agent-friendly metadata and compiler error mappings
  Source-Link: bd8cafc

Author: MIchaelMainer

.azure-pipelines/ci-build.yml

@@ -1,5 +1,9 @@
 # Copilot Instructions
 
+## Upgrade Guide
+
+When working on code that consumes the Kiota .NET libraries, or when encountering build errors after a version update, refer to [`docs/upgrade-guide-v1-to-v2.md`](../docs/upgrade-guide-v1-to-v2.md) for breaking changes, migration steps, and compiler error mappings between v1.x and v2.x.
+
 ## Commit Message Format
 
 Always use conventional commits format when creating commits. Follow this structure:

.github/copilot-instructions.md

@@ -3,9 +3,9 @@ name: Build and Test
 on:
   workflow_dispatch:
   push:
-    branches: ["main", "dev", "feature/*"]
+    branches: [ "main", "dev", "feature/*" ]
   pull_request:
-    branches: ["main", "dev"]
+    branches: [ "main", "dev" ]
 
 permissions:
   contents: read #those permissions are required to run the codeql analysis
@@ -19,10 +19,13 @@ jobs:
       solutionName: Microsoft.Kiota.slnx
     steps:
       - uses: actions/checkout@v6
-      - name: Setup .NET
+
+      - name: Setup .NET 8 and 10
         uses: actions/setup-dotnet@v5
         with:
-          dotnet-version: 10.x
+          dotnet-version: |
+            8.x
+            10.x
       - name: Initialize CodeQL
         uses: github/codeql-action/init@v4
         with:
@@ -32,10 +35,14 @@ jobs:
       - name: Check formatting
         run: dotnet format ${{ env.solutionName }} --verify-no-changes
       - name: Build
-        run: dotnet build ${{ env.solutionName }} --no-restore /p:UseSharedCompilation=false
+        run: dotnet build ${{ env.solutionName }} --no-restore
+          /p:UseSharedCompilation=false
       - name: Test for net472
-        run: dotnet test --solution ${{ env.solutionName }} --no-build --verbosity normal --framework net472
+        run: dotnet test --solution ${{ env.solutionName }} --no-build --verbosity
+          normal --framework net472
       - name: Test for net10.0 and collect coverage
-        run: dotnet test --solution ${{ env.solutionName }} --no-build --verbosity normal --framework net10.0 -- --coverlet --coverlet-output-format opencover
+        run: dotnet test --solution ${{ env.solutionName }} --no-build --verbosity
+          normal --framework net10.0 -- --coverlet --coverlet-output-format
+          opencover
       - name: Perform CodeQL Analysis
         uses: github/codeql-action/analyze@v4

.github/workflows/build-and-test.yml

@@ -61,7 +61,7 @@ jobs:
           SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
         shell: pwsh
         run: |
-          dotnet tool run dotnet-sonarscanner begin /k:"microsoft_kiota-abstractions-dotnet" /o:"microsoft" /d:sonar.token="$env:SONAR_TOKEN" /d:sonar.host.url="https://sonarcloud.io" /d:sonar.cs.opencover.reportsPaths="tests/abstractions/bin/Debug/net10.0/TestResults/coverage.opencover.xml,tests/authentication/azure/bin/Debug/net10.0/TestResults/coverage.opencover.xml,tests/http/httpClient/bin/Debug/net10.0/TestResults/coverage.opencover.xml,tests/serialization/json/bin/Debug/net10.0/TestResults/coverage.opencover.xml,tests/serialization/text/bin/Debug/net10.0/TestResults/coverage.opencover.xml,tests/serialization/form/bin/Debug/net10.0/TestResults/coverage.opencover.xml,tests/serialization/multipart/bin/Debug/net10.0/TestResults/coverage.opencover.xml,tests/bundle/bin/Debug/net10.0/TestResults/coverage.opencover.xml"
+          dotnet tool run dotnet-sonarscanner begin /k:"microsoft_kiota-abstractions-dotnet" /o:"microsoft" /d:sonar.token="$env:SONAR_TOKEN" /d:sonar.host.url="https://sonarcloud.io" /d:sonar.cs.opencover.reportsPaths="tests/**/TestResults/coverage.opencover.*.xml"
           dotnet workload restore
           dotnet build
           dotnet test --solution Microsoft.Kiota.slnx --no-build --verbosity normal --framework net10.0 -- --coverlet --coverlet-output-format opencover

.github/workflows/sonarcloud.yml

@@ -0,0 +1,26 @@
+<Project>
+  <PropertyGroup>
+    <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
+  </PropertyGroup>
+  <ItemGroup>
+    <!-- Source packages -->
+    <PackageVersion Include="Azure.Core" Version="1.50.0" />
+    <PackageVersion Include="Microsoft.CodeAnalysis.Analyzers" Version="5.3.0" />
+    <PackageVersion Include="Microsoft.CodeAnalysis.CSharp" Version="5.3.0" />
+    <PackageVersion Include="Microsoft.CodeAnalysis.PublicApiAnalyzers" Version="4.14.0" />
+    <PackageVersion Include="Microsoft.Extensions.DependencyInjection.Abstractions" Version="[8.0,)" />
+    <PackageVersion Include="Microsoft.IO.RecyclableMemoryStream" Version="3.0.1" />
+    <PackageVersion Include="Microsoft.VisualStudio.Threading.Analyzers" Version="17.14.15" />
+    <PackageVersion Include="Std.UriTemplate" Version="2.0.8" />
+    <PackageVersion Include="System.Diagnostics.DiagnosticSource" Version="[8.0.1,)" />
+    <PackageVersion Include="System.Net.Http.WinHttpHandler" Version="[10.0,)" />
+    <PackageVersion Include="System.Text.Json" Version="[8.0,)" />
+    <!-- Test packages -->
+    <PackageVersion Include="coverlet.MTP" Version="10.0.0" />
+    <PackageVersion Include="Microsoft.Extensions.DependencyInjection" Version="10.0.7" />
+    <PackageVersion Include="Microsoft.Extensions.Http" Version="10.0.7" />
+    <PackageVersion Include="Microsoft.Testing.Platform" Version="2.2.2" />
+    <PackageVersion Include="Moq" Version="4.20.72" />
+    <PackageVersion Include="xunit.v3.mtp-v2" Version="3.2.2" />
+  </ItemGroup>
+</Project>