【Mac上安装CocoaPods，以及CocoaPods的相关安装问题】

已于 2024-06-06 11:03:18 修改
阅读量1.6k 收藏
点赞数
分类专栏： CocoaPods 文章标签： cocoapods
于 2023-11-08 14:36:40 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/u012681458/article/details/134285775
版权

来源是‘林永坚’的课程

CocoaPods

搭建统一的IOS开发环境，Ruby链之CocoaPods

每次开启一个新项目，都需要手动搭建开发环境，或者加入一个新项目，都需要各种手动搭建，这些都是重复的工作。就不能统一搭建一次，后面的人直接使用这个配置去生成吗？可以的，本篇就是为了这个目的。

Homebrew

Homebrew是什么？

Homebrew 是 macOS 上的一个包管理器，用于简化安装和管理开发工具、库和其他软件包。它的核心是用 Ruby 编写的，这使得它可以充分利用 Ruby 的灵活性和表达能力。
Homebrew 的安装依赖于 Ruby： 在安装 Homebrew 时，系统通常需要已经安装了 Ruby。Homebrew 安装脚本本身也是用 Ruby 编写的，因此在安装 Homebrew 之前，Ruby 会被系统视为一个依赖项。

Homebrew怎么安装?

Homebrew源使用帮助

安装：参考
Mac环境情况：
macOS Catalina(10.15.x) 版开始，Mac使用/bin/zsh作为默认Shell，其对应的配置文件为/.zshrc
查看Mac的CPU型号，M1

$ uname -m
#M1芯片的打印是：x86_64

$ brew --config
*可以发现打印有下面一行：
Homebrew Ruby: 2.6.10 => /usr/local/Homebrew/Library/Homebrew/vendor/portable-ruby/2.6.10_1/bin/ruby

Homebrew 的安装目录为 /usr/local/bin/brew ，而 portable-ruby/ 在 /usr/local/Homebrew/Library/Homebrew/vendor/ 中

权限问题：
修改 /user/local/Homebrew 权限即可，如果 /usr/local 的很多文件都属于其他用户，那就进行全部修改，将 /usr/local 下的全部文件都修改为当前用户和当前用户所属的组：
$ sudo chown -R -v $(whoami): /usr/local/*

通常，Homebrew安装的软件的相关文件存储在以下位置：

/usr/local/Cellar：这个目录包含了Homebrew安装的软件的实际文件。
/usr/local/Homebrew/Caskroom：如果你使用Homebrew Cask来安装软件，那么相关文件可能存储在这个目录中。
~/.config：有些软件的配置文件可能存储在你的用户配置文件夹中。

Homebrew怎么用?有哪些必须知道的命令

brew --version			查看Homebrew的版本（或者brew -v）
brew update     		更新Homebrew
brew upgrade  			更新所有安装过的软件包
brew upgrade wget   	更新这个指定‘wget'的软件包
brew search wget  		搜索
brew install wget   	安装
brew remove wget  		卸载
brew list  				列出已安装的所有软件包
brew info wget   		查看软件包的信息
brew deps wget  		列出软件包的依赖关系
brew outdated    		列出可以更新的软件包
brew cleanup            清理卸载后残留的文件
brew help				帮助

Homebrew和CocoaPods的关系

如果不使用Ruby工具链，一般是使用Homebrew来安装和管理CocoaPods，比如：

brew install cocoapods
brew upgrade cocoapods
brew uninstall cocoapods

完全删除pods相关的

gem uninstall cocoapods cocoapods-core cocoapods-deintegrate cocoapods-downloader cocoapods-plugins cocoapods-search cocoapods-trunk cocoapods-try
rm -rf ~/.cocoapods
rm -rf ~/Library/Caches/CocoaPods

使用 Homebrew 管理 CocoaPods 的好处之一是它可以更好地集成到你的系统环境中，并且能够更容易地进行版本控制和更新。
而使用Ruby链能创建统一的开发环境，也更容易’复制‘（意味着节省不必要的重复工作）。

卸载Homebrew

/bin/bash -c “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/uninstall.sh)”

Ruby

目前流行的Ruby环境管理工具有 RVM 和 rbenv。这里推荐使用 rbenv，因为它使用shims 文件夹来分离各个 Ruby版本，相对于RVM更加方便。

rbenv

rbenv 是 Ruby的环境管理工具，能够安装、管理、隔离以及在多个Ruby版本之间切换。rbenv使用Homebrew来安装，下面是安装的脚本。

$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
brew install rbenv ruby-build rbenv-vars

一旦安装 rbenv 完毕，我们需要把以下的设置信息放到你的 Shell 配置文件里面，例如 ~/.bash_profile 或者 ~/.zshrc 等文件，这样能保证每次打开终端的时候都会初始化 rbenv。

export PATH="$HOME/.rbenv/bin:$PATH" 
eval "$(rbenv init -)"

接着我们就可以安装和设置项目的 Ruby 环境了。

$ cd $(PROJECT_DIR)
$ rbenv install 3.2.0   //安装3.2.0版本，位置在/Users/_pc_name_/.rbenv/versions/
$ rbenv local 2.7.1		//在项目文件下生成一个文件：.ruby-version

查看这个目录下的/Users/imvt/.rbenv/shims 有没有pod，如果有，删除掉系统层级的pod,
执行命令：which pod
输出：/Users/imvt/.rbenv/shims/pod，
此时执行：gem install cocoapods，就可以更新rbenv下的pod版本。
可以用这个：rbenv rehash，在rbenv global 3.1.2等命令后刷新一下。

RubyGems 和 Bundler

RubyGems和Bundler这两个主要用来管理CocoaPods和fastlane等第三方工具。
在Ruby的世界，包叫做Gem，可以用 gem install 命令来安装。但是因为RubyGems在管理 Gem 版本时有些缺陷，就有了Bundler，用来检查和安装Gem的特定版本，以此为Ruby项目提供一致性的环境。

//搜索
$ gem search cocoapods
//查看当前是否安装了cocoapods
$ gem list  
//安装
$ gem install cocoapods 
//安装Bundler
gem install bundler
//更新gem
sudo gem update --system

安装Ruby

  1. 安装ruby，有两种格式 brew install ruby@3.1 或者 brew install ruby ，
    直接在terminal根目录运行下面的代码

$ brew install ruby@3.1

#运行后会有如下的输出：
ruby@3.1 is keg-only, which means it was not symlinked into /usr/local,
because this is an alternate version of another formula.

If you need to have ruby@3.1 first in your PATH, run:
  echo 'export PATH="/usr/local/opt/ruby@3.1/bin:$PATH"' >> ~/.zshrc

For compilers to find ruby@3.1 you may need to set:
  export LDFLAGS="-L/usr/local/opt/ruby@3.1/lib"
  export CPPFLAGS="-I/usr/local/opt/ruby@3.1/include"

For pkg-config to find ruby@3.1 you may need to set:
  export PKG_CONFIG_PATH="/usr/local/opt/ruby@3.1/lib/pkgconfig"
==> Summary
🍺  /usr/local/Cellar/ruby@3.1/3.1.4: 16,183 files, 43MB
==> Running `brew cleanup ruby@3.1`...
Disable this behaviour by setting HOMEBREW_NO_INSTALL_CLEANUP.
Hide these hints with HOMEBREW_NO_ENV_HINTS (see `man brew`).

$ brew install ruby

#运行后会有如下的输出：
ruby is keg-only, which means it was not symlinked into /usr/local,
because macOS already provides this software and installing another version in
parallel can cause all kinds of trouble.

If you need to have ruby first in your PATH, run:
  echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.zshrc

For compilers to find ruby you may need to set:
  export LDFLAGS="-L/usr/local/opt/ruby/lib"
  export CPPFLAGS="-I/usr/local/opt/ruby/include"

For pkg-config to find ruby you may need to set:
  export PKG_CONFIG_PATH="/usr/local/opt/ruby/lib/pkgconfig"
==> Summary
🍺  /usr/local/Cellar/ruby/3.2.2_1: 16,605 files, 46.2MB
==> Running `brew cleanup ruby`...
Disable this behaviour by setting HOMEBREW_NO_INSTALL_CLEANUP.
Hide these hints with HOMEBREW_NO_ENV_HINTS (see `man brew`).
  1. 按照提示输入下面的命令：

$ echo ‘export PATH=“/usr/local/opt/ruby/bin:$PATH”’ >> ~/.zshrc
$ source ~/.zshrc
$ source ~/.bash_profile

第一行：是将路径写入到.zshrc，这个可以直接从文件夹找到（路径：/Users/你的用户名/.zshrc），直接按照文本方式打开，复制这个 export PATH=“/usr/local/opt/ruby/bin:$PATH” 到末尾也是一样。
第二行：是让对.zshrc的修改生效
第三行：是让.bash_profile在这个窗口生效，其它窗口包括新开的窗口：无效。
比如你在.bash_profile内有下面的两行， source ~/.bash_profile 后在这个窗口就只用rbenv的Ruby。

export PATH="$HOME/.rbenv/bin:$PATH"
eval "$(rbenv init -)"

关于keg-only，点击查看参考。

管理Ruby

$ brew update
$ brew install rbenv

在文件 .bashrc 内添加下面内容

eval “$(rbenv init -)”

查看可以安装的ruby版本，并安装

rbenv install -l
rbenv install 3.2.1

设置为全局使用这个ruby版本，并重新‘启用/运行’这个版本的ruby

$ rbenv global 3.2.1
$ rbenv rehash
$ which ruby
$ ruby -v

更新Ruby

替换Ruby镜像

方式1

查看当前的ruby源

$ gem sources -l
打印：
*** CURRENT SOURCES ***
https://rubygems.org/

移除ruby当前源，并替换国内镜像

$ gem sources --remove https://rubygems.org/
$ gem sources -a https://gems.ruby-china.com/
替换国内最新镜像源（淘宝的Ruby镜像已经不更新了，https://gems.ruby-china.org域名更新为https://gems.ruby-china.com）
再次查看是否成功替换
$ gem sources -l

方式2

解决brew update 无法访问问题：
// 执行下面这句命令，更换为中科院的镜像：

$ git clone git://mirrors.ustc.edu.cn/homebrew-core.git/ /usr/local/Homebrew/Library/Taps/homebrew/homebrew-core --depth=1
到这个目录下，查看会发现多一个homebrew-core文件夹，因为现在是‘浅克隆’，执行下面的命令‘完全克隆’：
git -C /usr/local/Homebrew/Library/Taps/homebrew/homebrew-core fetch --unshallow
然后可以执行：brew update

// 把homebrew-core的镜像地址也设为中科院的国内镜像 （check）

$ cd “$(brew --repo)”
$ git remote set-url origin https://mirrors.ustc.edu.cn/brew.git
$ cd “$(brew --repo)/Library/Taps/homebrew/homebrew-core”
$ git remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git

// 更新
$ brew update
// 使用
brew install node/xx1/某个组件2/

CocoaPods

安装CocoaPods

$ sudo gem install cocoapods
*可能会报错：ERROR: While executing gem … (Gem::FilePermissionError)
You don’t have write permissions for the /Library/Ruby/Gems/2.3.0 directory

改成下面的方式

$ sudo gem install -n /usr/local/bin cocoapods
然后执行
$ pod setup
*这个执行很慢，耐心等待… pod setup在执行时，会输出Setting up CocoaPods master repo，然后会卡一会儿。这步其实是 Cocoapods 将它的信息下载到 ~/.cocoapods目录下，你可以command+n新建一个终端窗口，执行cd ~/.cocoapods/进入到该文件夹下，然后du -sh *查看文件大小，这个目录最终大小是900多M。出现Setup completed 的时候说明已经完成了

CocoaPods使用

$ pod search AFNetworking
$ cd /user/filename/Your Project
$ vim Podfile
*输入下面的内容
platform :ios, ‘12.0’
target ‘dssf’ do
pod ‘AFNetworking’
end
*退出并保存
$ pod install

创建方式2：

$ pod init
*会自动创建Podfile，打开文件夹，添加需要的‘三方库’，最后
$ pod install
$ pod deintegrate #删除

安装的一些问题

$ rbenv install 3.2.1

还有Podfile的依赖包统一设置最小支持版本（有些库最小版本是ios8这种，编译有问题）
#规定target最小为iOS11
post_install do |installer|
installer.generated_projects.each do |project|
project.targets.each do |target|
target.build_configurations.each do |config|
config.build_settings[‘IPHONEOS_DEPLOYMENT_TARGET’] = ‘11.0’
end
end
end
end

如下error:
BUILD FAILED (macOS 14.1 using ruby-build 20230208.1) (M1及以上芯片导致的问题）

解决方案：

$ CFLAGS=“-Wno-error=implicit-function-declaration” RUBY_CONFIGURE_OPTS=‘–with-readline-dir=/usr/local/opt/readline/’ arch -x86_64 rbenv install 3.2.1

执行后可能得error如下：
warning: It seems your ruby installation is missing psych (for YAML output).
To eliminate this warning, please install libyaml and reinstall your ruby.
解决方法： brew install libyaml
然后在运行上面一整串代码： CFLAGS… rbenv install 3.2.1

单元测试引用问题

1.关闭当前的工作空间
2.删除掉文件夹中的workspace
3.然后重新pod install
4.通过workspace打开工作空间，clean+build即可

rm -rf MyProject.xcworkspace
pod install

在pod install之前，请确保已经执行pod setup命令。
本质实际就是： Header Search Paths Library Search Paths
将要引用的‘库’名称替换下面代码对应的位置

Targets->ProjectTests->Build Settings->找到path
复制下面的路径，替换最后面的AFNetworking，改成你要引用的‘三方库名称’。

Header Search Paths

$(inherited) "${PODS_ROOT}/Headers/Public" "${PODS_ROOT}/Headers/Public/AFNetworking"

Library Search Paths

$(inherited) "${PODS_CONFIGURATION_BUILD_DIR}/AFNetworking"

参考的链接

（本篇工具链部分参考林永坚的课程，整体思路是从课程来，具体的细节是自己实践后的结果）
MacOS 配置Ruby环境安装 Cocoapods
2023最新cocoaPods、Homebrew、RVM、Ruby 安装教程
M1电脑上升级Ruby
Homebrew - Error: Failed to upgrade Homebrew Portable Ruby
单元测试无法引用CocoaPods的三方库问题
系统理解 Ruby 工具链环境
CocoaPods安装方法 (M1芯片)-完美安装成功

更新ruby后的打印（ brew upgrade ruby ）
By default, binaries installed by gem will be placed into:
/usr/local/lib/ruby/gems/3.3.0/bin

You may want to add this to your PATH.

ruby is keg-only, which means it was not symlinked into /usr/local,
because macOS already provides this software and installing another version in
parallel can cause all kinds of trouble.

If you need to have ruby first in your PATH, run:
echo ‘export PATH=“/usr/local/opt/ruby/bin:$PATH”’ >> ~/.zshrc

For compilers to find ruby you may need to set:
export LDFLAGS=“-L/usr/local/opt/ruby/lib”
export CPPFLAGS=“-I/usr/local/opt/ruby/include”

For pkg-config to find ruby you may need to set:
export PKG_CONFIG_PATH=“/usr/local/opt/ruby/lib/pkgconfig”

国宝大人
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
anaconda 配置不同版本cuda方法
LMM_AI的博客
06-19 6981
方法1：在系统用软连接 方法2：在anaconda中独立设置运行环境 https://bluesmilery.github.io/blogs/a687003b/ 方法3：再尝试是否可以配置anaconda自带的cuda,暂时还不知道怎么弄
史上最详细的CocoaPods安装教程(图文)
09-01
2. **CocoaPods/Core**：核心Gem包，处理Podfile和podspecs文件，提供与CocoaPods相关文件的解析和管理。 3. **CocoaPods/Xcodeproj**：这个组件专门处理Xcode项目文件，可以创建和修改.xcodeproj和.xcworkspace，...
CocoaPods安装和使用教程
国宝大人的专栏
02-10 730
两篇文章：介绍比较详细，并且我一步步的验证过的。（点击下面两个标题） 1.用CocoaPods做iOS程序的依赖管理(唐巧） 2.CocoaPods安装和使用教程（code4) 下面是“链接2”的具体内容（图片可能会有问题） （Code4App 原创文章：http://code4app.com/article/cocoapods-install-usage） 目录
mac 教程 安装cocoapod(100%成功)试过无数次
热门推荐
weixin_38716347的博客
05-15 3万+
一直觉得自己写的不是技术，而是情怀，一个个的教程是自己这一路走来的痕迹。靠专业技能的成功是最具可复制性的，希望我的这条路能让你们少走弯路，希望我能帮你们抹去知识的蒙尘，希望我能帮你们理清知识的脉络，希望未来技术之巅上有你们也有我。 安装步骤：经过我多次的安装 做完下面的10就能完成。不行网络问题或者电脑问题。 现在开始安装 0.打开电脑的隐藏文件。defaults write com.apple.Finder AppleShowAllFiles YES;KillAll Finder（需要重启文件夹才能看
mac cocoapods安装失败，ruby版本过低
最新发布
风雨无阻 http://blog.csdn.net/ShineOrRain
04-28 374
macOS Sonoma 版本14.4。7.重新安装cocoapods。2.安装ruby2.7.4。3.修改系统ruby版本。
mac安装cocoapods完整步骤
wangyuhong2267的博客
03-18 7541
1、安装pods需要依赖 ruby 环境，而安装 ruby 你需要借助工具 rvm，rvm是用来管理 ruby 版本的，也就是说你的电脑上可以安装多个不同版本的 ruby 可以使用 rvm 来管理他们。这里注意最好去Homebrew官网copy命令，因为命令可能会改变，官网地址：https://brew.sh，安装过程如果遇到什么问题，自行百度不做过多讲解，因为你遇到的问题网上已经有铺天盖地的解决方案了，基本上遇到的问题都是因为访问不到网站或者下不到资源。1、安装Homebrew。
【Mac】安装cocoapods
weixin_45625639的博客
06-17 1808
【Mac】安装cocoapods
mac 11 安装cocoapods
fulai0_0的专栏
06-12 1501
解决："系统偏好设置"->"安全性与隐私"->"通用" 标签，在 "允许从以下位置下载的应用" 部分，选择 "App Store 和被验证的开发者"；再执行cocoapods的安装命令，虽然没有报错，但是执行pod的时候，提示“command not found: pod”说明还是没有安装成功的。此时，运行以下命令，在输出中查找 "EXECUTABLE DIRECTORY"，这是 gem 可执行文件所在的路径。配置完环境变量后，再运行cocoapods的安装命令，即安装成功。修改cocoapods的镜像。
详解2016 cocoapods的安装和使用以及版本升级遇到的问题
08-31
在安装CocoaPods之前，确保你的Mac系统已经预装了Ruby环境，可以通过在终端输入`ruby -v`来检查当前Ruby版本。接下来，你可以开始安装CocoaPods。通常，使用以下命令进行安装： ```bash sudo gem install cocoapods...
iOS cocoaPods 安装步骤
09-27
在Mac上面， 快速安装Ruby ，以便iOS项目中使用CocoaPods（通过XCode 管理项目中引入的三方类）。包括RVM的安装、Ruby版本设置、下载和安装CocoaPods、以及cocoaPods的简单使用
CocoaPods：可可依赖管理器
02-03
安装和更新CocoaPods非常容易。 不要错过《和《 。 项目目标 CocoaPods旨在改善第三方开源Cocoa库的参与度和可发现性。 这些项目目标影响并推动了CocoaPods的设计： 创建和共享库，并在您自己的项目中使用它们，而...
cocoaPods使用
11-15
首先确保你的系统中安装了Ruby环境，Mac系统一般已预装。如果需要更新Ruby，可以在终端执行`gem update --system`。由于CocoaPods的官方源可能在中国大陆访问受限，推荐使用淘宝的Ruby镜像。在终端执行： 1. `gem ...
如何安装homebrew，cocoapods
Coulnaut的博客
08-18 3136
博文内容1. homebrew和gem2. homebrew安装2.1 国内镜像安装3. cocoapods3.1 cocoapods安装3.2 cocoapods的简单使用 1. homebrew和gem Homebrew简称brew，是Mac OSX上的软件包管理工具，能在Mac中方便的安装软件或者卸载软件。相当于Linux听的yum、apt-get等软件管理工具。 RubyGems简称gem，RubyGems是一个包管理框架，提供了ruby社区的gem的托管服务，用于ruby软件包的下载、安装、使
最新版的 MacOS Catalina 的 CocoaPods 安装步骤 pod install/pod update 更新慢等问题
03-23 4875
当你开发iOS应用时，会经常使用到很多第三方开源类库，比如JSONKit，AFNetWorking等等。如果使 用他们，传统的方法是，在git上把他们下载下来，然后去配置。这个工作很繁琐，而且也容易出错。不 过有了Cocoapods你就会从这些繁琐的工作中解脱出来。
Mac安装使用Cocoapods（2022版本）
weixin_46926959的博客
08-23 1843
Cocoapods
搭建iOS开发环境
零丁若叹
04-04 4310
1.准备 当前移动开发主要分为安卓开发和iOS开发，安卓是谷歌在2007年宣布开源的移动操作系统，iOS是苹果2007年发布的。两个系统出现的时间大致相同，在随后的十年间引领了移动开发浪潮。如今各种移动开发技术层出不穷，一些跨平台的技术也相继出现，比如React Native，Flutter等，但目前仍然没有取代Native开发的地位，在一些核心页面依然采用的Native方式开发，所以Native开发依然是必备的技能。如果想入门移动开发，安卓和iOS两者都是不错的选择，本篇文章介绍iOS开发的搭建。iOS开
ios开发教程(一)开发环境搭建
dm569263708的专栏
05-06 4877
简单ios的开发入门，从新建项目到完成简单的UI界面，再到在虚拟手机里面运行APP
mac安装cocoapods（新旧版本系统）
Yeira的博客
03-26 3971
mac安装cocoapods：新旧版本系统（gem&brew安装）
Mac OS Homebrew 安装 cocoapods
zhjm76557707的博客
03-08 1098
在终端中运行以下命令以安装 Homebrew。验证 cocoapods 是否已成功安装。验证 Homebrew 是否已成功安装。安装 CocoaPods。
mac m1安装cocoapods
10-11
在 M1 芯片的 Mac 上安装 CocoaPods，可以按照以下步骤进行： 1. 打开终端应用程序。 2. 运行以下命令来安装 Homebrew： ``` /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" ``` 3. 运行以下命令来安装 CocoaPods： ``` arch -x86_64 sudo gem install ffi arch -x86_64 sudo gem install cocoapods ``` 4. 运行以下命令来创建一个别名，以便在终端中更轻松地使用 CocoaPods： ``` echo 'alias pod="arch -x86_64 pod"' >> ~/.zshrc source ~/.zshrc ``` 这样就可以在 M1 芯片的 Mac 上安装和使用 CocoaPods 了。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值