[绍棠] Carthage使用心得-让自己的项目支持Carthage

CocoaPods

　　CocoaPods发展到现在基本上已经是ios开发的标准依赖工具 我们只需要安装好pod后在项目中新建一个Podfile文件并且写入你需要的三方框架,在pod install后即可完成配置,具体使用网上有很多教程,我这里就不多赘述.

Carthage

Carthage的目标是用最简单的方式来管理Cocoa第三方框架

　　Carthage也是一个比较好用的三方框架管理工具,原理是自动帮你把工程编译为Dynamic framework(动态库),仅支持iOS8以上,相比Cocoa pods对项目更无侵入性

你可以使用Homebrew来安装Carthage 安装完homebrew后执行下面命令 $ brew update $ brew install carthage

在你的工程里创建一个Cartfile文件 ,并在里面写上类似下面这句话

github "cwxatlm/MXScrollView"

执行

$ carthage update

　　它会在你的工程目录里生成一个Carthage的文件夹,里面有帮你自动生成的framework,大多数说的都是直接把framework拖到工程里就可以使用,但我的貌似这样直接使用不了,具体的往下看 CocoaChina上有一篇非常好的Carthage入门文章,基本百度Carthage的第一个就是

让你的项目支持Carthage

　　什么东西都是开头难,如同一开始把我想把自己的开源代码发布到pods一样,也是各种查资料,最后成功trunk到pods服务器,然后自己pod下载传上去的开源框架然后使用时,那个成就感确实是满满的. 　　那么,怎么样让自己的的项目支持Carthage呢,一开始,我也不知道从何入手,然后我又是到处找资料,推酷上的这一篇使用Carthage发布Framework确实帮了我大忙,让我知道了该如何入手. 　　下面是我的实现方法.

让已有工程支持Carthage

你可以这样做. 　　首先,假如你已经有一个MyCarthage项目(该项目管理在Github上)

一般你会有一个头文件，这个头文件的作用是导入所有需要用到的文件

工程目录.png

MyCarthageView.h里面的方法是你要暴露的，现在里面有一个方法 - (NSString *)getCarthageSkill 这个方法是你提供给外界调用的

MyCarthage.png

这个MyCarthage的框架我们已经写好了，下一步就是framework了

创建一个framework

新建一个target

新建一个target.png

选择framework,命名为MyCarthageFramework 他会自带一个MyCarthageFramework.h的文件,这个文件的作用是告诉其他人我们引用了哪些头文件,我们不要它自动生成的文件,删除MyCarthageFramework.h

选择framework.png

配置你的framework

1.选择你的工程2.选择framework所在的Target3.选择Build Phases4.点击Header左下角的+号把你要暴露的头文件添加到Public里面（默认添加到Project里面，用鼠标把它拽过去）5.在Compile source里面添加实现的.m文件 配置工程1.png

在framework的BuildSettings的Packaging里面,把Produce Module Name 和 Produce Name改成MyCarthage

配置工程2.png 如果你使用了类别,那么你需要在Build Settings的Linking的Other Linker Flags里加上-all_load如果你想你的工程支持bitcode,需要在Other C Flags 里加上-fembed-bitcode

分享你的工程

选择 Manager Schemes

分享工程1.png

勾上shared(这样Carthage就可以编译你的工程)

分享工程2.png

　　到这里,基本上你已经成功了,那么我们来验证一下,我相信到这里你已经安装好了Carthage了(什么?并没有?...那你先去装一个先吧...),安装好Carthage后,我们cd到项目文件夹,运行

$ carthage build --no-skip-current

... 　　命令运行完成后,你会发现你的项目文件夹里面多了一个Carthage文件夹 　　Carthage->Build->iOS->MyCarthage.framework! 　　各位小伙伴们,我们需要的framework,它就这么出来了,好,下面我们来新建一个工程,测试一下看能否正确运行. ... 新建一个test工程,两种方式导入

1.

把framework拖进去,点击3个copy,然后导入头文件

然后在　target->Build Phases ->左上角+号 ->New Copy Files Phase 然后在Copy Files下 Destination选择Frameworks ->添加你自己的动态库 .

我们首先编译一下,没报错

导入framework.png

2.

1).还是先把framework拖进自己文件夹(如果framework和工程同属一总文件夹这一步可以省略,拖进来复制主要是保证这个framework不会丢失,如自己的项目使用了Carthage,"Cartahge"文件夹就在工程目录里,其实不用再拖一遍) 2).在工程目录目录下的->General(向下滑动少许)->Embedded Binaries->点左下角+号添加刚才的framework(如果直属目录下没有就点击Add Other去相应目录下添加)

Embedded Binaries.png

编译效果如上一种方式

以上两种方式也适用于你自己使用Carthage中的framework

　　ok,我们来运行一下

控制台.png

Good!控制台成功的打印了我们需要的信息,我们成功了,别慌,要给别人使用的话你还需要最后一步,给你的工程打上tag,push上去（记得要把工程shemes的配置文件也勾上push上去） 例如

$ git tag 1.0.0 $ git push --tags

以上对于创建自己的可共享动态库教程已结束