Cocoapods 和 Carthage 使用笔记

Cocoapods

安装

1. （可选）使用 taobao ruby-china 源替换默认 gem 源: gem source blabla..

   $ gem sources -l
   *** CURRENT SOURCES ***
   
   https://rubygems.org/
   
   $ gem sources --remove https://rubygems.org/
   https://ruby.taobao.org/ removed from sources
   
   $ gem source -a https://gems.ruby-china.com/
   https://gems.ruby-china.com/ added to sources
   
   $ gem source -c
   *** Removed specs cache ***
   
   $ gem source -u
   source cache successfully updated
   
   $ gem sources -l
   *** CURRENT SOURCES ***
   
   https://gems.ruby-china.com/

2. sudo gem install cocoapods

3. （可选）切换 pod 源

   $ pod repo
   
   master
   - Type: git (master)
   - URL:  https://github.com/CocoaPods/Specs.git
   - Path: /Users/qiwihui/.cocoapods/repos/master

$ pod repo remove master

$ pod repo add master https://git.coding.net/CocoaPods/Specs.git

$ pod repo update

$ pod setup
```

或者

```bash
$ git clone https://git.coding.net/CocoaPods/Specs.git ~/.cocoapods/repos/master
$ pod repo update
```

切换回官方镜像

```bash
$ pod repo remove master

$ pod repo add master https://github.com/CocoaPods/Specs.git

$ pod repo update
Updating spec repo `master`
  $ /usr/local/bin/git -C /Users/qiwihui/.cocoapods/repos/master fetch origin --progress
  remote: Enumerating objects: 511, done.        
  remote: Counting objects: 100% (511/511), done.        
  remote: Compressing objects: 100% (134/134), done.        
  remote: Total 820 (delta 399), reused 449 (delta 367), pack-reused 309        
  Receiving objects: 100% (820/820), 99.24 KiB | 401.00 KiB/s, done.
  Resolving deltas: 100% (501/501), completed with 194 local objects.
  From https://github.com/CocoaPods/Specs
     5b04790953c..e3ba7ee3a29  master     -> origin/master
  $ /usr/local/bin/git -C /Users/qiwihui/.cocoapods/repos/master rev-parse --abbrev-ref HEAD
  master
  $ /usr/local/bin/git -C /Users/qiwihui/.cocoapods/repos/master reset --hard origin/master
  HEAD is now at e3ba7ee3a29 [Add] IOS_OC_BASIC 6.3

CocoaPods 1.6.0.beta.2 is available.
To update use: `sudo gem install cocoapods --pre`
[!] This is a test version we'd love you to try.

For more information, see https://blog.cocoapods.org and the CHANGELOG for this version at https://github.com/CocoaPods/CocoaPods/releases/tag/1.6.0.beta.2
```

1. 如果Podfile文件中有

   source 'https://github.com/CocoaPods/Specs.git'

   也需要把它换成repo的源，否则依然是使用GitHub源

基础用法

1. cd <project_folder>
2. pod init

3. 编辑 Podfile, example

   # 平台，必需
   platform :ios, '9.0'
   # 隐藏警告
   inhibit_all_warnings!
   
   target 'AlamofireDemo' do
       # Using Swift and want to use dynamic frameworks
       use_frameworks!
   
       # 项目 Pods
       pod 'Alamofire', '~> 4.5'
   
       target 'AlamofireDemoTests' do
           inherit! :search_paths
           # 测试 Pods
       end
   
   end

   版本支持：

   - `>`, `>=`, `<`, `<=`
   - `~>`: **up to** next major | minor | patch
   - `:path` 本地绝对路径
   - `:git` git项目地址，还可使用 `:branch`, `:tag`, `:commit`

4. pod install
5. Always 打开项目下 *.xcworkspace 文件作为项目入口

pod install 和 pod update 区别

• pod install [package_name]: 安装特定版本的 pods
• pod update [package_name]: 升级 pods 到最新版本

Carthage

安装

brew install carthage

使用

1. 编辑 Cartfile，比如 SwiftyJSON

   github "SwiftyJSON/SwiftyJSON"

2. carthage update [--platform ios]

   $ carthage update
   *** Fetching SwiftyJSON
   *** Checking out SwiftyJSON at "4.2.0"
   *** xcodebuild output can be found in /var/folders/kl/g94q0k_571vdjtcwzzcv20s40000gn/T/carthage-xcodebuild.nN22hg.log
   *** Building scheme "SwiftyJSON iOS" in SwiftyJSON.xcworkspace
   *** Building scheme "SwiftyJSON watchOS" in SwiftyJSON.xcworkspace
   *** Building scheme "SwiftyJSON tvOS" in SwiftyJSON.xcworkspace
   *** Building scheme "SwiftyJSON macOS" in SwiftyJSON.xcworkspace

3. Carthage 目录下：

   • Build(编译出来的.framework二进制代码库)
   • Checkouts(源码)

   $ tree -L 3 Carthage/
   Carthage/
   ├── Build
   │   ├── Mac
   │   │   ├── SwiftyJSON.framework
   │   │   └── SwiftyJSON.framework.dSYM
   │   ├── iOS
   │   │   ├── 22BD4B6C-0B26-35E1-AF5F-8FB6AEBFD2FD.bcsymbolmap
   │   │   ├── C862E8A1-24ED-398A-A8E9-A7384E34EDB1.bcsymbolmap
   │   │   ├── SwiftyJSON.framework
   │   │   └── SwiftyJSON.framework.dSYM
   │   ├── tvOS
   │   │   ├── 1ADB9C1F-36CA-3386-BF07-6EE29B5F8081.bcsymbolmap
   │   │   ├── SwiftyJSON.framework
   │   │   └── SwiftyJSON.framework.dSYM
   │   └── watchOS
   │       ├── A8A151AB-D15E-3A0B-8A17-BF1A39EC6AB4.bcsymbolmap
   │       ├── EA427A42-6D21-3FF4-919F-5E50BF8A5D7B.bcsymbolmap
   │       ├── SwiftyJSON.framework
   │       └── SwiftyJSON.framework.dSYM
   └── Checkouts
       └── SwiftyJSON
           ├── CHANGELOG.md
           ├── Example
           ├── LICENSE
           ├── Package.swift
           ├── README.md
           ├── Source
           ├── SwiftyJSON.podspec
           ├── SwiftyJSON.xcodeproj
           ├── SwiftyJSON.xcworkspace
           ├── Tests
           └── scripts

4. 添加生成的文件： 项目 "General" -> "Linked Frameworks and Libraries" -> 将 Carthage/Build/iOS 中的 .framework 文件添加到项目中

5. "Build Phases" -> "+" -> "New Run Script Phase"

   • /bin/sh
   • /usr/local/bin/carthage copy-frameworks
   • "Input Files": $(SRCROOT)/Carthage/Build/iOS/SwiftyJSON.framework
   • "Output Files": $(BUILT_PRODUCTS_DIR)/$(FRAMEWORKS_FOLDER_PATH)/SwiftyJSON.framework

添加这个 Run Script 的作用是为了让运行时能够找到这个动态库。
还可以将 Carthage 所集成的第三方库生成的符号文件添加到项目中，这样我们在调试的时候，就可以步入第三方库内部的代码：`Build Phrases` -> `New Copy Files Phrase`，将 Carthage/Build/iOS 目录中的 `SwiftyJSON.framework.dSYM` 符号文件拖动进来

Carthage 和 CoaoaPods 的区别

CoaoaPods 是一套整体解决方案，我们在 Podfile 中指定好我们需要的第三方库。然后 CocoaPods 就会进行下载，集成，然后修改或者创建我们项目的 workspace 文件，这一系列整体操作。

相比之下，Carthage 就要轻量很多，它也会一个叫做 Cartfile 描述文件，但 Carthage 不会对我们的项目结构进行任何修改，更不多创建 workspace。它只是根据我们描述文件中配置的第三方库，将他们下载到本地，然后使用 xcodebuild 构建成 framework 文件。然后由我们自己将这些库集成到项目中。Carthage 使用的是一种非侵入性的哲学。

另外 Carthage 除了非侵入性，它还是去中心化的，它的包管理不像 CocoaPods 那样，有一个中心服务器(cocoapods.org)，来管理各个包的元信息，而是依赖于每个第三方库自己的源地址，比如 Github。

参考

• 解决Cocoapods贼慢问题
• Carthage 包管理工具，另一种敏捷轻快的 iOS & MAC 开发体验