From 70e534850e68115d634cf4d84fc6a593cdc41085 Mon Sep 17 00:00:00 2001 From: Luke Latham <1622880+guardrex@users.noreply.github.com> Date: Thu, 4 Mar 2021 14:41:25 -0600 Subject: [PATCH] Blazor WASM security troubleshoot upgrades (#21685) --- aspnetcore/blazor/includes/security/troubleshoot.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/aspnetcore/blazor/includes/security/troubleshoot.md b/aspnetcore/blazor/includes/security/troubleshoot.md index 1ceb35fbf2..07f1a97b19 100644 --- a/aspnetcore/blazor/includes/security/troubleshoot.md +++ b/aspnetcore/blazor/includes/security/troubleshoot.md @@ -83,6 +83,18 @@ One approach to prevent lingering cookies and site data from interfering with te * To avoid having to select the browser profile for each iteration of testing with an app, set the profile as the default with the **Set as Default** button. * Make sure that the browser is closed by the IDE for any change to the app, test user, or provider configuration. +### App upgrades + +A functioning app may fail immediately after upgrading either the .NET Core SDK on the development machine or changing package versions within the app. In some cases, incoherent packages may break an app when performing major upgrades. Most of these issues can be fixed by following these instructions: + +1. Clear the local system's NuGet package caches by executing [`dotnet nuget locals all --clear`](/dotnet/core/tools/dotnet-nuget-locals) from a command shell. +1. Delete the project's `bin` and `obj` folders. +1. Restore and rebuild the project. +1. Delete all of the files in the deployment folder on the server prior to redeploying the app. + +> [!NOTE] +> Use of package versions incompatible with the app's target framework isn't supported. For information on a package, use the [NuGet Gallery](https://www.nuget.org) or [FuGet Package Explorer](https://www.fuget.org). + ### Run the Server app When testing and troubleshooting a hosted Blazor app, make sure that you're running the app from the **`Server`** project. For example in Visual Studio, confirm that the Server project is highlighted in **Solution Explorer** before you start the app with any of the following approaches: