iOS之-CocoaPods安装使用详细

一、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 /项目文件


截屏2020-02-2508.41.57.png

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.这个错误


image.png

解决方法:

sudo gem install -n /usr/local/bin cocoapods
image.png

可以使用此命令查看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
取消代理.png

我也是从网上搜的,差不多就这两步骤就可以换源了
纵昂.png

分享两个不错的文章学习,与君共勉之:哈哈
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,

不定时更新哈!!!

你可能感兴趣的:(iOS之-CocoaPods安装使用详细)