docs: add page for migrating capacitor plugin from v7 to v8

[ItsChaceD]

No description provided.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
capacitor-docs	Ready	Preview	Comment	Nov 12, 2025 9:57pm

[jcesarmobile]

It's missing the deprecated Gradle property name syntax changes.

Also it's telling to update to versions that don't exist yet (npm and SPM), I think we usually recommend using the next tag for the npm versions and should use the -alpha (or -beta if we release it before merging this) for the SPM version, and then once we release the final version we update the docs to use the final versions.

[jcesarmobile]

the docs should also include information related to changed needed for using kotlin 2.2.0, it only mentions the update of the kotlin_version value, but should include more information like kotlinOptions changes, (i.e. this) or any other changes we might have done on gradle files, and also warn about possible code changes needed.

[riderx]

It would be nice to have a way to have plugin support multiple major versions, at least one backward.

The community often lags by one major version, and this prevents them from getting the latest bug fixes.

Currently, we have to backport feature in a lot of our plugin.

I don't know if that's doable; at least 6 to 7 was from my perspective.

Second point, I don't see in this migration the mention of SPM becoming default/mandatory. Does this change?