使用 .NET CLI 建置 iOS 應用程式

在本教學課程中,您將瞭解如何在 macOS 上使用 .NET 命令列介面 (CLI) 在 iOS 上建立和執行 .NET 多平臺應用程式 UI (.NET MAUI) 應用程式:

  1. 若要建立 .NET MAUI 應用程式,您必須下載並執行最新 .NET 執行階段的 安裝程式 。 您也必須下載並安裝您所使用的 .NET MAUI 版本所需的 Xcode 版本。 如需詳細資訊,請參閱 發行版本。

  2. 在 Mac 上,開啟 終端機 並檢查您是否安裝了最新的 .NET 執行階段:

    dotnet --version
    
  3. 在 終端機中,安裝最新的 .NET MAUI 公用組建:

    sudo dotnet workload install maui --source https://api.nuget.org/v3/index.json
    

    此命令會安裝最新發行的 .NET MAUI 版本,包括必要的平臺 SDK。

  4. 在 終端機中,使用 .NET CLI 建立新的 .NET MAUI 應用程式:

    dotnet new maui -n "MyMauiApp"
    
  1. 在 終端機中,將目錄更改為 MyMauiApp,然後構建並運行該應用程序:

    cd MyMauiApp
    dotnet build -t:Run -f net8.0-ios
    

    該 dotnet build 命令將恢復項目依賴項、構建應用程序並在默認模擬器中啟動它。

  2. 在預設模擬器中,按幾次 「按一下我」 按鈕,並觀察按鈕點擊次數的計數增加。

    .NET MAUI 應用程式在預設 iOS 模擬器中執行。

使用特定版本的 Xcode 建構

如果你的 Mac 上安裝了多個版本的 Xcode,你可以指定在建構 App 時應使用哪個 Xcode 版本。 有許多方法可用來達成此目的,但有兩種建議的方法:

  1. 用於 sudo xcode-select --switch ... 選擇系統目前選取的 Xcode 版本 (這需要管理員認證)。 也可以從 Xcode 內部執行此操作(設置 -> 位置 -> 命令行工具)。

  2. 在當前終端機會話期間使用 DEVELOPER_DIR 環境變數:

    1. 打開 終端機 應用程式。

    2. 鍵入以下命令,替換您的 Xcode 版本,然後按 Enter:

      export DEVELOPER_DIR=/Applications/Xcode_14.1.0.app
      

    如果您想要永久設定此環境變數,您可以將命令新增至 export Shell 設定檔,例如 .zprofile。

在特定模擬器上啟動應用程式

.NET MAUI iOS 應用程式可以透過提供其唯一的裝置識別碼 (UDID) 從 Mac 在特定 iOS 模擬器上啟動:

  1. 在 Mac 上,開啟 Xcode,選取 [Windows > 裝置和模擬器 ] 功能表項目,然後選取 [模擬器 ] 索引標籤。

    Xcode 模擬器選項卡的屏幕截圖。

  2. 右鍵單擊您選擇的模擬器,然後選擇 複製標識符 以將 UDID 複製到剪貼板。

    Xcode 中複製標識符菜單選項的屏幕截圖。

    或者,您可以執行 simctl list 命令來擷取 UDID 值清單:

    /Applications/Xcode.app/Contents/Developer/usr/bin/simctl list
    
  1. 在終端機中,建置應用程式,並使用 _DeviceName指定 -p MSBuild 屬性,在您選擇的模擬器上執行它:

    dotnet build -t:Run -f net8.0-ios -p:_DeviceName=:v2:udid=MY_SPECIFIC_UDID
    

    例如,使用以下命令構建應用程序並在 iPhone 13 Pro 模擬器上運行它:

    dotnet build -t:Run -f net8.0-ios -p:_DeviceName=:v2:udid=E25BBE37-69BA-4720-B6FD-D54C97791E79
    
  2. 在您選擇的模擬器中,按幾次 單擊我 按鈕,並觀察按鈕點擊次數的計數增加。

    在 iPhone 13 Pro 模擬器中執行的 .NET MAUI 應用程式。

在裝置上啟動應用程式

您必須先佈建裝置,才能將 iOS 應用程式部署到裝置。 如需詳細資訊,請參閱 iOS 的裝置佈建。 佈建裝置之後,即可提供其唯一的裝置識別碼 (UDID) ,從 Mac 在裝置上啟動 .NET MAUI iOS 應用程式:

  1. 使用 USB 連接線將裝置連接到本機 Mac。

  2. 開啟 Xcode,然後導覽至 Window > 裝置和模擬器。

  3. 在 Xcode 中,選取 [裝置] 索引標籤,然後從已連線裝置清單中選取裝置。

  4. 在 Xcode 中,將 Identifier 值複製到剪貼簿:

    已醒目提示 iOS 識別符字串位置的 Xcode 裝置和模擬器視窗。

    或者,右鍵單擊您的設備並選擇 複製標識符 以將 UDID 複製到剪貼板。

  1. 在終端機中,建置應用程式,並使用 _DeviceName指定 -p MSBuild 屬性,在您選擇的裝置上執行它:

    dotnet build -t:Run -f net8.0-ios -p:RuntimeIdentifier=ios-arm64 -p:_DeviceName=MY_SPECIFIC_UDID
    

    將 “MY_SPECIFIC_UDID” 替換為您複製到剪貼簿的裝置識別碼。