macOS High Sierra 最新系统cocoapods安装使用及常见问题处理

cocoaPods配置

• 1.先升级Gem
  sudo gem update --system

• 2.切换cocoapods的数据源
  【先删除，再添加，查看】
  gem sources --remove https://rubygems.org/
  gem sources -a https://ruby.taobao.org/ （已停止更新）
  最新源gem sources -a https://gems.ruby-china.org/
  gem sources -l

• 3.安装cocoapods
  sudo gem install cocoapods
  如果报错
  可使用sudo gem install -n /usr/local/bin cocoapods --pre
  或者（如10.11系统）sudo gem install -n /usr/local/bin cocoapods

• 4.将Podspec文件托管地址从github切换到国内的oschina
  【先删除，再添加，再更新】
  pod repo remove master
  pod repo add master http://git.oschina.net/akuandev/Specs.git
  pod repo add master https://gitcafe.com/akuandev/Specs.git
  pod repo update

如果出现

Snip20171203_21.png

使用命令 git clone https://git.coding.net/CocoaPods/Specs.git ~/.cocoapods/repos/master

出现Setting up CocoaPods master repo，说明Cocoapods在将它的信息下载到 ~/.cocoapods里，cd 到该目录里，用du -sh *命令来查看文件大小，每隔几分钟查看一次，我的这个目录最终大小是800 M，就是完成了

• 5.设置pod仓库
  pod setup

• 6.测试
  【如果有版本号，则说明已经安装成功】
  pod --version

cocoapods来安装第三方框架

• 进入要安装框架的项目的.xcodeproj同级文件夹 cd
• 在该文件夹中新建一个文件Podfile (touch是创建) vim Podfile （编辑）
  步骤：
• 按键盘上的“i”键（需要在英文状态下）这个时候可以对Podfile文件进行编辑：
• 填写你需要的框架
  platform:ios, ‘7.0‘
  pod ‘AFNetworking‘, ‘~> 2.3.1‘
  - 在编辑完成后按“esc”， 在按“:”,这个时候输入wq,点击回车，保存并退出。
• 在文件中告诉cocoapods需要安装的框架信息
  a.该框架支持的平台
  b.适用的iOS版本
  c.框架的名称
  d.框架的版本
• 安装
  pod install --no-repo-update
  更新
  pod update --no-repo-update

pod update与pod install的区别

• pod install 会参照Podfile.lock文件里面的第三方库的版本号来安装

  
  
  

  Snip20171203_3.png

• pod update 会参照Podfile里面的文件来安装第三方库，由于里面的库文件没有版本号，pod update会安装最新的库，当你和小伙伴用的库版本差距较大的时候你们的API差距较大会造成未知的问题

  
  
  

  Snip20171203_4.png

• 说明
  最新PodFile格式
  platform :ios, '8.0’ 用来设置所有第三方库所支持的iOS最低版本

#use_frameworks!个别需要用到它，比如reactiveCocoa 在OC中影响不大 但是在Swift中一定要用

target 'MyApp' do
pod 'AFNetworking', '~> 2.6’ 设置框架的名称和版本号
pod 'ORStackView', '~> 3.0’
pod 'SwiftyJSON', '~> 2.3’
end

platform :ios, '8.0' 用来设置所有第三方库所支持的iOS最低版本
pod 'SDWebImage','~>2.6' 设置框架的名称和版本号

版本号的规则：
'>1.0' 可以安装任何高于1.0的版本
'>=1.0' 可以安装任何高于或等于1.0的版本
'<1.0' 任何低于1.0的版本
'<=1.0' 任何低于或等于1.0的版本
'~>0.1' 任何高于或等于0.1的版本，但是不包含高于1.0的版本
'~>0' 任何版本，相当于不指定版本，默认采用最新版本号

使用pod install命令安装框架后的大致过程：

• 分析依赖:该步骤会分析Podfile,查看不同类库之间的依赖情况。如果有多个类库依赖于同一个类库，但是依赖于不同的版本，那么cocoaPods会自动设置一个兼容的版本。
• 下载依赖:根据分析依赖的结果，下载指定版本的类库到本地项目中。
• 生成Pods项目：创建一个Pods项目专门用来编译和管理第三方框架，CocoaPods会将所需的框架，库等内容添加到项目中，并且进行相应的配置。
• 整合Pods项目：将Pods和项目整合到一个工作空间中，并且设置文件链接。

pod search 搜索不到库解决方案

执行pod setup

在终端输入pod setup,会出现Setting up CocoaPods master repo，等几分钟，会输入Setup completed，说明pod setup执行成功。

• 结果pod search还是失败

在终端输入pod search AFN依然还是提示
Unable to find a pod with name, author, summary, or descriptionmatching 'AFN'。

1.删除~/Library/Caches/CocoaPods目录下的search_index.json文件

2.pod setup成功后会生成~/Library/Caches/CocoaPods/search_index.json文件。

3. 终端输入rm ~/Library/Caches/CocoaPods/search_index.json 删除成功后再执行pod search

4.执行pod search

终端输入：pod search AFN输出：Creating search index for spec repo 'master'.. Done!，稍等片刻就会出现所有带AFN字段的类库出现。

后续遇到问题会继续更新。
敬请拍砖，战争也是促进交流的一种方式。更希望您能喜欢