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

前端之家收集整理的这篇文章主要介绍了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以上

$ 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



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

猜你在找的Swift相关文章