cocoapod是ios开发时常用的包管理工具
1.M1或者是M2系统安装cocoapods先操作一下两个设置
1、打开访达->应用->实用工具->终端->右键点击终端->显示简介->勾选使用 Rosetta 打开,关闭终端,重新打开。
2、打开访达->应用->Xcode->右键点击Xcode->显示简介->勾选使用 Rosetta 打开,关闭Xcode,重新打开。
mac系统已经默认安装好Ruby环境,如果你不确定自己系统中是否有Ruby的,可以在终端中输入命令行:ruby -v查看当前ruby版本
如果ruby版本较低,可以通过rvm对Ruby进行升级
$ sudo gem update --system
2、更换Ruby镜像
首先移除现有的Ruby镜像
终端输入:$ gem sources --remove https://rubygems.org/
然后添加国内最新镜像源
终端输入:$ gem sources -a https://gems.ruby-china.com/(org 暂时不能使用官方推荐使用com)
执行完毕之后输入gem sources -l来查看当前镜像
如果结果是*** CURRENT SOURCES ***
https://gems.ruby-china.org/
说明添加成功,否则继续执行$ gem source -a https://gems.ruby-china.org/
来添加
3、CocoaPods的安装
$ sudo gem install -n /usr/local/bin cocoapods
等上十几秒钟,CocoaPods就可以在你本地下载并且安装好了,不再需要其他设置。
4、CocoaPods的使用
1)CocoaPods的搜索功能
pod search AFNetworking;
执行后可能会一直停在
Setting up CocoaPods master repo然后(很久)会出现如下错误:
[!] Failed to connect to GitHub to update the CocoaPods/Specs specs repo - Please check if you are offline, or that GitHub is down
解决办法是:
这说明CocoaPods还不能正常使用,需要更新pod,下载它的一些依赖包;在终端中输入:
$ pod setup
过一段时间之后,你会在终端中看到跟上面同样的红色的错误信息。
这说明某些环境原因导致pod更新不了,可能原因有,1)gem版本太低;2)github无法链接;3).cocoapods目录下的配置信息错误。我们可以一个一个来排除,
首先更新gem到最新版本,在终端中输入:
$ sudo gem update --system
可以只接继续进行安装:sudo gem install -n /usr/local/bin cocoapods
或者是检查是否可以ping通github,在终端中输入:
$ ping github.com
然后查看pob repo list:
$ pod repo list
说明Cocoapods在将它的信息下载到~/.cocoapods里;
cd到该目录里,用du -sh *命令来查看文件大小,结果显示0 repos,说明没有安装成功;
在终端输入:
cd ~/.cocoapods
进入cocoapods文件后在终端输入:du -sh *
重新执行pod setup,过一段时间后提示setup completed,在终端中输入pod list,展示出安装列表;
这样总算安装好了。接下来再一次输入:
pod search AFNetworking
输入过后它可能会报:
[!] Unable to find a pod with name, author, summary, or descriptionmatching `AFNetworking`
解决方案是:
输入:
rm ~/Library/Caches/CocoaPods/search_index.json
后在一次输入:pod search AFNetworking
就可以咯。
2)首先定位到项目文件目录
cd 项目位置
然后添加podfile文件:vim podfile (注:在写该文件的时候要注意格式 ' ' );
进入后按i进入插入模式,进行编辑,安装官方最新的文档格式:
platform :ios, '8.0'
target '你的项目名称' do
pod 'AFNetworking', '~> 3.0'
end
编辑完成后,按ESC退出编辑模式,最后输入:wq保存并退出文件,此时可以发现在项目目录下多了一个Podfile的文件,请注意这个文件必须与.xcodeproj在同一目录下,
最后:pod install进行安装即可
3)CocoaPods库的跳过更新安装
pod install --verbose --no-repo-update(跳过更新进行安装)
pod update --verbose --no-repo-update(跳过更新进行更新
如果你是M1或者M2芯片的Mac,还需要做以下操作:
1.访达-应用程序-实用工具里,右键点击终端-显示简介 (如果找不到实用工具,请以列表或分栏的方式显示项目)
2.勾选使用Rosetta打开
3.执行sudo gem install ffi
如下提示异常
xxx ~ % sudo gem install -n /usr/local/bin cocoapods
ERROR: Error installing cocoapods:
The last version of activesupport (>= 5.0, < 8) to support your Ruby & RubyGems was 6.1.7.3. Try installing it with `gem install activesupport -v 6.1.7.3` and then running the current command again
解决:sudo gem install activesupport -v 6.1.7.3
备注: sudo 使用系统权限,防止ruby permissions问题