I referred to many links and tried, but I had no success. I read CocoaPods documents and many times tried to install, but I always failed because of the starting steps. I found one error whereby I can't install gems first. What are the steps one by one? Such as steps or a demo of how to install.
This is one link which I tried.
The screenshot refers to this console error I was given:
POD Install
Open terminal and type:
sudo gem install cocoapods
The Gem will get installed in Ruby inside the System library. Or try on Mac OS X v10.11 (El Capitan), type:
sudo gem install -n /usr/local/bin cocoapods
If there is an error "activesupport requires Ruby version >= 2.xx", then install latest activesupport first by typing in the terminal.
sudo gem install activesupport -v 4.2.6
After installation, there will be a lot of messages. Read them and if no error found, it means the CocoaPods installation is done. Next, you need to setup the CocoaPods master repository. Type in the terminal:
pod setup
And wait it will download the master repository. The size is very big (370.0 MB in December 2016). So it can be a while. You can track of the download by opening Activity and go to the Network tab and search for "git-remote-https". Alternatively, you can try adding "--verbose" to the command like so:
pod setup --verbose
Once done, it will output "Setup Complete", and you can create your Xcode project and save it.
Then in the terminal, cd to your Xcode project root directory (where your .xcodeproj file resides) and type:
pod init
Then open your project's podfile by typing in terminal:
open -a Xcode Podfile
Your Podfile will get open in text mode. Initially there will be some default commands in there. Here is where you add your project's dependencies. For example, in the podfile, type
pod 'AFNetworking', '0.9.1'
(This line is an example of adding the AFNetworking library to your project.)
Other tips:
Uncomment platform :ios, '9.0'
Uncomment use_frameworks! if you're using Swift
When you are done editing the podfile, save it and close Xcode.
Then install pods into your project by typing in terminal:
pod install
or (For m1 chip)
arch -x86_64 pod install
Depending how many libraries you added to your podfile for your project, the time to complete this varies. Once completed, there will be a message that says
"Pod installation complete! There are X dependencies from the Podfile
and X total pods installed."
Now close your Xcode project. Then locate and open the .xcworkspace Xcode project file and start coding. (You should no longer open the xcodeproj file.)
First open your terminal
Then update your gem file with command
sudo gem install -n /usr/local/bin cocoapods
Then give your project path
cd /your project path
Touch the podifle
touch podfile
Open your podfile
open -e podfile
It will open a podfile like a text edit. Then set your target. For example if you want to set up Google maps then your podfile should be like
use_frameworks!
target 'yourProjectName' do
pod 'GoogleMaps'
end
Then install the pod
pod install
On macOS v10.14 (Mojave) with Xcode 10.3, I got scary warnings from the gem route with or without -n /usr/local/bin:
xcodeproj's executable "xcodeproj" conflicts with /usr/local/bin/xcodeproj
Overwrite the executable? [yN]
What works for me is still Homebrew. Just:
brew install cocoapods
This works for Mac OS X v10.11.x (El Capitan)
sudo gem install -n /usr/local/bin cocoapods
After this, you can set up the pod using pod setup cmd and then move to your project directory and install pod.
Simple steps to install a pod file:
Open the terminal
Command on the terminal: sudo gem install cocoapods
Set your project path in the terminal.
Command: pod init
Go to the pod file of your project and add the pod which you want to install
Added in the pod file: pod 'AFNetworking', '~> 3.0
Command: Pod install
Close the Xcode project
open your project from the terminal
Command: open PodDemos.xcworkspace
Year 2020, installing CocoaPods v1.9.1 in macOS v10.15 (Catalina)
First set up your Xcode version in your Mac using the terminal.
sudo xcode-select -switch /Applications/Xcode.app
Next, install CocoaPods using the terminal.
sudo gem install cocoapods
For more information, visit the official website, https://cocoapods.org/.
These are the complete steps that I usually follow. I am posting these steps as short as possible and assuming that you know about Mac and Xcode projects. First of all, open the terminal and use the following commands, and press enter after each command.
Type in the following command if you don't already have CocoaPods installed:
sudo gem install cocoapods
Now please move to your Xcode Project directory by using this following command, and replace /Your Xcode Project Directory Path with the actual path to the directory:
cd /Your Xcode Project Directory Path
Below are instructions for how to use CocoaPods. Please wait for some time after each and every command entered to the terminal to execute successfully.
Searching for pods in terminal:
pod search networking (replace networking with which you want to search)
Creating the pod file:
pod init
Opening the pod file:
open -a Xcode Podfile
Adding the pods: (After adding your pods you must save the podfile first and then head back to the terminal again.)
target 'WebServiceUsingMantleAFNetworking' do
# platform :ios, '8.0' //Choose your version of iOS
pod 'AFNetworking', '~> 2.6.0’
end
OR
platform :ios, '8.0'
pod 'AFNetworking'
pod 'Mantle'
pod 'LBBlurredImage'
pod 'TSMessages'
pod 'ReactiveCocoa'
Installing the pods:
pod install
Check for updates of pods on existing project:
pod outdated
Update the existing pods:
pod update
Uninstall the Cocoapods from system:
sudo gem uninstall cocoapods
There is a complete tutorial for removing pods from your Xcode project on Stack Overflow. You can check on this following link for more info.
How to remove CocoaPods from a project?
Open Terminal
Type in sudo gem install cocoapods if you don't have CocoaPods
Enter cd /project path, but replace project path with actual project path
touch podfile
Use one of the following commands to open the podfile:
open -e podfile to open in TextEdit or
open -a pod file to open in Xcode
Set your target and add pod file of GoogleMaps like as:
target 'PROJECT NAME HERE' do
pod 'GoogleMaps'
end
Use pod install to install dependencies
Here are all steps with an image. Please follow it properly and I am sure you will not get any error.
From How to install CocoaPods and setup with your Xcode project.
First of all, check you have to install command line or not.
You can check this by opening Xcode, navigating the menu to
Xcode → Preferences → Downloads → Components. Find Command Line Tools and select install/update.
If you haven't found command line tool then you need to write this command in the terminal:
xcode-select --install
And click on install.
If you have installed the command-line tool, you need to select your Xcode directory (sometimes these type of problems created due to different versions of Xcode available)
Follow this procedure.
Open terminal and run this command:
sudo gem install cocoapods
Enter the admin password. This could take a while. After a few minutes, it
will show a green message if CocoaPods installed successfully in your
Mac machine.
If you are getting any error with Xcode 6 like developer path is
missing. First run this command in terminal:
sudo xcode-select -switch /Applications/Xcode6.app (or your XCodeName.app)
Now you can set up Pod with your Xcode project.
And now you have to install pod. Follow this procedure.
Open Terminal
Change directory to your Xcode project root directory (where your
ProjectName.xcodeproj file is placed).
pod setup: (Setting up the CocoaPods master repository)
If successful, it shows: Setup completed (read-only access). So,
you set up everything. Now let’s do something which is more visible…Yes! Let’s install libraries in your Xcode project.
Now you have to set up and update the library related to pod in your project.
Steps to add-remove-update libraries in pod:
Open Terminal
Change directory to your Xcode project root directory. If your
terminal is already running then there isn't any need to do this, as you are
already at the same path.
touch pod file
open -e podfile (This should open a blank text file)
Add your library names in that text file. You can add new names
(library name), remove any name or change the version, e.g.:
pod ’Facebook-iOS-SDK’
pod ’EGOTableViewPullRefresh’
pod ’JSONKit’
pod ‘MBProgressHUD
NOTE: Use the (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.
Save and close this text file. Now libraries are set up and you have
to install/update it
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 Facebook-iOS-SDK \
Generating support files
Setup completed.
Note:
If you have followed this whole procedure correctly and step by step, then you can directly fire the pod update command after selecting Xcode and then select your project path. And write your command pod update.
You can also check a command line tool here:
CocoaPods Installation on macOS v10.13 (High Sierra):
Install Homebrew - https://brew.sh/
Execute the following commands in the terminal:
sudo gem update --system
sudo gem install activesupport -v 4.2.6
sudo gem install -n /usr/local/bin cocoapods
pod setup
pod setup --verbose
For macOS v10.15 (Catalina):
sudo gem install -n /usr/local/bin cocoapods -v 1.8.4
The latest CocoaPods 1.10.0 seem not to be working.
I found the answer in Trouble with installing CocoaPods.
1- Install the Cocoapods in your machine
$ sudo gem install cocoapods
$ pod setup --verbose
2- Check whether Cocoapods is installed on your machine or not?
$ pod --version
3- Go to your project directory where .xcodeproj is present
$ pod init
After using pod init one additional file is added in your folder of name Podfile.
4- By double click open the podfile and pods between target and end
5- Install Pod using command
pod install
When you run the pod install command it installs all pods which you write in the pod file. And after you install the required commands open the project directory you get 2 new files.
First is Podfile.lock -> Every time the pod install command is run — and downloads and install new pods — it writes the version it has installed, for each pod, in the Podfile.lock file.
Second is .xcworkspace -> Xcode workspace files can be used as a wrapper or container for an Xcode .XCODEPROJ project.
Now use your library by using .xcworkspace which have a white background colour.
Pod installation giving an error on Mac OS X v10.11.2 (El Capitan):
ERROR: Error installing cocoapods:
activesupport requires Ruby version >= 2.2.2.
After getting this error, I tried this command and installed again. It worked for me.
sudo gem install activesupport -v 4.2.6
Now try the same pod installation command
sudo gem install -n /usr/local/bin cocoapods
For me, the easiest way was to install via a Ruby gem:
sudo gem install cocoapods -v
Please note -v for verbose. It takes a while to install CocoaPods and often you get confused if it's really happening.
You can install CocoaPods via Homebrew in macOS.
First, open your terminal, and run this code (for installing Homebrew if you have not): Go here for the latest command.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Then install CocoaPods easily via this command:
brew install cocoapods
sudo gem install -n /usr/local/bin cocoapods
This worked for me. -n helps you fix the permission error.
Pod File Install Steps
sudo gem install -n /usr/local/bin cocoapods
Pod setup
cd ~/Path/To/Folder/Containing/ShowTracker
touch podfile
open -a Xcode Podfile // To open it in Xcode
OPEN -e podfile // To open it in text editor
pod install // To install a new pod
pod update // To update all pods
Works in macOS Big Sur
1 install LATEST version of brew (https://treehouse.github.io/installation-guides/mac/homebrew)
2 then use "brew uninstall cocoapods"
3 install the latest version of cocoapods using "brew install cocoapods" (You must verify installed version with github version https://github.com/CocoaPods/CocoaPods/releases/tag/1.11.2, they must match)
4 overwrite link to cocoapods with "brew link --overwrite cocoapods"
5 check the version of cocoapods "pod --version"
6 done, You have the latest version of cocoapods installed
Normally we use
sudo gem install cocoapods
Solution, fix for CocoaPods error on Mac OS X v10.11 (El Capitan):
sudo gem install -n /usr/local/bin cocoapods
pod setup
cd /project path
pod init
In Podfile we need to set the target
# Podfile
platform :ios, '9.0'
use_frameworks!
# My other pods
target “Projectname” do
pod 'MBProgressHUD', '~> 0.8'
pod 'Reachability', '~> 3.1.1'
pod 'AFNetworking', '~> 2.2'
pod 'TPKeyboardAvoiding', '~> 1.2'
end
target 'ProjectnameTests' do
testing_pods
end
target 'ProjectnameUITests' do
testing_pods
end
In the console - terminal
pod install
If you behind a proxy then pass the proxy as an argument:
sudo gem install --http-proxy http://user:password#www-proxy.example.com:80 cocoapods
Thanks to SwiftBoy's 10-step solution I successfully used CocoaPods to setup the latest version of AudioKit.
1. Using Xcode create MyAudioApp Swift project saving it to my Developer directory e.g.
/Users/me/Developer/MyAudioApp
2. Using Cocoapods install AudioKit within MyAudioApp project (i.e. install AudioKit sdk)
3. Open Terminal, type command below and press Enter
sudo gem install -n /usr/local/bin cocoapods
4. Provide system password and press Enter
5. In Terminal, type command below and press Enter
cd /Users/me/Developer/MyAudioApp
6. Create project pod file - in Terminal type command below and press Enter
touch Podfile
7. Open project pod file - in Terminal type command below and press Enter (opens in TextEdit)
open Podfile
8. Edit code below into open pod file (and save file before quitting TextEdit)
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '12.2'
use_frameworks!
target 'MyAudioApp' do
pod 'AudioKit', '~> 4.7'
end
9. To install AudioKit in MyAudioApp workspace type Terminal command below and press Enter
Pod install
and wait for install to finish
10. In Finder, go to project folder /Users/me/Developer/MyAudioApp
and click .xcworkspace file below (opens in Xcode!)
/Users/me/Developer/MyAudioApp/MyAudioApp.xcworkspace
11. In MyAudioApp edit ViewController.swift and insert the following
import AudioKit
CocoaPods installation step:
Open your Terminal:
sudo gem update --system
sudo gem install activesupport -v 4.2.6
sudo gem install cocoapods
pod setup
pod setup --verbose
Then go to your project directory with Terminal:
cd Your Project Path
Then enter the below command in Terminal:
pod init
open -a Xcode Podfile
(Edit POD file with pod ‘libname’)
pod install
For CocoaPods in the terminal, follow this:
sudo gem update
sudo gem install cocoapods
pod setup
cd (project direct drag link)
pod init
open -aXcode podfile # (If it’s already open, add your pod file name. Example: alamofire4.3)
pod install
pod update
Open Terminal
Enter $ sudo gem install cocoapods command in terminal
Create new Xcode project
Navigate to directory containing Xcode project. Use cd “../directory-location/..” or cd [drag-and-drop project folder]
Pod install
If this prompts error Unable to add a source with url.. then install command line tool for Xcode. Again, rerun Pod install command.
This will install all dependencies as well.
Now, open your project in Workspace i.e. Project-Name.xcworkspace rather than Project-Name.xcodeproj
If you want to install CocoaPods for the first time for your project.
Example: Here we will install the "Alamofire" SDK using CocoaPods step by step.
Step 1. Open Terminal, hit command, and then press the Enter key
sudo gem install cocoapods
Step 2. If it asks, you should provide system password and then press the Enter key
Step 3. With command “cd” and give the path of your project and then press the Enter key
Note: type the "cd" command then space and drag the project folder to the terminal. It will take the project path as shown below (here my project name is: Simple Alamofire)
cd /Users/ramdhanchoudhary/Documents/Swift\ Workspace/Simple\
Alamofire
Step 4. Create a pod file in your project by terminal by command “touch Podfile” and press “Enter”
touch Podfile
Step 5. Then, open “Podfile” by terminal command “open Podfile” and press “Enter”
open Podfile
Step 6. Now type following code in opened pod file then save and close file
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '10.0'
use_frameworks!
target '<Your Target Name>' do
pod 'Alamofire', '~> 4.0'
end
Step 7. Back in Terminal type command “Pod install” and then press Enter Key.
Pod install
Step 8. Wait for the install to get complete 100% its around 650+ MB
Step 9. That's it goto project folder and open below file
<your project name>.xcworkspace
Step 10. Import Alamofire class and use!!
import Alamofire
On mac M1
I had two cocoapods installed, one was using brew and one with gem. With 2 different versions.
After reading many of your posts, and try many things I encountered various troubles.
Finally this one help me : thanks to Evan
With his post : https://stackoverflow.com/a/70600723/2355088
The final working sequence for me probably was :
sudo gem uninstall cocoapods
brew uninstall cocoapods
brew install cocoapods
brew reinstall ruby
=> RESTART ALL TERMS <= magical step, thank you Evan
cd myProj
pod install
Check this
gem install -p http://proxy_ip:proxy_port compass
You might need to add your user name and password to it:
gem install -p http://[username]:[password]#proxy_ip:proxy_port compass
And check this link it may help you.
For Mac OS X v10.11 (El Capitan)
rvm install ruby-2.2.2.
rvm use ruby-2.2.2.
sudo gem install -n /usr/local/bin cocoapods
I was facing the same problem in mac after updating to macOS 12.1
Also you might get error attached with Ruby framework installed on your mac machine.
You just need to remove cocoa pods completely from mac and re-install cocoapods
And then reinstall your project pods
This will solve your problem
for Apple Silicon Mac
$ sudo gem uninstall ffi && sudo gem install ffi -- --enable-libffi-alloc
I downloaded this zip https://github.com/Loadex/MessageBanner but have no idea to install it correctly to run. All the app does is show custom iOS banners. I'd like for someone with cocoa pods experience to get this app to run locally and explain from the download process, what they did in a nice compact answer. I'd like a step by step explaining how to get it to run. Thanks. So far I've tried this but deleted the project folder after numerous warnings from the terminal and from Xcode at run time. I have cocoa pods installed.
WTL2:~ Apple$ cd desktop
WTL2:desktop Apple$ cd m
WTL2:m Apple$ cd MessageBannerDemo
WTL2:MessageBannerDemo Apple$ touch podfile
WTL2:MessageBannerDemo Apple$ pod install
Analyzing dependencies
CocoaPods 0.36.0.beta.2 is available.
To update use: `gem install cocoapods --pre`
[!] This is a test version we'd love you to try.
For more information see http://blog.cocoapods.org
and the CHANGELOG for this version http://git.io/BaH8pQ.
Downloading dependencies
Generating Pods project
Integrating client project
[!] From now on use `MessageBannerDemo.xcworkspace`.
[!] [!] The Podfile does not contain any dependencies.
WTL2:MessageBannerDemo Apple$
Also added this to podfile
source 'git#github.com:CocoaPods/Specs.git'
platform :ios, '7.0'
pod 'MessageBanner', '~> 1.0'
if you have not updated ruby gem and not installed cocoa pod, then follow “setup to use cocoa pods ” and after that “To run the project”. If you have already installed cocoapod,then you may leave option ‘A’. but it is recommended to follow ‘A’ then ‘B” both.
A. setup to use cocoa pods
Open terminal and follow the following steps
update ruby gem
“sudo gem update —system”
Enter you system password when requested. wait it until it finished.
it may take little time
After successful installation you will see something like this.
Ruby Interactive (ri) documentation was installed. ri is kind of like man
pages for ruby libraries. You may access it like this:
ri Classname
ri Classname.class_method
ri Classname#instance_method
If you do not wish to install this documentation in the future, use the
--no-document flag, or set it as the default in your ~/.gemrc file. See
'gem help env' for details.
RubyGems system software updated
Install cocoapods
“sudo gem install cocoapods”
you may get this to override press just enter Y to continue.
after successful installation you will see something similar to this
Installing ri documentation for cocoapods-core-0.36.0
Parsing documentation for cocoapods-0.36.0
Installing ri documentation for cocoapods-0.36.0
20 gems installed
to complete the setup of CocoaPods
“pod setup”
after successful, you will see something similar to this.
/System/Library/Frameworks/Ruby.framework/Versions/2.0/usr/lib/ruby/2.0.0/universal-darwin14/rbconfig.rb:213: warning: Insecure world writable dir /usr/local in PATH, mode 040777
Setting up CocoaPods master repo
Setup completed
B. To Run downloaded Project
Open Terminal and follow the these steps
go to the location of your project.
ex cd ~/desktop/myProjects/TestCocoapod
tell cocoapod to install the dependencies for your project.
“pod install”
After successful install, you will see something like this
Generating Pods project
Integrating client project
[!] Please close any current Xcode sessions and use `TestCocoapod.xcworkspace` for this project from now on.
3.Note: after this open the folder containing that project. You must
always open the .xcworkspace (ex. TestCocoapod.xcworkspace).
4Now run the project. you can successfully run it.
Make sure your Podfile is correctly formatted:
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '7.0'
workspace 'MessageBannerDemo.xcworkspace'
# Make sure xcodeproj is in correct path. Or update path here.
xcodeproj 'MessageBannerDemo/MessageBannerDemo.xcodeproj'
pod 'MessageBanner'
# Specify Xcode project targets to link the default pod with.
link_with 'MessageBannerDemo'
Try "rm -rf Pods Podfile.lock" and then "pod install" again.
Change the Podfile like that and run pod install :
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '7.0'
pod 'MessageBanner'