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

　　作为一个新时代的程序员,与时俱进(自以为)是我们的本职工作,作为程序员的我们更是要不停的学习新的知识.

　　依稀记得我刚开始接触iOS的时候,使用三方框架时,那被各种添加framework和各种工程配置所支配时的恐惧.举个栗子,在我初学时,我们需要用到FMDB这个框架,那么在当时,我们需要拷贝FMDB(是的,当时直接就是从教我的那个人那里拷的),然后手动拖入到工程中,然后运行...duang..duang..duang...程序没运行起来,一竖条红字,拖动xcode的问题条一眼看不到底.

CocoaPods

　　CocoaPods,不得不说,这个东西,真的好用

　　当你开发iOS应用时，会经常使用到很多第三方开源类库，比如JSONKit，AFNetWorking等等。可能某个类库又用到其他类库，所以要使用 它，必须得另外下载其他类库，而其他类库又用到其他类库，“子子孙孙无穷尽也”.自从有了Cocoapods,我们再也不用做这些繁杂的工作,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以上

• 你可以使用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确实帮了我大忙,让我知道了该如何入手.
　　但是这篇文章说的是新建一个framework工程,然后把自己原来的代码丢进去,这就让我感觉有点麻烦了,因为我的代码已经写好了,是用git管理,如果新建一个工程,然后我在上传,岂不是要把我原来的工程给删了然后重新push?哎呀,感觉好麻烦啊.

让已有工程支持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工程,并且把framework拖进去,点击3个copy,然后导入头文件

导入framework.png

　　可以正常导入,也可以正常编写代码并且编译通过,我们距离成功运行只有一步之遥了.好,command + R...Go!
...
???what happen?!

运行出错.png

　　这...什么情况,这搞了半天不是白搞了,难道是小编我上述哪个步奏弄错了？我尝试着Carthage了一些成熟的开源框架如AFNetWorking和SVProgressHUD,发现依旧报这个错误,这我就有点费解了,看来不是我们的原因
　　不过和我们码农的好朋友百度交流了一番之后,找到了这个问题的解决办法,错误发生原因不详,我感觉可能还是调用时没找到正确的路径？(希望有高人帮我解答一番)

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

　　ok,我们再来运行一下

控制台.png

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

$ git tag 1.0.0

$ git push --tags

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

github "cwxatlm/MyCarthageDemo"

上面的例子我放在github上了,需要的朋友可以自行去看
MyCarthageDemo

重点

咳咳咳,推荐一下自己写的一个小功能模块,MXScrollView,希望喜欢的朋友可以顺手点个Star,您的Star就是我最大的动力！
传送门MXScrollView

demo2GIF.gif

文／just_xam（简书作者）
原文链接：http://www.jianshu.com/p/bf263c596538
著作权归作者所有，转载请联系作者获得授权，并标注“简书作者”。