Deploy checkbox is disabled for the .NET MAUI project in Visual Studio 17.14.9

Question

Deploy checkbox is disabled for the .NET MAUI project in Visual Studio 17.14.9

Yusuf Groenewald 20

I have upgraded Visual Studio to version 17.14.9. I then upgraded my .NET MAUI project from NET7 to NET9, but now when I try to run the project, I get this message: "The project needs to be deployed before we can debug. Please enable Deploy in the Configuration Manager". However, in Configuration Manager, the Deploy checkbox is disabled for the .NET MAUI project.

A. Should I go down to NET8 rather? If so, I can't seem to find the .NET 8 SDK for Visual Studio 17.14.9.

B. Should I uninstall Visual Studio 17.14.9 and install an earlier version? If so, which version supports NET9, and where can I get the installer?

C. Should I rollback to my previous version of Visual Studio (17.9.x) and go back to NET7?

Any help would be appreciated.

0 comments

Answer accepted by question author

0 additional answers

Your answer

Answer 1

Hi Yusuf Groenewald!

Thanks for reaching out on this platform!

For .NET 9 MAUI, particularly when targeting Windows, the "Deploy" checkbox option in the Visual Studio Configuration Manager is intentionally disabled by default and is effectively deprecated for Windows unpackaged, which can make debugging a lot faster and more efficient. See here

If you want the traditional Windows packaged debug, you must first enable the option in (Right click your project→Properties→Application→Windows Targets->Enable the Create Packaged App checkbox), below:

image (5)

Then the "deploy" checkbox in Configuration Manager should be available for you.

Troubleshooting "The project needs to be deployed before we can debug. Please enable Deploy in the Configuration Manager"

Back to the issue you are encountering, you typically don't need to roll back any action, this issue might be due to a conflict between .NET 7 and .NET 9 that you are currently upgrading. This directly contradicts the expected behavior, suggesting that Visual Studio thinks it needs that checkbox enabled to proceed. Here are steps to solve:

Check the Configuration Manager (Even if it's Grayed Out):

If it's grayed out, that's the expected behavior. The error message implies it should be enabled, which is the core of the problem. If, by some chance, it's not grayed out and is unchecked, check it. (Highly unlikely for MAUI, but worth a double-check).

Clean and Rebuild Your Solution

In Solution Explorer, right-click your solution.
Select Clean Solution.
After cleaning, right-click the solution again and select Rebuild Solution

This ensures you're starting with a fresh slate.

Delete bin and obj Folders

Sometimes, files within these folders get corrupted or out of sync, leading to strange build or deployment errors. Deleting them allows them to be regenerated accordingly.

Close Visual Studio.
Navigate to your project directory in File Explorer.
Inside your project folder, locate and delete the bin and obj folders.
Reopen Visual Studio and try to run the project again.

Check your .csproj File

Look for any PropertyGroup settings that might be incorrect:

DeployOnBuild should be False
IsPublishable should be True

Example of correct settings:

<PropertyGroup>
    <DeployOnBuild>False</DeployOnBuild>
    <IsPublishable>True</IsPublishable>
</PropertyGroup>

Remove any remnants of WindowsPackageType if you're targeting Windows (though this is usually handled correctly by MAUI templates)

These steps should resolve the deployment error when upgrading from .NET 7 to .NET 9.

Here are some sources that might be helpful:

I hope this helps! If you agree with the suggestions, feel free to interact with the system accordingly!

Yusuf Groenewald 20 Reputation points

2025-07-29T21:52:37.91+00:00

Hi Tony Dinh,

Thank you for taking the time to respond to my issue. It is much appreciated.

I followed your instructions, and I no longer get the error: "The project needs to be deployed before we can debug. Please enable Deploy in the Configuration Manager".

I have the following under the PropertyGroup within my .csproj file:

<WindowsPackageType>None</WindowsPackageType> <DeployOnBuild>False</DeployOnBuild> <IsPublishable>True</IsPublishable>

I have the following under Application > Windows Targets: My app's Properties/launchSettings.json file has the commandName value changed from MsixPackage to Project

{ "profiles": { "Windows Machine": { "commandName": "Project", "nativeDebugging": false } } }

My solution/project builds fine, without any errors.

However, when I try to run (Debug - F5) my project, I started getting a new error: "Unable to start program 'open.exe'. The system cannot find the file specified."

I did a "Repair" (twice) of Visual Studio, and what was strange is that when I opened my project again, the "Deploy" checkbox was no longer disabled and it was checked. I then unchecked it. This is strange, because when I created a new out-of-the-box .NET MAUI Blazor Hybrid application, the "Deploy" checkbox is disabled, which is the expected behaviour as you mentioned, and this project runs fine.

I have searched high and low for a solution for the new error, but I have had no joy. I will continue to search for a solution to this problem. If you know this error, it would be great if you could share your recommendations on how to go about troubleshooting it!
Starry Night 625 Reputation points

2025-07-30T07:44:19.84+00:00

You can first restart your PC and try again.

And from the tip of document Convert a packaged .NET MAUI Windows app to unpackaged, we know that If your app defines multiple launch setting profiles you'll have to manually update the commandNamevalue fromMsixPackagetoProject for each profile., you can recheck this for your app.
Anonymous

2025-08-04T02:45:27.0133333+00:00

Hi Yusuf Groenewald!
I notice that you have solve the issue relate to disable deploy checkbox, if you agree from my suggestion, feel free to interact the system accordingly.

Best regards!
Yusuf Groenewald 20 Reputation points

2025-08-06T07:10:11.5566667+00:00

Subject: Update on Project Issue Resolution

Hi Tony Dinh,

I wanted to thank you for your suggestions, which helped me resolve the original issue I posted. Thanks to your guidance, my project was building correctly. However, when I ran the project (using F5), I encountered a new error: "Unable to start program 'open.exe'. The system cannot find the file specified."

I researched this issue extensively, searching for possible solutions, but was unable to find any that worked. Finally, I decided to create a brand new solution in the updated version of Visual Studio (17.14.9) with .NET 9, and I copied all my projects and files into this new solution. This approach eliminated the new error, and now I can successfully build and run my project without any issues.

Thanks again for your suggestions.

Warm regards!
Anonymous

2025-08-06T10:41:56.6066667+00:00

You are welcome! Feel free to reach out to this platform if you need any help!

Share via

Deploy checkbox is disabled for the .NET MAUI project in Visual Studio 17.14.9

Troubleshooting "The project needs to be deployed before we can debug. Please enable Deploy in the Configuration Manager"

0 additional answers

Your answer