Xcode との同期

xcsync は、開発者が .NET プロジェクトを使用して Apple 固有のファイルを管理するために Xcode を利用できるようにする .NET ツールです。 このツールは、.NET プロジェクトから一時的な Xcode プロジェクトを生成し、Xcode ファイルへの変更を .NET プロジェクトに同期します。

サポートされているファイルの種類は次のとおりです。

• 資産カタログ
• plist
• Storyboard
• Xib

このツールには、generate と sync という 2 つのコマンドがあります。 generate を使用して.NET プロジェクトから Xcode プロジェクトを作成し、sync を使用して Xcode プロジェクトでの変更を .NET プロジェクトに戻します。

Note

このツールは、Xcode との対話のために macOS でのみ使用できます。

Visual Studio Code

インストール

次のコマンドを使用して、.NET xcsync をグローバルにインストールします。

dotnet tool install -g dotnet-xcsync

使用方法

1. .NET MAUI 拡張機能はxcsyncのサポートを提供します。 最新バージョンを使用していることを確認します。 .NET MAUI 拡張機能の xcsync コマンドは、macOS で Visual Studio Code を使用する場合にのみ使用できます。
2. コマンド パレット (Cmd + Shift + P) を開き、 .NET MAUI: xcsync - Generate an Xcode project コマンドと .NET MAUI: xcsync - Sync from an Xcode project コマンドを検索します。

トラブルシューティング

xcsyncに関連するエラーの詳細を表示するには、Output ウィンドウ (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 プロジェクト、またはサポートされているプラットフォーム (iOS、tvOS、macOS、MacCatalyst) をターゲットにする任意の .NET プロジェクトです。

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

  特定のフレームワークのツールを呼び出します。 フレームワークは、[プロジェクト ファイル](../project-sdk/overview.md)で定義する必要があります。 例: 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、Minimal、Normal、Quiet です。 既定値は Normal です。

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

  .NET SDK へのパス。 既定値は、親プロセスが dotnetされている場合はパスであり、それ以外の場合は PATH の dotnet にフォールバックします。

• -h|--help

  ヘルプと使用状況の情報を表示します

例

• 現在のディレクトリ内のプロジェクト ファイルを使用する .NET MAUI プロジェクト (net9.0-iosTFM をサポート) の Xcode プロジェクトを生成して開きます。

  xcsync generate -tfm net9.0-ios
  

• net9.0-iosTFM をサポートしている .NET MAUI プロジェクトの Xcode プロジェクトを生成して開きます。

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

• 既定の場所 ($(IntermediateOutputPath)/xcsync) で生成された Xcode プロジェクトからの変更を、net9.0-ios TFM をサポートする .NET MAUI プロジェクトに同期します

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

詳細

xcsync はオープンソースです。 詳細については、または問題を提出するには、 https://github.com/dotnet/xcsyncを参照してください。