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