Documentation

fsds/dplx-fix-aspire-workload-version-mismatch.md

Fix Aspire Workload Version Mismatch

Problem

The Aspire workload installed on the machine was updated to a version that requires Aspire.Hosting.AppHost 13.0.0+, but the project uses 9.5.2 packages. The DCP (Developer Control Plane) version check rejects the older packages.

Root Cause

  • Project packages: Aspire 9.5.2 (correct)
  • Installed workload: Newer version requiring 13.0.0+
  • The DcpDependencyCheck.EnsureDcpVersion check fails due to version incompatibility

Solution: Downgrade Aspire Workload

Step 1: Check current workload version

dotnet workload list

Step 2: Uninstall the current Aspire workload

dotnet workload uninstall aspire

Step 3: Install the compatible Aspire workload version

For Aspire 9.5.2 packages, install the 9.0 workload:

dotnet workload install aspire --version 9.0.0

Step 4: Verify installation

dotnet workload list

Step 5: Clean and rebuild

# Clean build artifacts
dotnet clean
rm -rf **/bin **/obj

# Restore and build
dotnet restore
dotnet build

Step 6: Run the AppHost

dotnet run --project projects/bbu-rfid/src/Acsis.Dynaplex.Projects.BbuRfid/Acsis.Dynaplex.Projects.BbuRfid.csproj

Notes

  • The Aspire workload version must be compatible with the package versions
  • Aspire 9.x packages require the 9.0 workload
  • When ready to upgrade to Aspire 13.0.0+, update both packages AND workload together