Synchronizowanie z programem Xcode

xcsync to narzędzie platformy .NET, które umożliwia deweloperom korzystanie z programu Xcode do zarządzania plikami specyficznymi dla firmy Apple przy użyciu projektów platformy .NET. Narzędzie generuje tymczasowy projekt Xcode z projektu platformy .NET i synchronizuje zmiany z plikami Xcode z powrotem do projektu .NET.

Obsługiwane typy plików obejmują:

• Wykaz zasobów
• Plist
• Serii ujęć
• Xib

Narzędzie ma dwa polecenia: generate i sync. Użyj generate polecenia , aby utworzyć projekt Xcode z projektu platformy .NET i sync wprowadzić zmiany w projekcie Xcode z powrotem do projektu .NET.

Uwaga

To narzędzie jest dostępne tylko dla systemu macOS ze względu na interakcje z programem Xcode.

Visual Studio Code

Instalacja

Zainstaluj platformę .NET xcsync globalnie za pomocą następującego polecenia:

dotnet tool install -g dotnet-xcsync

Użycie

1. Rozszerzenie .NET MAUI zapewnia obsługę programu xcsync. Upewnij się, że masz najnowszą wersję. Polecenia xcsync w rozszerzeniu .NET MAUI są dostępne tylko w przypadku korzystania z programu Visual Studio Code w systemie macOS.
2. Otwórz paletę poleceń (Cmd + Shift + P) i wyszukaj .NET MAUI: xcsync - Generate an Xcode project polecenia i .NET MAUI: xcsync - Sync from an Xcode project .

Rozwiązywanie problemów

Aby wyświetlić szczegółowe informacje o błędach związanych z xcsyncusługą , przejdź do okna Dane wyjściowe (CMD + Shift + u ) i wybierz pozycję .NET MAUI — xcsync na liście rozwijanej. Jeśli masz problemy, zgłoś problem.

Przekazywanie opinii

Przed zgłoszeniem nowego problemu lub sugestii sprawdź istniejące znane problemy .

CLI

Instalacja

Zainstaluj platformę .NET xcsync globalnie za pomocą następującego polecenia:

dotnet tool install -g dotnet-xcsync

Streszczenie

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

Opcje

• -p|--project <PROJECT>

  Plik projektu do skompilowania. Obsługiwane typy projektów to projekty MAUI platformy .NET lub dowolny projekt platformy .NET przeznaczony dla obsługiwanej platformy (iOS, tvOS, macOS, MacCatalyst).

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

  Wywołaj narzędzie dla określonej platformy. Struktura musi być zdefiniowana w pliku projektu. Przykłady: net9.0-ios, net9.0-maccatalyst. Wymagane , jeśli projekt platformy .NET obsługuje wiele platform docelowych (na przykład wielokierunkowy projekt MAUI platformy .NET). Jeśli pojedynczy projekt platformy, wartością domyślną będzie pojedyncza platforma docelowa określona w pliku projektu.

• -t|--target <TARGET_XCODE_DIRECTORY>

  Katalog, w którym ma być umieszczany wygenerowany projekt Xcode. Wartość domyślna to (*_$(IntermediateOutputPath)_/xcsync*).

• -f|--force

  Wymusza zastąpienie istniejącego projektu Xcode. Wartość domyślna to False.

• -o|--open

  Otwiera wygenerowany projekt w środowisku Xcode. Wartość domyślna to False.

• -v|--verbosity <LEVEL>

  Ustawia poziom szczegółowości polecenia. Dozwolone wartości to Detailed, , MinimalDiagnostic, Normal, Quiet. Wartość domyślna to Normal.

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

  Ścieżka do zestawu SDK platformy .NET. Wartość domyślna to ścieżka z procesu nadrzędnego, jeśli jest dotnetto , w przeciwnym razie wraca do dotnet ścieżki .

• -h|--help

  Pokazuje informacje pomocy i użycia

Przykłady

• Wygeneruj i otwórz projekt Xcode dla projektu .NET MAUI, który używa pliku projektu w bieżącym katalogu, który obsługuje net9.0-ios program TFM:

  xcsync generate -tfm net9.0-ios
  

• Wygeneruj i otwórz projekt Xcode dla projektu .NET MAUI obsługującego net9.0-ios program TFM:

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

• Synchronizuj zmiany z wygenerowanego projektu Xcode w domyślnej lokalizacji ($(IntermediateOutputPath)/xcsync) z powrotem do projektu .NET MAUI obsługującego net9.0-ios program TFM:

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

Więcej informacji

xcsync jest typu open source. Aby uzyskać więcej informacji lub zgłosić problem, odwiedź stronę https://github.com/dotnet/xcsync.