猫哥学习站 ducafecat.com
登录

猫哥主打系统环境是: - macos - flutter 3.7.12 - ruby 3.2.2 - cocoapods 1.12.1 - xcode 14.3.1 这套配置运行最新的项目没问题，但是最近需要维护 flutter 2.10.5 这种老项目，虽然用了 fvm 进行 flutter 版本切换，但是 flutter 2.10.5 用的 ruby 2 ，我当前是 ruby 3 所以运行 pod install 的时候就报错了。 今天就来说说我是怎么解决的，我是需要灵活切换旧版、新版的 IOS 开发环境。

如何在 macOS 上同时使用 Ruby2、Ruby3、CocoaPods、Flutter2 和 Flutter3，使用 RVM 和 FVM 进行版本管理

视频

前言

猫哥主打系统环境是:

  • macos
  • flutter 3.7.12
  • ruby 3.2.2
  • cocoapods 1.12.1
  • xcode 14.3.1

这套配置运行最新的项目没问题，但是最近需要维护 flutter 2.10.5 这种老项目，虽然用了 fvm 进行 flutter 版本切换，但是 flutter 2.10.5 用的 ruby 2 ，我当前是 ruby 3 所以运行 pod install 的时候就报错了。

[!] Invalid `Podfile` file: undefined method `exists?' for File:Class.

 #  from /Users/ducafecat/Documents/project-2021/helber_v2/helber_v2_flutter_210/ios/Podfile:34
 #  -------------------------------------------
 #
 >    flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
 #
 #  -------------------------------------------

这个错误很常见，因为 ruby 3 的 api 接口有变化。

今天就来说说我是怎么解决的，我是需要灵活切换旧版、新版的 IOS 开发环境。

原文 https://ducafecat.com/blog/011-flutter-macos-rvm-cocoapods-fvm

参考

https://www.moncefbelyamani.com/how-to-install-xcode-homebrew-git-rvm-ruby-on-mac/

https://www.moncefbelyamani.com/why-you-should-never-use-sudo-to-install-ruby-gems/

https://www.phusionpassenger.com/library/walkthroughs/deploy/ruby/ownserver/nginx/oss/install_language_runtime.html

https://blog.driftingruby.com/articles/2023/03/04/ruby-with-yjit.html

https://github.com/rvm/rvm

https://rvm.io/rvm/install

https://brew.sh/

https://cocoapods.org/

rvm 知识点

RVM（Ruby Version Manager）是一个用于管理 Ruby 版本的工具，它可以让您在同一台机器上安装和使用多个 Ruby 版本，并且可以为每个 Ruby 版本提供独立的 gem 环境。以下是 RVM 的一些优点：

  1. 多版本管理：使用 RVM，您可以轻松地在同一台机器上安装和管理多个 Ruby 版本。这对于开发人员来说非常有用，因为不同的项目可能需要不同的 Ruby 版本或 gem 包。
  2. gem 环境隔离：RVM 可以为每个 Ruby 版本提供独立的 gem 环境，以避免不同版本之间的 gem 包冲突。这意味着您可以在不同的 gem 环境中安装和管理 gem 包，而不会相互干扰。
  3. 简单易用：RVM 提供了一组简单易用的命令，使您可以轻松地安装、卸载、切换和管理 Ruby 版本、gem 包和 gemset。
  4. 社区支持：RVM 是一个流行的 Ruby 工具，拥有活跃的社区支持和开发团队，可以及时解决问题和更新版本。
  5. 跨平台支持：RVM 支持多种操作系统，包括 macOS、Linux 和 Windows，使您可以在不同的平台上使用相同的工具和环境。

思路

我尝试了些方法，过程如下:

  • 删除本机各种 ruby cocoapods 工具
  • 安装最新版 ruby 3.2.2
  • 安装最新版 cocoapods
  • 安装 rvm ruby 版本切换工具
  • 通过 rvm 安装 ruby 2.7.8
  • 切换 ruby 2.7.8 安装 cocoapods
  • 完成后 rvm 可以切换回系统 ruby 3.2.2 版本

步骤

注意以下操作竟可能不要用 sudo 执行，否则权限会乱掉。

第一步：准备环境

卸载旧版 ruby 2 和 ruby 版本工具（rvm rbenv asdf frum）

安装 homebrew

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

brew 升级到最新

$ brew update && brew doctor

检查自己的系统芯片 arm64 x86_64

$ uname -m

清理错误的配置，有些包管理工具会写下面的配置文件

~/.zshrc
~/.zprofile
~/.zlogin
~/.bash_profile
~/.profile
~/.bashrc
~/.config/fish/config.fish

主要是 .zshrc .bash_profile .profile

第二步：安装 ruby 最新版

安装 ruby 3.2.2

$ brew install ruby

配置 ruby 环境

$ vi ~/.bash_profile

# ruyb
# intel 芯片
if [ -d "/usr/local/opt/ruby/bin" ]; then
  export PATH=/usr/local/opt/ruby/bin:$PATH
  export LDFLAGS="-L/usr/local/opt/ruby/lib"
  export CPPFLAGS="-I/usr/local/opt/ruby/include"
  export PATH=`gem environment gemdir`/bin:$PATH
fi
# m1 silicon 芯片
if [ -d "/opt/homebrew/opt/ruby/bin" ]; then
  export PATH=/opt/homebrew/opt/ruby/bin:$PATH
  export LDFLAGS="-L/opt/homebrew/opt/ruby/lib"
  export CPPFLAGS="-I/opt/homebrew/opt/ruby/include"
  export PATH=`gem environment gemdir`/bin:$PATH
fi

查看版本

$ ruby -v
ruby 3.2.2 (2023-03-30 revision e51014f9c0) [x86_64-darwin22]

安装 cocoapods

$ gem install cocoapods

第三步：安装 rvm 版本管理

安装 rvm

$ curl -sSL https://get.rvm.io | bash -s stable

rvm 查看可安装版本

$ rvm list known

安装 ruby 2.7.8

$ rvm install ruby-2.7.8 --default

rvm 切换版本

$ rvm use ruby-2.7.8

安装 cocoapods

$ gem install cocoapods

rvm 会自动管理 gem 不同 ruby 版本的隔离

使用

切换 flutter 2.10.5

fvm 切到 2.10.5

$ fvm global 2.10.5

rvm 切到 ruby 2.7.8

$ rvm use ruby-2.7.8

cocoapods 拉包

$ cd ios
$ pod install

切换 flutter 3.7.12

rvm 还原系统

$ rvm reset

fvm 切到 3.7.12

$ fvm global 3.7.12

cocoapods 拉包

$ cd ios
$ pod install

小结

大家可以看到现在可以顺利的切换 flutter 2&3 的开发环境了，如果你有和我相同需求的，可以动手试试。

感谢阅读本文

如果我有什么错？请在评论中让我知道。我很乐意改进。

© 猫哥 ducafecat.com

end