建置您的第一個應用程式

在本教學課程中,您將瞭解如何在 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 上執行:

  1. 啟動 Visual Studio 2022。 在開始視窗中,按兩下 [建立新專案 ] 以建立新的專案:

    新增解決方案。

  2. 在 [建立新專案] 視窗中,選取 [所有項目類型] 下拉式清單中的 [MAUI],選取 .NET MAUI 應用程式範本,然後按兩下 [下一步] 按鈕:

    選擇範本。

  3. 在 [ 設定新專案] 視窗中,為您的專案 命名,選擇適合它的位置,然後按兩下 [ 下一步 ] 按鈕:

    設定專案。

  4. 在 [ 其他資訊] 視窗中,選擇您想要設為目標的 .NET 版本,然後按兩下 [ 建立] 按鈕:

    其他資訊。

  5. 等待專案的建立,並還原其相依性。

    已還原相依性。

  1. 在 Visual Studio 工具列中,使用 偵錯目標 下拉式清單選擇 Android Emulators,然後選取 Android 模擬器 項目:

    選取 .NET MAUI 的Android模擬器偵錯目標。

  2. 在 Visual Studio 工具列中 ,按 Android 模擬器 按鈕:

    Android 模擬器按鈕。

    Visual Studio 將會開始安裝預設 Android SDK 和 Android 模擬器的程式。

  3. 在 [ Android SDK - 許可協定] 視窗中,按 [ 接受 ] 按鈕:

    第一個 Android SDK 許可協定視窗。

  4. 在 [ 用戶帳戶控制 ] 對話框中,按 [ 是 ] 按鈕:

    Android SDK 授權用戶帳戶控制對話框。

    等候 Visual Studio 下載預設的 Android SDK 和 Android 模擬器。

  5. 在 [ 用戶帳戶控制 ] 對話框中,按 [ 是 ] 按鈕:

    Android 裝置管理員 用戶帳戶控制對話方塊。

  6. 在 [Android SDK 平臺遺失 ] 對話框中,按 [ 安裝 ] 按鈕:

    Android SDK 平臺遺漏對話框。

  7. 在 [ Android SDK - 許可協定] 視窗中,按 [ 接受 ] 按鈕:

    第二個 Android SDK 許可協議視窗。

    等候 Visual Studio 安裝 Android SDK 元件。

  8. 在 [ 新增裝置 ] 視窗中,按 [ 建立] 按鈕:

    新 Android 裝置 視窗。

    等候 Visual Studio 下載、解壓縮及建立 Android 模擬器。

  9. 關閉 [Android 裝置管理員] 視窗:

    Android 裝置管理員 視窗。

  10. 在 Visual Studio 工具列中,按 像素 7 - API 35(Android 15.0 - API 35) 按鈕:

    Pixel 7 API 35 模擬器按鈕。

  11. 在 [ Android SDK - 許可協定] 視窗中,按 [ 接受 ] 按鈕:

    第三個 Android SDK 許可協議視窗。

  12. 在 [ 用戶帳戶控制 ] 對話框中,按 [ 是 ] 按鈕:

    Android SDK 授權用戶帳戶控制對話框。

    等候 Visual Studio 安裝以下載 Android SDK。

  13. 在 Visual Studio 工具列中,按一下 Pixel 7 - API 35 (Android 15.0 - API 35) 按鈕來建置和執行應用程式:

    Pixel 5 API 35 模擬器按鍵。

    Visual Studio 會啟動 Android 模擬器、建置應用程式,並將應用程式部署至模擬器。

    警告

    必須啟用硬體加速,才能將Android模擬器效能最大化。 無法執行這項操作會導致模擬器執行速度非常慢。 如需詳細資訊,請參閱如何使用Android模擬器啟用硬體加速(Hyper-V和AEHD)。

  14. 在 Android 模擬器中運行的應用程式內,多次按下 Click me 按鈕,並觀察按鈕點擊次數的計數遞增。

    在 Android 模擬器中執行的應用程式。

疑難排解

如果您的應用程式無法編譯,請參閱已知問題的疑難排解,其中可能有您的問題適用的解決方案。 如果問題與 Android 模擬器有關,請參閱 Android 模擬器疑難解答。

  1. 在 Visual Studio 工具列中 ,按 [Windows 計算機 ] 按鈕來建置並執行應用程式:

    在 Visual Studio 按鈕中執行 .NET MAUI 應用程式。

  2. 在執行中的應用程式按下 [按我] 按鈕數次,觀察按鈕點擊次數的計數遞增:

    在 Windows 上執行的 .NET MAUI 應用程式。

疑難排解

如果您的應用程式無法編譯,請參閱已知問題的疑難排解,其中可能有您的問題適用的解決方案。

  1. 在 Visual Studio 中,將 IDE 與 Mac 組建主機配對。 如需詳細資訊,請參閱 與 Mac 配對以進行 iOS 開發。

  2. 在 Visual Studio 工具列中,使用 [ 偵錯目標 ] 下拉式清單選取 [iOS 模擬器],然後選取 特定的 iOS 模擬 器:

    Visual Studio iOS 模擬器偵錯目標。

  3. 在 Visual Studio 工具列中,按所選 iOS 模擬器的 [開始] 按鈕,以建置並執行您的應用程式:

    Visual Studio iOS 模擬器偵錯目標選擇。

    Visual Studio 會建置應用程式、啟動適用於 Windows 的遠端 iOS 模擬器,並將應用程式部署至遠端模擬器。 如需 Windows 遠端 iOS 模擬器的詳細資訊,請參閱 適用於 Windows 的遠端 iOS 模擬器。

  4. 在執行中的應用程式中,按下 [按下我 ] 按鈕數次,並觀察按鈕點擊次數的計數遞增。

    在 Mac 上的 iOS 模擬器中執行的 .NET MAUI 應用程式。

疑難排解

如果您的應用程式無法編譯,請參閱已知問題的疑難排解,其中可能有您的問題適用的解決方案。

以 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 建置行動和桌面應用程式。