與 Xcode 同步處理

xcsync 是 .NET 工具，可讓開發人員利用 Xcode 搭配 .NET 專案管理 Apple 特定檔案。 此工具會從 .NET 專案產生暫時 Xcode 專案，並將 Xcode 檔案的變更同步處理回 .NET 專案。

支援的檔案型態包括：

• 資產目錄
• Plist
• 分鏡
• Xib

此工具有兩個指令： generate 和 sync。 使用 generate 從 .NET 專案建立 Xcode 專案，並將 sync Xcode 專案中的變更帶回 .NET 專案。

注意

此工具僅適用於 macOS，因為與 Xcode 的互動。

Visual Studio Code

安裝

使用下列命令全域安裝 .NET xcsync ：

dotnet tool install -g dotnet-xcsync

使用方式

1. .NET MAUI 延伸模組支援 xcsync。 確認您擁有最新版本。 xcsync只有在macOS上使用Visual Studio Code時，才能使用 .NET MAUI 延伸模組中的命令。
2. 開啟命令選擇區 （Cmd + Shift + P），然後搜尋 .NET MAUI: xcsync - Generate an Xcode project 和 .NET MAUI: xcsync - Sync from an Xcode project 命令。

疑難排解

若要查看與 相關的xcsync錯誤詳細數據，請流覽至 [輸出] 視窗 （CMD + Shift + u ），然後在下拉式清單中選取 [.NET MAUI]。 xcsync 如果您遇到問題，請 回報問題。

提供意見反應

請先檢查現有的 已知問題 ，再提出新的問題或建議。

CLI

安裝

使用下列命令全域安裝 .NET xcsync ：

dotnet tool install -g dotnet-xcsync

概要

xcsync generate [-p|--project <PROJECT>]
[-tfm|--target-framework-moniker <FRAMEWORK>]
[-t|--target <TARGET_XCODE_DIRECTORY>] [-f|--force]
[-o|--open] [-v|--verbosity <LEVEL>]
[-d|--dotnet-path <PATH>]

xcsync sync [-p|--project <PROJECT>]
[-tfm|--target-framework-moniker <FRAMEWORK>]
[-t|--target <TARGET_XCODE_DIRECTORY>] [-v|--verbosity <LEVEL>]

xcsync -h|--help

選項。

• -p|--project <PROJECT>

  要建置的專案檔。 支援的專案類型為 .NET MAUI 專案或任何以支援平臺為目標的 .NET 專案（iOS、tvOS、macOS、MacCatalyst）。

• -tfm|--target-framework-moniker <FRAMEWORK>

  叫用特定架構的工具。 架構必須定義於專案檔中。 例如：net9.0-ios、net9.0-maccatalyst。 如果 .NET 專案支援多個目標架構，則為必要 專案（例如多重目標 .NET MAUI 專案）。 如果單一平臺項目，預設值會是項目檔中指定的單一目標架構。

• -t|--target <TARGET_XCODE_DIRECTORY>

  要放置所產生 Xcode 項目的目錄。 預設值為 (*_$(IntermediateOutputPath)_/xcsync*)。

• -f|--force

  強制覆寫現有的 Xcode 專案。 預設值為 False。

• -o|--open

  在 Xcode 中開啟產生的專案。 預設值為 False。

• -v|--verbosity <LEVEL>

  設定命令的詳細資訊層級。 允許的值為 Detailed、、Diagnostic、MinimalNormal、 Quiet。 預設值為 Normal。

• -d|--dotnet-path <PATH>

  .NET SDK 的路徑。 默認值是父進程的路徑，如果為 dotnet，則為 ，否則會回復為 dotnet PATH。

• -h|--help

  顯示說明和使用方式資訊

範例

• 為使用目前目錄中項目檔的 .NET MAUI 專案產生並開啟 Xcode 專案，其支援 net9.0-ios TFM：

  xcsync generate -tfm net9.0-ios
  

• 為支援 TFM 的 net9.0-ios .NET MAUI 專案產生並開啟 Xcode 專案：

  xcsync generate -p path/to/maui.csproj -tfm net9.0-ios
  

• 將預設位置 （$（IntermediateOutputPath）/xcsync中產生的 Xcode 專案變更同步回支援 TFM 的 net9.0-ios .NET MAUI 專案：

  xcsync sync -p path/to/maui.csproj -tfm net9.0-ios
  

其他相關資訊

xcsync 是開放原始碼。 如需詳細資訊或提出問題，請造訪 https://github.com/dotnet/xcsync。