建置您的第一個 應用程式

在本教學課程中，您將瞭解如何在 Windows 上的 Visual Studio 2022 或 Windows、macOS 或 Linux 上的 Visual Studio Code 中建立和執行第一個 .NET 多平台應用程式 UI （.NET MAUI） 應用程式。 這有助於確保您的開發環境已正確設定。

Visual Studio

必要條件

• Visual Studio 2022 17.8 或更高版本，其中已安裝 .NET 多平台應用程式 UI 工作負載。 請參閱安裝了解詳細資訊。

建立應用程式

在本教學課程中，您將在 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. 等候專案建立，以及還原其相依性：

   

6. 在 Visual Studio 工具列中，使用 [偵錯目標] 下拉式清單選取 [Android 模擬器]，然後選取 [Android 模擬器] 專案：

   

7. 在 Visual Studio 工具列中 ，按 Android 模擬器 按鈕：

   

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

8. 在 [ Android SDK - 許可協定] 視窗中，按 [ 接受 ] 按鈕：

   

9. 在 [ Android SDK - 許可協定] 視窗中，按 [ 接受 ] 按鈕：

   

10. 在 [ 用戶帳戶控制 ] 對話框中，按 [ 是 ] 按鈕：

    

11. 在 [授權接受] 視窗中，按 [接受] 按鈕：

    

    等候 Visual Studio 下載 Android SDK 和 Android Emulator。

12. 在 Visual Studio 工具列中 ，按 Android 模擬器 按鈕：

    

    Visual Studio 將會開始建立預設的 Android 模擬器。

13. 在 [ 用戶帳戶控制 ] 對話框中，按 [ 是 ] 按鈕：

    

14. 在 [ 新增裝置 ] 視窗中，按 [ 建立] 按鈕：

    

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

15. 關閉 [Android 裝置管理員] 視窗：

    

16. 在 Visual Studio 工具列中，按 圖元 5 - API 34 （Android 14.0 - API 33） 按鈕來建置和執行應用程式：

    

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

    警告

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

17. 在Android模擬器中執行的應用程式中，按下 [按下'按下'按鈕數次，並觀察按鈕點擊次數的計數遞增。

    

疑難排解

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

6. 在 Visual Studio 工具列中，使用 [偵錯目標] 下拉式清單選取 [Framework]，然後選取 net8.0-windows 專案：

   

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

   

   如果您尚未啟用開發人員模式，Visual Studio 會提示您啟用它。 在 [ 啟用 Windows 開發人員模式] 對話框中，按兩下 開發人員 的設定以開啟 [設定] 應用程式：

   

   在 [設定] 應用程式中，開啟 [開發人員模式 ]，並接受免責聲明：

   

   關閉 [設定] 應用程式，然後關閉 [ 啟用 Windows 開發人員模式] 對話方塊。

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

   

疑難排解

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

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

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

   

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

   

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

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

   

疑難排解

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

以 Mac Catalyst 為目標的 .NET MAUI 應用程式只能使用 Visual Studio 2022 for Mac 來啟動和偵錯。

Visual Studio Code

必要條件

• 已安裝 .NET MAUI 延伸模組的Visual Studio Code。 請參閱安裝了解詳細資訊。

建立應用程式

若要建立新的 .NET MAUI 應用程式：

1. 啟動 Visual Studio Code。 在 [總管] 中，按兩下 [總管] 中的 [建立 .NET 專案 ]。 或者，選取 CTRL/CMD+SHIFT+P .NET：新增專案...。
2. 選取 [.NET MAUI 應用程式 ] 或 [.NET MAUI Blazor 應用程式]。
3. 選取空白資料夾。 如果檔案總管再次開啟，您的資料夾就不是空的。
4. 命名專案。
5. 請確定專案已成功載入 方案總管，然後開啟 C# 或 XAML 檔案。

注意

您也可以透過 > [檔案開啟...] 功能表，在 Visual Studio Code 中開啟現有的 .NET MAUI 專案。

您現在應該會在 Visual Studio Code 的 C# 開發工具包 方案總管 中看到您的應用程式。 由於 .NET MAUI 擴充功能相依於 C# 開發工具包，因此您可以搭配 .NET MAUI 擴充功能使用 其所有功能 。

選擇您的目標裝置

若要選擇您的目標裝置，請按下 Visual Studio Code 右下角的大括號符號 { } 。 您可以使用此符號來變更啟動專案、將偵錯目標變更為開發電腦上的任何有效專案，並將任一設定釘選到 Visual Studio Code 狀態列：

您也可以使用 CTRL/CMD+SHIFT+P 在命令選擇區中設定啟動專案和偵錯目標，並搜尋 “.NET MAUI”。

您可以部署至本機開發計算機 （Windows 桌面或 macOS 搭配 Xcode），而不需要任何額外的步驟。

目標 Android

如果您想要使用 Android 模擬器，請遵循下列步驟來安裝和建立模擬器：

1. 在終端機中瀏覽至 <YOUR_ANDROID_SDK_DIRECTORY>/cmdline-tools/11.0/bin/。

2. 使用 sdkmanager 來安裝模擬器。

   在 Windows 上，在終端機中執行下列命令：

   sdkmanager --install emulator
   sdkmanager --install "system-images;android-33;google_apis;x86_64"
   

   在macOS上，在終端機中執行下列命令：

   ./sdkmanager --install emulator
   ./sdkmanager --install "system-images;android-33;google_apis;x86_64"
   

   注意

   命令行自變數的 sdkmanager 引號很重要。

3. 然後，您可以使用 Android 的 avdmanager 在命令行上建立新的模擬器。

   在 Windows 上，在終端機中執行下列命令：

   avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64"
   

   在macOS上，在終端機中執行下列命令：

   ./avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64"
   

   注意

   命令行自變數的 avdmanager 引號很重要。

您也可以在實體 Android 裝置上進行偵錯。

目標 iOS

iOS 模擬器內建於 Xcode 中。 若要下載模擬器，請確定在 Xcode 第一次啟動時選取要安裝的選項，或流覽至 [Xcode > 設定 > 平臺 ]，然後選擇要安裝的模擬器運行時間。

若要使用 iOS 裝置進行偵錯，請先遵循下列步驟，再嘗試進行偵錯：

1. 在 Xcode > 設定>帳戶中指定您的 Apple ID。
2. 如果您屬於 Apple Developer Program，請向小組註冊裝置。
3. 在裝置上啟用開發人員模式，如在裝置上啟用開發人員模式中所述。 第一次執行應用程式時，您可能會在裝置上收到快顯 - 請確定您選取 [ 允許]。

偵錯應用程式

若要偵錯您的應用程式，請流覽至 Visual Studio Code 的 [執行和偵錯 ] 功能表，然後選取 [ 執行和偵錯] 按鈕。 或者，您可以使用 F5 來啟動偵錯工作階段。 如果 Visual Studio Code 提示您選擇除錯程式，請確定您選取 C# 。

注意

在延伸模組的預覽版本中，調試程式已列為 .NET MAUI。 在穩定版本中，此組態已取代為 C# 。

調試程式會自動選擇您在大括弧 { } 功能表中設定的偵錯目標和啟動專案。 如果您尚未選取任何項目，系統會提示您選擇偵錯目標。

您的應用程式開始偵錯之後，您可以使用內建的 Visual Studio Code 偵錯工具來設定斷點、逐步執行程式代碼等等。

深入了解

如果您遇到擴充功能的任何問題，您可以遵循 疑難解答步驟、查看 已知問題或 提供意見反應。

下一步

在本教學課程中，您已瞭解如何建立並執行您的第一個 .NET 多平台應用程式 UI （.NET MAUI） 應用程式。

若要瞭解使用 .NET MAUI 建置應用程式的基本概念，請參閱 建立 .NET MAUI 應用程式。 或者，如需完整的 .NET MAUI 訓練課程，請參閱 使用 .NET MAUI 建置行動和桌面應用程式。