在本教學課程中,您將瞭解如何在 macOS 上使用 .NET 命令列介面 (CLI) 在 iOS 上建立和執行 .NET 多平臺應用程式 UI (.NET MAUI) 應用程式:
若要建立 .NET MAUI 應用程式,您必須下載並執行最新 .NET 執行階段的 安裝程式 。 您也必須下載並安裝您所使用的 .NET MAUI 版本所需的 Xcode 版本。 如需詳細資訊,請參閱 發行版本。
在 Mac 上,開啟 終端機 並檢查您是否安裝了最新的 .NET 執行階段:
dotnet --version在 終端機中,安裝最新的 .NET MAUI 公用組建:
sudo dotnet workload install maui --source https://api.nuget.org/v3/index.json此命令會安裝最新發行的 .NET MAUI 版本,包括必要的平臺 SDK。
在 終端機中,使用 .NET CLI 建立新的 .NET MAUI 應用程式:
dotnet new maui -n "MyMauiApp"
在 終端機中,將目錄更改為 MyMauiApp,然後構建並運行該應用程序:
cd MyMauiApp dotnet build -t:Run -f net8.0-ios該
dotnet build命令將恢復項目依賴項、構建應用程序並在默認模擬器中啟動它。在預設模擬器中,按幾次 「按一下我」 按鈕,並觀察按鈕點擊次數的計數增加。
使用特定版本的 Xcode 建構
如果你的 Mac 上安裝了多個版本的 Xcode,你可以指定在建構 App 時應使用哪個 Xcode 版本。 有許多方法可用來達成此目的,但有兩種建議的方法:
用於
sudo xcode-select --switch ...選擇系統目前選取的 Xcode 版本 (這需要管理員認證)。 也可以從 Xcode 內部執行此操作(設置 -> 位置 -> 命令行工具)。在當前終端機會話期間使用
DEVELOPER_DIR環境變數:打開 終端機 應用程式。
鍵入以下命令,替換您的 Xcode 版本,然後按 Enter:
export DEVELOPER_DIR=/Applications/Xcode_14.1.0.app
如果您想要永久設定此環境變數,您可以將命令新增至
exportShell 設定檔,例如 .zprofile。
在特定模擬器上啟動應用程式
.NET MAUI iOS 應用程式可以透過提供其唯一的裝置識別碼 (UDID) 從 Mac 在特定 iOS 模擬器上啟動:
在 Mac 上,開啟 Xcode,選取 [Windows > 裝置和模擬器 ] 功能表項目,然後選取 [模擬器 ] 索引標籤。
右鍵單擊您選擇的模擬器,然後選擇 複製標識符 以將 UDID 複製到剪貼板。
或者,您可以執行
simctl list命令來擷取 UDID 值清單:/Applications/Xcode.app/Contents/Developer/usr/bin/simctl list
在終端機中,建置應用程式,並使用
_DeviceName指定-pMSBuild 屬性,在您選擇的模擬器上執行它: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在您選擇的模擬器中,按幾次 單擊我 按鈕,並觀察按鈕點擊次數的計數增加。
在裝置上啟動應用程式
您必須先佈建裝置,才能將 iOS 應用程式部署到裝置。 如需詳細資訊,請參閱 iOS 的裝置佈建。 佈建裝置之後,即可提供其唯一的裝置識別碼 (UDID) ,從 Mac 在裝置上啟動 .NET MAUI iOS 應用程式:
使用 USB 連接線將裝置連接到本機 Mac。
開啟 Xcode,然後導覽至 Window > 裝置和模擬器。
在 Xcode 中,選取 [裝置] 索引標籤,然後從已連線裝置清單中選取裝置。
在 Xcode 中,將 Identifier 值複製到剪貼簿:
或者,右鍵單擊您的設備並選擇 複製標識符 以將 UDID 複製到剪貼板。