# 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 项目。
