Remove or uninstall library previously added : cocoapods

W

10

375

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

Wrist answered 6/12, 2012 at 19:35 Comment(0)

K

429

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:

Install clean:
```
sudo gem install cocoapods-clean
```
Run deintegrate in the folder of the project:
```
pod deintegrate
```
~~Clean~~ (this tool is no longer available):
```
pod clean
```
Modify your podfile (delete the lines with the pods you don't want to use anymore) and run:
```
pod install
```

Done.

Km answered 10/2, 2016 at 13:33 Comment(12)

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. – Vegetable 30/1, 2017 at 21:30

Note to @All: This commandcocoapods-clean deletes the Podfile and .xcworkspace – Verticillate 15/6, 2017 at 11:2

Seems now pod deintegrate is official: guides.cocoapods.org/terminal/commands.html#pod_deintegrate No need for sudo gem install cocoapods-deintegrate. – Postulate 7/8, 2017 at 4:54

I found that when I removed SwiftLint from my project, that I also had to manually remove a line referencing it from the run script. – Lyrism 5/4, 2018 at 7:55

I second that from @ZinWinHtet, when I try pod clean I get: $ pod clean [!] Unknown command: clean – Ashbaugh 21/9, 2018 at 22:12

yes... , pod clean no longer exists anymore I think. – Danette 24/9, 2018 at 7:38

@Outsider that is interesting. What is your situation? – Km 26/2, 2019 at 10:1

I had a project where I incorrectly added a podfile. I then changed it by changing teh text and restarting teh project which is incorrect. Then I tried this and it did not work at that point – Latakia 26/2, 2019 at 21:30

Fully completing all these steps did the trick. I still had to remove a few Pods-related files from the Finder and Xcode, but the Xcode project file built correctly after replacement of the pods with Swift Package Manager. – Ibadan 10/2, 2020 at 3:3

So if the command pod clean no longer exists, should I still run sudo gem install cocoapods-clean? – Tebet 3/8, 2022 at 6:51

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?..... 🙄 – Tebet 3/8, 2022 at 7:22

I followed these steps but still ended up with many duplicates in the Pods folder. So I deleted the Pods folder before pod install and it worked. – Tirzah 28/8, 2023 at 20:2

R

488

Remove lib from Podfile, then pod install again.

Roadwork answered 7/12, 2012 at 7:50 Comment(7)

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? – Tolley 19/12, 2013 at 1:18

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. – Deflection 9/1, 2014 at 22:32

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. – Eloiseelon 6/3, 2015 at 5:20

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. – Executory 2/10, 2015 at 11:10

The article that @vrunoa mentions is now a dead link. This article is helpful: #16427921 – Veldaveleda 14/1, 2016 at 19:51

I want to delete a framework installed by pod without updating or installing podfile – Permanency 18/11, 2016 at 11:3

Installing podfile only means that you use the dependencies currently there in the podfile, which is exactly what you want to do. If you don't do that, you will still depend on the deleted libraries, which would be bad. Update, however, is unnecessary. – Tebet 3/8, 2022 at 7:26

K

429

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:

Install clean:
```
sudo gem install cocoapods-clean
```
Run deintegrate in the folder of the project:
```
pod deintegrate
```
~~Clean~~ (this tool is no longer available):
```
pod clean
```
Modify your podfile (delete the lines with the pods you don't want to use anymore) and run:
```
pod install
```