Carthage的安装和使用

Carthage和CocoaPods相比,轻量级一些,在swift中使用很方便,它本身就是swift写的。

1.brew

安装carthage之前需要安装brew,进入官网(https://brew.sh/index_zh-cn.html) 有详细的安装步骤。

获取 Homebrew

打开终端Tterminal`,输入以下命令:

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
获取最新版本
brew update

注意:如果遇到Error: The /usr/local directory is not writable.错误,就执行以下命令sudo chown -R $(whoami):admin /usr/local,再更新。

其他brew命令
brew install git // 使用brew安装软件
brew uninstall wget // 使用brew卸载软件
brew search /wge*/  // 使用brew查询软件,其中/wge*/是个正则表达式,需要包含在/中
brew list  // 列出已安装的软件
brew home   // 用浏览器打开brew的官方网站
brew info   // 显示软件信息
brew deps   // 显示包依赖

2.安装Carthage

安装brew之后,就可以安装Carthage了。

brew install carthage

安装Carthage之后,查看版本

carthage version // 目前的版本号为0.15.2

3. 使用Carthage

进入项目所在文件夹
cd ~/路径/项目文件夹
创建一个空的carthage文件
touch Cartfile

此时项目文件夹中会有一个名字为Carthage的文件

使用Xcode打开该文件
open -a Xcode Cartfile
编辑Cartfile
github "SVProgressHUD/SVProgressHUD" ~> 1.0

Cartfile格式说明

依赖源 Dependency origin

Carthage支持两种类型的源,一个是github,另一个是git

  1. github 表示依赖源,告诉Carthage去哪里下载文件。依赖源之后跟上要下载的库,格式为Username/ProjectName
  2. git 关键字后面跟的是资料库的地址,可以是远程的URL地址,使用git://, http://, ssh://,或者是本地资料库地址。
依赖版本号 Dependency Version

告诉Carthage使用哪个版本,这是可选的,不写默认使用最新版本

  1. == 1.0 表示使用1.0版本
  2. >= 1.0 表示使用1.0或更高的版本
  3. ~> 1.0 表示使用版本1.0以上但是低于2.0的最新版本,如1.2,1.6
  4. branch名称 / tag名称 / commit名称,意思是使用特定的分支/标签/提交,比如可以是分支名master,也可以是提交5c8a74a

4. 运行Carthage

保存并关闭Cartfile文件,回到终端,执行以下命令:

carthage update --platform iOS

carthage会clone文件中对应的git第三方库,把每一个第三方库编译成二进制文件的framework文件。

其中--platform iOS命令是可选的,作用是保证只为iOS编译framework,如果不指定平台,会为全平台编译framework文件。如果想要了解更多的命令,可以运行carthage help update查看。

当命令执行完毕,在Cartfile文件同级别的文件夹中生成一个名为“Carthage”文件夹和“Cartfile.resolved”文件。打开Carthage文件夹,可以看到两个文件夹BuildCheckouts

Cartfile.resolved:这个文件是辅助Cartfile的,需要被提交到版本库中,它有助于其他开发者使用和你相同版本的第三方库。
Build:包含每一个第三方库创建生成的framework,可以被集成到项目中,每一个framework都是依赖于源文件或者GitHub上的Releases版本。

Checkouts:这里包含的是转换成framework之前的源文件,Carthage有自己的缓存机制,所以不需要在不同的项目中对同一个的第三方库clone多次。

对于是否把BuildCheckouts文件夹提交到版本库取决于你,这不是必须的。如果提交的话,其他人clone了你的资料库就可以使用这两个文件中的内容。

不要改变Checkouts文件夹中的内容,因为如果使用carthage update 或者 carthage checkout命令的话,这个文件夹中的内容可以随时被复写,那么改动工作就白费了。如果一定要改动的话,在使用carthage update命令时,可以使用--use-submodules选项。如果加上这个选项的话,Carthage在添加每个依赖库的时候就会作为一个字模块。

如果其他人想要使用你的工程,你不需要在你的代码中提交已经编译好的framework,他们需要在check out你的工程之后执行carthage bootstrap命令。

bootstrap命令会根据Cartfile.resolved文件下载和编译依赖库的精确版本。另一方面,carthage update命令会更新项目中的第三方库的最新的编译版本,这是不可取的。

在"Carthage/Build/iOS"文件夹中会生成.framework文件

Carthage生成目录

注意, 如果遇到如下问题,解决方法如下:

*** Skipped downloading Alamofire.framework binary due to the error:
    "Bad credentials"

这个错误的原因是carthage通过git向 Github API 发送请求时,要先取得GitHub凭证

解决办法一

打开命令行工具terminal

  • 1.检查gitosxkeychain helper是否已经安装
$ git credential-osxkeychain
# 如果出现以下提示说明已经安装,进入第3步
Usage: git credential-osxkeychain <get|store|erase>
# 如果出现以下提示说明未安装,进入第2步
xcode-select: note: no developer tools were found at '/Applications/Xcode.app',requesting install. Choose an option in the dialog to download the command line developer tools.
  • 2.如果第一步提示未安装,则使用Homebrew来安装git
$ brew install git
  • 3.告诉git通过全局的credential.helper的配置来使用osxkeychain helper
$ git config --global credential.helper osxkeychain
# Set git to use the osxkeychain credential helper
  • 4.通过HTTPS URL方式 clone 在github上一份代码下来,这个过程你有可能被提示输入GitHub的用户名和密码来授权访问OSX keychain,此时,你的用户名和密码就会被保存在keychain中了。
# 可以进入系统桌面,创建一个临时文件夹,用来clone代码,之后再删除即可
$ cd
$ cd Desktop
$ mkdir tempdir
$ cd tempdir
$ git clone https://github.com/SVProgressHUD/SVProgressHUD.git

解决办法二

参考:http://stackoverflow.com/questions/39578496/carthage-error-bad-credentials

5. 添加FrameWorks到项目中

点击"项目名称"-> "target" -> "Gerneral",在最底部找到"Linked Frameworks and Libraries"。

打开Carthage文件夹,进入Build\iOS,拖拽SVProgressHUD.framework到Xcode的**Linked Frameworks and Libraries **中。

Link Frameworks

目的是告诉Xcode链接你的app到这个framework,允许你在代码中使用。

下一步选择菜单上的Build Phases,并添加一个新的Run Script,并添加以下命令:

/usr/local/bin/carthage copy-frameworks

点击Input Files下面的+号为每一个framework添加条目。

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

严格来讲,build phase对项目运行来说不是必须的,但是,这巧妙的解决了APP因为使用的frameworks包含二进制图像的iOS模拟器在提交APP Store时会被自动拒绝的问题。

carthage copy-frameworks命令剔除了额外的框架。

Run Script

command + B编译项目,比已成功之后就可以使用了。

import SVProgressHUD
升级指定Frameworks
carthage update SVProgressHUD --platform iOS

参考

参考1:https://github.com/Carthage/Carthage
参考2:https://www.raywenderlich.com/109330/carthage-tutorial-getting-started

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,029评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,395评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,570评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,535评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,650评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,850评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,006评论 3 408
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,747评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,207评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,536评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,683评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,342评论 4 330
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,964评论 3 315
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,772评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,004评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,401评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,566评论 2 349

推荐阅读更多精彩内容