Развертывание и отладка приложения .NET MAUI в Windows

Вы можете использовать локальный компьютер разработки Windows для развертывания и отладки приложения .NET Multi-platform App UI (.NET MAUI). В этой статье описывается, как настроить Windows для отладки приложения .NET MAUI.

При отладке и развертывании нового проекта MAUI .NET в Windows поведение по умолчанию заключается в развертывании непакованного приложения. Сведения о непакованных приложениях см. в статье "Приложения Windows: упаковка, развертывание и процесс".

Целевые окна

В Visual Studio задайте целевой объект отладки для платформы (...)>net9.0-windows. В записи элемента есть номер версии, который может соответствовать следующему снимку экрана:

Преобразование непакованного приложения .NET MAUI Для Windows в упакованный

Если ваше приложение должно использовать API, которые доступны только в упакованных приложениях Windows, и вы планируете распространять свое приложение через Microsoft Store, вам потребуется преобразовать распаковаемое приложение в упаковаемое приложение. Это можно сделать в Visual Studio:

1. В Обозреватель решений щелкните правой кнопкой мыши проект приложения .NET MAUI и выберите "Свойства". Затем перейдите на вкладку "Целевые объекты Приложений > Windows" и убедитесь, что установлен флажок "Создать пакет Windows MSIX":

   

Visual Studio изменит файл проекта приложения (CSPROJ), чтобы удалить <WindowsPackageType>None</WindowsPackageType> строку. Кроме того, в файле свойств или launchSettings.json приложения будет изменено commandName значение:Project MsixPackage

JSON

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

Важно!

Если приложение определяет несколько профилей параметров запуска, необходимо вручную обновить commandName значение для Project MsixPackage каждого профиля.

При развертывании упаковаированного приложения .NET MAUI Для Windows необходимо включить режим разработчика в Windows. Дополнительные сведения см. в разделе "Настройка Windows для упаковаемого развертывания приложений".

Преобразование упаковаированного приложения .NET MAUI Для Windows в распаковку

Чтобы преобразовать существующее упакованое приложение .NET MAUI Windows в распаковку приложения в Visual Studio:

1. В Обозреватель решений щелкните правой кнопкой мыши проект приложения .NET MAUI и выберите "Свойства". Затем перейдите на вкладку "Целевые объекты Приложений > Windows" и убедитесь, что установлен флажок "Создать пакет Windows MSIX":

   

Visual Studio изменит файл проекта приложения (*.csproj), чтобы задать для свойства сборки $(WindowsPackageType) значение None:

XML

<PropertyGroup>
    <WindowsPackageType>None</WindowsPackageType>
</PropertyGroup>

Кроме того, в файле свойств или launchSettings.json приложения будет изменено commandName значение:MsixPackage Project

JSON

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

Важно!

Если приложение определяет несколько профилей параметров запуска, необходимо вручную обновить commandName значение для MsixPackage Project каждого профиля.

Настройка Windows для развертывания упакованных приложений

Вам потребуется включить режим разработчика в Windows для развертывания упаковаемого приложения .NET MAUI Для Windows. Поддерживаются Windows 10 и Windows 11.

Windows 11

Режим разработчика включен в приложении "Параметры" в разделе "Конфиденциальность и безопасность>для разработчиков". Чтобы включить режим разработчика в Windows 11, выполните действия.

1. Откройте меню "Пуск".
2. Введите параметры разработчика в поле поиска и выберите его.
3. Включите режим разработчика.
4. Если вы получаете предупреждение о режиме разработчика, прочитайте его и выберите "Да ", если вы понимаете предупреждение.

Windows 10

Режим разработчика включен в приложении "Параметры" в разделе "Обновление и безопасность>для разработчиков". Чтобы включить режим разработчика в Windows 10, выполните действия.

1. Откройте меню "Пуск".
2. Найдите параметры разработчика, выберите его.
3. Включите режим разработчика.
4. Если вы получаете предупреждение о режиме разработчика, прочитайте его и выберите "Да ", если вы понимаете предупреждение.