Cocoa pods的安装和使用详解

如何制作自己的开源库，请参考

原理

CocoaPods的原理,它是将所有的依赖库都放到另一个名为Pods项目中,然后 让主项目依赖Pods项目,这样,源码管理工作都从主项目移到了Pods项目中

• 1、Pods项目最终会编译成一个名为libPods.a的文件,主项目只需要依赖这个.a 文件即可。
• 2、对于资源文件,CocoaPods提供了一个名为Pods-resources.sh的bash脚本, 该脚本在每次项目编译的时候都会执行,将第三方库的各种资源文件复制到目 标目录中。
• 3、CocoaPods通过一个名为Pods.xcconfig的文件来在编译时设置所有的依赖和 参数。
• 注意
  • 关于.gitignore
    当你执行pod install之后,除了Podfile外,CocoaPods还会生成一个名为 Podfile.lock的文件,你不应该把这个文件加入到.gitignore中。因为Podfile.lock 会锁定当前各依赖库的版本,之后如果多次执行pod install 不会更改版本,要 pod update才会改Podfile.lock了。这样多人协作的时候,可以防止第三方库升 级时造成大家各自的第三方库版本不一致。

常用指令

1.pod install --no-repo-update(禁止索引更新操作)

  pod update --no-repo-update
2.pod serach:`pod search AFNetworking`
3.pod outdated:`检查各第三方库是否有更新`
4.pod init:自动生成一个podfile文件并初始化
5.vim 编辑模式,输入i进入编辑,按ESC退出编辑,按:,输入wq回到控制台

可能遇到的问题

（1）使用cocoapods导入第三方类库后头文件没有代码提示？
解决办法： 选择Target -> Build Settings 菜单，找到\”User Header Search Paths\”设置项，新增一个值"${SRCROOT}"，并且选择\”Recursive\”

（2）出现如下警告
[!] Your Podfile has had smart quotessanitised. To avoid issues in the future, you should not use TextEdit forediting it. If you are not using TextEdit, you should turn off smart quotes inyour editor of choice.
解决办法：不要使用文本编辑去编辑Podfile，使用Xcode编辑，或者使用终端敲命令去编辑。

(3) 执行pod install 或pod update 命令后，updating local specsrepositories 卡住不动
解决办法：pod install 被墙了，换成新的命令pod install --verbose --no-repo-update

(4) 项目运行时报错：Thefile “Pods.xcconfig” couldn’t be opened because there is no such file.
解决办法：pod update就可以了

1.先升级Gem

    sudo gem update --system
2.切换cocoapods的数据源

    【先删除，再添加，查看】
    gem sources --remove https://rubygems.org/
    gem sources -a https://ruby.taobao.org/
    gem sources -l
3.安装cocoapods

    sudo gem install cocoapods
    或者（如10.11系统）sudo gem install -n /usr/local/bin cocoapods
    
4.将Podspec文件托管地址从github切换到国内的oschina

    【先删除，再添加，再更新】
    pod repo remove master
    pod repo add master https://gitcafe.com/akuandev/Specs.git
    pod repo update
5.设置pod仓库

    pod setup
6.测试

    【如果有版本号，则说明已经安装成功】
    pod --version
7.利用cocoapods来安装第三方框架

    01 进入要安装框架的项目的.xcodeproj同级文件夹
    02 在该文件夹中新建一个文件podfile
    03 在文件中告诉cocoapods需要安装的框架信息
        a.该框架支持的平台
        b.适用的iOS版本
        c.框架的名称
        d.框架的版本
8.安装
pod install --no-repo-update
pod update --no-repo-update

9.说明
platform :ios, '8.0' 用来设置所有第三方库所支持的iOS最低版本
pod 'SDWebImage','~>2.6' 设置框架的名称和版本号
格式参照最新版本, ------------pod init中标准格式
版本号的规则：
'>1.0'    可以安装任何高于1.0的版本
'>=1.0'   可以安装任何高于或等于1.0的版本
'<1.0'    任何低于1.0的版本
'<=1.0'   任何低于或等于1.0的版本
'~>0.1'   任何高于或等于0.1的版本，但是不包含高于1.0的版本
'~>0'     任何版本，相当于不指定版本，默认采用最新版本号

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


11 . 注意苹果系统升级OS X EL Capitan后改为$sudo gem install -n /usr/local/bin cocoapods, 要在指令前面加上sudo,会提醒输入密码,然后安装        

Cocoapods指令

Usage:

    $ pod COMMAND

      CocoaPods, the Cocoa library package manager.

Commands:

    + cache         Manipulate the CocoaPods cache
    + deintegrate   Deintegrate CocoaPods from your project.
    + env           Display pod environment
    + init          Generate a Podfile for the current directory.
    + install       Install project dependencies to Podfile.lock versions
    + ipc           Inter-process communication
    + lib           Develop pods
    + list          List pods
    + outdated      Show outdated project dependencies
    + plugins       Show available CocoaPods plugins
    + repo          Manage spec-repositories
    + search        Search for pods.
    + setup         Setup the CocoaPods environment
    + spec          Manage pod specs
    + trunk         Interact with the CocoaPods API (e.g. publishing new
                    specs)
    + try           Try a Pod!
    + update        Update outdated project dependencies and create new
                    Podfile.lock

Options:

    --silent        Show nothing
    --version       Show the version of the tool
    --verbose       Show more debugging information
    --no-ansi       Show output without ANSI codes
    --help          Show help banner of specified command