docs: add @NativePlugin removal to Capacitor 9 upgrade guide - #586
Draft
OS-ruimoreiramendes wants to merge 3 commits into
Draft
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Extends the "Breaking changes in @capacitor/android" section in the "Updating to 9.0" upgrade guide (
docs/main/updating/9-0.md) with a subsection for the removal of the legacy@NativePluginannotation and its associated deprecated permission/activity-result APIs.The new subsection documents the annotation removal (with a pointer to the Capacitor 3 plugin migration guide for the overall migration pattern) and provides a replacement table for each removed method.
Change Type
Rationale / Problems Fixed
Capacitor 9 removes the legacy
@NativePluginecosystem (see ionic-team/capacitor#8558 / RMET-5305).Plugin authors and app developers hitting compile errors after upgrading need a place that maps each removed API to its replacement, alongside the rest of the Android deprecated API removals from ionic-team/capacitor#8553.
Tests or Reproductions
Content was verified against the actual removals in ionic-team/capacitor#8558: every removed symbol listed in the guide matches the source changes. Replacements were taken directly from the
@deprecatedjavadoc annotations on the removed methods where available, and from the modern equivalents in the same files for the two methods without explicit replacement notes (Plugin.startActivityForResult(int)andBridge.startActivityForPluginWithResult(int)).Platforms Affected
Notes / Comments
chore/RMET-5304-cap9-android-deprecated-apis(docs: add Android deprecated API removals to Capacitor 9 upgrade guide #581) sincedocs/main/updating/9-0.mddoes not yet exist onmain. Once docs: add Android deprecated API removals to Capacitor 9 upgrade guide #581 merges, this PR needs a trivial rebase ontomain.