在macOS中搭建.NET MAUI开发环境
@
准备
- 一台 macOS Monterey 以上的电脑
- 安装 XCode13.3 以上
- 安装 Visual Studio Code
安装扩展
打开Visual Studio Code,按下
Command + Shift + P
,输入
install
,选择
Extensions: Install Extensions
,搜索
MAUI
,安装
.NET MAUI
扩展。
安装 .NET
安装 .NET 8
https://dotnet.microsoft.com/zh-cn/download/dotnet
安装工作负载
打开终端,输入以下命令:
dotnet workload install maui
安装 Xcode 命令行工具
打开终端,输入以下命令:
sudo xcode-select --install
至此,应该可以调试iOS应用了。
调试安卓应用
若要在 Visual Studio Code 中调试 Android 应用,请执行以下操作:
安装 JDK
下载最新版本的 JDK:
https://learn.microsoft.com/zh-cn/java/openjdk/download
安装 JDK:
安装 Android SDK
创建新的 .NET MAUI 项目,在合适的位置打开终端,输入以下命令:
dotnet new maui
在项目文件夹中,打开终端,输入以下命令:
dotnet build -t:InstallAndroidDependencies -f:net8.0-android -p:AndroidSdkDirectory="<ANDROID SDK DIRECTORY>" -p:AcceptAndroidSDKLicenses=True
在 macOS 上,建议的 Android SDK 目录值为 $HOME/Library/Android/sdk
Android SDK 将自动被创建
安装 Android 模拟器
此时已可以真机调试 Android 应用,如果真机调试不方便,我们需要安装 Android 模拟器。
安装模拟器
前往 Android SDK Manager 所在目录,默认为 $HOME/Library/Android/sdk/cmdline-tools/11.0/bin,打开终端,输入以下命令:
./sdkmanager --install emulator
安装镜像
./sdkmanager "emulator" "system-images;android-34;google_apis;x86_64"
创建虚拟机
./avdmanager create avd -n Pixel5-API34 -k "system-images;android-34;google_apis;x86_64"
另外可以通过切换调试目标中的菜单,查看可用的镜像,选择一个镜像,或创建一个新的镜像。
CMD+SHIFT+P 或 查看->命令面板
选择“创建Android Emulator”
根据提示完成创建
同意许可条款
打开终端,输入以下命令:
./sdkmanager --licenses --verbose
按照提示输入
y
同意许可条款。
创建 MAUI 项目
若要创建新的 .NET MAUI 应用,请执行以下操作:
- 在资源管理器中,单击“创建 .NET 项目”或按 CMD+SHIFT+P> 选择“.NET: New Project...”。
- 选择“.NET MAUI 应用”或“.NET MAUI Blazor 应用”。
- 选择空文件夹。 如果文件资源管理器弹出窗口再次打开,则文件夹不为空。
- 为项目命名。
- 确保项目在解决方案资源管理器中成功加载,然后打开 C# 或 XAML 文件。
- 也可以通过单击“文件”>“打开...”在 Visual Studio Code 中打开现有的 .NET MAUI 项目。
调试 MAUI 应用
在 Visual Studio Code 中,按 F5 键或单击“运行”>“启动调试”以调试 .NET MAUI 应用。
调试器选择器将显示可用的调试器。 选择“ .NET MAUI”以启动调试会话。
切换调试目标
在 Visual Studio Code 的资源管理器中,打开项目sln文件,
此时在任务栏出现大括号
{}
,点击选择调试目标。
参考资料
扩展主页:
https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.dotnet-maui