建置您的第一個應用程式

在本教學課程中，您將在 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. 在 [ 用戶帳戶控制 ] 對話框中，按 [ 是 ] 按鈕：

   

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

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

    

11. 在 [Android SDK 平臺遺失 ] 對話框中，按 [ 安裝 ] 按鈕：

    

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

    

    等候 Visual Studio 安裝 Android SDK 元件。

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

    

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

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

    

15. 在 Visual Studio 工具列中 ，按圖元 7 - API 35 （Android 15.0 - API 35） 按鈕：

    

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

    

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

    

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

18. 在 Visual Studio 工具列中 ，按圖元 7 - API 35 （Android 15.0 - API 35） 按鈕來建置和執行應用程式：

    

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

    警告

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

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

    

疑難排解

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

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

   

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

   

疑難排解

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

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 Code 來啟動和偵錯。

在本教學課程中，您將在 Visual Studio Code 中建立第一個 .NET MAUI 應用程式，並在 Android 模擬器上執行：

在本教學課程中，您將在 Mac 上的 Visual Studio Code 中建立第一個 .NET MAUI 應用程式，並在 iOS 模擬器上執行：

在本教學課程中，您將在 Mac 上的 Visual Studio Code 中建立第一個 .NET MAUI 應用程式，並在 macOS 上執行：

在本教學課程中，您將在 Windows 上的 Visual Studio Code 中建立第一個 .NET MAUI 應用程式，並在 Windows 上執行：

7. 在 Visual Studio Code 中，按下 Windows 上的 CTRL+SHIFT+ P，或在 macOS 上按 CTRL+SHIFT+P，或選取 [.NET MAUI]，然後選取 [.NET MAUI：設定 Android]，然後 重新整理 Android 環境。 必須解決任何偵測到的錯誤。

8. 在 Visual Studio Code 底部的狀態列中，按大括弧符號 { }，並確定 偵錯目標 設定為特定的 Android 模擬器：

   

   您也可以在 Windows 上按 CTRL+SHIFT+P，或在 macOS 上按 CMD+SHIFT+P，然後選取 [.NET MAUI：從命令選擇區中挑選 Android 裝置 來設定偵錯目標。

9. 在 Android 上，按 F5，或按下 Visual Studio Code 右上角的 [執行] 按鈕，在 Android 上建置並執行應用程式：

   

   如果系統要求您在命令選擇區中選取調試程式，請選取 C#，然後選取項目的啟動組態。

10. 在您選擇的 Android 模擬器中執行的應用程式中，按幾次 點擊我 按鈕，並觀察按鈕按下次數的增長：

    

對 Android 裝置上的應用程式進行偵錯

若要對 Android 裝置上的應用程式進行偵錯：

1. 確定您的裝置已設定為部署。 如需詳細資訊，請參閱 設定裝置以進行部署。
2. 將您的裝置插入您的電腦，並在 Visual Studio Code 中將其選取為偵錯目標。
3. 執行應用程式。

7. 在 Visual Studio Code 中，按下 CMD+SHIFT+P 鍵，然後選取 .NET MAUI：設定 Apple，接著選擇 重新整理 Apple 環境，以確認您的 Apple 環境已正確設定。 必須解決任何偵測到的錯誤。

8. 在 Visual Studio Code 底部的狀態欄中，按下大括號符號 { }，並確定 偵錯目標 設定為特定的 iOS 模擬器：

   

   您也可以按 CMD+SHIFT+P 並選取 [.NET MAUI：從命令選擇區挑選 iOS 裝置，以設定偵錯目標。

9. 在 iOS 上，按 F5，或按下 Visual Studio Code 右上角的 [執行] 按鈕，在 iOS 上建置並執行應用程式：

   

   如果系統要求您在命令選擇區中選取調試程式，請選取 C#，然後選取項目的啟動組態。

10. 在所選 iOS 模擬器的執行中應用程式中，按 按一下我 按鈕數次，並觀察按鈕點擊次數的計數遞增：

    

對 iOS 裝置上的應用程式進行偵錯

若要對 iOS 裝置上的應用程式進行偵錯：

1. 請確定您已在 Xcode > [設定] > [帳戶]中將 Apple ID 新增至 Xcode。
2. 如果您屬於 Apple Developer Program，請確定您的裝置已向小組註冊。
3. 在您的裝置上啟用開發人員模式。 第一次執行應用程式時，您可能會在裝置上收到快顯 - 請確定您選取 [ 允許]。 如需開發人員模式的詳細資訊，請參閱 在裝置上啟用開發人員模式 developer.apple.com。
4. 將您的裝置插入您的電腦，並在 Visual Studio Code 中將其選取為偵錯目標。
5. 執行應用程式。

7. 在 Visual Studio Code 中，按下 CMD+SHIFT+P 鍵，然後選取 .NET MAUI：設定 Apple，接著選擇 重新整理 Apple 環境，以確認您的 Apple 環境已正確設定。 必須解決任何偵測到的錯誤。

8. 在 Visual Studio Code 底部的狀態列中，按下大括弧符號 { }，並確保將 偵錯目標 設定為你的 Mac：

   

   您也可以按 CMD+SHIFT+P 並選取 [.NET MAUI：從命令選擇區挑選 macOS 裝置 來設定偵錯目標。

9. 按下 F5 或在 Visual Studio Code 右上角按下 [執行] 按鈕，在 macOS 上建置並執行應用程式：

   

   如果系統要求您在命令選擇區中選取調試程式，請選取 C#，然後選取項目的啟動組態。

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

    

7. 在 Visual Studio Code 底部的狀態列中，按大括弧符號 { }，並確定 偵錯目標 設定為 Windows：

   

   您也可以按 CTRL+SHIFT+P 來設定偵錯目標，然後從命令選擇區中選取 .NET MAUI：挑選 Windows 裝置。

8. 在 Windows 上，按 F5，或按下 Visual Studio Code 右上角的 [執行] 按鈕，在 Windows 上建置並執行應用程式：

   

   如果系統要求您在命令選擇區中選取調試程式，請選取 C#，然後選取項目的啟動組態。

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