CocoaPods is a dependency management tool, here is how you can install and use CocoaPods for your next iOS App from iOS prototype App made by the others. We think, if you are a beginner in iOS App development arena; you better start reading our old guide – iOS Universal Framework XCode Project Template and How To Start Developing iOS Apps. We separately explained the RESTful API creation part and also mentioned about a RESTful API Testing Tool named CocoaRestClient.
The newest phrase popped up here is Dependency Management Tool. We should briefly explain it first.
CocoaPods : What is a Dependency Management Tool ?
CocoaPods is an Objective-C library dependency manager. A dependency management tool helps to overcome most of the common issues for the dependencies between the various libraries; it will fetch the source code for the dependencies, create and maintain the needed environment to build your project easily.
---
Official webpage of CocoaPods is here :
1 | http://cocoapods.org/ |
Installing CocoaPods on OS X
This guide – Fixing UNIX Commands After OSX 10.8 Update will give you the all stuffs needed for a proper setup. The article is a misnomer, works for OS X Mavericks and also describe installation of Homebrew Package Manager and iTerm2. Although installation of Homebrew Package Manager and iTerm2 are not mandatory for our usage, we like to use them for easy management of repositories and CLI tools.
CocoaPods runs on Ruby, so we need nothing more to install except CocoaPods itself.
1 | sudo gem install cocoapods |
There will be no initial response in the command line output, as if nothing is happening; but it will ultimately get installed, after a brief time of waiting you will see the output. Also, if you are a nervious type person, simply quit iTerm and use this command instead to view what is happening :
1 | sudo gem install cocoapods -V |
The command will install 16 gems. It might ask whether to overwrite rake with option y and n. Press y and hit Return key. Next command will be :
1 | pod setup |
It might take time and throw errors. Possibly the reader is aware that gem is the package manager written in Ruby. And probably the best version manager for Ruby is RVM :
1 | http://rvm.io/ |
But before going to run the pod setup command, we will suggest to run :
1 | brew doctor |
and fix the errors first. Again, pod setup command can take a huge time without any practical output of what is happening. Next you must follow guide of this repo :
1 | https://github.com/CocoaPods/Specs#a-repository-of-cocoapods-specifications |
The Core gem provides support for working with the files that are involved with CocoaPods, mainly the Podfile and podspecs. A Podspec or Spec, describes a version of a Pod library. One Pod might have many Specs. It includes details about where the source should be fetched from, what files to use, the build settings to apply and other general metadata such as its name, version, and description. The Podfile is the file that defines the pods you want to use.
Start up Xcode and create a new project with the iOSApplicationSingle View Application template. Name the project CocoaPods and make sure to enable ARC (Automatic Reference Counting) for the project. An example iOS App to start with :
1 | https://github.com/MatthewYork/iPhone-IntroductionTutorial |
