Sdílet prostřednictvím


Synchronizace Xcode (xcsync)

Synchronizace Xcode (xcsync) je nástroj, 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.

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.

Synopse

Následující příklady ukazují syntaxi příkazů generate a sync příkazů.

xcsync-generovat

dotnet build /t:xcsync-generate
    /p:xcSyncProjectFile=<PROJECT>
    /p:xcSyncXcodeFolder=<TARGET_XCODE_DIRECTORY>
    /p:xcSyncTargetFrameworkMoniker=<FRAMEWORK>
    /p:xcSyncVerbosity=<LEVEL>

xcsync-synchronizovat

dotnet build /t:xcsync-sync
    /p:xcSyncProjectFile=<PROJECT>
    /p:xcSyncXcodeFolder=<TARGET_XCODE_DIRECTORY>
    /p:xcSyncTargetFrameworkMoniker=<FRAMEWORK>
    /p:xcSyncVerbosity=<LEVEL>

Argumenty

  • /p:xcSyncProjectFile=<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).

Možnosti

Následující možnosti umožňují změnit výchozí chování nástroje:

  • /p:xcSyncTargetFrameworkMoniker=<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 standardní projekt MAUI). Pokud jeden projekt platformy, výchozí hodnota bude jedno cílové rozhraní zadané v souboru projektu.

  • /p:xcSyncXcodeFolder=<TARGET_XCODE_DIRECTORY>

    Adresář, do kterého se má umístit vygenerovaný projekt Xcode. Výchozí cesta je ./obj/xcode.

  • /p:xcSyncVerbosity=<LEVEL>

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

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-ios TFM:

    dotnet build /t:xcsync-generate /p:xcSyncTargetFrameworkMoniker=net9.0-ios
    
  • Vygenerujte a otevřete projekt Xcode pro projekt .NET MAUI, který podporuje net9.0-ios TFM:

    dotnet build /t:xcsync-generate /p:xcSyncProjectFile=path/to/maui.csproj /p:xcSyncTargetFrameworkMoniker=net9.0-ios
    
  • Synchronizujte změny z vygenerovaného projektu Xcode ve výchozím umístění (./obj/Xcode) zpět do projektu .NET MAUI, který podporuje net9.0-ios TFM:

    dotnet build /t:xcsync-sync /p:xcSyncProjectFile=path/to/maui.csproj /p:xcSyncTargetFrameworkMoniker=net9.0-ios