Carthage 使用、托管框架到Git、SDK的坑


Carthage 简介

  • Carthage 类似于 CocoaPods,为用户管理第三方框架和依赖,但不会自动修改项目文件和生成配置
  • Carthage 是去中心化的依赖管理工具,安装依赖时不需要去中心仓库获取 CocoaPods 所有依赖的索引,节省时间
  • 对项目无侵入性,Carthage 设计上也比较简单,利用的都是 Xcode 自身的功能,开发者在创建依赖时,相比 CocoaPods 也简单许多
  • Carthage 管理的依赖只需编译一次,项目干净编译时,不会再去重新编译依赖,节省时间
    自动将第三方框架编程为 Dynamic framework( 动态库 )
    与 CocoaPods 无缝集成,一个项目能同时拥有 CocoaPods 和 Carthage
  • 缺点:
    • 仅支持 iOS8 +
    • 它只支持框架,所以不能用来针对 iOS 8 以前的系统版本进行开发
    • 支持的 Carthage 安装的第三方框架和依赖不如 CocoaPods 丰富
    • 无法在 Xcode 里定位到源码
    • 安装包的大小比用CocoaPods安装的包大


安装 Homebrew

可以使用 Homebrew 来安装 Carthage

1、安装 Homebrew

将以上命令粘贴至终端
脚本会在执行前暂停,并说明将它将做什么。高级安装选项在 这里(需要OSX 10.5+)

$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

安装完 homebrew 后执行下面命令,获取最新版本【可选】

$ 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 install carthage

安装 Carthage 之后,可查看版本

carthage version // 目前的版本号为:0.20.1

3、使用 Carthage 安装依赖

进入项目所在文件夹

cd ~/路径/项目文件夹

创建一个空的 Carthage 文件 Cartfile

touch Cartfile

使用 Xcode 打开 Cartfile 文件

open -a Xcode Cartfile

编辑 Cartfile【可手动打开进行编辑】

github "Alamofire/Alamofire" == 4.4.0

执行更新命令

$ carthage update  --platform iOS
$  carthage update --no-use-binaries --platform iOS // 推荐这个

更新成功后,项目文件夹中会多出三个文件

  • cartfile

  • Cartfile.resolved

  • Carthage/

    • Build/
    • Checkouts/

Carthage 会 clone 文件中对应的 git 第三方库,把每一个第三方库编译成二进制文件的 framework 文件。
其中 “–platform iOS” 命令是可选的,作用是保证只为 iOS 编译framework,如果不指定平台,会为全平台编译 framework 文件。如果想要了解更多的命令,可以运行 carthage help update查看。


4、添加 Frameworks 到项目中

  • 01 - 点击”项目名称”–> “TARGETS” –> “General”,在最底部找到 “Linked Frameworks and Libraries”
  • 02 - 点击 + 号,选择左下角 Add Other… 按钮,选择项目下 Carthage/Build/iOS/Alamofire.framework 文件,点击 Open 加入到项目中

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

  • 03 - 下一步选择菜单上的 Build Phases,点击左上角 + 号添加一个新的 Run Script,并添加以下命令:
/usr/local/bin/carthage copy-frameworks
  • 04 - 点击 Input Files 下面的 + 号为每一个 framework 添加访问路径

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

$(SRCROOT)/Carthage/Build/iOS/Alamofire.framework
  • 05 - Import 框架名到控制器,Command + B 编译项目,如果成功,就可以使用了
import Alamofire


上面内容转发于这里


把自己的Framework托管到Git上面

1、在Git上面新建仓库 (此步骤忽略)clone(克隆)到本地

2、创建项目,比如 PQ

PQ

image.png

3、把代码(或者自行创建)拖入到项目中,确保编译无误

image.png

4、查看分享是否勾选(一般默认是勾选的)

image.png

勾选

5、使用终端进入项目目录

cd address

6、接下来就是一顿操作(gitcarthage)

git add . //把文件添加到缓冲区(暂存区)
git commit -m "这里写日志信息,比如添加了啥功能,修复了啥bug"

carthage build --no-skip-current // 编译SDK

git push origin master // 如果你有多个分支,自行切换分支名称

git tag 1.0.0 // 添加标签,也就是SDK的版本号
// 比如 github "SnapKit/SnapKit" ~> 4.0.0

git push --tags // 把标签推送到服务器

7、然后就可以使用carthage导入到工程中了

这里假设你的仓库地址是 "...../SS/PQ"

那么导入你的框架就是 github "SS/PQ" 
// 后面的版本号如果不加会默认选中最新的版本 如果想指定版本就
 github "SS/PQ" ~> 1.0.0


PS: 如果你在选择语言的时候,选择了Swift

  • 请一定注意修饰符的使用(public, open, private, interval ,fileprivate), 否则有可能出现,导入SDK但是却找不到相关方法的坑,
  • 如果要让Swift的SDK支持OC,请记得加上 @objc
  • 还有由于OC和Swift的enum不一样,所以你要让enum支持OC,就只能是基本类型
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,921评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,635评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,393评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,836评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,833评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,685评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,043评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,694评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 42,671评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,670评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,779评论 1 332
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,424评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,027评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,984评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,214评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,108评论 2 351
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,517评论 2 343

推荐阅读更多精彩内容