Swift 中通过Cocoapods使用OC第三方库
这是本人第一次写博客，作为一个比较年长的猿人，这说起来确实不怎么光彩，真是丢人啊，但是林子大，什么样的猿人都有，我就是这样的一个懒猿人！言归正传，下面开始说说我的情况：
本人长期以来一直钟情OC开发，进来深感Swift要高潮，一则自己某天失业，出门找工作，估计人家问起我是否懂Swift，我都不好意思回答。SO，我也来试试这牛逼的L！
情况：
首先，我在网上下载了一个开源的Swift语言开发的Demo，人家在项目中其实已经设置好了桥接的头文件，但是ta没有使用pod来管理ta用到的第三方库，这时，本人习惯了pod，所以，建立好了pod文件，最后成功的pod install了我需要的第三方类库，但是如何使用第三方库中的头文件呢，这个我一下子就懵逼了！最后，本着不懂就问问那个好心的娘，度娘给出的答案几乎都是在桥接文件中import我们的pod中的第三方库的头文件，比如：
#import "AFNetworking.h"
#import "UIView+Toast.h"
#import "FMDB.h"
#import "MJRefresh.h"
我也他们所愿的做了，可是连天都跟我作对，xxx file not found! 报错报得梆梆响！我也一段时间内百思不得其姐，后来本人灵光一现，终于知道花儿为何这样红了：我没有设置User Header Search Path，后来我就来了一个暴力的$(PODS_ROOT)，路径查找方式设置成了recursive，如图：
头文件搜索目录设置图???????? 上图的设置虽然可以成功的让你成为一个懒货，但是你会发现你的程序的编译时间明显边长了很多，特别是你的第三方库比较多的时候！
???????? 如果有人跟我一样是新手，我也顺手说下，桥接文件的设置。正常情况下，我们的顺序应该是这样的：新建工程--创建桥接文件。但是我这个懒人懒的都没有心思去试验这个步骤了，我直接就在别人的项目上进行的，也就是说我失去了xcode好心提示我们创建桥接文件的那个步骤，怎么办，我好捉鸡！在捉了很久的鸡以后，我也捉出经验了，自己新建一个就是呗，步骤如下：
第一步、新建头文件，名字随便取，也让自己做主一次，位置可以随便放（简单的话，你就直接放到工程下的第一级），如图：
新建桥接头文件在这里我就直接给这个头文件取名为“Bridge-Header.h”,然后我们去找到工程的Build Setting，在搜索输入框中输入bridge，你可以看到下图：
查找桥接文件的路径设置图在上图中的设置也可以修改成：${SRCROOT}/Bridge-Header.h，如果你的桥接文件在某个路径下的话，就用：${SRCROOT}/目录1/目录2/Bridge-Header.h。
设置好了以后，我们就可以在Bridge-header.h中import我们的类库头文件就可以了。如下图：
桥接文件中导入OC头文件剩下的就改怎么着就怎么着了，如下图：
swift类中调用Pod管理的第三方代码图祝大家有一个美好的猿人生涯！
起因
去年，公司iOS端，之前由于所有的业务端代码都是混乱管理，造成开发有很多痛点无法单测，团队成员提交代码冲突机率大，CI配合效果差，功能性代码多端无法复用，单仓库代码量大，编译时间长 等等痛点，领导和组内多次沟通开始着手组件化开发，希望能改进这些开发中的痛点，成立组件化团队。
组件化的方案大同小异，基础性代码封装私有库，业务组件交互交由中间件负责，项目依赖工具用iOS项目事实上的标准CocoaPods
前期的基础性组件拆分都较为顺利，从依赖树的叶子节点开发是最合适的方案。
随着组件抽离的越来越多，私有库的依赖体系也越来越复杂，慢慢过渡到了业务组件。业务组件用了Swift的第三方组件，用了Swift库的同学都知道必须加上use_frameworks!，这个标记是说Pod管理的依赖全部编译为动态库，然后呢我们的很多组件又依赖了诸如百度地图，微信分享等静态库，于是我在执行 pod install 报了一个没有碰见过的错误。
[!]The'Pods-LJA_Example'targethastransitivedependenciesthatincludestaticbinaries:复制代码这就尴尬了，于是一阵疯狂的搜索google stackoverflow等，然而并没有什么卵用，而且上面催得急，根本没时间处理这些小问题 业务重构是最主要的，以至于我们的业务组件没有做到独立仓库拆分。
直到最近终于找到了解决办法:( 主要是自己的功力不够深厚）
理论功底
动态库和静态库
介绍
首先静态库和动态库都是以二进制提供代码复用的代码库
静态库 常见的是 .a动态库常见的是 .dll(windows)，.dylib(mac)，so(linux)framework(in Apple): Framework 是Cocoa/Cocoa Touch程序中使用的一种资源打包方式，可以将代码文件、头文件、资源文件、说明文档等集中在一起，方便开发者使用。也就是说我们的 framework其实是资源打包的方式，和静态库动态库的本质是没有关系的静态库和动态库的区别
静态库: 链接时会被完整的复制到可执行文件中，所以如果两个程序都用了某个静态库，那么每个二进制可执行文件里面其实都含有这份静态库的代码
动态库: 链接时不复制，在程序启动后用dyld加载，然后再决议符号，所以理论上动态库只用存在一份，好多个程序都可以动态链接到这个动态库上面，达到了节省内存(不是磁盘是内存中只有一份动态库)，还有另外一个好处，由于动态库并不绑定到可执行程序上，所以我们想升级这个动态库就很容易，windows和linux上面一般插件和模块机制都是这样实现的。
But我们的苹果爸爸在iOS平台上规定不允许存在动态库，并且所有的 IPA 都需要经过苹果爸爸的私钥加密后才能用，基本你用了动态库也会因为签名不对无法加载，(越狱和非 APP store 除外)。于是就把开发者自己开发动态库掐死在幻想中。
直到有一天，苹果爸爸的iOS升级到了8，iOS出现了APP Extension，swift编程语言也诞生了，由于iOS主APP需要和Extension共享代码，Swift语言的机制也只能有动态库，于是苹果爸爸尴尬了，不过这难不倒我们的苹果爸爸，毕竟我是爸爸，规则是我来定，我想怎样就怎样，于是提出了一个概念Embedded Framework，这种动态库允许APP和APP Extension共享代码，但是这份动态库的生命被限定在一个APP进程内。简单点可以理解为被阉割的动态库。
举个例子，iOS项目中使用Embeded Framework
如果你把某个自己开发的动态库(系统的不算，毕竟苹果是爸爸)放在了Linked Frameworks and Libraries里面，程序一启动就会报Reason: Image Not Found，你只能把它放在Embeded Binaries里面才能正常使用，
看图:
静态库和动态库如何构建和加载
简单点，说话的方式简单点~~
上面的介绍貌似有点抽象啊套用在美团技术分享大会上的话就是:
静态库: 一堆目标文件(.o/.obj)的打包体(并非二进制文件)动态库: 一个没有main函数的可执行文件这里我们来复习下C语言的基本功，编译和链接
编译: 将我们的源代码文件编译为目标文件链接: 将我们的各种目标文件加上一些第三方库，和系统库链接为可执行文件。由于某个目标文件的符号(可以理解为变量，函数等)可能来自其他目标文件，其实链接这一步最主要的操作就是决议符号的地址。
若符号来自静态库(本质就是.o 的集合包)或 .o，将其纳入链接产物，并确定符号地址若符号来自动态库，打个标记，等启动的时候再说---交给dyld去加载和链接符号于是链接加装载就有了不同的情况
Load 装载：将库文件载入内存Static Loading：启动时
Dynamic Loading：启动后（使用时）
Link 链接：决议符号地址Static Linking：构建（链接）时
Dynamic Linking：运行时（启动时或使用时）
然后组合起来就是 2 * 2=4 了
Static Loading + Static LinkingStatic Loading + Dynamic LinkingDynamic Loading + Dynamic Linking~~Dynamic Loading + Static Linking~~第一种是纯静态库相关了
第二种就是静态加载(启动时)，动态链接，链接时，动态库参与链接，但是这时候只是给符号打了标记告诉我这个符号来自与动态库，程序启动时，iOS或者Mac OS操作系统的dyld自动load + link。
既然全部都是自动的。那么符号的调用方完全不知道你到底是源码还是静态库，动态库 。
第三种收到调用dlopen + performSelector通常iOS的APP不适用这里不讨论
第四种，没见过，个人也不是特别懂
有需求请参看文后的程序员的自我修养一书
静态库和动态库依赖关系
既然有 2 种库，那么依赖关系又是 2 * 2 喽
libA.a dependency libB.aUIKit.dylib dependency Foundation.dyliblibA.a dependency Foundation.dylibMyXX.dylib dependency libA.a第一种 静态库互相依赖，这种情况非常常见，制作静态库的时候只需要有被依赖的静态库头文件在就能编译出来。但是这就意味者你要收到告诉使用者你的依赖关系
幸运的是CocoaPod就是这样做的
第二种动态库依赖动态库，两个动态库是相互隔离的具有隔离性，但是制作的静态库的时候需要被依赖动态库参与链接，但是具体的符号决议交给dyld来做。
第三种，静态库依赖动态库，也很常见，静态库制作的时候也需要动态库参与链接，但是符号的决议交给dyld来做。
第四种，动态库依赖静态库，这种情况就有点特殊了。首先我们设想动态库编译的时候需要静态库参与编译，但是静态库交由dyld来做符号决议，but这和我们前面说的就矛盾了啊。静态库本质是一堆.o 的打包体，首先并不是二进制可执行文件，再者你无法保证主程序把静态库参与链接共同生成二进制可执行文件。这就尴尬了。
怎么办？
目前的编译器的解决办法是，首先我无法保证主程序是否包含静态库，再者静态库也无法被dyld加载，那么我直接把你静态库的.o 偷过来，共同组成一个新的二进制。也被称做吸附性
那么我有多份动态库都依赖同样的静态库，这就尴尬了，每个动态库为了保证自己的正确性会把静态库吸附进来。然后两个库包含了同样的静态库，于是问题就出现了。 看到这里想必前面出现的错误你已经能猜出来了把~_~
后面再详细解释
先来个总结
可执文件（主程序或者动态库）在构建的链接阶段
遇到静态库，吸附进来遇到动态库，打标记，彼此保持独Xcode 项目结构
target：对于一个产物(app,.a ,.framework)project：一个项目包含多个 targetworkspace: 一个包含多个 targetschema: 指定了一个产物是按照何种的依赖关系，编译-链接到最终的一个产物iOS 依赖管理事实上的标准
这么多年，Apple的博客和文档也就告诉了我们什么是静态库什么是动态库，如何制作等。但是并没有给我们提供一系列的依赖管理工具。所以CocoaPods成了事实上的标准。
通常CocoaPods管理的工程结构如下:
那么当我们按下CMD + B的时候，整个项目按照先编译被依赖Pod，然后依赖其他Pod的Pod也被构建出来，最终所有的组件被编译为一个lib-Pods-XXXAPP.a被添加进项目进去。资源通过CocoaPods提供的脚本也一并被复制进去。想了解CocoaPods做了什么的读者可以参看后面的链接
解决问题
这么多理论功底的建立，相信我们已经能分析出来之前pod install的原因了。就是用了use_framework那么我们的所有Pod都会以动态库(Embeded Framework)的形式去构建，于是那些非开源的库(如百度地图，微信分享)如果被多个Pod依赖(组件化开发中太常见了)于是被吸附到动态库里面，所以CocoaPod直接就不让我们install成功。因为你现在的依赖管理就是错误的。
在听取美团叶樉老师分享的时候 他们的出发点是因为要绕过苹果爸爸在iOS9以下对__text 段60M的限制使用了动态库方案，我们是因为某些swift库必须要用到(历史遗留原因)动态库。美团的做法是摘除依赖关系，自定义CocoaPods(开源的本来就是用着不爽我就改)。但是我是个小菜鸡啊。我也不会 ruby(以后会学的)，但是叶樉老师给我提了别的idea。前面我们知道 动态库和动态库是隔离性，动态库依赖静态库具有吸附性，那么我们可以自定义一个动态库把百度地图这种静态库吸附进来。对外整体呈现的是动态库特性。其他的组件依赖我们自定义的动态库，由于隔离性的存在，不会出现问题。
制作动态库
1 创建动态库项目这里以 wx 举例
2 按照微信的官方文档。添加依赖库(我是因为pod install巨慢所以我直接拽进来了)
3 将wx的PublicHeader暴露出来，注意由于我并没有使用到wx相关API所以链接器帮我们链接动态库的时候可能并不会把wx静态库吸附进来。我们手动在build Setting的other link flags加上-all_load标记
4.在Schema里面跳转编译配置为Release，并且选择所有的CPU架构
5 然后选择模拟器或者 Generic iOS Device 运行编译就会生成对应版本的 Framework 了。
6.但是为了保证开发者使用的时候是真机模拟器都能正常使用，我们需要合并不同架构
这里在Build Phases里添加以下脚本，真机和模拟器都Build一遍之后就会在工程目录下生成Products文件夹，
if["${ACTION}"="build"]thenINSTALL_DIR=${SRCROOT}/Products/${PROJECT_NAME}.frameworkDEVICE_DIR=${BUILD_ROOT}/${CONFIGURATION}-iphoneos/${PROJECT_NAME}.frameworkSIMULATOR_DIR=${BUILD_ROOT}/${CONFIGURATION}-iphonesimulator/${PROJECT_NAME}.frameworkif[-d"${INSTALL_DIR}"]thenrm-rf"${INSTALL_DIR}"fimkdir-p"${INSTALL_DIR}"cp-R"${DEVICE_DIR}/""${INSTALL_DIR}/"#ditto"${DEVICE_DIR}/Headers""${INSTALL_DIR}/Headers"lipo-create"${DEVICE_DIR}/${PROJECT_NAME}""${SIMULATOR_DIR}/${PROJECT_NAME}"-output"${INSTALL_DIR}/${PROJECT_NAME}"open"${DEVICE_DIR}"open"${SRCROOT}/Products"fi复制代码于是我们有了我们自己的私有动态库LJWXSDK，那么我们来验证我们之前的问题
首先指定一个LJWXSDK.podspec这里我直接传到了我的Github上面
##Besuretorun`podliblintLJPod.podspec'toensurethisisa#validspecbeforesubmitting.##Anylinesstartingwitha#areoptional,buttheiruseisencouraged#TolearnmoreaboutaPodspecseehttp://guides.cocoapods.org/syntax/podspec.html#Pod::Spec.newdo|s|s.name='LJWXSDK's.version='0.1.0's.summary='AshortdescriptionofLJWXSDK.'s.description=<'MIT',:file=>'LICENSE'}s.author={'ValiantCat'=>'519224747@qq.com'}s.source={:http=>'http://onk2m6gtu.bkt.clouddn.com/LJWXSDK.framework.zip'}s.ios.deployment_target='8.0's.default_subspec='zip's.subspec'zip'do|zip|puts'-------------------------------------------------------------------'puts'Notice:LJWXSDKiszipnow'puts'-------------------------------------------------------------------'zip.ios.vendored_frameworks='*.framework'endend复制代码注意上面我是把二进制压缩丢进了七牛的 oss 文件存储。毕竟免费还快。
然后通过 pod lib create 创建了一个 pod 用来验证之前我们的传递性依赖问题，
文件夹结构如下
.├──Example│├──LJA││├──Base.lproj│││├──LaunchScreen.storyboard│││└──Main.storyboard││├──Images.xcassets│││└──AppIcon.appiconset│││└──Contents.json││├──LJA-Info.plist││├──LJA-Prefix.pch││├──LJAppDelegate.h││├──LJAppDelegate.m││├──LJViewController.h││├──LJViewController.m││├──en.lproj│││└──InfoPlist.strings││└──main.m│├──LJA.xcodeproj│├──LJA.xcworkspace│├──Podfile│├──Podfile.lock│├──Pods││├──Headers││├──LJWXSDK│││└──LJWXSDK.framework│││├──Headers││││├──LJWXSDK.h││││├──WXApi.h││││├──WXApiObject.h││││└──WechatAuthSDK.h│││├──Info.plist│││├──LJWXSDK│││├──Modules││││└──module.modulemap│││├──_CodeSignature││││└──CodeResources│││└──read_me.txt││├──Local\Podspecs│││├──LJA.podspec.json│││├──LJB.podspec.json│││└──LJWXSDK.podspec.json││├──Manifest.lock││├──Pods.xcodeproj│││├──project.pbxproj│││├──project.xcworkspace││├──Target\Support\Files│││├──LJA││││├──Info.plist││││├──LJA-dummy.m││││├──LJA-prefix.pch││││├──LJA-umbrella.h││││├──LJA.modulemap││││└──LJA.xcconfig│││├──LJB││││├──Info.plist││││├──LJB-dummy.m││││├──LJB-prefix.pch││││├──LJB-umbrella.h││││├──LJB.modulemap││││└──LJB.xcconfig│││├──Pods-LJA_Example││││├──Info.plist││││├──Pods-LJA_Example-acknowledgements.markdown││││├──Pods-LJA_Example-acknowledgements.plist││││├──Pods-LJA_Example-dummy.m││││├──Pods-LJA_Example-frameworks.sh││││├──Pods-LJA_Example-resources.sh││││├──Pods-LJA_Example-umbrella.h││││├──Pods-LJA_Example.debug.xcconfig││││├──Pods-LJA_Example.modulemap││││└──Pods-LJA_Example.release.xcconfig│││└──Pods-LJA_Tests│││├──Info.plist│││├──Pods-LJA_Tests-acknowledgements.markdown│││├──Pods-LJA_Tests-acknowledgements.plist│││├──Pods-LJA_Tests-dummy.m│││├──Pods-LJA_Tests-frameworks.sh│││├──Pods-LJA_Tests-resources.sh│││├──Pods-LJA_Tests-umbrella.h│││├──Pods-LJA_Tests.debug.xcconfig│││├──Pods-LJA_Tests.modulemap│││└──Pods-LJA_Tests.release.xcconfig││└──libWeChatSDK││├──README.md││├──WXApi.h││├──WXApiObject.h││├──WechatAuthSDK.h││└──libWeChatSDK.a├──LICENSE├──LJA│├──Assets│└──Classes│└──LJA.m├──LJA.podspec├──LJB│├──Assets│└──Classes│└──LJB.m├──LJB.podspec├──README.md└──_Pods.xcodeproj->Example/Pods/Pods.xcodeproj复制代码测试工程我也丢在7牛上面。下载测试即可
编译运行。完美。我们又可以愉快的和swift第三方库配合使用。
很多人可能会问 诸如百度地图 微信这种sdk为什么官方不支持动态库版(所说的都是embeded Framework)，猜测是为了兼容更低iOS7版本吧
很多人会觉得麻烦的要死。首先每个公司多多少少都有历史包袱，麻烦也要做，再者这是一次对基本功的补充，即便你们没有用到，但是为了学习，这篇教程所做的也值得你尝试一次。
剖析下动态库 Framework 吧
上述解决了我们一开始遇到的问题。but既然动态库和静态库压根就不一回事，所以里面还是有很多细节值得我们去了解的。
回过头来看 Embened Framework
首先我们之前记得如果一个动态库加在LinkedFrameworksand Libraies程序启动就会报ImageNotFound，如果放在EmbededBinaries里面就可以。这是为什么呢。我们拿MacoView来看下两种情况下可执行文件的细节
其中@rpth 这个路径表示的位置可以查看Xcode中的链接路径问题
这样我们就知道了其实加在EmbededBinaries里面的东西其实会被复制一份到xx.app里面，所以这个名字起得还是不错的直译就是嵌入的框架
Why Swift does not Support Staic Libraies
造成这个的主要原因是Swift的运行时库(不等同于OC的runtime概念)，由于Swift的ABI不稳定，静态库会导致最终的目标程序中包含重复的运行库，相关可以看下最后的参考文章SwiftInFlux#static-libraries。等到我们的SwiftABI稳定之后，我们的静态库支持可能就又会出现了。当然也可能不出Swift伴随诞生的SPM(Swift，Package Manager)，可能有更好的官方的包依赖管理工具。让我们期待吧。
CocoaPods使用Use_framework!
既然加了Swift的第三方库之后就需要在Podfile里面加上use_framework! 那么CocoaPods就会帮我们生成动态库，但是奇怪的是，我们并没有在主工程的embeded binaries看到这个动态库，这又是什么鬼。其实是CocoaPods使用脚本帮我们加进去了。脚本位置在主工程的build Phase下的Emded Pods frameworks
"${SRCROOT}/Pods/TargetSupportFiles/Pods-LJA_Example/Pods-LJA_Example-frameworks.sh"复制代码动态库Framework的文件结构
.├──Headers│├──LJWXSDK.h│├──WXApi.h│├──WXApiObject.h│└──WechatAuthSDK.h├──Info.plist├──LJWXSDK├──Modules│└──module.modulemap└──_CodeSignature└──CodeResources复制代码更愉快的导入文件
@class，@protocol：不说了就是声明一个类，并不导入。#import <>, #import""：是加强版的#include<>，#include"" 防止重复导入的。#import<> : 通过build setting里面中的header Search Path里面去找#import"" : 第一步先搜索user Header search Path再搜索 header search Path 。所以对我们的framework来说，CocoaPod帮我们加到了Header search Path目前2种导入方式都是可以支持的。上面的导入方式都带了 某个framework的路径"xx/xx.h" ，我们在开发自己主工程的时候会发现我们导入主工程其他类是不需要导入前缀的。 这又是怎么回事。
看下面的配置
目前的配置是non-recursive。如果把non去掉意思就是我可以递归的去查找某些framework下面的头文件了。 但是Xcode的效率肯定就会有影响。
还是不建议修改的好。
大家都知道iOS7之后多了@import，这又是什么鬼。
简单理解这个方式叫做Module导入，好处就是使用了@import 之后不需要在project setting手动添加framework，系统会自动加载，而且效率更高。
最主要的是swift也只能这样用。
导入的时候系统会查找如果有模块同名的文件就会导入这个文件。如果没有CocoaPods帮我们生成一个module-umbrela.hl文件，然后就是导入的这个文件。
回过头来看我们的framework的结构 里面有个Modules文件夹，里面有个文件module.modulemap
frameworkmoduleLJWXSDK{umbrellaheader"LJWXSDK.h"export*module*{export*}}复制代码我们可以看到其实被暴露的header就是这个文件，之前我在按照#import "/"的时候有个警告
而且按照@import 导入的东西发现没有导入可用的头文件就是因为并没有在umbrella header的头文件中加入其他头文件。
加入之后我们就可以完美的使用@import ，并且#import"/" 也不会报warning
更多关于umbrella Header 参看文后参考
资源问题
首先我们来看常见的资源文件: 主要分为图片和其他类资源那么加载图片和加载其他资源都是怎么做的？
1: [UIimage imageNamed:]
2: [NSbundle bundleForclass[XXX class]]
其实方式1去本质就是去mainBundle去拿资源，方式2从XXX所在的框架里面去拿。
前面也说道framework只是资源的打包方式，本质上是有两种的。
我们这个framework如果本质是静态库，那么无需改变使用方式，资源最终都会打包到Main Bundle里面
如果我们这个framework本质是动态库，那么我们的资源就发生了变化，资源就会被存放在framework里面。所以我们需要使[NSbundle bundleForclass[XXX class]]。需要注意的是很多人为了简单，下意
的使用self class传递，但是有可能这个self实例不在资源所属的framework。所以会出现资源加载失败。一定要谨慎使用。
总结：
动态库的podspce不能依赖静态库
发表评论