Carthage使用心得-让自己的项目支持Carthage

2016-03-27 本文已影响22865人 just_xam

三方库依赖极大的方便了我们的工程配置与管理

CocoaPods

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

Carthage

今天的猪脚出厂了!
那么,有些小猿们可能还不太清楚,这个Carthage它到底是个什么东西!
...让我们一起来看看

Carthage
英 [ˈkɑ:θidʒ]  美 [ˈkɑrθɪdʒ] 
n.
迦太基（非洲北部，今突尼斯的奴隶制城邦，腓尼基人所建，公元146年被罗马帝国所灭，见Punic Wars）
网络
迦太基古城;  迦太基遗址;  迦太基城

...以上内容来自百度翻译...

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所在的Target
3.选择Build Phases
4.点击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

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

下面我们来试一试是否成功,
ok,新建一个Cartfile文件,写上下面这句话,并执行carthage update就可以使用Carthage安装你的代码了,是不是迫不及待去试试你自己的了呢

github "cwxatlm/MyCarthageDemo"