docs: update Capacitor 9 docs outside guides and plugin APIs - #591
Open
andredestro wants to merge 1 commit into
Open
docs: update Capacitor 9 docs outside guides and plugin APIs#591andredestro wants to merge 1 commit into
andredestro wants to merge 1 commit into
Conversation
andredestro
requested review from
ItsChaceD,
OS-pedrogustavobilro,
OS-ruimoreiramendes,
alexgerardojacinto,
jcesarmobile,
markemer and
theproducer
August 12, 2026 13:52
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
andredestro
force-pushed
the
chore/RMET-5321-cap9-plugin-upgrade-guide
branch
from
August 14, 2026 10:22
6dd69f7 to
e4ff100
Compare
andredestro
force-pushed
the
chore/RMET-5322-cap9-docs-misc
branch
from
August 14, 2026 10:32
ed2c887 to
caf73d1
Compare
andredestro
force-pushed
the
chore/RMET-5321-cap9-plugin-upgrade-guide
branch
from
August 14, 2026 11:42
e4ff100 to
0400079
Compare
andredestro
force-pushed
the
chore/RMET-5322-cap9-docs-misc
branch
from
August 14, 2026 11:42
caf73d1 to
7288075
Compare
Updates cap run CLI docs and the live-reload guide for the --url flag merge, refreshes iOS/Android minimum platform mentions, and adds a v9 row to the support policy and target SDK tables. RMET-5322
andredestro
force-pushed
the
chore/RMET-5322-cap9-docs-misc
branch
from
August 14, 2026 12:05
7288075 to
c86e308
Compare
Comment on lines
8
to
24
| All Android applications must specify a target SDK version, or the version of Android that the application is designed to run on. Each year, Google releases updates to the Android operating system and subsequently bumps the version number that applications are required to target. Typically, [this date is August 31st](https://support.google.com/googleplay/android-developer/answer/11926878?hl=en) of each year. Because of this, it is important to keep your application up to date with the latest version of Android. In a Capacitor application, this is done by specifying your target SDK in the `/android/variables.gradle` file. | ||
|
|
||
| ```groovy | ||
| targetSdkVersion = 36 | ||
| targetSdkVersion = 37 | ||
| ``` | ||
|
|
||
| ## Capacitor Android Requirements | ||
|
|
||
| In Capacitor, the Android target SDK version is strongly tied to the major version of Capacitor. This means that while you could change the target SDK to a higher version and rebuild your application, there's a very strong likelihood that your application will experience issues not otherwise present. The Capacitor team releases a new major version of Capacitor every year that includes support for the new target SDK version to ensure that applications remain compliant with Google's requirements. For this reason, it is important to keep your application up to date with the latest major version of Capacitor. | ||
|
|
||
| ## Android Target SDK Matrix | ||
|
|
||
| The following table shows the target SDK versions that are supported by Capacitor Android. | ||
|
|
||
| | Capacitor Android | Target SDK Version | | ||
| | ----------------- | ------------------ | | ||
| | 8.x | 36 | |
Contributor
There was a problem hiding this comment.
Because the targetSdkVersion is now the same as compile SDK version, perhaps this page needs tweaking? Also, we could add 9.x to Android Target SDK matrix as well?
|
|
||
| ```bash | ||
| npx cap run --live-reload --port 8100 | ||
| npx cap run android --url http://192.168.1.68:8100 |
Contributor
There was a problem hiding this comment.
Minor: To maintain the same command it should be without android, users can select android or ios manually afterwards.
Contributor
There was a problem hiding this comment.
Kind of related to this, we could update the "Official Platforms" under docs/main/getting-started/faqs.md as well?
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
2 participants
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
Updates Capacitor 9 documentation that falls outside the app/plugin migration guides and the auto-generated plugin API pages:
docs/cli/commands/run.mdanddocs/main/guides/live-reload.md: replace the removed--live-reload/-l/--host/--port/--httpsflags with the new--urlflag (verified directly against the CLI's current option list on thenextbranch)docs/main/ios/index.md: iOS 15+ / Xcode 26.0+ → iOS 16+ / Xcode 27.0+docs/main/android/index.md: API 24+ → API 26+ (both the general support statement and the emulator note), keeping the Chrome-vs-System-WebView distinction accurate for the new floor (Android 8-9 vs 10+)docs/main/android/setting-target-sdk.md: exampletargetSdkVersion36 → 37docs/main/getting-started/environment-setup.md: Node 22 → 24, Xcode 26.0 → 27.0, Android Studio 2025.2.1 → 2025.3.3, minimum installable SDK API 24 → 26, latest stable Android 16 (API 36) → Android 17 (API 37)docs/main/reference/support-policy.mdx: added av9row to all three tables (release status, compatibility recommendations, minimum supported platforms), markedUnreleased/TBD where there's no public date yetChange Type
Rationale / Problems Fixed
docs/mainnow represents the unreleased Capacitor 9 (next), but several reference pages still described Capacitor 8 minimums and the old live-reload CLI flags. These are locked-in facts already shipped in thenextbranch (Node/iOS/Android floors, the--urlflag), so keeping the docs stale would actively mislead anyone testing against Capacitor 9 alpha.Internal Jira reference: https://outsystemsrd.atlassian.net/browse/RMET-5322
Tests or Reproductions
Every changed value was verified against the actual Capacitor 9
nextbranch (CLI option list,variables.gradle,--versionoutputs) rather than inferred, and cross-checked with the internal System Requirements doc for the platform floors. Verifiednpm run build(Docusaurus) succeeds with no broken links or routes.Note: unlike the other changes, the
support-policy.mdxv9row records values that are still moving pre-GA (e.g. Xcode 27 is in beta at the time of writing). Decided to add it now anyway and revisit if it drifts before GA, rather than waiting until release like previous majors did.Screenshots / Media
N/A
Platforms Affected