Skip to content

[BREAKING] Drop CocoaPods from the install docs and release process - #100

Open
jrosendahl-opt wants to merge 1 commit into
masterfrom
docs/drop-cocoapods
Open

jrosendahl-opt wants to merge 1 commit into
masterfrom
docs/drop-cocoapods

Conversation

@jrosendahl-opt

Copy link
Copy Markdown
Contributor

Why

CocoaPods trunk goes read-only on Dec 2, 2026. 1.4.0 is the last version we publish there, and 2.0.0 onward ships through Swift Package Manager only. Part of 2.0.0. Don't merge until 1.4.0, the last CocoaPods release, has shipped.

What Changed

  • README: the CocoaPods install section now says 1.4.0 is the last CocoaPods version and later versions are SPM-only. The SPM example uses from: "2.0.0".
  • docs/releasing.md, rewritten for SPM:
    • Removed: Ruby/CocoaPods setup, the Gemfile update, the podspec bump, pod lib lint/pod spec lint, pod trunk push.
    • Release branch: named release/X.Y.Z, not the bare version, which made 1.3.0 ambiguous between branch and tag. It's a regular PR, not a draft.
    • Release step: publish a bare tag (no v) on the squash-merge commit. A draft release creates no tag; that's why from: "1.3.0" didn't resolve until Nov 9.
    • New final step: check that swift package resolve finds the version.
    • Demo apps: points to the README's build steps.
  • CI: the tag-trigger comment explains bare tags in terms of SPM instead of the podspec.
  • PR template: "a vX.Y.Z tag" → "a bare X.Y.Z release tag".

How to Test

  • Read through docs/releasing.md as the 2.0.0 release checklist

Notes

🤖 Generated with Claude Code

CocoaPods trunk goes read-only on Dec 2, 2026, and 1.4.0 is the last
version published there. The README's CocoaPods section now says so and
points to SPM, whose example moves to 2.0.0. docs/releasing.md drops
the podspec, lint and trunk steps, names the release branch
release/X.Y.Z so it can't be confused with the tag, warns that a draft
release creates no tag, and adds an SPM resolve check. The CI tag
comment and PR template now describe bare tags in terms of SPM.

The podspec and the cocoapods gem stay until the Objective-C demo moves
to SPM.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@jrosendahl-opt
jrosendahl-opt requested review from a team as code owners November 10, 2026 02:23
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.

1 participant