docs: add Android deprecated API removals to Capacitor 9 upgrade guide - #581
Draft
andredestro wants to merge 1 commit into
Draft
docs: add Android deprecated API removals to Capacitor 9 upgrade guide#581andredestro wants to merge 1 commit into
andredestro wants to merge 1 commit into
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
This was referenced Aug 5, 2026
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
Adds the "Breaking changes in @capacitor/android" section to the "Updating to 9.0" upgrade guide (
docs/main/updating/9-0.md) and registers the page in the Upgrade Guides sidebar.The section covers the Java APIs removed in Capacitor 9 (deprecated in previous majors), with a replacement table for each: the legacy
CapConfigconstructor and generic accessors,PluginCall.save()/isSaved()/hasOption()/isReleased(),Bridge.CAPACITOR_HTTPS_INTERCEPTOR_START,Plugin.getConfigValue(String)and the deprecatedMessageHandlerconstructor.Change Type
Rationale / Problems Fixed
Capacitor 9 removes the Android APIs that were deprecated in previous major versions (see ionic-team/capacitor#8553). Plugin authors and app developers hitting compile errors after upgrading need a single place that maps each removed API to its replacement (RMET-5304).
The legacy
@NativePluginecosystem is not covered here because it is intentionally kept in Capacitor 9 for now; its removal is being evaluated separately.Tests or Reproductions
Content was verified against the actual removals in ionic-team/capacitor#8553: every removed symbol listed in the guide matches the source changes, and the replacements were validated by building and running the capacitor-testapp against that branch.
Platforms Affected
Notes / Comments
main, wheredocs/main/updating/9-0.mddoes not exist yet, so it creates the page with the Android section only. docs: add Capacitor 9 upgrade guide with iOS deprecated API removals #580 creates the same page with the iOS section. Whichever merges second needs a trivial rebase to combine both sections into the same file; the sidebar entry is identical in both.