使用VSCode开发.NET8 MAUI Windows应用程序指南

环境准备

1. 安装.NET 8 SDK

  • 访问 .NET官网

  • 下载并安装.NET 8 SDK(需包含MAUI组件)

  • 验证安装:

    dotnet --list-sdks

2. 安装VSCode

3. 安装MAUI工作负载 

# 管理员权限运行
dotnet workload install maui 
  • 验证安装:

    dotnet workload list

    输出应包含:

    
    已安装的工作负载 ID       清单版本       安装源文件
    --------------------------------------------------
    maui              8.0.100/8.0.100      SDK 8.0.400
    maui-windows      8.0.100/8.0.100      SDK 8.0.400

4. Windows平台依赖

  • 启用开发者模式:

    powershell

    Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock" -Name "AllowDevelopmentWithoutDevLicense" -Value 1
  • 安装Windows App SDK 1.3+

  • 安装最新Windows SDK

winget install Microsoft.WindowsSDK.10.0.22000

创建MAUI项目

1. 新建项目

powershell:

dotnet new maui -n HellowWorld
cd MauiWinApp

创建项目时候会创建.csproj, .xaml, .cs, .sln等文件。

2. 配置Windows平台
修改.csproj文件:

xml

<PropertyGroup>
  <TargetFrameworks>net8.0-windows</TargetFrameworks>
  <SupportedOSPlatformVersion>10.0.17763.0</SupportedOSPlatformVersion>
</PropertyGroup>
不编译Android app的话,可以把net8.0-android;net8.0-ios;net8.0-maccatalyst去掉或者移到下面的注释块里。

3. 恢复依赖包

powershell:

dotnet restore

配置VSCode调试环境

1. 创建调试配置

在.vscode/launch.json 中添加:

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Launch Windows",
      "type": "coreclr",
      "request": "launch",
      "program": "${workspaceFolder}/bin/Debug/net8.0-windows/win10-x64/MauiWinApp.exe",
      "args": [],
      "cwd": "${workspaceFolder}",
      "preLaunchTask": "build"
    }
  ]
}

2. 配置构建任务
.vscode/tasks.json中添加:

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "build",
      "command": "dotnet",
      "type": "process",
      "args": [
        "build",
        "--configuration",
        "Debug",
        "-t:Run",
        "-f",
        "net8.0-windows"
      ],
      "problemMatcher": "$msCompile"
    }
  ]
}

开发调试步骤

  1. 创建MAUI界面

    编辑MainPage.xaml:
    
    
    <ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
                 Title="MAUI Windows App">
      <VerticalStackLayout>
        <Label Text="Hello MAUI Windows!"
               FontSize="32"
               HorizontalOptions="Center" />
        <Button Text="Click Me"
                Clicked="OnButtonClicked"
                HorizontalOptions="Center"/>
      </VerticalStackLayout>
    </ContentPage>

     

  2. 添加事件处理
    编辑MainPage.xaml.cs

    private void OnButtonClicked(object sender, EventArgs e)
    {
        DisplayAlert("Message", "Hello from MAUI!", "OK");
    }

     

  3. 运行调试

    dotnet build -t:Run -f net8.0-windows
    • 按F5启动调试

    • 或终端执行:

打包部署

  1. 发布应用

    dotnet publish -c Release -f net8.0-windows --sc -p:WindowsPackageType=Msix

     

  2. 生成安装包

    安装包路径:
    bin/Release/net8.0-windows/win10-x64/publish/

常见问题解决

  1. MAUI模板找不到

    dotnet new install Microsoft.Maui.Templates

     

  2. Windows目标不可用

    dotnet workload install maui-windows

     

  3. XAML预览问题
    安装XAML Language Support扩展

  4. 如果遇到maui workload not found错误:

    # 更新工作负载
    dotnet workload update
    
    # 修复安装
    dotnet workload repair

     

开发建议

  1. 使用Hot Reload功能:

    dotnet watch build -t:Run -f net8.0-windows
  2. 推荐安装扩展:

    • C# XML Documentation Comments

    • Output Colorizer

  3. 调试技巧:

    • launch.json中添加:

    "logging": {
      "moduleLoad": true
    }
  4. 推荐在launch.json中添加环境变量:

    "environmentVariables": {
      "DOTNET_MAUI_RUNTIME": "windows"
    }
  5. 启用详细构建日志:

    dotnet build -v diag

本文包含从环境搭建到打包部署的完整流程,使用VSCode开发MAUI Windows应用需要注意Windows目标的配置和调试环境的设置。建议定期更新.NET MAUI工作负载以获取最新功能。

 

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值