Xcode와 동기화

xcsync 는 개발자가 .NET 프로젝트를 사용하여 Apple 특정 파일을 관리하기 위해 Xcode를 활용할 수 있도록 하는 .NET 도구입니다. 이 도구는 .NET 프로젝트에서 임시 Xcode 프로젝트를 생성하고 Xcode 파일의 변경 내용을 다시 .NET 프로젝트로 동기화합니다.

지원되는 파일 형식은 다음과 같습니다.

• 자산 카탈로그
• Plist
• 스토리보드
• Xib

도구에는 두 가지 명령이 있습니다. generate sync .NET 프로젝트에서 Xcode 프로젝트를 만들고 Xcode 프로젝트의 sync 변경 내용을 .NET 프로젝트로 다시 가져오는 데 사용합니다generate.

참고 항목

이 도구는 Xcode와의 상호 작용으로 인해 macOS에서만 사용할 수 있습니다.

Visual Studio Code

설치

다음 명령을 사용하여 .NET xcsync 을 전역적으로 설치합니다.

dotnet tool install -g dotnet-xcsync

사용

1. .NET MAUI 확장은 .에 대한 xcsync지원을 제공합니다. 최신 버전이 있는지 확인합니다. xcsync.NET MAUI 확장의 명령은 macOS에서 Visual Studio Code를 사용하는 경우에만 사용할 수 있습니다.
2. 명령 팔레트(Cmd + Shift + P)를 열고 명령 및 .NET MAUI: xcsync - Sync from an Xcode project 명령을 검색 .NET MAUI: xcsync - Generate an Xcode project 합니다.

문제 해결

관련된 xcsync오류에 대한 세부 정보를 보려면 출력 창(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>

  특정 프레임워크에 대한 도구를 호출합니다. 프레임워크는 프로젝트 파일에 정의해야 합니다. 예: 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>

  명령의 세부 정보 표시 수준을 설정합니다. 허용되는 값은 , Diagnostic, MinimalNormal, Quiet입니다Detailed. 기본값은 Normal여야 합니다.

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

  .NET SDK에 대한 경로입니다. 기본값은 부모 프로세스의 경로이고 dotnet, 그렇지 않으면 PATH로 dotnet 돌아갑니다.

• -h|--help

  도움말 및 사용 정보를 표시합니다.

예제

• TFM을 지원하는 net9.0-ios 현재 디렉터리의 프로젝트 파일을 사용하는 .NET MAUI 프로젝트에 대한 Xcode 프로젝트를 생성하고 엽니다.

  xcsync generate -tfm net9.0-ios
  

• TFM을 지원하는 .NET MAUI 프로젝트에 대한 Xcode 프로젝트를 생성하고 엽니다.net9.0-ios

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

• 기본 위치($(IntermediateOutputPath)/xcsync)에서 생성된 Xcode 프로젝트의 변경 내용을 TFM을 지원하는 .NET MAUI 프로젝트로 다시 동기화합니다 net9.0-ios .

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

자세한 정보

xcsync 는 오픈 소스입니다. 자세한 내용을 확인하거나 문제를 제기하려면 다음을 방문 https://github.com/dotnet/xcsync하세요.