Carthage安装与使用(2018.12.4更新)

一、Carthage的安装

先简单介绍两种安装方法,都是官方给的,一个是下载 pkg 文件安装,特简单。另一个是使用 brew 安装,需要使用命令行先安装 brew。如果只是为了使用Carthage,那就使用第一种即可。

第一种:使用 pkg 文件安装

1.1 下载地址:https://github.com/Carthage/Carthage/releases

下载完成后,双击安装即可,简单方便。

1.2 检查版本,如果有版本号, 证明安装成功

carthage version

我更新这篇文章时版本为0.31.2,如果你的版本大于等于此版本,那么,Carthage已经安装完成,可以跳过第二种安装,直接看下面的使用即可。

第二种 使用homebrew安装

2.0 安装Xcode Command Line Tools

xcode-select --install

如果已经安装了,会报错,显示already installed。

2.1 先安装homebrew,两步

2.1.1 使用下面命令行安装homebrew
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
2.1.2 更新brew,保证版本最新
brew update

显示Already up-to-date.就是最新版的 brew 了。

2.2 再安装Carthage,两步

2.2.1 使用homebrew安装Carthage
brew install carthage
2.2.2 检查版本,如果有版本号, 证明安装成功
carthage version

我更新这篇文章时版本为0.31.2,如果你的版本大于等于此版本,那么,Carthage已经安装完成,直接看下面的使用即可。

二、Carthage的使用

3.配置Carthage在项目中使用

3.1创建Carthage文件

3.1.1 方法一:命令行创建
  1. 在命令行中使用cd命令到你的项目所在文件夹路径
cd /Users/allen_qin/test/我的测试app

小技巧:打开teminal终端,敲入cd命令后,敲一下空格键,然后将项目文件所在的文件夹直接拽进终端,就显示路径了,此时回车即可。

  1. 用touch命令创建Cartfile文件,保证跟你的项目在统一文件夹下
touch Cartfile
  1. 因为这个文件需要提交git或者svn版本管理,而且为了便于编辑,可以拽进Xcode项目中,填写需要的git库,用版本管理工具管理
3.1.2 方法二:用Xcode创建Cartfile文件
  1. 直接用Xcode创建一个空白文件,起名为Cartfile,存储位置为与项目.xcodeproj同一个文件夹
  2. 直接在Xcode中编写库文件即可

简单说明~>的意思:更详细的可以参考这篇文章

  • >= 1.0 代表 “最低 1.0版本”
  • ~> 1.0 代表 “表示使用版本1.0以上但是低于2.0的最新版本,如1.5, 1.9”
  • == 1.0 代表 “必须是 1.0 版本”
  • 直接使用branch等分支名称:例如
 github "Alamofire/Alamofire"                ~> 4.0
  • 一般你去git上找到git库的说明文档时,都会给出建议版本,复制粘贴即可

3.2 在项目中使用Carthage

3.2.1 下载git库并编译成framework
  1. 在命令行中使用cd命令到你的项目所在文件夹:(我的测试app.xcodeproj文件所在的文件夹),同步骤3.1.1。确保你用ls命令可以看到Carthage文件,如图:


    image
  2. 在终端内输入更新命令下载git库文件即可,可以加上平台限制如--platform iOS
carthage update --platform iOS
  1. 等着Carthage下载并编译你的git库,根据你库的多少和库本身的体积大小,时间会不同,编译完成后终端会提示,如图:
    image

提示:
如果升级了Xcode版本,例如从Xcode8升级到Xcode9,或者从beta1升级到beta2,需要重新执行一次上面的更新命令,否则会报下面的错误,如图:


image
  1. 编译完成后会在项目文件夹下自动生成Carthage文件夹和一个Cartfile.resolved文件,第三方库的源码文件和framework文件就在Carthage的Checkout文件夹下,如图:


    image
  2. 注意:Cartfile和Cartfile.resolved两个文件需要提交到git或svn,如图


    image

3.2.2 配置Xcode

最后一步了,这一步是配置一下Xcode项目文件,因为Carthage是号称无侵入性的管理框架,所以不会修改你到Xcode项目的任何内容,所以这里需要自己手动设置一下Xcode项目,以便于使用Carthage

  1. 添加framework,很简单,如图点+号按钮


    image

    选择Add Other


    image

    找到编译好的framework文件,点击Open
    image

    项目中就添加好了


    image
  2. 配置脚本,很简单,复制好下面的命令,看图一步步来就行:
/usr/local/bin/carthage copy-frameworks
  1. 添加运行脚本,点击+号后选择New Run Script Phase


    image
  2. 将刚才复制的命令粘贴到黑框中,覆盖掉原来的内容,并且在Input Files和Output Files中按照格式填写\

inputfiles

$(SRCROOT)/Carthage/Build/iOS/Result.framework

outputfiles

$(BUILT_PRODUCTS_DIR)/$(FRAMEWORKS_FOLDER_PATH)/Result.framework
image

简单解释填写的内容:
(SRCROOT):你的工程的相对路径\(BUILT_PRODUCTS_DIR):built后的输出路径
$(FRAMEWORKS_FOLDER_PATH):framework所在的路径

  1. 到此为止,已经完成了,在项目中使用到第三方的地方直接“import Alamofire”就行,跟引入系统框架一样。
  2. 以后再添加第三方库,只需重复3.2步骤即可。

其他提示(可能遇到的坑)

  1. 等待时间很长,如果你一次行添加了好多第三方框架,那就等吧,你的网速好海行,网速差就等好几个小时
  2. 路径错误,你很有可能路径设置有问题,我已经尽可能的用截图的方式给你展示了合适的路径,如果没有严格按照我的截图路径来,那么你最后填写的inputfile和output路径就需要按照你自己的来
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,125评论 6 498
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,293评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,054评论 0 351
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,077评论 1 291
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,096评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,062评论 1 295
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,988评论 3 417
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,817评论 0 273
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,266评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,486评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,646评论 1 347
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,375评论 5 342
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,974评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,621评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,796评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,642评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,538评论 2 352

推荐阅读更多精彩内容

  • Carthage v0.26.2(原文链接) Carthage的目标是用最简单的方式来管理Cocoa第三方框架。 ...
    iOSLee阅读 3,586评论 0 7
  • 文档地址https://github.com/Carthage/Carthage release v0.20.0...
    指尖弹灰阅读 4,494评论 2 4
  • Carthage和CocoaPods相比,轻量级一些,在swift中使用很方便,它本身就是swift写的。 1.b...
    牧晓逸风阅读 49,432评论 25 98
  • WebSocket-Swift Starscream的使用 WebSocket 是 HTML5 一种新的协议。它实...
    香橙柚子阅读 23,846评论 8 183
  • 女儿问: 妈妈你为什么嫁给爸爸? 我说: 是因为爸爸拿走了我的心 后来, 爸爸把心还你了吗? 后来, 爸爸把我的心...
    云是雨的衣阅读 87评论 0 1