【配环境】iOS项目开发环境

一、核心开发工具

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报错的清理与重建

彻底清理项目:

  1. 删除Xcode工程中的DerivedData(rm -rf ~/Library/Developer/Xcode/DerivedData)。
  2. 删除unity导出的项目,重新导出Xcode工程。
  3. 重启Xcode并清除缓存(Product → Clean Build Folder)
相关推荐
健了个平_244 小时前
iOS 27 适配笔记
ios·xcode·wwdc
Tr2e4 小时前
🐱 从 0 到 1:用 Swift 手搓一个 macOS 桌面宠物(附源码)
macos·ios·swift
iOS开发上架哦7 小时前
Jenkins 自动上传 IPA 到 App Store 把发布步骤融入 CI/CD
后端·ios
ZJPRENO8 小时前
2026 苹果 WWDC 完整总结
ios
REDcker9 小时前
WWDC2026系统更新综述
macos·ios·开发者·apple·wwdc·ipados·wwdc2026
星星电灯猴10 小时前
全面解决Charles抓取HTTPS请求响应中文乱码问题的方法与技巧
后端·ios
人月神话-Lee11 小时前
【WWDC】Core AI:iOS 端侧大模型新纪元
人工智能·ios·ai·swift·wwdc·core ai
2501_9160074712 小时前
iOS 开发工具选择指南 从编辑器、编译器到自动化构建
ide·vscode·ios·objective-c·个人开发·swift·敏捷流程
库奇噜啦呼12 小时前
【iOS】源码学习-YYModel源码学习
学习·ios·cocoa
风华圆舞13 小时前
一个 Flutter 项目同时保留 Android、iOS、HarmonyOS 支持的实践
android·flutter·ios