Synchronisieren mit Xcode

xcsync ist ein .NET-Tool, mit dem Entwickler Xcode für die Verwaltung von Apple-spezifischen Dateien mit .NET-Projekten nutzen können. Das Tool generiert ein temporäres Xcode-Projekt aus einem .NET-Projekt und synchronisiert Änderungen an den Xcode-Dateien mit dem .NET-Projekt.

Unterstützte Dateitypen sind unter anderem:

• Ressourcenkatalog
• Plist
• Storyboard
• Xib

Das Tool hat zwei Befehle: generate und sync. Verwenden Sie generate, um aus einem .NET-Projekt ein Xcode-Projekt zu erstellen, und sync, um Änderungen im Xcode-Projekt wieder in das .NET-Projekt zu übernehmen.

Hinweis

Dieses Tool ist nur für macOS aufgrund der Interaktionen mit Xcode verfügbar.

Visual Studio Code

Installation

Installieren Sie .NET xcsync global mit dem folgenden Befehl:

dotnet tool install -g dotnet-xcsync

Verbrauch

1. Die .NET MAUI-Erweiterung bietet Unterstützung für xcsync. Stellen Sie sicher, dass Sie über die aktuelle Version verfügen. Die xcsync Befehle in der .NET MAUI-Erweiterung sind nur verfügbar, wenn Visual Studio Code unter macOS verwendet wird.
2. Öffnen Sie die Befehlspalette (Cmd + UMSCHALT + P), und suchen Sie nach den .NET MAUI: xcsync - Generate an Xcode project Befehlen und .NET MAUI: xcsync - Sync from an Xcode project Befehlen.

Problembehandlung

Um Details zu Fehlern im Zusammenhang mit xcsyncanzuzeigen, navigieren Sie zum Ausgabefenster (CMD + UMSCHALT + u ), und wählen Sie .NET MAUI xcsync - in der Dropdownliste aus. Wenn Probleme auftreten, melden Sie ein Problem.

Feedback geben

Überprüfen Sie vorhandene bekannte Probleme , bevor Sie ein neues Problem oder einen neuen Vorschlag einreichen.

BEFEHLSZEILENSCHNITTSTELLE (CLI)

Installation

Installieren Sie .NET xcsync global mit dem folgenden Befehl:

dotnet tool install -g dotnet-xcsync

Übersicht

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

Optionen

• -p|--project <PROJECT>

  Die zu erstellende Projektdatei. Unterstützte Projekttypen sind .NET-MAUI-Projekte oder beliebige .NET-Projekte, die auf eine unterstützte Plattform (iOS, tvOS, macOS, MacCatalyst) abzielen.

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

  Rufen Sie das Tool für ein bestimmtes Framework auf. Das Framework muss in der Projektdatei definiert werden. Beispiele: net9.0-ios, net9.0-maccatalyst. Erforderlich , wenn das .NET-Projekt mehrere Zielframeworks unterstützt (z. B. ein mehrorientiertes .NET MAUI-Projekt). Wenn es sich um ein einzelnes Plattformprojekt handelt, ist der Standardwert das in der Projektdatei angegebene einzelne Ziel-Framework.

• -t|--target <TARGET_XCODE_DIRECTORY>

  Das Verzeichnis, in dem das generierte Xcode-Projekt abgelegt werden soll. Der Standardwert ist (*_$(IntermediateOutputPath)_/xcsync*).

• -f|--force

  Erzwingt das Überschreiben eines vorhandenen Xcode-Projekts. Der Standardwert ist False.

• -o|--open

  Öffnet das generierte Projekt in Xcode. Der Standardwert ist False.

• -v|--verbosity <LEVEL>

  Legt den Ausführlichkeitsgrad für den Befehl fest. Zulässige Werte sind Detailed, Diagnostic, Minimal, Normal, Quiet. Der Standardwert ist Normal.

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

  Pfad zum .NET SDK. Der Standardwert ist Pfad vom übergeordneten Prozess, wenn er der Fall ist dotnet, andernfalls auf PATH zurück dotnet .

• -h|--help

  Zeigt Hilfe- und Nutzungsinformationen an.

Beispiele

• Erstellen und öffnen Sie ein Xcode-Projekt für ein .NET MAUI-Projekt, das die Projektdatei im aktuellen Verzeichnis verwendet und den net9.0-iosTFM unterstützt:

  xcsync generate -tfm net9.0-ios
  

• Erstellen und öffnen Sie ein Xcode-Projekt für ein .NET MAUI-Projekt, das net9.0-iosTFM unterstützt:

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

• Synchronisieren Sie Änderungen von einem generierten Xcode-Projekt am Standardspeicherort ($(IntermediateOutputPath)/xcsync) zurück zu einem .NET MAUI-Projekt, das tfMnet9.0-ios unterstützt:

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

Weitere Informationen

xcsync ist Open-Source. Weitere Informationen oder eine Problemdatei finden Sie unter https://github.com/dotnet/xcsync.