Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 1 addition & 5 deletions docs/cli/commands/run.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,10 +28,6 @@ npx cap run [options] <platform>
- `--target <id>`: Run on a specific target device
- `--target-name <name>`: Run on a specific target device by its name (ex: "iPhone 17 Pro", "John's iPhone")
- `--target-name-sdk-version <version>`: Run on a target device by name with a specific sdk version when using --target-name, (ex: "26.0" for iOS 26 or "35" for Android API 35). Useful for targets that have the same name but have different OS / SDK versions
- `--live-reload`: Set live-reload URL via CLI (uses defaults, overrides `server.url` config)
- `-l`: Shorthand for `--live-reload`
- `--host <host>`: Configure host for live-reload URL (used with `--live-reload`)
- `--port <port>`: Configure port for live-reload URL (used with `--live-reload`)
- `--https`: Use https:// instead of http:// for live-reload URL (used with `--live-reload`)
- `--url <url>`: Load an external URL in the Web View, useful for live-reload (overrides `server.url` config)
- `--forwardPorts <port1:port2>`: Automatically run "adb reverse" for better live-reloading support

4 changes: 2 additions & 2 deletions docs/main/android/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Capacitor Android apps are configured and managed through Android Studio.

## Android Support

API 24+ (Android 7 or later) is supported, which represents around 99% of the Android market. Capacitor requires an Android WebView with Chrome version 60 or later. On Android 7-9, [Google Chrome](https://play.google.com/store/apps/details?id=com.android.chrome) provides the WebView. On Android 10+ Capacitor uses the [Android System WebView](https://play.google.com/store/apps/details?id=com.google.android.webview).
API 26+ (Android 8 or later) is supported. Capacitor requires an Android WebView with Chrome version 60 or later. On Android 8-9, [Google Chrome](https://play.google.com/store/apps/details?id=com.android.chrome) provides the WebView. On Android 10+ Capacitor uses the [Android System WebView](https://play.google.com/store/apps/details?id=com.google.android.webview).

## Adding the Android Platform

Expand Down Expand Up @@ -46,7 +46,7 @@ Alternatively, you can open Android Studio and import the `android/` directory a

You can either run your app on the command-line or with Android Studio.

> To use an Android Emulator you must use an API 24+ system image. The System WebView does not automatically update on emulators. Physical devices should work as low as API 24 as long as their System WebView is updated.
> To use an Android Emulator you must use an API 26+ system image. The System WebView does not automatically update on emulators. Physical devices should work as low as API 26 as long as their System WebView is updated.

### Running on the Command-Line

Expand Down
2 changes: 1 addition & 1 deletion docs/main/android/setting-target-sdk.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ slug: /android/setting-target-sdk
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
Expand Down
12 changes: 6 additions & 6 deletions docs/main/getting-started/environment-setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,13 +10,13 @@ Capacitor has three officially supported application targets: Android, iOS, and

## Core Requirements

In order to develop any application with Capacitor, you will need NodeJS 22 or higher installed. You can install Node by using the installer on [the Node website](https://nodejs.org), using [Volta](https://volta.sh/): a JavaScript tools manager, or installing it with a package manager like [homebrew](https://brew.sh/), or [Chocolatey](https://chocolatey.org/).
In order to develop any application with Capacitor, you will need NodeJS 24 or higher installed. You can install Node by using the installer on [the Node website](https://nodejs.org), using [Volta](https://volta.sh/): a JavaScript tools manager, or installing it with a package manager like [homebrew](https://brew.sh/), or [Chocolatey](https://chocolatey.org/).

Once you have installed Node, open your terminal of choice and type in the following command to make sure node is properly installed

```bash
node --version
# v22.21.1
# v24.19.0
```

With Node installed, you can get started with creating Progressive Web Applications (PWA) with Capacitor.
Expand All @@ -34,7 +34,7 @@ Once you've installed the core requirements, as well as Xcode, Xcode Command Lin

### Xcode

Xcode is Apple's IDE for creating native macOS, iOS, and iPadOS applications. You can install Xcode by [using the Apple App Store](https://apps.apple.com/us/app/xcode/id497799835?mt=12) on your Mac. Capacitor 8 requires a minimum of Xcode 26.0.
Xcode is Apple's IDE for creating native macOS, iOS, and iPadOS applications. You can install Xcode by [using the Apple App Store](https://apps.apple.com/us/app/xcode/id497799835?mt=12) on your Mac. Capacitor 9 requires a minimum of Xcode 27.0.

### Xcode Command Line Tools

Expand Down Expand Up @@ -120,16 +120,16 @@ Once you've installed the core requirements, as well as an Android SDK with Andr

### Android Studio

Android Studio is Google's IDE for creating native Android applications. You can install Android Studio by going to the [Android Studio download page](https://developer.android.com/studio). Capacitor 8 requires a minimum of Android Studio 2025.2.1.
Android Studio is Google's IDE for creating native Android applications. You can install Android Studio by going to the [Android Studio download page](https://developer.android.com/studio). Capacitor 9 requires a minimum of Android Studio 2025.3.3.

### Android SDK

Once Android Studio has been installed, you need to install an Android SDK package.

Developing Android apps requires some Android SDK packages to be installed. Make sure to install the Android SDK Tools, and a version of the Android SDK Platforms for API 24 or greater.
Developing Android apps requires some Android SDK packages to be installed. Make sure to install the Android SDK Tools, and a version of the Android SDK Platforms for API 26 or greater.

In Android Studio, open **Tools -> SDK Manager** from the menu and install the platform versions you'd like to test with in the **SDK Platforms** tab:

![SDK Platforms](/img/v6/docs/android/sdk-platforms.png)

To get started, you only need to install one API version. In the above image, the SDKs for Android 9 (API 28) and Android 10 (API 29) are installed. The latest stable version is Android 16 (API 36).
To get started, you only need to install one API version. In the above image, the SDKs for Android 9 (API 28) and Android 10 (API 29) are installed. The latest stable version is Android 17 (API 37).
2 changes: 1 addition & 1 deletion docs/main/guides/live-reload.md
Original file line number Diff line number Diff line change
Expand Up @@ -73,5 +73,5 @@ Finally, click the Run button to launch the app and start using Live Reload.
Alternatively to setting `url` in `capacitor.config.json`, you can set the live reload url directly from the CLI when running the app from the command line:

```bash
npx cap run --live-reload --port 8100
npx cap run android --url http://192.168.1.68:8100
```
2 changes: 1 addition & 1 deletion docs/main/ios/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ Capacitor iOS apps are configured and managed with Xcode and [CocoaPods](https:/

## iOS Support

iOS 15+ is supported. Xcode 26.0+ is required (see [Environment Setup](/main/getting-started/environment-setup.md#ios-requirements)). Capacitor uses [WKWebView](https://developer.apple.com/documentation/webkit/wkwebview), not the deprecated [UIWebView](https://developer.apple.com/documentation/uikit/uiwebview).
iOS 16+ is supported. Xcode 27.0+ is required (see [Environment Setup](/main/getting-started/environment-setup.md#ios-requirements)). Capacitor uses [WKWebView](https://developer.apple.com/documentation/webkit/wkwebview), not the deprecated [UIWebView](https://developer.apple.com/documentation/uikit/uiwebview).

## Adding the iOS Platform

Expand Down
3 changes: 3 additions & 0 deletions docs/main/reference/support-policy.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,7 @@ The current status of each Capacitor version is:

| Version | Status | Released | Maintenance Ends | Ext. Support Ends |
| :-----: | :------------: | :--------------: | :---------------: | :---------------: |
| v9 | Unreleased | TBD | TBD | TBD |
| v8 | **Active** | December 8, 2025 | TBD | TBD |
| v7 | Extended Support | January 20, 2025 | June 8, 2026 | Dec 8, 2026 |
| v6 | End of Support | April 15, 2024 | July 20, 2025 | January 20, 2026 |
Expand All @@ -40,6 +41,7 @@ The Capacitor team has compiled a set of recommendations for using the Capacitor

| Capacitor | Minimum Node version | Minimum Xcode version | Minimum Android Studio version |
| :-------: | :------------------: | :-------------------: | :----------------------------: |
| v9 | 24 | 27.0 | 2025.3.3 |
| v8 | 22 | 26.0 | 2025.2.1 |
| v7 | 20 | 16.0 | 2024.2.1 |
| v6 | 18 | 15.0 | 2023.1.1 |
Expand All @@ -53,6 +55,7 @@ Each Capacitor version sets a minimum version for each of its supported platform

| Capacitor | Minimum iOS version | Minimum Android version |
| :-------: | :-----------------: | :---------------------: |
| v9 | 16.0 | 8.0 (API 26) |
| v8 | 15.0 | 7.0 (API 24) |
| v7 | 14.0 | 6.0 (API 23) |
| v6 | 13.0 | 5.1 (API 22) |
Expand Down