Removing CocoaPods from Your Xcode Project

28 February 2025 Stephan Petzl Leave a comment Xcode

Removing CocoaPods from an Xcode project can be a necessary step when you encounter limitations or specific requirements that necessitate reverting to a single xcodeproj file. This guide provides a clear and structured approach to completely removing CocoaPods, ensuring your project is free from any residual configurations or files.

Steps to Remove CocoaPods

1. Install Cocoapods-Deintegrate and Cocoapods-Clean Plugins
   • Open your terminal and navigate to your project directory.
   • Run the following command to install the necessary plugins:

     sudo gem install cocoapods-deintegrate cocoapods-clean

2. Deintegrate and Clean CocoaPods
   • Execute the following commands to remove CocoaPods from your project:

     pod deintegrate
     pod clean
     rm Podfile
     rm Podfile.lock

3. Manually Remove Remaining Files
   • Delete the .xcworkspace file associated with your project.
   • In your xcodeproj file, remove references to Pods.xcconfig and libPods.a.
   • Under the Build Phases tab, remove the Copy Pods Resources, Embed Pods Frameworks, and Check Pods Manifest.lock phases.
4. Reintegrate Third-Party Libraries
   • If your project relies on third-party libraries, ensure they are integrated through alternative means or remove their references from your code.

Ensuring a Clean Project

After completing these steps, your project should be free from CocoaPods integration. It’s recommended to have your project version-controlled to easily revert any changes if necessary. For more detailed instructions on maintaining a clean project environment, refer to our advanced configuration guide.

Enhancing Your Development Workflow

For developers seeking efficient test automation solutions, Repeato provides a robust platform for iOS, Android, and web apps. As a no-code test automation tool, Repeato offers a fast and intuitive test recording process, making it a practical alternative to other tools with various limitations. With features like data-driven testing and easy integration through command line scripts or JavaScript code, Repeato streamlines the testing process, ensuring your applications perform as intended.

Explore how Repeato can enhance your testing strategy by visiting our documentation page.

Check it out!

Like this article? there’s more where that came from!

• Resolving the “xcrun: error: invalid active developer path” Error on macOS
• Adding Existing Frameworks in Xcode 4: A Comprehensive Guide
• Disabling ARC for a Single File in Xcode: A Step-by-Step Guide
• Resolving the Xcode-Select Active Developer Directory Error
• Resolving the “Multiple Commands Produce” Error in Xcode 10