基于CocoaPods的iOS项目模块化实践

什么是CocoaPods？

CocoaPods is a dependency manager for Swift and Objective-C Cocoa projects. It has over ten thousand libraries and can help you scale your projects elegantly. - 摘录自CocoaPods.org

在CocoaPods出现之前，iOS项目中引用第三方库的方式是非常原始的，要么是把源代码拷贝到主工程中，要么是通过静态库引入.a文件，然后还要修改一系列的build settings。后续的第三方库的升级也是个枯燥乏味的事情，总之如果你的iOS项目目前还是这样管理第三方库，那么你们还处在石器时代。

CocoaPods通过集中式的管理，可以非常有效的管理第三方库，甚至可以用于大型项目的模块化管理，非常优雅高效的解决iOS项目中的依赖管理。

安装CocoaPods

CocoaPods是一个Ruby Gem，因为直接访问RubyGem速度非常慢，建议先替换成淘宝镜像

$ gem sources --remove https://rubygems.org/  $ gem sources -a https://ruby.taobao.org/

安装CocoaPods

$ sudo gem install cocoapods

管理第三方库

创建Podfile

在项目根目录下创建Podfile，下面是一个Podfile的例子 (详情可以参考http://guides.cocoapods.org/syntax/podfile.html#podfile)：

platform :ios, '9.0'    target "MyApp" do    pod 'ObjectiveSugar', '~> 0.5'      target "MyAppTests" do      pod 'OCMock', '~> 2.0.1'    end  end

platform: 可以指定平台的信息和deployment target的版本

target: 可以根据不同的target来引入不同的pod

pod: 引入依赖库

pod 'SSZipArchive'  -- 引入最新版本

pod 'Objection' , '0.9'  -- 引入特定的版本

pod  'Objection' ,  '>0.9' > -- 任何大于0.9的版本

pod  'Objection' ,  '>=0.9' > -- 任何大于等于0.9的版本

pod  'Objection' ,  '<0.9' > -- 任何小于0.9的版本

pod  'Objection' ,  '<=0.9' > -- 任何小于等于0.9的版本

pod  'Objection' ,  '~>0.9' > -- 任何介于0.9到1.0的最新版本，不包含1.0

pod 'AFNetworking' , :path => '~/Documents/AFNetworking'  -- 使用本地路径引入

pod 'AFNetworking' , :git => 'https://github.com/gowalla/AFNetworking.git' , :tag => '0.7.0'  -- 使用git库引入

pod 'JSONKit' , :podspec => 'https://example.com/JSONKit.podspec'  -- 使用外部的podspec来引入

安装Pods

安装pods

$ pod install

更新pods

$ pod update

install和update的区别：假如使用 pod 'SVProgressHUD'，没有指定版本。使用pod install，如果Pods中存在SVProgressHUD，则直接使用。使用pod update，则会保证更新SVProgressHUD到最新版本。

install或update速度通常很慢，因为每次执行的时候都需要同步一下CocoaPods Specs，这个有几百兆的大小，同步一次非常耗时。所以如果你使用的第三方库并不是经常更新，则不用经常更新那个Specs库。可以使用以下命令：

$ pod install --verbose --no-repo-update  $ pod update --verbose --no-repo-update

执行完install或者update命令后，就可以使用.xcworkspace打开项目。

使用CocoaPods管理私有库

大型项目模块化管理

随着iOS APP越来越复杂，功能越来越多，对于iOS项目的工程化要求也越来越高了，对于复杂的APP一般都需要对项目进行模块化管理。

模块化有几个方式：

1. 目录结构管理：这是最原始的方式，仅仅通过目录结构实现代码层次的清晰化。但本质上并没有解决代码之间的依赖混乱的情况，模块化划分也非常不清晰。

2. 子工程：通过子工程可以实现代码依赖管理和模块化，但是需要引入复杂的设置，不利于管理。

3. 静态库：将依赖代码打包成为静态库.a，不过由于不能看到源码，调试不方便。

自从有了CocoaPods，可以使用它来管理私有库，从而实现了代码模块化管理。例如下图所示：

CocoaPods私有库

1. 创建私有的Specs git库

例如在github上面创建一个空的git库：https://github.com/xxx/MySpecs

将这个git库加入到CocoaPods库的列表中：

$ pod repo add MySpecs git@github.com:xxx/MySpecs.git

此时可以检查下本地的pod repo

 $ pod repo list    MySpecs

- Type: git (master)    - URL: git@github.com:xxx/MySpecs.git

- Path: /Users/xxx/.cocoapods/repos/mySpecs

master

- Type: git (master)

- URL:  git@github.com:CocoaPods/Specs.git

- Path: /Users/xxx/.cocoapods/repos/master

确定私有库的Specs已经加到本地pod repo中。

2.在私有库项目中创建podspec文件

在私有库项目中的根目录，创建对应的podspec文件，里面会描述这个库的基本信息。

PodSpec规范可以查看： https://guides.cocoapods.org/syntax/podspec.html

#  #  Be sure to run `pod spec lint PodName.podspec' to ensure this is a  #  valid spec and to remove all comments including this before submitting the spec.  #  To learn more about Podspec attributes see http://docs.cocoapods.org/specification.html  #  To see working Podspecs in the CocoaPods repo see https://github.com/CocoaPods/Specs/  #  Pod::Spec.new do |s|    s.name         = "PodName"    s.version      = "0.0.1"    s.summary      = "A short description of PodName."    s.homepage     = "http://github.com/xxx/PodName"    s.license      = { :type => "MIT", :text => <<-LICENSE      Copyright © 2016年 xxx. All rights reserved.      LICENSE       }    s.author       = { "" => "" }    s.source       = { :git => "git@github.com:xxx/PodName.git", :tag => "0.0.1" }    s.source_files = "**/*.{h,m,mm,c}"    s.frameworks   = "Foundation", "QuartzCore", "UIKit", "WebKit"    s.libraries    = "z"       s.dependency 'AFNetworking'    s.ios.deployment_target = '6.0'  end

resource: 可以指定资源文件，建议使用bundle以避免资源文件产生冲突。

frameworks: 指定这个pod依赖的系统framework

libraries: 指定这个pod依赖的系统动态库。注意使用的名字：比如需要引用"libz.dylib", 那么这里只需要写"z"

无论原始项目的目录结构或者group结构，默认的pod里面的代码都会平铺在根目录里面

注意：SubSpecs之间不能存在相互依赖关系，只能单向依赖

3. 验证私有库的合法性

$ pod lib lint --sources='git@github.com:xxx/MySpecs.git' --verbose --use-libraries --allow-warnings

sources参数可以指定私有库的Pod Specs库的地址。如果能够通过，说明代码编译没有问题。

4. 提交私有库的版本信息

$ git tag -m "first release" "0.0.1"  $ git push --tags     #推送tag到远端仓库

5.向Spec Repo提交podspec

$ pod repo push MySpecs PodName.podspec --sources='git@github.com:xxx/MySpecs.git' --use-libraries --allow-warnings