CocoaPods的使用

1.安装和更新

更换为国内源

  • gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/
  • gem sources -l

RubyGems的升级(如果可以用就不用升级)

  • sudo gem update --system
    或者(Mac OSX 10.11之后)
    sudo gem update -n /usr/local/bin —system

安装CocoaPods

  • sudo gem install cocoapods
    或者(Mac OSX 10.11之后)
    sudo gem install -n /usr/local/bin cocoapods
  • 如果升级到新的gem,会出现文件夹无法访问的error可以尝试
    sudo gem install -n /usr/local/bin cocoapods --pre

更换第三方库源(感觉新的gem不能换源,用默认的源也可以)

  • 默认的源为https://github.com/CocoaPods/Specs.git
    可以通过pod repo -list 来查看
    以下命令是删除默认源再添加国内的源,但我试了删除后无法添加,提醒用pod setup恢复之前的源。所以这一步可以跳过,不用换源。
  • pod repo remove master
  • pod repo add master https://gitcafe.com/akuandev/Specs.git

初始化第三方库信息

  • pod setup

更新第三方库信息(以后要更新时使用)

  • pod repo update

2.为iOS项目添加CocoaPods管理库

  1. 查找自己需要添加的第三方库
    pod search + 库名
    如输入:pod search AFNetworking 后,等待返回所有符合搜索条件的结果。可以直接利用的是:pod 'AFNetworking', '~> 3.1.0'

  2. 找到项目文件路径
    在终端输入cd+空格,然后拖动项目文件夹到终端,自动生成路径。

  3. 创建并编辑Podfile文件(可以终端操作,也可以直接手动操作)
    终端输入:vim podfile
    编辑文件,没有文件就自动在当前目录添加一个文件再编辑。
    输入内容
    platform :ios, '8.0'
    target “target名称” do
    pod 'AFNetworking', '~> 3.1.0'
    end
    按Esc退出编辑,然后按Shift +冒号,输入wq退出文件编辑。

  4. 为项目导入第三方库和相关依赖库
    终端输入:pod install
    然后耐心等待下载第三方库,如果文件大,可能要花长时间。终端会打印进度的。

  5. 至此,添加已经完成。可以看到项目目录里面多了4个文件,以后运行工程都使用.xcworkspace文件,而不再用.xcodeproj了。

3. 移除CocoaPods

  1. 编辑Podfile文件,清除里面所有库,然后终端输入:pod install。这时会清空第三方库和相关依赖库。
  2. 删除之前的4个文件,Podfile、Podfile.lock、Pods文件夹和.xcworkspace文件。
  3. 然后打开.xcodeproj,删除项目中的libpods.a和Pods.xcconfig引用。
  4. TARGETS - Build Phases 删除有关pods的选项,至此完成删除。

4.常见问题

  1. Error fetching http://ruby.taobao.org/:bad response Not Found 404 (http://ruby.taobao.org/specs.4.8.gz)
    说明:链接不到Ruby淘宝源,常见的[404错误],可能因为https替换http了。
    所以gem sources -a http://ruby.taobao.org/ 需要替换成:gem sources -a https://ruby.taobao.org/

  2. ERROR: While executing gem ... (Errno::EPERM)Operation not permitted - /usr/bin/update_rubygems
    说明:Mac OSX 10.11不能使用sudo gem update —system了,
    需要替换成:sudo gem update-n /usr/local/bin —system

  3. ERROR: While executing gem ... (Errno::EPERM)Operation not permitted - /usr/bin/pod
    说明:Mac OSX 10.11不能使用sudo gem install cocoapods了,
    需要替换成:sudo gem install -n /usr/local/bin cocoapods

  4. [!] Unable to add a source with url [https://github.com/CocoaPods/Specs.git](https://github.com/CocoaPods/Specs.git) named master-1. You can try adding it manually in ~/.cocoapods/repos or via pod repo add.
    说明:由于安装了多个Xcode导致路径变了,需要变换路径:sudo xcode-select -switch /Applications/Xcode6.4/Xcode.app

  5. The dependency `` is not used in any concrete target
    说明:Podfile升级之后到1.0.0版本,Pod里的内容必须明确指出所用第三方库的target,
    所以在podfile文件需要明确:
    target “YOUR_TARGRT_NAME” do
    ...
    end

你可能感兴趣的:(CocoaPods的使用)