1. CocoaPods 安装版本问题

• 问题描述: 使用 pod --version 命令时，出现权限相关错误，提示需要 sudo 权限。
• 错误示例:

  /Users/xxx/.rvm/gems/ruby-3.1.4/bin/pod:25:in `load'
  

• 解决方案:
  • 使用 sudo 安装 CocoaPods，或者
  • 更改 .npm 目录的权限，执行以下命令：

    sudo chown -R $(whoami) ~/.npm
    

2. CocoaPods 依赖安装失败

• 问题描述: 运行 pod install 时，出现找不到 gem 的错误。
• 错误示例:

  can't find gem cocoapods (>= 0.a) with executable pod (Gem::GemNotFoundException)
  

• 解决方案:
  • 尝试使用 gem pristine <gem_name> 修复特定 gem，例如：

    gem pristine debug --version 1.6.3
    

3. OpenSSL 相关问题

• 问题描述: 安装 Ruby 时，因 OpenSSL 版本冲突导致编译失败，提示找不到库文件。
• 错误示例:

  Error running '__rvm_make -j8', please read /Users/xxx/.rvm/log/1727334268_ruby-3.1.4/make.log
  

• 解决方案:
  • 卸载旧版本的 OpenSSL，并确保正确安装 OpenSSL 3.x，执行：

    brew uninstall openssl
    brew install openssl
    

  • 确保环境变量指向正确的 OpenSSL 路径。

4. CocoaPods 源无法添加

• 问题描述: 运行 pod repo add 时，提示无法添加 CocoaPods specs 源。
• 错误示例:

  Unable to add a source with url `https://github.com/CocoaPods/Specs.git` named `cocoapods`.
  

• 解决方案:
  1. 手动添加源：

     pod repo add cocoapods https://github.com/CocoaPods/Specs.git
     

  2. 检查网络连接，确保能访问 GitHub。
  3. 清理 CocoaPods 缓存：

     pod cache clean --all
     

  4. 重新初始化 CocoaPods：

     rm -rf ~/.cocoapods/repos
     pod setup
     

  5. 更新 CocoaPods：

     gem update cocoapods
     

5. Ruby 版本与 gem 依赖问题

• 问题描述: 使用 Ruby 3.3.5 时，出现 gem 依赖无法满足的错误，提示某个 gem 已经激活但不符合版本要求。
• 错误示例:

  can't satisfy 'rexml (>= 3.3.2, < 4.0)', already activated 'rexml-3.2.5' (Gem::LoadError)
  

• 解决方案:
  • 确保 Ruby 与 gem 的兼容性。可以尝试安装符合要求的版本：

    gem install rexml -v '3.3.2'
    

  • 如果依赖冲突，可以考虑降级或升级相关 gem。

6. CocoaPods 使用过程中的常见错误

• 问题描述: 执行 pod install 时，出现找不到某些库文件的错误。
• 错误示例:

  dlopen(..., 0x0009): Library not loaded: /opt/homebrew/opt/openssl@3/lib/libssl.3.dylib
  

• 解决方案:
  • 检查 OpenSSL 的安装路径是否正确。
  • 确保 Ruby 可以访问正确的 OpenSSL 库文件。
  • 可能需要重新安装 Ruby 以确保它能找到 OpenSSL。