# Xcode 프로젝트 {#xcode-project}

Xcode 프로젝트에서 레지스트리를 사용해 패키지를 추가하려면 기본 Xcode UI를 사용하세요. Xcode의 `Package Dependencies` 탭에서 `+` 버튼을 클릭해 레지스트리에서 패키지를 검색할 수 있습니다. 패키지가 레지스트리에 있으면 오른쪽 상단에 `tuist.dev` 레지스트리가 표시됩니다.

![패키지 종속성 추가](/images/guides/features/build/registry/registry-add-package.png)

## 소스 제어 패키지 해결 {#resolving-source-control-packages}

추가한 패키지의 전달적 종속성과 같이 소스 제어 URL로 선언된 패키지는 기본적으로 소스 제어에서 해결됩니다. `tuist registry setup`는 다음 사용자 기본값을 기록해 Xcode가 대신 레지스트리에서 이를 해결하도록 구성합니다.

```bash
defaults write com.apple.dt.Xcode IDEPackageDependencySCMToRegistryTransformation useRegistryIdentityAndSources
```

이후 Xcode는 레지스트리에 해당하는 항목이 있을 때 소스 제어 패키지를 레지스트리에서 해결하고, 없는 경우 소스 제어로 대체합니다.

> [!NOTE]
> 이는 기기별 Xcode 환경설정이며 프로젝트 설정이 아니므로, 레지스트리 구성 파일을 커밋해도 팀원들과 공유되지 않습니다. 각 개발자는 자신의 기기에서 `tuist registry setup`를 한 번 실행해야 합니다. 이 환경설정은 해당 기기의 모든 Xcode 프로젝트에 적용됩니다.

Xcode 프로젝트

Xcode 프로젝트에서 레지스트리를 사용해 패키지를 추가하려면 기본 Xcode UI를 사용하세요. Xcode의 Package Dependencies 탭에서 + 버튼을 클릭해 레지스트리에서 패키지를 검색할 수 있습니다. 패키지가 레지스트리에 있으면 오른쪽 상단에 tuist.dev 레지스트리가 표시됩니다.

패키지 종속성 추가

소스 제어 패키지 해결#

추가한 패키지의 전달적 종속성과 같이 소스 제어 URL로 선언된 패키지는 기본적으로 소스 제어에서 해결됩니다. tuist registry setup는 다음 사용자 기본값을 기록해 Xcode가 대신 레지스트리에서 이를 해결하도록 구성합니다.

bash

defaults write com.apple.dt.Xcode IDEPackageDependencySCMToRegistryTransformation useRegistryIdentityAndSources

이후 Xcode는 레지스트리에 해당하는 항목이 있을 때 소스 제어 패키지를 레지스트리에서 해결하고, 없는 경우 소스 제어로 대체합니다.

Note

이는 기기별 Xcode 환경설정이며 프로젝트 설정이 아니므로, 레지스트리 구성 파일을 커밋해도 팀원들과 공유되지 않습니다. 각 개발자는 자신의 기기에서 tuist registry setup를 한 번 실행해야 합니다. 이 환경설정은 해당 기기의 모든 Xcode 프로젝트에 적용됩니다.