1、ide 下載安裝
- 如果你還沒安裝 visual studio 2022 預覽版
你可以点击下载
在安装过程中,应选择.NET 跨平台应用程序 UI 开发,如下图所示:

- 已經擁有 visual studio 2022 預覽版
如果您已经拥有 Visual Studio 2022 预览版,则可以更新以添加 .NET MAUI 支持。
2、創建應用
- 打開 visual studio 2022 預覽版。
- 選擇創建新項目按鈕。
- 從項目類型下拉列表中選擇 maui 。
- 選擇.net maui app 模板並選擇下一步按鈕。

- 输入
MyFirstMauiApp作为项目名称并选择Create按钮。

- 還原 nuget 包
等待 nuget 自動還原應用程式的依賴項,等到屏幕左下方的狀態欄中出現已恢復或就緒消息。

3、運行應用
本教程將重點居間首先將 .net maui 應用程式部署到本地 windows 計算機。稍後,您可以選擇設置 android 設備或模擬器。
- 為開發設置 windows
要開發 windows 應用程式,您需要啟用開發人員模式以在 windows 11 或 windows 10 上旁加載應用程式。
啟用開發者模式
- 在 windows 上,轉到“設置”應用程式。
- 在 windows 11 上的隱私和安全和 windows 10 上的更新和安全中搜索開發人員設置。
- 打開 developer mode 下的切換開關。

- 將顯示使用開發人員功能對話框。選擇“是”以確認您要啟用開發者模式。

- 在 windows 上運行
現在已準備好運行 .net maui 應用並將其部署到 windows。在工具欄中,默認將 windows 機器視為調試目標。

选择“调试” > “开始调试F5”(或按)

4、編輯代碼
使用 .net maui 開發時,可以在調試時使用 xaml 熱重載。這意味著您可以在運行時更改 xaml 用戶界面, ui 將自動更新。
在解决方案资源管理器中,双击项目 MainPage.xaml 下的文件 MyFirstMauiApp。
目前,text 第一個 label 設置為 hello, world!如下代碼所示:
<Label
Text="Hello, World!"
SemanticProperties.HeadingLevel="Level1"
FontSize="32"
HorizontalOptions="Center" >
將文本更新為 hello, .net maui!:
<Label
Text="Hello, .NET MAUI!"
SemanticProperties.HeadingLevel="Level1"
FontSize="32"
HorizontalOptions="Center" >
ui 會自動更新:

使用 .net maui 開發時,還可以使用 .net hot reload 重新加載 c# 代碼。我們修改程式中的邏輯,將計數增加 10 而不是 1。
打开 MainPage.xaml.cs(此文件嵌套在 MainPage.xaml 下,或者您可以右键单击并从菜单中选择查看代码)。

該 oncounterclicked 文件上的方法當前具有以下代碼:
private void OnCounterClicked(object sender, EventArgs e)
{
count++;
if (count == 1)
CounterBtn.Text = $"Clicked {count} time";
else
CounterBtn.Text = $"Clicked {count} times";
SemanticScreenReader.Announce(CounterBtn.Text);
}
通過將 更改為 來更新 count++;以增加 10 count += 10;
private void OnCounterClicked(object sender, EventArgs e)
{
count += 10;
if (count == 1)
CounterBtn.Text = $"Clicked {count} time";
else
CounterBtn.Text = $"Clicked {count} times";
SemanticScreenReader.Announce(CounterBtn.Text);
}
要應用代碼更改,請在 visual studio 中選擇熱重載按鈕或選擇 alt+f10.

選擇“點擊我”按鈕,看到它增加了 10。
5、配置安卓設備
可以根據自己的開發環境決定部署到多個平台。剛剛運行並部署到 windows。現在,讓我們設置一個 android 設備或模擬器。
- 安卓 sdk 安裝
从调试下拉菜单中,选择框架下的 net6.0-android。

构建项目需要特定版本的 Android SDK。如果您尚未接受 Android SDK 许可,您将在错误列表窗口中看到以下错误消息。

雙擊消息以開始許可接受過程。對存在的每個許可證單擊接受,然後將開始自動安裝。

- 設置安卓模擬器
如果您沒有要部署的 android 設備,則可以設置 android 模擬器。如果你已經這樣做了,你可以跳過這一步。
如果這是您第一次構建 .net maui 應用程式,您將在調試菜單中看到“android emulator”。單擊它開始創建過程。

這會彈出用戶帳戶控制提示。選擇是按鈕,模擬器創建過程將開始。選擇創建按鈕以使用默認設置創建模擬器。

此时,可能会提示您同意 Android 模拟器的许可协议。选择接受以继续该过程,下载模拟器图像并完成模拟器的创建,创建模拟器后,您会看到一个显示Start的按钮。点击它。

您可能会收到启用 Windows Hypervisor 平台的提示。按照文档启用加速以提高性能(强烈推荐)

android 模擬器將啟動。等待它完全完成啟動,您將看到它顯示在 visual studio 調試菜單中。

您的 android 模擬器現已創建並可以使用。下次運行 visual studio 時,模擬器將直接出現在調試目標窗口中,並在您選擇它時啟動。
- 設置安卓設備 要使用 android 設備進行開發,需要啟用 usb 調試。按照設備上的這些步驟將其連接到 visual studio。如果您沒有 android 設備,則可以跳過此部分。
啟用開發者模式
- 轉到設置屏幕。
- 使用设置屏幕顶部的搜索查找
内部版本号,或在关于手机中找到它。 - 点击
内部版本号7-10 次,直到“你现在是开发者了!” 弹出。 - 单击
创建。

檢查 usb 調試狀態
- 轉到設置屏幕。
- 使用设置屏幕顶部的搜索查找
USB 调试,或在开发人员选项中找到它。 - 如果尚未启用
USB 调试,请启用它。

信任裝置
- 將您的設備插入計算機。
- 系統將提示您允許 usb 調試。
- 選中始終允許從此計算機。
- 單擊允許。

您的設備現已配置好,並將作為部署目標顯示在 visual studio 中。
- 在安卓上運行
確保您的設備或仿真器被選為調試目標。

从菜单中,选择调试>开始调试(或按F5)。如果禁用此选项,请确保选择了模拟器或设备。
應用程式將構建、部署到所選的 android 設備/模擬器並運行。
