在本教學課程中,您將瞭解如何在 Windows 上的 Visual Studio 2022 或 Windows、macOS 或 Linux 上的 Visual Studio Code 中建立和執行第一個 .NET 多平台應用程式 UI (.NET MAUI) 應用程式。 這有助於確保您的開發環境已正確設定。
必要條件
- 已安裝 .NET 多平臺應用程式 UI 工作負載的 Visual Studio 2022 17.12 或更高版本。 請參閱安裝了解詳細資訊。
建立應用程式
在本教學課程中,您將在 Visual Studio 2022 中建立第一個 .NET MAUI 應用程式,並在 Android 模擬器上執行:
在 Windows 上開發適用於 iOS 的 .NET MAUI 應用程式需要 Mac 組建主機。 如果您不需要以 iOS 為目標,而且沒有 Mac,請考慮改為開始使用 Android 或 Windows。
在本教學課程中,您將在 Visual Studio 中建立第一個 .NET MAUI 應用程式,並在 iOS 模擬器上執行:
在本教學課程中,您將在 Visual Studio 2022 中建立第一個 .NET MAUI 應用程式,並在 Windows 上執行:
啟動 Visual Studio 2022。 在開始視窗中,按兩下 [建立新專案 ] 以建立新的專案:
在 [建立新專案] 視窗中,選取 [所有項目類型] 下拉式清單中的 [MAUI],選取 .NET MAUI 應用程式範本,然後按兩下 [下一步] 按鈕:
在 [ 設定新專案] 視窗中,為您的專案 命名,選擇適合它的位置,然後按兩下 [ 下一步 ] 按鈕:
在 [ 其他資訊] 視窗中,選擇您想要設為目標的 .NET 版本,然後按兩下 [ 建立] 按鈕:
等待專案的建立,並還原其相依性。
在 Visual Studio 工具列中,使用 偵錯目標 下拉式清單選擇 Android Emulators,然後選取 Android 模擬器 項目:
在 Visual Studio 工具列中 ,按 Android 模擬器 按鈕:
Visual Studio 將會開始安裝預設 Android SDK 和 Android 模擬器的程式。
在 [ Android SDK - 許可協定] 視窗中,按 [ 接受 ] 按鈕:
在 [ 用戶帳戶控制 ] 對話框中,按 [ 是 ] 按鈕:
等候 Visual Studio 下載預設的 Android SDK 和 Android 模擬器。
在 [ 用戶帳戶控制 ] 對話框中,按 [ 是 ] 按鈕:
在 [Android SDK 平臺遺失 ] 對話框中,按 [ 安裝 ] 按鈕:
在 [ Android SDK - 許可協定] 視窗中,按 [ 接受 ] 按鈕:
等候 Visual Studio 安裝 Android SDK 元件。
在 [ 新增裝置 ] 視窗中,按 [ 建立] 按鈕:
等候 Visual Studio 下載、解壓縮及建立 Android 模擬器。
關閉 [Android 裝置管理員] 視窗:
在 Visual Studio 工具列中,按 像素 7 - API 35(Android 15.0 - API 35) 按鈕:
在 [ Android SDK - 許可協定] 視窗中,按 [ 接受 ] 按鈕:
在 [ 用戶帳戶控制 ] 對話框中,按 [ 是 ] 按鈕:
等候 Visual Studio 安裝以下載 Android SDK。
在 Visual Studio 工具列中,按一下 Pixel 7 - API 35 (Android 15.0 - API 35) 按鈕來建置和執行應用程式:
Visual Studio 會啟動 Android 模擬器、建置應用程式,並將應用程式部署至模擬器。
警告
必須啟用硬體加速,才能將Android模擬器效能最大化。 無法執行這項操作會導致模擬器執行速度非常慢。 如需詳細資訊,請參閱如何使用Android模擬器啟用硬體加速(Hyper-V和AEHD)。
在 Android 模擬器中運行的應用程式內,多次按下 Click me 按鈕,並觀察按鈕點擊次數的計數遞增。
疑難排解
如果您的應用程式無法編譯,請參閱已知問題的疑難排解,其中可能有您的問題適用的解決方案。 如果問題與 Android 模擬器有關,請參閱 Android 模擬器疑難解答。
在 Visual Studio 工具列中 ,按 [Windows 計算機 ] 按鈕來建置並執行應用程式:
在執行中的應用程式按下 [按我] 按鈕數次,觀察按鈕點擊次數的計數遞增:
疑難排解
如果您的應用程式無法編譯,請參閱已知問題的疑難排解,其中可能有您的問題適用的解決方案。
在 Visual Studio 中,將 IDE 與 Mac 組建主機配對。 如需詳細資訊,請參閱 與 Mac 配對以進行 iOS 開發。
在 Visual Studio 工具列中,使用 [ 偵錯目標 ] 下拉式清單選取 [iOS 模擬器],然後選取 特定的 iOS 模擬 器:
在 Visual Studio 工具列中,按所選 iOS 模擬器的 [開始] 按鈕,以建置並執行您的應用程式:
Visual Studio 會建置應用程式、啟動適用於 Windows 的遠端 iOS 模擬器,並將應用程式部署至遠端模擬器。 如需 Windows 遠端 iOS 模擬器的詳細資訊,請參閱 適用於 Windows 的遠端 iOS 模擬器。
在執行中的應用程式中,按下 [按下我 ] 按鈕數次,並觀察按鈕點擊次數的計數遞增。
疑難排解
如果您的應用程式無法編譯,請參閱已知問題的疑難排解,其中可能有您的問題適用的解決方案。
以 Mac Catalyst 為目標的 .NET MAUI 應用程式只能使用 Visual Studio Code 來啟動和偵錯。
從命令列建立應用程式
在 .NET 11 及更新版本中,你也可以從命令列建立應用程式。 首先,安裝 .NET 11 SDK 和 .NET MAUI 工作負載。
建立一個 C# 使用者介面
要用 C# 而非 XAML 建立應用程式介面,請執行:
dotnet new maui -n MyApp --ui csharp
該範本會使用內建的 .NET MAUI API 產生 App.cs、AppShell.cs 和 MainPage.cs。 你不需要額外的 C# UI 函式庫。 Shell 和頁面 UI 是用 C# 定義的,但 App.xaml 和 XAML 資源字典仍保留作為應用程式資源。 當你省略 --ui csharp時,XAML 仍然是預設。
這個 --sample-content 選項只支援 XAML。 如果你將它與 --ui csharp 結合,模板會建立一個沒有範例內容的 C# 介面,並顯示警告。
新增 Avalonia 桌面專案
另外,可以建立一個多專案解決方案,並搭配可選的 Avalonia 桌面專案:
dotnet new maui-multiproject -n MyApp --avalonia
此指令會建立一個適用於 Windows、macOS 和 Linux 的共用 .NET MAUI 專案,以及一個 MyApp.Desktop 專案。 Avalonia 預設不包含,且此選項不會新增 WebAssembly 專案。 若要包含原生應用程式專案,請結合 --avalonia--android、 --ios、 --macos或 --windows。
下一步
在本教學課程中,您已瞭解如何建立並執行您的第一個 .NET 多平台應用程式 UI (.NET MAUI) 應用程式。
若要瞭解使用 .NET MAUI 建置應用程式的基本概念,請參閱 建立 .NET MAUI 應用程式。 或者,如需完整的 .NET MAUI 訓練課程,請參閱 使用 .NET MAUI 建置行動和桌面應用程式。