375

I added an external framework via cocoapods into my iOS application. How can i remove that library from the project?

Improve this question

10 Answers 10

Reset to default
488

Remove lib from Podfile, then pod install again.

Improve this answer
7
  • 13
    When I do this, I'm left with dozens of warnings in XCode 5 complaining that the workspace can't find the removed files. I've tried to manually clean this up but have not been successful. How can you cleanly remove a pod?
    – Matt Mombrea
    Dec 19, 2013 at 1:18
  • 8
    Find the pods file in Finder, then delete each of the individual pods (you'll notice they're missing the .h and .m files). Then pod update. That worked for me.
    – AMayes
    Jan 9, 2014 at 22:32
  • 1
    Also remember if library A is referenced by library B, which is also in Podfile, library A won't be removed even if you remove its entry and run "pod install". Library A will only be removed if you also removed the entry for library B.
    – CodeBrew
    Mar 6, 2015 at 5:20
  • 9
    You also get the warnings that @MattMombrea mentions if you successfully deleted the podfiles, but haven't committed the change. Make sure everything is committed to the code repository.
    – HughHughTeotl
    Oct 2, 2015 at 11:10
  • 2
    I want to delete a framework installed by pod without updating or installing podfile
    – Anand Prakash
    Nov 18, 2016 at 11:03
428

The unwanted side effects of simple folder delete or installing over existing installation have been removed by a script written by Kyle Fuller - deintegrate and here is the proper workflow:

  1. Install clean:

    sudo gem install cocoapods-clean

  2. Run deintegrate in the folder of the project:

    pod deintegrate

  3. Clean (this tool is no longer available):

    pod clean

  4. Modify your podfile (delete the lines with the pods you don't want to use anymore) and run:

    pod install

Done.

Improve this answer
12
  • 2
    This pod should be the accepted answer, because it is much more thorough. Although, before following this workflow, I would suggest to clear the contents of the project's Derived Data directory, and make sure to commit the project's changes to the existing code repository. Finally, after running pod install, I opened the Xcode xcworkspace file, performed a full clean on the build folder (alt+shift+command+K), and the warnings/linker errors were gone. Pods were now successfully uninstalled from the project.
    – Mark Barrasso
    Jan 30, 2017 at 21:30
  • 1
    Note to @All: This commandcocoapods-clean deletes the Podfile and .xcworkspace
    – Suhaib
    Jun 15, 2017 at 11:02
  • 10
    Seems now pod deintegrate is official: guides.cocoapods.org/terminal/commands.html#pod_deintegrate No need for sudo gem install cocoapods-deintegrate.
    – Pang
    Aug 7, 2017 at 4:54
  • 5
    I second that from @ZinWinHtet, when I try pod clean I get: $ pod clean [!] Unknown command: clean
    – ScottyBlades
    Sep 21, 2018 at 22:12
  • 4
    yes... , pod clean no longer exists anymore I think.
    – Zin Win Htet
    Sep 24, 2018 at 7:38
31

  1. Remove the library from your Podfile

  2. Run pod install on the terminal

Improve this answer
2
  • If I'm using Flutter, can I run flutter clean - flutter pub get instead of pod install? Just wondering...
    – Karolina Hagegård
    Aug 3, 2022 at 6:54
  • Hey..... There are no pod names in my Podfile! 😲 There's only the line: flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))!... In the Podfile.lock file, there's a list of pod names, but I'm not supposed to edit that one, am I?..... 🙄
    – Karolina Hagegård
    Aug 3, 2022 at 7:21
8

None of these worked for me. I have pod version 1.5.3 and the correct method was to remove the pods that were not longer needed from the Podfile and then run:

pod update

This updates your Podfile.lock file from your Podfile, removes libraries that have been removed and updates all of your libraries.

Improve this answer
3
  • 3
    You don't need to update all the libraries in your project (something that can be very dangerous) just to remove a library. There are much better ways in this thread including removing the pod from your podfile and then running pod install
    – Braden Holt
    May 26, 2020 at 20:20
  • 1
    This updates all versions of your libraries and naturally removes the one that is not present anymore in the Podfile, but do you really want to update the libraries ? Removing the pod and pod install is the correct way.
    – Karim Mortabit
    Jun 2, 2020 at 23:25
  • Hey..... There are no pod names in my Podfile! 😲 There's only the line: flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))!... In the Podfile.lock file, there's a list of pod names, but I'm not supposed to edit that one, am I?..... 🙄
    – Karolina Hagegård
    Aug 3, 2022 at 7:21
3

To completely remove Pod or Cocoapods Framework from your Project repository !

sudo gem install cocoapods-clean
pod deintegrate
pod clean

Then Try to remove the File

Pods

Podfile

Podfile.lock

yourProjectName.xcworkspace

Improve this answer
2

First, determine which versions of Cocoapods are installed :

gem list --local | grep cocoapods

You get output as this:

cocoapods (1.11.2)
cocoapods-clean (0.0.1)
cocoapods-core (1.11.2, 1.10.2, 1.10.1)
cocoapods-deintegrate (1.0.4)

To completely remove, issue the following commands:

gem uninstall cocoapods
gem uninstall cocoapods-clean
gem uninstall cocoapods-core
gem uninstall cocoapods-deintegrate

Running again to confirm that Cocoapods has been removed:

gem list --local | grep cocoapods

You may have residual artefacts in a hidden folder in your directory. Remove these with:

rm -rf ~/.cocoapods
Improve this answer
1
  • 3
    The question was not how to remove cocoapods!!... 😏 The qn is how to remove A LIBRARY that was installed via cocoapods!
    – Karolina Hagegård
    Aug 3, 2022 at 6:44
2

Remove the Pod without hurting other Pods or their versions.

remove the pod that is no longer needed from the PodFile and run

pod install --no-repo-update
Improve this answer
1
  1. Remove pod name(which to remove) from Podfile and then
  2. Open Terminal, set project folder path
  3. Run pod install --no-integrate
Improve this answer
2
  • 1
    I'm getting this error: [!] Unknown option: '--no-integrate'
    – neoneye
    Nov 23, 2018 at 12:00
  • Hey..... There are no pod names in my Podfile! 😲 There's only the line: flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))!... In the Podfile.lock file, there's a list of pod names, but I'm not supposed to edit that one, am I?..... 🙄
    – Karolina Hagegård
    Aug 3, 2022 at 7:26
0

Remove pod name from Podfile then Open Terminal, set project folder path and Run pod update command.

NOTE: pod update will update all the libraries to the latest version and will also remove those libraries whose name have been removed from podfile.

Improve this answer
1
  • Hey..... There are no pod names in my Podfile! 😲 There's only the line: flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))!... In the Podfile.lock file, there's a list of pod names, but I'm not supposed to edit that one, am I?..... 🙄
    – Karolina Hagegård
    Aug 3, 2022 at 7:21
0

Got this trying to install google_sign_in with flutter. Just had to remove the AppAuth library stuff from cocoapods, then 'pod install' in ios directory. Then I had to remove the flutter plugin, then I had to reinstall flutter plugin, then redo pod install. Then it worked. So I guess weird caching.

Improve this answer

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.