一、CocoaPods简介
CocoaPods是iOS开发、macOS开发中的包依赖管理工具,效果如Java中的Maven,nodejs的npm。
CocoaPods是一个开源的项目,源码是用ruby写的,源码地址在GitHub上。
二、安装CocoaPods
安装CocoaPods比较方便。通常情况下,macOS都安装了ruby,直接使用ruby 的gem命令即可安装CocoaPods。
使用如下命令可以查看有没有安装ruby:
// 如果能正确的输出版本号,则说明ruby已经正确安装
ruby --version
使用如下命令可以查看gem的版本号:
// 该命令会输出gem的版本号
gem --version
如果gem的版本号过低,安装CocoaPods可能会失败。所以在安装CocoaPods之前可以升级一下gem,使用如下命令:
// 更新gem
sudo gem update --system
另外需要注意的是,ruby的软件源https://rubygems.org 使用的是亚马逊云的服务,国内普通网络是不能访问的。如果不能访问,可以将ruby的源换成国内淘宝的源,命令如下:
gem sources --remove https://rubygems.org/
gem sources -a https://ruby.taobao.org/
操作完后,可以验证下更换源是否成功,命令如下:
// 如果只有一个淘宝的源,说明更换源成功
gem source -l
以上所有工作都完成之后,现在可以安装CocoaPods了,命令如下:
// 安装CocoaPods
sudo gem install cocoapods
安装成功后,在使用之前,还需要对CocoaPods初始化,命令如下:
// 这一步花费的时间比较久,耐心等待即可
pod setup
测试一下CocoaPods有没有安装成功:
// 如果能正确显示版本号,说明CocoaPods安装成功
pod --version
三、使用CocoaPods安装第三方库
1、打开终端命令 cd /项目文件
2、在该目录下新建一个Podfile文件,可以使用命令
touch Podfile
3、编辑Podfile文件。vim podfile
vim Podfile
编辑内容
platform :ios, '10.0'
target 'ZongRequestTest' do
pod 'SDWebImage'
end
4、安装所依赖的第三方库。安装使用的方式是命令行,在该目录下执行下述命令即可:
pod install
四、安装时遇到的问题
sudo gem install cocoapods
的时候出现 While executing gem ... (Gem::FilePermissionError)
You don't have write permissions for the /usr/bin directory.这个错误
解决方法:
sudo gem install -n /usr/local/bin cocoapods
可以使用此命令查看pod版本,是否安装成功
pod --version
五、报错:Failed to connect to 127.0.0.1 port 1080: Connection refused
这是由于设置了动态代理,这个问题是我在换源的时候出现的,特分享解决方法
git查看
// 查询动态代理
git config --global http.proxy //可以查看当前动态代理地址
git config --global https.proxy
若是有返回值
// 取消代理
git config --global --unset http.proxy //
git config --global --unset httpx.proxy
分享两个不错的文章学习,与君共勉之:哈哈
CocoaPods 镜像使用帮助
CocoaPods 换源 git 安装 与 使用
2021-6-28 更新
一、使用清华镜像更新pod install
source 'https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git’
platform :ios, '10.0'
target 'QiNiuYInShiPin' do
use_frameworks!
pod 'MBProgressHUD'
pod 'Masonry'
pod 'MJRefresh'
pod 'HyphenateChat'
pod 'SDWebImage'
pod 'AgoraRtcEngine_iOS'
pod 'FMDB'
pod 'EaseCallKit'
pod 'EaseIMKit'
end
二、PCH文件操作
一、PCH文件配置项
将pch文件拖进第三步弹出的框里面,pch的文件路径就会被填进去,但是这是绝对路径,如果你把项目移到另外一个地方,就会报错,找不到pch文件,所以需要把它转为相对路径。例如绝对路径格式:/Users/lixue/Desktop/项目名/项目名/PrefixHeader.pch,转化为相对路径,如下格式$(SRCROOT)/项目名/PrefixHeader.pch,
#pragma mark - $(SRCROOT) 相对路径
查看pch路径
将pch文件拖进第三步弹出的框里面,pch的文件路径就会被填进去,但是这是绝对路径,如果你把项目移到另外一个地方,就会报错,找不到pch文件,所以需要把它转为相对路径。例如绝对路径格式:/Users/lixue/Desktop/项目名/项目名/PrefixHeader.pch,转化为相对路径,如下格式$(SRCROOT)/项目名/PrefixHeader.pch,
不定时更新哈!!!