CocoaPods is the dependency manager for Swift and Objective-C Cocoa projects. It has thousands of libraries and can help you scale your projects elegantly.
CocoaPods is built with Ruby and is installable with the default Ruby available on OS X. We recommend you do this.
Using the default Ruby install will require you to use
sudo when installing
gems. Further instructions are in the guides.
$ sudo gem install cocoapods
Search for pods (above). Then list the dependencies in a text file named
Podfile in your Xcode project directory:
platform :ios, '8.0' use_frameworks! target 'MyApp' do pod 'AFNetworking', '~> 2.5' pod 'ORStackView', '~> 2.0' pod 'SwiftyJSON', '~> 2.1' end
Tip: CocoaPods provides a
pod init command to create a Podfile with
smart defaults. You should use it.
Now you can install the dependencies in your project:
$ pod install
Make sure to always open the Xcode workspace instead of the project file when building your project:
$ open App.xcworkspace
Now you can import your dependencies e.g.:
Sometimes CocoaPods doesn’t yet have a pod for one of your dependencies. Fortunately, creating a pod is pretty easy:
$ pod spec create Peanut $ edit Peanut.podspec $ pod spec lint Peanut.podspec
We’re developing CocoaPods on GitHub. There’s a guide for getting started on the CocoaPods tool. It’s easy and really gratifying to contribute patches! - for a lot of people it's their first foray into Open Source. We are also working with the RailsGirls Summer of Code 2015, you should participate!