# Xcode 项目 {#xcode-project}

要在 Xcode 项目中通过注册表添加软件包，请使用默认的 Xcode 界面。你可以点击 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 项目。