Thursday, January 21, 2016

How to install CocoaPods and setup with your Xcode project

Before installing Pods make sure you have installed/updated command line tool in your Mac machine. You can check this by opening Xcode, navigating the menu to Xcode > Preferences > Downloads > Components, finding Command Line Tools and select install/update.



Also, make sure Git is installed in your Mac machine.
Open terminal and run this command:
 sudo gem install cocoapods
Enter admin password. This could take a while. After few minutes it will show green message is cocoa pods installed successfully in your mac machine.
If you are getting any error with XCode6 like developer path is missing. First run this command in terminal: sudo xcode-select -switch /Applications/Xcode6.app (or your XCodeName.app)
Hurrah….You successfully installed CocoaPods in your mac machine. Now you can setup Pod with your Xcode project.
How to setup POD for your Xcode project:
1. Open Terminal
2. Change directory to your XCode project root directory (where your ProjectName.xcodeproj file is placed).
3. $ pod setup : (Setting up CocoaPods master repo)
If successful, it shows : Setup completed (read-only access). So, you setup everything. Now Lets do something which is more visible…Yes ! Lets install libraries in your Xcode project.
Steps to add-remove-update libraries in pod:
1. Open Terminal
2. Change directory to your XCode project root directory. If your terminal is already running then no need to do this, as you are already at same path.
3. $ touch podfile
4. $ open -e podfile (This should open a blank text file)
5. Add your library names in that text file. You can add new names (lib name), remove any name or change the version e.g :
pod ‘AFNetworking’, ’0.9.1′
pod ’Facebook-iOS-SDK’
pod ’EGOTableViewPullRefresh’
pod ’JSONKit’
pod ‘MBProgressHUD’
pod ’Reachability’
NOTE: Use ( control + ” ) button to add single quote at both end of library name. It should be shown as straight vertical line. Without control button it shall be added as curly single quote which will give error while installation of file.
6. Save and close this text file. Now libraries are setup and you have to install/update it.
7. Go to your terminal again and run this command: $ pod install (to install/update these libraries in pod).
You should see output similar to the following:
Updating spec repo `master’
Installing AFNetworking (0.9.1)..
Generating support files
After successful downloading/installation of any single library, It will generate ProjectName.xcworkspace in your project root directory. From now use this workspace to open your project. When you open your project work space you will see Pod is also added as another Xcode project with your Xcode project. If you open Pod it will show all libraries.
For your next project your don’t need to install the cocoa pod again in your mac machine just open the terminal and setup the Pod in root directory of your Xcode project and always remember these 3 commands :
  • 1. $ touch podfile
  • 2. $ open -e podfile
  • 3. $ pod install
To update Pod libraries : $ pod update
To check POD version : $ pod –version
To update CocoaPods : $ gem install cocoapods or use sudo at start if getting error “You don’t have write permissions for the /Library/Ruby/Gems/2.0.0 directory.”

Share:
Location: Pune, Maharashtra 411001, India