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
3、把代码(或者自行创建)拖入到项目中,确保编译无误
4、查看分享是否勾选(一般默认是勾选的)
5、使用终端进入项目目录
cd address
6、接下来就是一顿操作(git
和 carthage
)
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,就只能是基本类型