Apache Cordova

Cordova CLI 13.0.0 Released!

Tue, 25 Nov 2025 00:00:00 +0000

We are happy to announce that cordova@13.0.0 has been released! This is the latest version of the Cordova command-line interface (CLI) used for creating and building Cordova apps.

cordova@13.0.0 on npm

To upgrade a global installation:

npm uninstall -g cordova
npm install -g cordova@latest

Note: If you are installing Cordova locally in a project (not globally), simply omit the -g flag.

Release Highlights

The most notable changes in this major release include:

Updated npm dependencies.
Increased Node.js engine requirement to >=20.17.0 || >=22.9.0.
Removed telemetry.

One of the main dependencies that was updated is cordova-lib, which for provides the core CLI functionality for managing platforms and plugins, including adding and removing them. Among the breaking changes in this release, the cordova serve command has been removed.

We recommend checking out the following blog posts for updates on related packages that also apply to Cordova CLI:

Please report any issues you find by following the How to File a Bug guide!

Changes include:

Breaking Changes:

GH-678 feat!: bump dependencies & node engine requirement
GH-633 feat!: remove telemetry feature
GH-672 chore(npm)!: bump various npm packages
GH-666 chore!: bump node requirement & npm dependencies
GH-642 chore!: Prepare for next major

Fixes:

GH-662 fix: bump @babel/helpers
GH-640 fix: remove potential error when setting exit code

Others:

GH-679 chore: update release audit workflow & license headers
GH-677 chore(deps-dev): bump js-yaml from 4.1.0 to 4.1.1
GH-676 chore(deps): bump glob from 10.4.5 to 10.5.0
GH-673 chore: license headers
GH-671 chore(deps): bump tmp from 0.2.3 to 0.2.4
GH-668 chore(coverage): Move from nyc to c8 for code coverage
GH-667 chore(deps): bump on-headers and compression
GH-665 chore(deps-dev): bump brace-expansion from 1.1.11 to 1.1.12
GH-658 chore(deps): bump systeminformation from 5.22.11 to 5.23.8
GH-657 chore(deps): bump path-to-regexp and express
GH-654 chore(deps): bump cross-spawn from 7.0.3 to 7.0.6
GH-655 chore(ci): Add code scanning & fix dependabot failures
GH-646 chore(deps): bump micromatch from 4.0.7 to 4.0.8
GH-652 chore(deps): bump cookie and express
GH-643 chore: Update dependencies
GH-637 chore(deps): bump express from 4.18.2 to 4.19.2
GH-639 chore(deps): bump tar from 6.2.0 to 6.2.1
GH-641 chore(deps): bump braces from 3.0.2 to 3.0.3
GH-635 chore(deps): bump ip from 2.0.0 to 2.0.1
GH-631 chore: Rolled dependencies to the latest non-breaking versions
GH-670 ci: various workflow improvements
GH-669 ci(workflow): update release-audit & license config
GH-656 ci: use apache-rat-action@v1 (tag)
GH-638 ci: update codecov@v4 w/ token
GH-636 ci: update release audit workflow
GH-630 ci(gh-action): add Apache RAT & package license checker workflow
GH-554 doc(create): update default values
GH-428 doc: update README.md
GH-616 doc: update & refactor cli reference

Cordova iOS 8.0.0 is now available!

Sun, 23 Nov 2025 00:00:00 +0000

After nearly 2 years of work, we are excited to finally announce that we have released Cordova iOS 8.0.0! This is Cordova's platform supporting the development of applications for iOS & iPadOS; now with better support for the latest platform features.

cordova-ios@8.0.0

To upgrade:

cordova platform remove ios
cordova platform add ios@8.0.0

This is a major version release which includes some breaking changes!
We have tried hard to make the update process as smooth as possible for both application and plugin developers, while improving the experience for developers embedding Cordova iOS as a library.

For plugin authors, we've written a guide about Upgrading Plugins to Cordova iOS 8.x.

Release Highlights

Supported version minimums
- The minimum supported iOS version is now 13.
- The minimum supported Xcode version is now 15.
- The minimum supported NodeJS version is now 20.17.
Embracing Swift
- The platform project now uses Swift classes and a storyboard file.
- Plugins can now be set up as Swift packages, including other Swift packages as dependencies.
- CordovaLib is available as a Swift package to be embedded in existing projects.
Platform project modernizing
- The Xcode project, and build target are now always named App.
  This resolves numerous issues around CocoaPods, multi-target projects, and Info.plist additions, but potentially breaks some hooks that assume the project name matches what's defined in config.xml.
- The platform project now supports building for macOS using Catalyst.
- The platform project has adopted the iOS Scene APIs, which are required for iOS 26 support.
- CordovaLib (used as a library) supports targeting the visionOS platform.
Build-in status bar handling
- Status bar handling is now built-in to Cordova iOS, and the StatusBar plugin is no longer required in most cases.
- Whether the status bar is shown or not is controlled by the viewport meta tag's viewport-fit directive.
- The background color of the status bar is controlled by the theme-color meta tag.
App icon simplification
- Projects can now provide a single 1024px × 1024px icon in config.xml.
- Projects building with Xcode 16 or newer can provide monochrome and dark mode icon variants.
- See GH-1465 for details.
- NOTE: Cordova iOS 8.0.0 does not include support for the new Xcode 26 Icon Composer file format. We hope to introduce support in the near future.
Bunches of bugs fixed
- Range requests are now supported for large media files when using a custom protocol.
- Opening system alert boxes from JavaScript code should no longer freeze the application.
- Improved error messaging when no iOS simulators are installed.
- Configurable behavior for recovering from web view crashes that sometimes left blank screens.
- Fix for handleOpenURL() not firing reliably when the app is launched.
- Improve handling for the deployment-target preference with CocoaPods.
Embedded framework improvements
- Several memory leaks have been fixed when disposing of a Cordova view controller.
- Several API improvements for specifying background colours and splash screen behaviour.
- Introduced CDVSceneDelegate for integrating with the iOS Scene API.
- Added nullability annotations to several classes and API methods.
- New API documentation is published for the CordovaLib classes.

The full changelog is available to read here. Please report any issues you find on our Cordova-iOS GitHub issue tracker!

Cordova Lib 13.0.0 Released!

Wed, 05 Nov 2025 00:00:00 +0000

We are happy to announce that cordova-lib@13.0.0 has been released. This is the main library behind the Cordova CLI, handling project and build operations.

cordova-lib@13.0.0

Release Highlights

The most notable changes in this major release are:

Updated the library's npm dependencies.
Increased the Node.js engine requirement to >=20.17.0 || >=22.9.0.
Dropped support for the cordova serve command.
Dropped support for the create plugin command.
Added support for listing available emulators with the cordova emulate <platform> --list command.

Please report any issues you find by following the How to File a Bug guide!

Changes include:

Breaking Changes:

GH-964 chore(npm)!: bump write-file-atomic@7.0.0
GH-961 chore!: update dependencies & node requirement
GH-957 feat!: remove cordova serve command
GH-955 chore(npm)!: bump various packages
GH-953 feat(plugman)!: remove create plugin support
GH-949 chore!: bump node requirement & npm dependencies
GH-958 chore!: remove deprecated platform data
GH-959 chore!: remove unused templates

Features:

GH-952 feat: replace dep-graph dependency w/ custom class

Fixes:

GH-944 fix(emulator): Support listing emulators with --list

Chores:

GH-963 chore: update package-lock.json
GH-960 chore: various updates to the root files
GH-956 chore(npm): bump @cordova/eslint-config@6.0.0
GH-946 chore(deps-dev): bump brace-expansion from 1.1.11 to 1.1.12
GH-939 chore(deps): bump path-to-regexp and express
GH-937 chore(deps): bump cross-spawn from 7.0.3 to 7.0.6
GH-938 chore(ci): Fix failing dependabot PRs

CI & Others:

GH-954 ci: various workflow improvements
GH-950 ci(workflow): update release-audit & license config
GH-945 ci: Add node 22 and 24 to CI testing matrix
GH-941 Keep final new line in package.json
GH-942 Persist relative paths on disk

Cordova Create 6.0.0 Released!

Wed, 22 Oct 2025 00:00:00 +0000

We are happy to announce that cordova-create@6.0.0 has been released. This is the library used behind-the-scenes of the Cordova tooling for creating a Cordova project.

Release Highlights

The most notable changes in this major release were:

Updated the library's npm dependencies.
Increased in the Node.js engine requirement to >=20.17.0 || >=22.9.0.

Changes include:

Breaking Changes:

GH-99 chore!: upgrade @cordova/eslint-config@6.0.0
GH-98 chore!: bump package dependencies
- cordova-app-hello-world@7.0.0
- cordova-common@6.0.0
- cordova-fetch5.0.0
- tmp@0.2.5
- rewire@9.0.1
- jasmine@5.10.0
- npm-package-arg@13.0.0
- Bumped node engine requirement >=20.17.0 || >=22.9.0
GH-94 chore!: bump node requirement & npm dependencies

Chores & CI:

GH-103 chore: add .npmrc & update ignore files
GH-102 chore: replace nyc with c8
GH-101 chore: update project defaults
GH-100 chore: ci and license updates
GH-97 chore(deps): bump tmp from 0.2.3 to 0.2.4
GH-96 ci: use macos-15 instead of macos-latest
GH-93 ci(workflow): add release-audit & license config
GH-92 chore(deps-dev): bump brace-expansion from 1.1.11 to 1.1.12
GH-91 chore(deps): bump cross-spawn from 7.0.3 to 7.0.6
GH-90 chore(deps): bump micromatch from 4.0.5 to 4.0.8
GH-88 chore(deps): bump braces from 3.0.2 to 3.0.3
GH-86 chore(deps): Update npm deps, add Node 20 to CI
GH-87 ci: update codecov@v4 w/ token

Cordova Fetch 5.0.0 Released!

Fri, 29 Aug 2025 00:00:00 +0000

We are happy to announce that cordova-fetch@5.0.0 has been released. This is the library used behind-the-scenes of the Cordova tooling for fetching of Cordova platforms and plugins.

Release Highlights

The most notable changes in this major release were:

Updated the library's npm dependencies.
Increased in the Node.js engine requirement to >=20.9.0.

Changes include:

Breaking Changes:

GH-131 chore(npm)!: bump cordova-common@6.0.0
GH-125 chore!: bump node requirement & npm dependencies

Chores:

GH-136 chore(README): update badges
GH-135 chore: update & add source code license headers
GH-130 chore: bump @cordova/eslint-config
GH-127 chore(coverage): Move from nyc to c8 for code coverage
GH-124 chore(deps-dev): bump brace-expansion from 1.1.11 to 1.1.12
GH-122 chore(deps): bump cross-spawn from 7.0.3 to 7.0.6
GH-120 chore(deps): bump micromatch from 4.0.5 to 4.0.8
GH-119 chore(deps): bump braces from 3.0.2 to 3.0.3
GH-116 chore(deps): Update some dependencies, add Node 20 to CI

CI:

GH-137 ci: workflow updates
GH-128 ci(workflow): update release-audit & license config
GH-123 ci: Add licence checker workflow
GH-121 ci: Fix dependabot code scanning errors
GH-118 ci: Set up CodeQL analysis
GH-117 ci: update codecov@v4 w/ token

Tests:

GH-126 test: drop file-url

Cordova App Hello World 7.0.0 Released!

Fri, 29 Aug 2025 00:00:00 +0000

We are happy to announce that cordova-app-hello-world@7.0.0 has been released. This is the default app template used when creating a new Cordova App project though Cordova CLI.

Release Highlights

The most notable changes in this release were:

Setting the body element's box-sizing to border-box to avoid the safe-area-inset padding that caused scrolling issues
Disabled the overscroll behavior of the root element to remove rubber-banding effects.
Used modern, unprefixed CSS directives.
Updated default template's package ID to org.apache.cordova.hellocordova.

Changes include:

Fixes:

GH-98 fix(css): Fix extra padding causing scrolling

Chores:

GH-99 chore: updated defaults, license headers & added release audit workflow
GH-78 chore: correct access inline comment

Cordova Common 6.0.0 Released!

Sat, 09 Aug 2025 00:00:00 +0000

We are happy to announce that cordova-common@6.0.0 has been released. This is one of the libraries used behind-the-scenes by nearly all of the Cordova tooling and provides utilities for dealing with things like config.xml parsing.

Release Highlights

The most notable changes in this major release were:

Removal of superspawn, which also dropped the npm dependencies q and cross-spawn.
Update to the <resource-file> directive to allow directories and their contents to be copied.
Update to the <config-file> and <edit-config> directives to support finding unprefixed Info.plist files.
Increase in the Node.js engine requirement to >=20.9.0.

Changes include:

Breaking Changes:

GH-239 feat!: change resource-file behavior to support directory contents
GH-236 feat!: remove superspawn.js
GH-231 feat!: remove superspawn & npm packages q & cross-spawn
GH-235 dep(npm)!: bump @cordova/eslint-config@6.0.0
Bumps node >=20.9.0
GH-228 chore!: bump node >=20.5.0 & upgrade npm packages

Features:

GH-212 feat: Support finding an unprefixed Info.plist file

Chores:

GH-240 chore: update package-lock.json
GH-232 chore(tests): Improve test coverage
GH-229 chore(coverage): Move from nyc to c8 for code coverage
GH-238 dep(npm): update w/ rebuilt package-lock.json
GH-237 refactor(bom): Bring strip-bom in as util

CI & Refactoring:

GH-234 ci: use macos-15
GH-233 ci(workflow): update release-audit & license config
GH-230 ci: add permissions block & commit hash pinning of third-party actions

Cordova Android 14.0.1 Released!

Wed, 30 Apr 2025 00:00:00 +0000

We are happy to announce that we have just released Cordova Android 14.0.1! This is one of Cordova's supported platforms for building Android applications.

cordova-android@14.0.1

To upgrade:

cordova platform remove android
cordova platform add android@14.0.1

To install:

cordova platform add android@14.0.1

Release Highlights

Fixes

Fetching Gradle Path for Windows

Resolved an issue in Windows environments where projects containing spaces in their paths could not be built due to changes in how the Gradle path was fetched.

Setting Gradle's java.home

Resolved an issue where the user-defined environment variable JAVA_HOME or CORDOVA_JAVA_HOME was not being used to set the java.home property for the Gradle Wrapper.

Changes include:

Fixes:

GH-1795 fix: configure gradle java.home
GH-1793 fix(windows): get gradle path with which command

Cordova Android 14.0.0 Released!

Wed, 26 Mar 2025 00:00:00 +0000

We are happy to announce that we have just released Cordova Android 14.0.0! This is one of Cordova's supported platforms for building Android applications.

cordova-android@14.0.0

To upgrade:

cordova platform remove android
cordova platform add android@14.0.0

To install:

cordova platform add android@14.0.0

Release Highlights

BREAKING CHANGES

Increased Target SDK

This release has increased the target SDK to 35 (Android 15).

Project Dependencies

The following Gradle dependencies were bumpped:

Gradle: 8.13
Android Gradle Plugin (AGP): 8.7.3

Additionally, the following libraries have been upgraded:

AndroidX App Compat - 1.7.0
AndroidX WebKit - 1.12.1
AndroidX SplashScreen Core - 1.0.1
Google Services Gradle Plugin - 4.4.2

If you or a plugin has made changes to any of the following configuration preferences, the build results might not match the expected outcomes with this release:

Preference	Default Value
`android-minSdkVersion`	24
`android-maxSdkVersion`	Not set
`android-targetSdkVersion`	35
`android-compileSdkVersion`	android-targetSdkVersion configured value
`android-buildToolsVersion`	35.0.0
`GradleVersion`	8.13
`AndroidGradlePluginVersion`	8.7.3
`GradlePluginKotlinVersion`	1.9.24
`AndroidXAppCompatVersion`	1.7.0
`AndroidXWebKitVersion`	1.12.1
`GradlePluginGoogleServicesVersion`	4.4.2

Please take note of the versions that have been updated in this release. If you have manually modified any of these values, it is recommended to review and update the preference values accordingly.

Increased Android Studio Requirement

With the increase of Android Gradle Plugin, Android Studio Ladybug is the minimum required version for building and running projects in Android Studio. This aligns with the Android Gradle plugin and Android Studio compatibility documentation.
Required Build Tools

To use cordova-android@14.0.0, SDK Platform 35 and SDK Build Tools 35.0.0 must be installed. Older build tools version can be uninstalled if older versions of cordova-android is no longer used in any of your projects.

Upgrade with Command-line tools:

The recommended way to install SDK Platform 35 and SDK Build Tools 35.0.0 is by using sdkmanager, which is part of Android's Command-line tools package. The command-line tools is useful as it does not require Android Studio.

At the time of writing, version 19 of the Command-line tools was downloaded from Android Studio's SDK Manager and used. It can also be downloaded from the Android Developers website.
```
  sdkmanager 'build-tools;35.0.0' 'platforms;android-35'
```
You may need to run the update flag first:
```
  sdkmanager --update
```
Upgrade with Android Studio:

To install SDK Platform 35:
1. Open Android Studio's SDK Manager:
2. Click on SDK Platforms tab
3. Check Android 15.0 ("VanillaIceCream") which has the API Level of 35
4. Click Apply
To install SDK Build Tools 35.0.0:
1. Open Android Studio's SDK Manager:
2. Click on SDK Tools tab
3. Check Show Package Details
4. Expand Android SDK Build-Tools
5. Check 35.0.0
6. Click Apply
Increased Java Source & Target Compatibility

The Java Source & Target Compatibility has been increased to version 11. This aligns with the default settings used when creating a blank native project.
Increased Node.js Engine Requirement

The Node.js engine requirement in this release has been increased to version 20.5.0 or later.
Deprecated CordovaPlugin's initialize Method

The initialize method of the CordovaPlugin class has been marked as deprecated and will be removed in a future release. While this method was always considered deprecated, it was not properly annotated to notify plugin developers.

We recommend using the pluginInitialize method as a replacement for initialize.
Replaced Library kotlin-stdlib-jdk* with kotlin-stdlib

The kotlin-stdlib-jdk* libraries have been replaced with kotlin-stdlib. Both kotlin-stdlib-jdk7 and kotlin-stdlib-jdk8 are merged into kotlin-stdlib.

Feature

Added AndroidEdgeToEdge Preference Support

By default, Android 15 enforces the Edge-to-Edge feature, which may affect some Apache Cordova apps.

In this major release, Apache Cordova has opted out of the Edge-to-Edge feature to retain the original behavior and allow app developers ample time to make the necessary adjustments to support Edge-to-Edge.

Users can re-enable the Edge-to-Edge feature using this new preference flag.

It is expected that in Android's next major release, opting out of Edge-to-Edge will no longer be possible.

Apache Cordova will continue to prepare for this expected future behavior change.

Changes include:

Breaking Changes:

GH-1788 dep!: bump npm packages
- nyc@17.1.0
- which@5.0.0
- semver@7.7.1
- jasmine@5.6.0
- android-versions@2.1.0
- cordova-common@5.0.1
- fast-glob@3.3.3
- nopt@8.1.0
GH-1789 feat!: bump node engine requirement >=20.5.0
GH-1784 feat!: bump java default targets to 11
GH-1771 feat!: deprecate CordovaPlugin's method initialize
GH-1767 feat!: use kotlin-stdlib instead of kotlin-stdlib-jdk*
GH-1763 feat!: SDK 35 Support

Features:

GH-1785 feat: bump gradle to 8.13
GH-1779 feat: add AndroidEdgeToEdge preference & theme flag
GH-1778 feat: Account for Node security patch
GH-1768 feat: androidx.core:core-splashscreen@1.0.1
GH-1766 feat: com.google.gms:google-services@4.4.2
GH-1765 feat: androidx.webkit:webkit@1.12.1
GH-1764 feat: androidx.appcompat:appcompat@1.7.0

Fixes:

GH-1790 fix: replace fs-extra.ensureFileSync with fs.writeFileSync
GH-1781 fix: copy gradle wrapper from tools to platform root dir
GH-1770 fix: creation of cdv-gradle-config.json w/ --link flag
GH-1739 fix(docs): Incorrect JDK requirement stated in README
GH-1718 fix: app restart when BT keyboard is connected in some devices

Chores & Refactoring:

GH-1786 chore: add AndroidX build test to gitignore
GH-1774 style: update & resolve doc block warnings
GH-1772 refactor: replace fs-extra with node:fs
GH-1769 refactor: prefix node:*
GH-1748 chore(deps): bump cross-spawn from 7.0.3 to 7.0.6
GH-1750 chore(ci): Fix dependabot PR failures
GH-1736 chore(deps): bump micromatch from 4.0.5 to 4.0.8
GH-1716 chore(deps): bump braces from 3.0.2 to 3.0.3

Media Capture Plugin 6.0.0 Released!

Wed, 26 Feb 2025 00:00:00 +0000

We are happy to announce that we have just released an update for cordova-plugin-media-capture!

cordova-plugin-media-capture@6.0.0

To upgrade:

cordova plugin remove cordova-plugin-media-capture
cordova plugin add cordova-plugin-media-capture@6.0.0

Release Highlights

This major release primarily focused on ensuring that the plugin complies with Android's new strict permission requirements.

Specifically, it removes unnecessary permissions such as:

android.permission.READ_EXTERNAL_STORAGE
android.permission.WRITE_EXTERNAL_STORAGE
android.permission.RECORD_AUDIO

Additionally, it removes broad media permissions:

android.permission.READ_MEDIA_AUDIO
android.permission.READ_MEDIA_IMAGES
android.permission.READ_MEDIA_VIDEO

Please report any issues you find by following the How to File a Bug guide!

Changes include:

Breaking Changes:

GH-308 feat(android)!: remove unnecessary permissions
GH-280 feat(android)!: remove RECORD_AUDIO permission not requested at runtime
GH-295 fix(android)!: remove broad media permissions

Features:

GH-281 feat(android): Field 'storagePermissions' may be 'final'

Fixes:

GH-307 fix(android): Remove usage of Media Store queries
GH-302 fix(android): save media capture to File Provider

Chores, Refactoring, CI:

GH-306 chore: upgrade eslint config and rolled dependencies
GH-305 chore: npmrc
GH-284 chore: update asf config
GH-309 refactor(android): cleanup unused or obsolete code
GH-304 ci(ios): update workflow environment
GH-301 ci: sync workflow w/ paramedic