一、核心开发工具
1. Xcode
- 从Mac App Store免费下载
- 包含:iOS SDK、编译器、模拟器、Interface Builder、调试工具
- 建议安装最新稳定版本
2. 命令行工具
安装Xcode后,在终端运行:
bash
xcode-select --install
这会安装Git、Clang等必要工具。
二、依赖管理工具
1. CocoaPods
- 最流行的第三方库管理工具
需要Ruby环境
brew install ruby
ruby -v
brew search ruby
brew install ruby@3.0
rvm install "ruby-3.0.0"
ruby -v
rvm list known
rvm --default use 3.0.0
ruby -v
gem sources -l
gem sources --remove https://rubygems.org/
gem sources --add https://gems.ruby-china.com
sudo gem install -n /usr/local/bin cocoapods
sudo gem install cocoapods
//实在不行,退而求其次安装cocoapods时指定个低版本:
sudo gem install cocoapods -v 1.8.4
解决CocoaPods安装后的路径配置问题
当在终端中安装CocoaPods(或其它Ruby gem)后,可能会遇到这个错误提示:
You don't have /Users/用户名/.gem/ruby/2.3.0/bin in your PATH, gem executables will not run.
意思是:系统找不到CocoaPods等gem安装的可执行文件,因为它们的安装路径没有被添加到系统的环境变量PATH中。
解决方案步骤
1. 编辑shell配置文件
根据你使用的shell类型,编辑对应的配置文件:
- Bash 用户:
vim ~/.bash_rc - Zsh 用户:
vim ~/.zshrc(macOS Catalina及以后版本默认使用Zsh)
2. 添加环境变量
在文件中添加以下两行代码:
bash
export GEM_HOME="$(ruby -e 'puts Gem.user_dir')"
export PATH="$PATH:$GEM_HOME/bin"
代码解释:
- 第一行:设置
GEM_HOME环境变量为Ruby gem的用户安装目录 - 第二行:将gem的bin目录添加到系统
PATH中,让系统能找到pod等命令
3. 使配置生效
执行命令重新加载配置文件:
bash
source ~/.bash_rc # 或 source ~/.zshrc
4. 验证和使用
配置完成后,就可以正常使用CocoaPods了:
bash
pod install # 在iOS项目目录中执行,安装第三方库依赖
Xcode build报错的清理与重建
彻底清理项目:
- 删除Xcode工程中的DerivedData(rm -rf ~/Library/Developer/Xcode/DerivedData)。
- 删除unity导出的项目,重新导出Xcode工程。
- 重启Xcode并清除缓存(Product → Clean Build Folder)