Skip to content

Add section on removing CocoaPods from a project - #13774

Open
sfshaza2 wants to merge 3 commits into
mainfrom
cocoapods
Open

Add section on removing CocoaPods from a project#13774
sfshaza2 wants to merge 3 commits into
mainfrom
cocoapods

Conversation

@sfshaza2

@sfshaza2 sfshaza2 commented Aug 20, 2026

Copy link
Copy Markdown
Contributor

@sfshaza2
sfshaza2 requested a review from a team as a code owner August 20, 2026 23:17

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request adds a new section to the documentation detailing how to remove CocoaPods integration from iOS and macOS Flutter projects once they have migrated to Swift Package Manager. The review feedback suggests updating the configuration file cleanup instructions to include the Profile.xcconfig files (and macOS equivalents) alongside the debug and release configurations to prevent build failures in profile mode.

@flutter-website-bot

flutter-website-bot commented Aug 20, 2026

Copy link
Copy Markdown
Collaborator

Staged preview of the updated docs.flutter.dev site (updated for commit cd7e2fa):

https://flutter-docs-prod--docs-pr13774-cocoapods-2kd84rzj.web.app

@sfshaza2
sfshaza2 requested a review from jmagman August 20, 2026 23:36
@jmagman
jmagman requested a review from vashworth August 20, 2026 23:49

In `ios/Flutter/Debug.xcconfig`, `ios/Flutter/Profile.xcconfig`,
and `ios/Flutter/Release.xcconfig`
(and macOS equivalents under `macos/Flutter/`),

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Technically the macOS ones are named differently macos/Flutter/Flutter-Debug.xcconfig and macos/Flutter/Flutter-Release.xcconfig


1. Check your configuration files:

In `ios/Flutter/Debug.xcconfig`, `ios/Flutter/Profile.xcconfig`,

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
In `ios/Flutter/Debug.xcconfig`, `ios/Flutter/Profile.xcconfig`,
In `ios/Flutter/Debug.xcconfig`,

There shouldn't be a profile one

cd macos
pod deintegrate
cd ..
```

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe use tabs for iOS vs macOS?

## How to remove CocoaPods integration

When all Flutter plugins in your project support Swift Package Manager,
you can remove CocoaPods integration completely from your project.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some developer may have also manually edited their Podfile to added CocoaPod dependencies or logic that are not Flutter plugins. If they've done this, they need to manually transition any Pod dependencies or custom logic. We can't really instruct them on how to do this, though, since it can vary widely

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

How to remove Cocoapods after SPM upgrade?

3 participants