Osheep

时光不回头,当下最重要。

Cocoapods私有库的完整二进制化方案

前言

假设你已经非常熟练的使用cocoapods来管理私有库,并且实现了组件化的APP设计模式。这篇文章将会帮助你将私有库编译成二进制文件,这样做的好处是会大大缩短编译工程的时间.

目标

我们当前最重要的目标是将私有库编译成二进制文件,但是也有诸多限制条件:

  • 尽量做到不修改原来私有库的所有版本的任何代码
  • 在任何时候都可以随意切换源码和二进制文件,以方便调试
  • 所依赖的第三方库不参与二进制

步骤

新建私有Cocoapods库

这里我将新建一个示例的私有库工程,对制作私有Cocoapods库不是非常了解的,可以去先看看其他文章.

$ pod lib create CCDemoLib

按照提示信息依次填写选项,完成之后Xcode会被自动打开到CCDemoLib的pod工程.删除pod目录下的ReplaceMe.m文件.
这里,我将建立两个子库.一个CCUICCNetwork,一个CCDemo.h的头文件.该头文件用来导入所有子库的头文件.CCDemoLib.podspec文件如下:

Pod::Spec.new do |s|
  s.name             = 'CCDemoLib'
  s.version          = '0.1.0'
  s.summary          = '一个测试二进制化的私有库'
  s.description      = '一个测试二进制化的私有库'
  s.homepage         = 'https://github.com/zhahao/CCDemoLib'
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { 'zhahao' => '506902638@qq.com' }
  s.source           = { :git => 'https://git.coding.net/zhahao/CCDemoLib.git', :tag => s.version.to_s }
  s.ios.deployment_target = '8.0'

  s.source_files = 'CCDemoLib/Classes/CCDemo.h'

  s.subspec 'CCNetwork' do |ss|
     ss.source_files = 'CCDemoLib/Classes/CCNetwork/**/*'
    ss.dependency 'AFNetworking', '~> 2.3'
  end

  s.subspec 'CCUI' do |ss|
    ss.source_files = 'CCDemoLib/Classes/CCUI/**/*'
    ss.dependency 'SDWebImage', '~> 4.1.0'
  end

end

执行pod install,安装完成之后的目录结构是这样的:

《Cocoapods私有库的完整二进制化方案》

目录结构

我们将工程推到远程Git仓库

➜  CCDemoLib git:(master) ✗ git add origin https://git.coding.net/zhahao/CCDemoLib.git
➜  CCDemoLib git:(master) ✗ git add .
➜  CCDemoLib git:(master) ✗ git commit -m 'init project'
➜  CCDemoLib git:(master) git push origin master

发布到私有索引库

添加完tag,推到索引库,这里其实不需要验证的,如果有错误,自然也就推送不进去.等几分钟…

➜  CCDemoLib git:(master) git tag 0.1.0
➜  CCDemoLib git:(master) git push --tags
➜  CCDemoLib git:(master) pod repo push CCPodSpec CCDemoLib.podspec --allow-warnings

然后,成功了~ 到此,我们就发布了一个正常的私有库.

二进制化

上面是铺垫,主角还是二进制化私有库

生成framework

直接上图:

《Cocoapods私有库的完整二进制化方案》

新建一个framework类型的target
《Cocoapods私有库的完整二进制化方案》

选择framework
《Cocoapods私有库的完整二进制化方案》

编辑scheme
《Cocoapods私有库的完整二进制化方案》

选择release模式
《Cocoapods私有库的完整二进制化方案》

在Build Settings里面
《Cocoapods私有库的完整二进制化方案》

在Build Settings里面
《Cocoapods私有库的完整二进制化方案》

删除
《Cocoapods私有库的完整二进制化方案》

将下面的直接拖到CCDemoBinary文件夹下
《Cocoapods私有库的完整二进制化方案》

在Build Phases下,将头文件全部拖到public下
《Cocoapods私有库的完整二进制化方案》

选真机的,不要模拟器

修改podfile文件

《Cocoapods私有库的完整二进制化方案》

WX20170930-222316.png

执行 ‘pod install’,等安装完成之后,编译刚才的CCDemoBinarytarget,找到CCDemoBinary.framework,位置如下:

《Cocoapods私有库的完整二进制化方案》

WX20170930-222609.png

右键show in finder 找到CCDemoBinary.framework文件,选Release-iphoneos文件夹里面的那个.

《Cocoapods私有库的完整二进制化方案》

WX20170930-222731.png
《Cocoapods私有库的完整二进制化方案》

在pod文件夹下面

至此,framework已经搞定了,接下来我们要去修改CCDemoLib.podspec文件

修改CCDemoLib.podspec

之前说过,我们需要随时切换源码和二进制文件,所以我们可以利用环境变量来处理这两种情况

$ CCDemoLib_Source=1 pod install

CCDemoLib_Source就是设置了一个环境变量,在.podspec文件中,可以使用ENV['CCDemoLib_Source']来获取

修改之后的CCDemoLib.podspec文件

Pod::Spec.new do |s|
  s.name             = 'CCDemoLib'
  s.version          = '0.1.0'
  s.summary          = '一个测试二进制化的私有库'
  s.description      = '一个测试二进制化的私有库'
  s.homepage         = 'https://github.com/zhahao/CCDemoLib'
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { 'zhahao' => '506902638@qq.com' }
  s.source           = { :git => 'https://git.coding.net/zhahao/CCDemoLib.git', :tag => s.version.to_s }
  s.ios.deployment_target = '8.0'


if ENV['CCDemoLib_Source'] || ENV['AllLib_Source']
    s.source_files = 'CCDemoLib/Classes/CCDemo.h'
    s.subspec 'CCNetwork' do |ss|
        ss.source_files = 'CCDemoLib/Classes/CCNetwork/**/*'
        ss.dependency 'AFNetworking', '~> 2.3'
    end

    s.subspec 'CCUI' do |ss|
        ss.source_files = 'CCDemoLib/Classes/CCUI/**/*'
        ss.dependency 'SDWebImage', '~> 4.1.0'
    end
else
    s.source_files = 'CCDemoLib/Classes/**/*.h'
    s.vendored_frameworks = 'CCDemoLib/Products/CCDemoBinary.framework'
    s.dependency 'AFNetworking', '~> 2.3'
    s.dependency 'SDWebImage', '~> 4.1.0'
end

end

中间的if...else...end的逻辑中AllLib_Source环境变量的意思是所有私有库判断,CCDemoLib_Source是当前的私有库判断.

当设置环境变量为true,那么,我们这个pod库的source_filesdependency都是引用源码.否则,我们就将source_files全部设置为头文件.并且设置vendored_frameworks为刚才拖进来的framework,第三方库全部为依赖关系,也就是全部为源码.

  • 当我想让所有私有库显示源码,只需要设置AllLib_Source=1
  • 当我们指定某一个私有库为源码,其他都为二进制,只需要设置CCDemoLib_Source=1
  • 当我们想让所有私有库都是二进制,那么就什么环境变量都不设置

测试工程的framework私有库的结构目录如下:

《Cocoapods私有库的完整二进制化方案》

二进制的私有库文件目录结构

可以看到,所有的.m文件全部没有了.
自此,我们就完成了大部分工作.最后就是要将修改后的所有文件提交到Git远程仓库和pod索引库.

提交修改,更新索引库

git提交修改:

➜  CCDemoLib git:(master) ✗ git add .
➜  CCDemoLib git:(master) ✗ git commit -m '二进制化该私有库'
➜  CCDemoLib git:(master) git push origin master

删除之前的tag

➜  CCDemoLib git:(master) git tag
0.1.0
➜  CCDemoLib git:(master) git tag -d 0.1.0
➜  CCDemoLib git:(master) git push origin :0.1.0

设置新的同名tag并提交

➜  CCDemoLib git:(master) git tag 0.1.0
➜  CCDemoLib git:(master) git push --tags

提交新的索引库

➜  CCDemoLib git:(master) pod repo push CCPodSpec CCDemoLib.podspec --allow-warnings

等几分钟成功之后,可以查看一下索引库是否更新了该版本的.podspec文件.

到此为止,我们所有的操作都没有修改源码,也实现了我们之前的三个限制.

清除缓存

由于pod update的原理是先从缓存中读取,即Podfile.lock文件,由于我们没有修改私有库的版本号,所以我们需要先清空缓存,让索引库重新从远程拉取.podspec文件. 所以,当你每次二进制化一个私有库成功之后,都需要清空缓存,不然执行pod install之后都是源码,而不是二进制文件.

➜  CCDemoLib git:(master) pod cache clean --all

使用

在你的APP主工程里面,执行pod install或者pod update:

  • $ CCDemoLib_Source=1 pod update 只安装了CCDemoLib私有库为源码
  • $ pod update 安装了所有私有库为二进制
  • $ AllLib_Source=1 pod update 安装了所有私有库为源码

我们新建了一个测试主工程CocoapodsBinary

platform :ios, '8.0'

use_frameworks!

source 'https://git.coding.net/zhahao/CCPodSpec.git'
source 'https://github.com/CocoaPods/Specs.git'


target 'CocoapodsBinary' do
  pod 'CCDemoLib'
end

执行pod install,完成之后pod目录结构上如下:

《Cocoapods私有库的完整二进制化方案》

目录结构

自此,我们就彻底完成了私有库的二进制!

下一期,我将使用fastlane来简化一些流程,避免做一些重复的操作和可能带来的操作失误.

点赞