macOS Big Sur 运行 Flutter 提示 CocoaPods 未安装如何解决

修复步骤 #

• 第一步：修复Xcode命令行工具配置
  如果你仅安装了Xcode命令行工具未安装完整Xcode，先从App Store安装适配Big Sur的最高支持版本Xcode 13.2.1，安装完成后执行以下命令：

  sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
  sudo xcodebuild -license accept
  

• 第二步：重新安装CocoaPods
  Big Sur自带Ruby版本较低，使用系统Ruby安装CocoaPods会出现权限或兼容问题，建议通过Homebrew安装：
  1. 若未安装Homebrew，先执行安装命令：

  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  

  安装完成后按照终端提示将Homebrew路径加入系统环境变量
  2. 卸载原有CocoaPods后通过brew重新安装：

  sudo gem uninstall cocoapods -a
  brew install cocoapods
  pod setup
  

• 第三步：修复Android许可证问题
  打开Android Studio的SDK Manager，在「SDK Tools」标签页勾选安装「Android SDK Command-line Tools」，完成后执行以下命令，一路输入y同意所有许可：

  flutter doctor --android-licenses
  

• 第四步：更新环境变量配置
  Big Sur默认使用zsh作为终端shell，打开用户目录下的.zshrc配置文件，添加以下内容（替换为你自己的Flutter安装路径）：

  export PATH="$PATH:/替换为你的Flutter存放路径/flutter/bin"
  export ANDROID_HOME="$HOME/Library/Android/sdk"
  export PATH="$PATH:$ANDROID_HOME/tools"
  export PATH="$PATH:$ANDROID_HOME/platform-tools"
  

  保存后执行source ~/.zshrc让配置生效

验证修复结果 #

所有步骤执行完成后，重新执行flutter doctor，即可看到所有检测项正常通过。

内容的提问来源于stack exchange，提问作者Mohamed draz