Xcode Locations 和 Source Control(版本控制)设置说明
以下是 Locations 和 Source Control(版本控制) 设置界面的详细说明。
Source Control(版本控制)
1. General(通用设置)
Source Control(版本控制设置)
- Enable Source Control(启用版本控制):
启用 Xcode 内置的版本控制功能。 - Refresh local status automatically(自动刷新本地状态):
自动检查和更新本地文件的版本控制状态。 - Fetch and refresh server status automatically(自动拉取并刷新服务器状态):
自动从远程仓库拉取最新状态并刷新。 - Add and remove files automatically(自动添加和移除文件):
项目文件变更时自动添加或移除文件。 - Select files to commit automatically(自动选择提交的文件):
自动选择所有变更的文件进行提交。
Text Editing(文本编辑)
- Show Source Control changes(显示版本控制更改):
在代码编辑器中直观显示文件的版本控制变更。 - Include upstream changes(包含上游更改):
显示上游仓库的更改内容。
Swift Assist Operations(Swift 辅助操作)
- Don't stage or commit(不暂存或提交):
不在 Swift 辅助操作时自动处理暂存或提交。 - Stage and commit before Swift Assist operations(操作前暂存并提交):
在 Swift 辅助操作前暂存并提交。 - Stage and commit before and after Swift Assist operations(操作前后暂存并提交):
在 Swift 辅助操作前和后均执行暂存和提交。
Comparison View(比较视图)
- Local Revision on Left Side(本地修订在左侧):
设置版本比较视图中本地和远程修订的显示位置。
Source Control Navigator(版本控制导航器)
- Sort by Name(按名称排序):
按文件或目录名称排序显示。
Default Branch Name(默认分支名称)
- 设置默认分支名称,例如
main或master。
注意: 分支名称不能包含空格、反斜杠或其他特殊符号。
2. Git(Git 设置)
Author Information(作者信息)
- Author Name(作者名称):
设置 Git 提交记录中显示的作者名称。 - Author Email(作者邮箱):
设置 Git 提交记录中显示的作者邮箱。
Ignored Files(忽略文件)
- 添加需要忽略的文件或目录规则。
示例: 忽略*.log或build/目录。
Options(选项)
- Prefer to rebase when pulling(拉取时优先使用 rebase):
拉取远程更改时优先使用rebase而非merge,保持整洁的提交历史。 - Show merge commits in per-file log(在文件日志中显示合并提交):
显示文件变更日志中的合并提交记录。
Locations(位置设置)
1. Locations 选项卡
设置 Xcode 项目文件的默认存储位置。
Derived Data(派生数据)
- Default(默认位置):
存储项目生成的临时文件,例如索引文件和缓存。路径通常是:
/Users/<用户名>/Library/Developer/Xcode/DerivedData - Advanced(高级设置):
可以为不同的项目单独设置派生数据路径。
Archives(存档文件)
- Default(默认位置):
存储项目的归档文件,用于上传到 App Store 或共享应用程序。路径通常是:
/Users/<用户名>/Library/Developer/Xcode/Archives - 可以自定义存储路径。
Command Line Tools(命令行工具)
- 显示和选择当前 Xcode 的版本,用于命令行工具(如
xcodebuild)的执行。
示例:Xcode 16.1 (16B40) - 如果安装了多个版本的 Xcode,可以从下拉菜单中选择。
2. Custom Paths(自定义路径)
- Name(名称):
为自定义路径创建一个标识名称。 - Display Name(显示名称):
显示在 Xcode 内的名称。 - Path(路径):
自定义路径的实际存储位置。
可以通过点击左下角的 + 按钮添加自定义路径,点击 - 按钮移除路径。
推荐设置
Locations
- 存档管理:
自定义 Archives 路径,将归档文件存储到单独的目录中,便于管理。 - 派生数据管理:
将 Derived Data 路径自定义到 SSD 或高速存储设备中,加快构建速度。
Source Control
- 同步管理:
启用 Refresh local status automatically 和 Fetch and refresh server status automatically,保持本地与远程同步。 - 提升效率:
勾选 Show Source Control changes,在代码编辑器中直观查看变更。 - 历史清晰:
使用 Prefer to rebase when pulling,确保 Git 历史整洁。