Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
C

cocoapods-binary-cache

> 编程语言
Open source

CocoaPods binary cache A plugin that helps to reduce the build time of Xcode projects which use CocoaPods by prebuilding pod frameworks and…

488 stars0 likes2 views
WebsiteGitHub

About

CocoaPods binary cache A plugin that helps to reduce the build time of Xcode projects which use CocoaPods by prebuilding pod frameworks and…

CocoaPods binary cache

A plugin that helps to reduce the build time of Xcode projects which use CocoaPods by prebuilding pod frameworks and cache them in a remote repository to share across multiple machines.

Installation

Requirements

  • Ruby: >= 2.4
  • CocoaPods: >= 1.5.0

Via Bundler

Add the gem cocoapods-binary-cache to the Gemfile of your project.

rb
gem "cocoapods-binary-cache", :git => "https://github.com/grab/cocoapods-binary-cache.git", :tag => "0.1.11"

Then, run bundle install to install the added gem.

In case you're not familiar with bundler, take a look at Learn how to set it up here.

Via RubyGems

bash
$ gem install cocoapods-binary-cache

How it works

Check out the documentation on how it works for more information.

Usage

1. Configure cache repo

First of all, create a git repo that will be used as a storage of your prebuilt frameworks. Make sure this git repo is accessible via git clone and git fetch. Specify this cache repo in the following section.

2. Configure Podfile

2.1. Load the cocoapods-binary-cache plugin.

Add the following line at the beginning of Podfile:

rb
plugin "cocoapods-binary-cache"

2.2. Configure cocoapods-binary-cache

rb
config_cocoapods_binary_cache(
  cache_repo: {
    "default" => {
      "remote" => "git@cache_repo.git",
      "local" => "~/.cocoapods-binary-cache/prebuilt-frameworks"
    }
  },
  prebuild_config: "Debug"
)

For details about options to use with the config_cocoapods_binary_cache function, check out our guidelines on how to configure cocoapods-binary-cache.

2.3. Declare pods as prebuilt pods

To declare a pod as a prebuilt pod (sometimes referred to as binary pod), add the option :binary => true as follows:

rb
pod "Alamofire", "5.2.1", :binary => true

NOTE:

  • Dependencies of a prebuilt pod will be automatically treated as prebuilt pods.
    For example, if RxCocoa is declared as a prebuilt pod using the :binary => true option, then RxSwift, one of its dependencies, is also treated as a prebuilt pod.

3. CLI

We provided some command line interfaces (CLI):

  • Fetch from cache repo
bash
$ bundle exec pod binary fetch
  • Prebuild binary pods
bash
$ bundle exec pod binary prebuild [--push]
  • Push the prebuilt pods to the cache repo
bash
$ bundle exec pod binary push

For each command, you can run with option --help for more details about how to use each:

bash
$ bundle exec pod binary fetch --help

4. A trivial workflow

A trivial workflow when using this plugin is to fetch from cache repo, followed by a pod installation, as follows:

bash
$ bundle exec pod binary fetch
$ bundle exec pod install

For other usages, check out the best practices docs.

Benchmark

We created a project to benchmark how much of the improvements we gain from this plugin. The demo project is using the following pods:

AFNetworking
SDWebImage
Alamofire
MBProgressHUD
Masonry
SwiftyJSON
SVProgressHUD
MJRefresh
CocoaLumberjack
Realm
SnapKit
Kingfisher

Below is the result we recorded:

Hardware specs of the above benchmark:

MacBook Pro (15-inch, 2018)
Mac OS 10.14.6
Processor 2.6 GHz Intel Core i7
Memory 16 GB 2400 MHz DDR4

You can also try it out on your local:

bash
$ cd PodBinaryCacheExample
$ sh BuildBenchMark.sh

In our real project with around 15% of swift/ObjC code from vendor pods. After applying this technique, we notice a reduction of around 10% in build time.

Known issues and roadmap

Exporting IPA with Bitcode

  • When exporting an IPA with Bitcode, remember to disable the rebuild from bitcode option. Refer to https://github.com/grab/cocoapods-binary-cache/issues/24.

Pods with headers only

  • By default, pods with empty sources (ie. pods with header files only) will be automatically excluded and they will be later integrated as normal. For now, we rely on the source_files patterns declared in podspec to heuristically detect empty-sources pods.
  • However, there are cases in which the source_files of a pod looks like non-empty sources (ex. s.source_files = "**/*.{c,h,m,mm,cpp}") despite having header files only. For those cases, you need to manually add them to the excluded_pods option.

Best practices

Check out our Best practices for for information.

Troubleshooting

Check out our Troubleshooting guidelines for more information.

Contribution

Check out CONTRIBUTING.md for more information on hw to contribute to this repo.

License

The cocoapods-binary-cache plugin is available as open-source under the terms of the MIT License. It uses cocoapods-rome and cocoapods-binary internally, which are also under MIT License.

Issues· 34 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

Ruby

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言