Synchronizace s Xcode

xcsync je nástroj .NET, který vývojářům umožňuje využívat Xcode ke správě konkrétních souborů Apple pomocí projektů .NET. Nástroj vygeneruje dočasný projekt Xcode z projektu .NET a synchronizuje změny souborů Xcode zpět do projektu .NET.

Důležitý

xcsync je aktuálně ve verzi Preview.

Mezi podporované typy souborů patří:

• Katalog assetů
• Plist
• Scénáře
• Xib

Nástroj má dva příkazy: generate a sync. Slouží generate k vytvoření projektu Xcode z projektu .NET a sync k přenesení změn v projektu Xcode zpět do projektu .NET.

Poznámka:

Tento nástroj je k dispozici pouze pro macOS kvůli interakcím s Xcode.

Visual Studio Code

Instalace

Nainstalujte verzi Preview rozhraní .NET xcsync globálně pomocí následujícího příkazu:

dotnet tool install dotnet-xcsync -g --prerelease --add-source https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet9/nuget/v3/index.json

Využití

1. Rozšíření .NET MAUI poskytuje podporu pro xcsync. Ujistěte se, že máte nejnovější verzi. Příkazy xcsync v rozšíření .NET MAUI jsou k dispozici pouze při použití editoru Visual Studio Code v macOS.
2. Otevřete paletu příkazů (Cmd + Shift + P) a vyhledejte .NET MAUI: xcsync - Generate an Xcode project příkazy..NET MAUI: xcsync - Sync from an Xcode project

Řešení problému

Pokud chcete zobrazit podrobnosti o chybách souvisejících s xcsync, přejděte do okna Výstup (CMD + Shift + u ) a v rozevíracím seznamu vyberte .NET MAUI – xcsync. Pokud máte problémy, nahlašte problém.

Poskytnutí názorů

Před vytvořením nového problému nebo návrhu zkontrolujte existující známé problémy .

Rozhraní příkazového řádku

Instalace

Nainstalujte verzi Preview rozhraní .NET xcsync globálně pomocí následujícího příkazu:

dotnet tool install dotnet-xcsync -g --prerelease --add-source https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet9/nuget/v3/index.json

Synopse

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

Možnosti

• -p|--project <PROJECT>

  Soubor projektu, který se má sestavit. Podporované typy projektů jsou projekty .NET MAUI nebo jakýkoli projekt .NET, který cílí na podporovanou platformu (iOS, tvOS, macOS, MacCatalyst).

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

  Vyvolá nástroj pro konkrétní architekturu. Architektura musí být definována v souboru projektu. Příklady: net9.0-ios, net9.0-maccatalyst. Vyžaduje se, pokud projekt .NET podporuje více cílových architektur (například projekt .NET MAUI s více cíli). Pokud jeden projekt platformy, výchozí hodnota bude jedno cílové rozhraní zadané v souboru projektu.

• -t|--target <TARGET_XCODE_DIRECTORY>

  Adresář, do kterého se má umístit vygenerovaný projekt Xcode. Výchozí hodnota je (*_$(IntermediateOutputPath)_/xcsync*).

• -f|--force

  Vynutí přepsání existujícího projektu Xcode. Výchozí hodnota je False.

• -o|--open

  Otevře vygenerovaný projekt v Xcode. Výchozí hodnota je False.

• -v|--verbosity <LEVEL>

  Nastaví úroveň podrobností příkazu. Povolené hodnoty jsou Detailed, , DiagnosticMinimal, Normal, Quiet. Výchozí hodnota je Normal.

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

  Cesta k sadě .NET SDK Výchozí hodnota je cesta z nadřazeného procesu, pokud je dotnet, jinak se vrátí zpět na dotnet PATH.

• -h|--help

  Zobrazuje informace o nápovědě a využití.

Příklady

• Vygenerujte a otevřete projekt Xcode pro projekt .NET MAUI, který používá soubor projektu v aktuálním adresáři, který podporuje net9.0-iosTFM:

  xcsync generate -tfm net9.0-ios
  

• Vygenerujte a otevřete projekt Xcode pro projekt .NET MAUI, který podporuje net9.0-iosTFM:

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

• Synchronizujte změny z vygenerovaného projektu Xcode ve výchozím umístění ($(IntermediateOutputPath)xcsync) zpět do projektu .NET MAUI, který podporuje net9.0-ios:

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

Více informací

xcsync je opensourcový. Pokud chcete získat další informace nebo podat problém, navštivte prosím https://github.com/dotnet/xcsync.