This is an automated email from the ASF dual-hosted git repository.
github-actions[bot] pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/cordova-docs.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 751fc51be5 Deploying to asf-site from @
apache/cordova-docs@9c4a8eb284fbc7e8e5e995cc6c6b348965d69375 🚀
751fc51be5 is described below
commit 751fc51be5dd960732bbe74aaa1e6889f9a22519
Author: GitToTheHub <[email protected]>
AuthorDate: Sat Sep 26 07:47:05 2026 +0000
Deploying to asf-site from @
apache/cordova-docs@9c4a8eb284fbc7e8e5e995cc6c6b348965d69375 🚀
---
docs/en/latest/config_ref/images.html | 47 ++-
docs/en/latest/config_ref/index.html | 35 ++
docs/en/latest/cordova/events/events.html | 35 ++
docs/en/latest/cordova/storage/storage.html | 35 ++
.../latest/core/features/splashscreen/index.html | 35 ++
docs/en/latest/guide/appdev/allowlist/index.html | 35 ++
docs/en/latest/guide/appdev/hooks/index.html | 35 ++
docs/en/latest/guide/appdev/privacy/index.html | 35 ++
docs/en/latest/guide/appdev/security/index.html | 35 ++
docs/en/latest/guide/cli/index.html | 35 ++
docs/en/latest/guide/cli/installation.html | 35 ++
docs/en/latest/guide/cli/template.html | 35 ++
docs/en/latest/guide/hybrid/plugins/index.html | 35 ++
docs/en/latest/guide/hybrid/webviews/index.html | 35 ++
docs/en/latest/guide/next/index.html | 35 ++
docs/en/latest/guide/overview/index.html | 35 ++
.../latest/guide/overview/project-structure.html | 35 ++
docs/en/latest/guide/platforms/android/index.html | 35 ++
docs/en/latest/guide/platforms/android/plugin.html | 35 ++
.../en/latest/guide/platforms/android/upgrade.html | 35 ++
.../en/latest/guide/platforms/android/webview.html | 35 ++
docs/en/latest/guide/platforms/electron/index.html | 35 ++
docs/en/latest/guide/platforms/ios/index.html | 35 ++
docs/en/latest/guide/platforms/ios/plugin.html | 35 ++
docs/en/latest/guide/platforms/ios/upgrade.html | 35 ++
docs/en/latest/guide/platforms/ios/webview.html | 35 ++
docs/en/latest/guide/support/index.html | 35 ++
docs/en/latest/index.html | 46 +++
.../index.html | 420 ++++++++-------------
docs/en/latest/platform_pinning/index.html | 35 ++
.../platform_plugin_versioning_ref/index.html | 35 ++
docs/en/latest/plugin_ref/plugman.html | 35 ++
docs/en/latest/plugin_ref/spec.html | 35 ++
docs/en/latest/reference/cordova-cli/index.html | 35 ++
.../cordova-plugin-battery-status/index.html | 35 ++
.../reference/cordova-plugin-camera/index.html | 35 ++
.../reference/cordova-plugin-device/index.html | 35 ++
.../reference/cordova-plugin-dialogs/index.html | 35 ++
.../reference/cordova-plugin-file/index.html | 246 ++++--------
.../cordova-plugin-geolocation/index.html | 35 ++
.../cordova-plugin-inappbrowser/index.html | 37 +-
.../cordova-plugin-media-capture/index.html | 35 ++
.../reference/cordova-plugin-media/index.html | 35 ++
.../cordova-plugin-network-information/index.html | 35 ++
.../cordova-plugin-screen-orientation/index.html | 35 ++
.../cordova-plugin-splashscreen/index.html | 35 ++
.../reference/cordova-plugin-statusbar/index.html | 68 +++-
.../reference/cordova-plugin-vibration/index.html | 35 ++
docs/en/latest/third-party/index.html | 35 ++
feed.xml | 4 +-
sitemap.xml | 193 +++++-----
static/css/main.css | 24 +-
52 files changed, 2032 insertions(+), 558 deletions(-)
diff --git a/docs/en/latest/config_ref/images.html
b/docs/en/latest/config_ref/images.html
index cac4dec528..45b9fc5cc7 100644
--- a/docs/en/latest/config_ref/images.html
+++ b/docs/en/latest/config_ref/images.html
@@ -810,6 +810,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
@@ -2209,6 +2244,12 @@ If you do not specify an icon, the Apache Cordova logo
is used.</p>
<h4>Adaptive Icon with Vectors:</h4>
+<p>Android vector drawable resources are XML files, not regular SVG files. To
convert an SVG for use
+as a vector drawable, open Vector Asset Studio in Android Studio by
right-clicking the <code>res</code> folder
+and selecting <code>New > Vector Asset</code>, then import the SVG. A
vector drawable can be resized for
+different screen densities without losing image quality; Android Studio can
also generate bitmap
+fallbacks for older Android versions that do not support vector drawables.</p>
+
<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nt"><platform</span> <span
class="na">name=</span><span class="s">"android"</span><span
class="nt">></span>
<span class="nt"><icon</span> <span class="na">monochrome=</span><span
class="s">"res/icon/android/ldpi-monochrome.png"</span> <span
class="na">background=</span><span
class="s">"res/icon/android/ldpi-background.xml"</span> <span
class="na">density=</span><span class="s">"ldpi"</span> <span
class="na">foreground=</span><span
class="s">"res/icon/android/ldpi-foreground.xml"</span> <span
class="na">src=</span><span class="s">"res/android/ldpi.png"</span> <span
class="nt">/></span>
<span class="nt"><icon</span> <span class="na">monochrome=</span><span
class="s">"res/icon/android/mdpi-monochrome.png"</span> <span
class="na">background=</span><span
class="s">"res/icon/android/mdpi-background.xml"</span> <span
class="na">density=</span><span class="s">"mdpi"</span> <span
class="na">foreground=</span><span
class="s">"res/icon/android/mdpi-foreground.xml"</span> <span
class="na">src=</span><span class="s">"res/android/mdpi.png"</span> <span
class="nt">/></span>
@@ -2267,9 +2308,11 @@ If you do not specify an icon, the Apache Cordova logo
is used.</p>
<p><strong>See Also:</strong></p>
<ul>
- <li><a
href="https://developer.android.com/guide/practices/ui_guidelines/icon_design_adaptive";>Android
icon guide</a></li>
+ <li><a
href="https://developer.android.com/studio/write/create-app-icons";>Create app
icons with Android Studio</a></li>
+ <li><a
href="https://developer.android.com/studio/write/vector-asset-studio";>Add
multi-density vector graphics with Vector Asset Studio</a></li>
+ <li><a
href="https://developer.android.com/develop/ui/compose/system/icon_design_adaptive";>Adaptive
icon design guidance</a></li>
<li><a
href="https://developer.android.com/develop/ui/views/launch/icon_design_adaptive#user-theming";>Android
Adaptive icons - User theming</a></li>
- <li><a
href="https://developer.android.com/guide/practices/screens_support.html";>Android
- Supporting multiple screens</a></li>
+ <li><a
href="https://developer.android.com/guide/practices/screens_support";>Android -
Supporting multiple screens</a></li>
</ul>
<h2>Browser</h2>
diff --git a/docs/en/latest/config_ref/index.html
b/docs/en/latest/config_ref/index.html
index 19628715cf..15548e2966 100644
--- a/docs/en/latest/config_ref/index.html
+++ b/docs/en/latest/config_ref/index.html
@@ -810,6 +810,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/cordova/events/events.html
b/docs/en/latest/cordova/events/events.html
index 935cc87990..4e7488575e 100644
--- a/docs/en/latest/cordova/events/events.html
+++ b/docs/en/latest/cordova/events/events.html
@@ -808,6 +808,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/cordova/storage/storage.html
b/docs/en/latest/cordova/storage/storage.html
index 6304b452f4..6f928708a3 100644
--- a/docs/en/latest/cordova/storage/storage.html
+++ b/docs/en/latest/cordova/storage/storage.html
@@ -810,6 +810,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/core/features/splashscreen/index.html
b/docs/en/latest/core/features/splashscreen/index.html
index 9a4b8a0a8f..6771464685 100644
--- a/docs/en/latest/core/features/splashscreen/index.html
+++ b/docs/en/latest/core/features/splashscreen/index.html
@@ -810,6 +810,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/guide/appdev/allowlist/index.html
b/docs/en/latest/guide/appdev/allowlist/index.html
index b794949d08..dfb8eac015 100644
--- a/docs/en/latest/guide/appdev/allowlist/index.html
+++ b/docs/en/latest/guide/appdev/allowlist/index.html
@@ -810,6 +810,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/guide/appdev/hooks/index.html
b/docs/en/latest/guide/appdev/hooks/index.html
index 04783624e1..ae1ea009bb 100644
--- a/docs/en/latest/guide/appdev/hooks/index.html
+++ b/docs/en/latest/guide/appdev/hooks/index.html
@@ -810,6 +810,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/guide/appdev/privacy/index.html
b/docs/en/latest/guide/appdev/privacy/index.html
index f1b4931afe..b73e94ac01 100644
--- a/docs/en/latest/guide/appdev/privacy/index.html
+++ b/docs/en/latest/guide/appdev/privacy/index.html
@@ -810,6 +810,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/guide/appdev/security/index.html
b/docs/en/latest/guide/appdev/security/index.html
index fcdb022117..9f32e05648 100644
--- a/docs/en/latest/guide/appdev/security/index.html
+++ b/docs/en/latest/guide/appdev/security/index.html
@@ -810,6 +810,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/guide/cli/index.html
b/docs/en/latest/guide/cli/index.html
index 019c7a41c7..bb6c53a8db 100644
--- a/docs/en/latest/guide/cli/index.html
+++ b/docs/en/latest/guide/cli/index.html
@@ -810,6 +810,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/guide/cli/installation.html
b/docs/en/latest/guide/cli/installation.html
index 1cbc4daeec..2c057644b2 100644
--- a/docs/en/latest/guide/cli/installation.html
+++ b/docs/en/latest/guide/cli/installation.html
@@ -810,6 +810,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/guide/cli/template.html
b/docs/en/latest/guide/cli/template.html
index 60a8cf044a..7a09446bb0 100644
--- a/docs/en/latest/guide/cli/template.html
+++ b/docs/en/latest/guide/cli/template.html
@@ -808,6 +808,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/guide/hybrid/plugins/index.html
b/docs/en/latest/guide/hybrid/plugins/index.html
index 7d210376b1..77eef42844 100644
--- a/docs/en/latest/guide/hybrid/plugins/index.html
+++ b/docs/en/latest/guide/hybrid/plugins/index.html
@@ -810,6 +810,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/guide/hybrid/webviews/index.html
b/docs/en/latest/guide/hybrid/webviews/index.html
index 947196f6c2..e72add7b79 100644
--- a/docs/en/latest/guide/hybrid/webviews/index.html
+++ b/docs/en/latest/guide/hybrid/webviews/index.html
@@ -808,6 +808,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/guide/next/index.html
b/docs/en/latest/guide/next/index.html
index a3d775cf56..3dbb360cb4 100644
--- a/docs/en/latest/guide/next/index.html
+++ b/docs/en/latest/guide/next/index.html
@@ -808,6 +808,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/guide/overview/index.html
b/docs/en/latest/guide/overview/index.html
index fe1f81be7f..b1325e8a9f 100644
--- a/docs/en/latest/guide/overview/index.html
+++ b/docs/en/latest/guide/overview/index.html
@@ -810,6 +810,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/guide/overview/project-structure.html
b/docs/en/latest/guide/overview/project-structure.html
index 4117ba4edc..6c251cdbc6 100644
--- a/docs/en/latest/guide/overview/project-structure.html
+++ b/docs/en/latest/guide/overview/project-structure.html
@@ -810,6 +810,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/guide/platforms/android/index.html
b/docs/en/latest/guide/platforms/android/index.html
index 0044979f53..06f2553dfd 100644
--- a/docs/en/latest/guide/platforms/android/index.html
+++ b/docs/en/latest/guide/platforms/android/index.html
@@ -810,6 +810,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/guide/platforms/android/plugin.html
b/docs/en/latest/guide/platforms/android/plugin.html
index a60167cf2f..4c5fcafdf7 100644
--- a/docs/en/latest/guide/platforms/android/plugin.html
+++ b/docs/en/latest/guide/platforms/android/plugin.html
@@ -810,6 +810,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/guide/platforms/android/upgrade.html
b/docs/en/latest/guide/platforms/android/upgrade.html
index 403772cd16..1252137d2e 100644
--- a/docs/en/latest/guide/platforms/android/upgrade.html
+++ b/docs/en/latest/guide/platforms/android/upgrade.html
@@ -808,6 +808,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1753,6 +1773,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/guide/platforms/android/webview.html
b/docs/en/latest/guide/platforms/android/webview.html
index 4e8f99555c..a8d0b8d086 100644
--- a/docs/en/latest/guide/platforms/android/webview.html
+++ b/docs/en/latest/guide/platforms/android/webview.html
@@ -808,6 +808,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1753,6 +1773,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/guide/platforms/electron/index.html
b/docs/en/latest/guide/platforms/electron/index.html
index c1a5ca2395..2208935cce 100644
--- a/docs/en/latest/guide/platforms/electron/index.html
+++ b/docs/en/latest/guide/platforms/electron/index.html
@@ -810,6 +810,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/guide/platforms/ios/index.html
b/docs/en/latest/guide/platforms/ios/index.html
index f67feb11f9..ba4fe94308 100644
--- a/docs/en/latest/guide/platforms/ios/index.html
+++ b/docs/en/latest/guide/platforms/ios/index.html
@@ -810,6 +810,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/guide/platforms/ios/plugin.html
b/docs/en/latest/guide/platforms/ios/plugin.html
index 6de827c699..c6fb12bf36 100644
--- a/docs/en/latest/guide/platforms/ios/plugin.html
+++ b/docs/en/latest/guide/platforms/ios/plugin.html
@@ -810,6 +810,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/guide/platforms/ios/upgrade.html
b/docs/en/latest/guide/platforms/ios/upgrade.html
index e42bfe868f..8927bcafce 100644
--- a/docs/en/latest/guide/platforms/ios/upgrade.html
+++ b/docs/en/latest/guide/platforms/ios/upgrade.html
@@ -808,6 +808,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1753,6 +1773,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/guide/platforms/ios/webview.html
b/docs/en/latest/guide/platforms/ios/webview.html
index 1423cd0456..14f31895ed 100644
--- a/docs/en/latest/guide/platforms/ios/webview.html
+++ b/docs/en/latest/guide/platforms/ios/webview.html
@@ -808,6 +808,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1753,6 +1773,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/guide/support/index.html
b/docs/en/latest/guide/support/index.html
index 07fbf7e78a..24498a555c 100644
--- a/docs/en/latest/guide/support/index.html
+++ b/docs/en/latest/guide/support/index.html
@@ -810,6 +810,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/index.html b/docs/en/latest/index.html
index d5c7bb6892..8faf959eb1 100644
--- a/docs/en/latest/index.html
+++ b/docs/en/latest/index.html
@@ -808,6 +808,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1753,6 +1773,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
@@ -2382,6 +2417,15 @@
+ <li>
+ <h2><a href="package_ref/index.html">package.json API</a></h2>
+ <span class="summary">List of Cordova-specific fields in the
package.json file, and when the CLI updates them.</span>
+ </li>
+
+
+
+
+
<li>
<h2><a href="plugin_ref/spec.html">Plugin.xml API</a></h2>
<span class="summary">List of supported tags in the plugin.xml
file.</span>
@@ -2406,6 +2450,8 @@
+
+
<h1>Resources</h1>
<ul>
diff --git a/docs/en/latest/platform_plugin_versioning_ref/index.html
b/docs/en/latest/package_ref/index.html
similarity index 65%
copy from docs/en/latest/platform_plugin_versioning_ref/index.html
copy to docs/en/latest/package_ref/index.html
index ad79acde8d..8be340a1e8 100644
--- a/docs/en/latest/platform_plugin_versioning_ref/index.html
+++ b/docs/en/latest/package_ref/index.html
@@ -6,12 +6,12 @@
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta name="format-detection" content="telephone=no">
<meta name="viewport" content="user-scalable=no, initial-scale=1,
maximum-scale=1, minimum-scale=1, width=device-width" />
- <meta name="description" content="How to manage platforms & plugins
versions. ">
+ <meta name="description" content="List of Cordova-specific fields in the
package.json file, and when the CLI updates them. ">
<title>
- Version Management - Apache Cordova
+ package.json API - Apache Cordova
</title>
@@ -23,7 +23,7 @@
- <link rel="canonical"
href="https://cordova.apache.org/docs/en/latest/platform_plugin_versioning_ref/";>
+ <link rel="canonical"
href="https://cordova.apache.org/docs/en/latest/package_ref/";>
<!-- CSS -->
<link rel="stylesheet" type="text/css" href="/static/css/main.css">
@@ -322,16 +322,14 @@
<li>
- <a class="this-page"
href="/docs/en/latest/platform_plugin_versioning_ref/index.html">
+ <a class=""
href="/docs/en/latest/platform_plugin_versioning_ref/index.html">
Version Management
</a>
- <span class="entry-highlight"></span>
-
- <div id="page-toc" class="page-toc"></div>
+
</li>
@@ -810,6 +808,28 @@
+ <li>
+
+ <a class="this-page" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+ <span class="entry-highlight"></span>
+
+
+
+
+ <div id="page-toc" class="page-toc"></div>
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1432,7 +1452,7 @@
<li>
- <a class="this-page"
href="/docs/en/latest/platform_plugin_versioning_ref/index.html">
+ <a class=""
href="/docs/en/latest/platform_plugin_versioning_ref/index.html">
Version Management
</a>
</li>
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="this-page" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
@@ -2092,7 +2127,7 @@
</div>
- <a class="edit hidden-xs hidden-sm"
href="https://github.com/apache/cordova-docs/tree/master/www/docs/en/latest/platform_plugin_versioning_ref/index.md";><span
class="glyphicon glyphicon-pencil" aria-hidden="true"></span> </a>
+ <a class="edit hidden-xs hidden-sm"
href="https://github.com/apache/cordova-docs/tree/master/www/docs/en/latest/package_ref/index.md";><span
class="glyphicon glyphicon-pencil" aria-hidden="true"></span> </a>
</div>
@@ -2111,295 +2146,144 @@
<div id="page-toc-source">
- <h1>Version Management</h1>
-
-<p>Cordova allows developers to <strong>save</strong> and
<strong>restore</strong> platforms and plugins, eliminating the need to check
in platform and plugin source code.</p>
+ <svg xmlns="http://www.w3.org/2000/svg"; hidden=""
style="display: none !important"><symbol id="cdv-platform-browser"
viewBox="461.6 9.3 30 30"><path d="M476.7 10.3c-7.7 0-14 6.3-14 14s6.3 14 14 14
14-6.3 14-14-6.3-14-14-14m9.8 9h-5.1c-.3-2.1-.8-4-1.4-5.5 2.8.9 5.1 2.9 6.5
5.5m-6.8 5-.1 3h-5.8l-.1-3 .1-3h5.8l.1 3m-3
11h-.9c-.6-1.1-1.4-3.1-1.8-6h5.3c-.4 2.9-1.1 4.8-1.8 6h-.8m-2.7-16c.4-2.9
1.1-4.8 1.8-6h1.8c.6 1.1 1.4 3.1 1.8 6H474zm-.6-5.5c-.6 1.5-1.1 3.4-1.4
5.5h-5.1c1.3- [...]
+
+<h1>package.json API</h1>
+
+<p>Alongside <code>config.xml</code>, every Cordova project created with the
CLI also has a standard npm <a
href="https://docs.npmjs.com/cli/configuring-npm/package-json";><code>package.json</code></a>
file. Cordova reads and writes fields inside <code>package.json</code> to keep
track of your project's platforms and plugins.</p>
+
+<p>This page lists the Cordova-specific fields you may find in your
<code>package.json</code>, and explains when and how the CLI updates each one,
so that you know what's safe to edit by hand and what's managed for
you.</p>
+
+<p><strong>Sample <code>package.json</code>:</strong></p>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="nl">"name"</span><span class="p">:</span><span
class="w"> </span><span class="s2">"io.cordova.hellocordova"</span><span
class="p">,</span><span class="w">
+ </span><span class="nl">"displayName"</span><span class="p">:</span><span
class="w"> </span><span class="s2">"HelloCordova"</span><span
class="p">,</span><span class="w">
+ </span><span class="nl">"version"</span><span class="p">:</span><span
class="w"> </span><span class="s2">"1.0.0"</span><span class="p">,</span><span
class="w">
+ </span><span class="nl">"description"</span><span class="p">:</span><span
class="w"> </span><span class="s2">"Sample Apache Cordova App"</span><span
class="p">,</span><span class="w">
+ </span><span class="nl">"main"</span><span class="p">:</span><span
class="w"> </span><span class="s2">"index.js"</span><span
class="p">,</span><span class="w">
+ </span><span class="nl">"scripts"</span><span class="p">:</span><span
class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="nl">"test"</span><span class="p">:</span><span
class="w"> </span><span class="s2">"echo </span><span class="se">\"</span><span
class="s2">Error: no test specified</span><span class="se">\"</span><span
class="s2"> && exit 1"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="nl">"cordova"</span><span class="p">:</span><span
class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="nl">"platforms"</span><span class="p">:</span><span
class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"android"</span><span class="p">,</span><span
class="w">
+ </span><span class="s2">"ios"</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="nl">"plugins"</span><span class="p">:</span><span
class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="nl">"cordova-plugin-device"</span><span
class="p">:</span><span class="w"> </span><span class="p">{}</span><span
class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="nl">"devDependencies"</span><span
class="p">:</span><span class="w"> </span><span class="p">{</span><span
class="w">
+ </span><span class="nl">"cordova-android"</span><span
class="p">:</span><span class="w"> </span><span
class="s2">"^13.0.0"</span><span class="p">,</span><span class="w">
+ </span><span class="nl">"cordova-ios"</span><span class="p">:</span><span
class="w"> </span><span class="s2">"^7.0.0"</span><span class="p">,</span><span
class="w">
+ </span><span class="nl">"cordova-plugin-device"</span><span
class="p">:</span><span class="w"> </span><span class="s2">"^2.1.0"</span><span
class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
-<p>When a platform or plugin is added, its version details are automatically
saved to the <code>package.json</code> file.</p>
+<h2>name, displayName, version</h2>
-<p>The recommended way to add or remove platforms and plugins is by using the
Cordova CLI commands:</p>
+<p>Set automatically when a project is first created with <code>cordova
create</code>, alongside <code>config.xml</code>. Cordova does not go back and
update these values later if <code>config.xml</code> changes.</p>
-<ul>
- <li><code>cordova platform add|remove ...</code></li>
- <li><code>cordova plugin add|remove ...</code></li>
-</ul>
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Description</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>name</td>
+ <td>Copied from <code>config.xml</code>'s <code>widget id</code>
attribute (the app's reverse-DNS identifier), converted to lowercase.</td>
+ </tr>
+ <tr>
+ <td>displayName</td>
+ <td>Copied from <code>config.xml</code>'s <code><name></code>
element (the app's human-readable name).</td>
+ </tr>
+ <tr>
+ <td>version</td>
+ <td>Copied from <code>config.xml</code>'s <code>widget
version</code> attribute.</td>
+ </tr>
+ </tbody>
+</table>
-<p>Using these commands helps prevent out-of-sync issues.</p>
+<p>Examples:</p>
-<p>While it is technically possible to add a platform or plugin by editing
<code>package.json</code> directly, this is <strong>strongly
discouraged</strong>.</p>
+<div class="language-json highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="nl">"name"</span><span class="p">:</span><span
class="w"> </span><span class="s2">"io.cordova.hellocordova"</span><span
class="p">,</span><span class="w">
+ </span><span class="nl">"displayName"</span><span class="p">:</span><span
class="w"> </span><span class="s2">"HelloCordova"</span><span
class="p">,</span><span class="w">
+ </span><span class="nl">"version"</span><span class="p">:</span><span
class="w"> </span><span class="s2">"1.0.0"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
-<p>The restore process runs automatically when executing <code>cordova
prepare</code>, using the information stored in <code>package.json</code> and
<code>config.xml</code>. This applies to both platforms and plugins. If a
platform or plugin is defined in both files, <code>package.json</code> takes
priority.</p>
+<h2>cordova.platforms</h2>
-<p>One scenario where save/restore capabilities come in handy is in large
teams that work on an app, with each team member focusing on a platform or
plugin. This feature makes it easier to share the project and reduce the amount
of redundant code that is checked in the repository.</p>
+<p>An array listing the platforms currently installed in the project. Entries
are added automatically when you run <code>cordova platform add
<platform></code>, and removed when you run <code>cordova platform remove
<platform></code>. Adding a platform that's already listed will not
create a duplicate entry.</p>
-<p>The adding and removing mechanisim that Cordova CLI uses for platforms and
plugins is controlled by npm CLI. Below we will take a look at the command
syntax and examples.</p>
+<p>Automatic saving can be turned off with the <a
href="#cli---nosave-flag"><code>--nosave</code> flag</a>.</p>
-<h2>Adding Platforms and Plugins</h2>
+<p>Examples:</p>
-<p><strong>Command Syntax:</strong></p>
+<div class="language-json highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="nl">"cordova"</span><span class="p">:</span><span
class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="nl">"platforms"</span><span class="p">:</span><span
class="w"> </span><span class="p">[</span><span
class="s2">"android"</span><span class="p">,</span><span class="w">
</span><span class="s2">"ios"</span><span class="p">]</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
-<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova <platform | plugin> add <span
class="o">[</span><package-spec> ...]
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova platform add android
+cordova platform add ios <span class="nt">--nosave</span>
</code></pre></div></div>
-<p>The <code>package-spec</code> argument supports most formats accepted by
the npm CLI.</p>
+<h2>cordova.plugins</h2>
-<p>Examples include:</p>
+<p>An object listing the plugins currently installed in the project. Each key
is a plugin's ID, and its value holds any CLI variables that were supplied
when the plugin was installed (or an empty object if none were needed). Entries
are added by <code>cordova plugin add <plugin></code> and removed by
<code>cordova plugin remove <plugin></code>. Automatic saving can be
turned off with the <a href="#cli---nosave-flag"><code>--nosave</code>
flag</a>.</p>
-<ul>
- <li>Scoped and non-scoped npm packages</li>
- <li>Local directory paths</li>
- <li>Git remote URLs</li>
- <li>Tarball archives</li>
- <li><a href="#Cordova-Resolved-Names">Cordova Resolved Names</a> for
official Cordova platforms</li>
-</ul>
+<p>Examples:</p>
-<p>Additionally, the <code>--nosave</code> flag could be appended to the
command to prevent adding of specified platform and plugins from the
<code>package.json</code> file.</p>
-
-<hr />
-
-<p><strong>Quick Overview:</strong></p>
-
-<p>When you add a platform or plugin, <code>package.json</code> is updated
with its dependencies and Cordova-specific metadata.</p>
-
-<p>For example, running the following commands in a Cordova project:</p>
-
-<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova platform add [email protected]
-cordova plugin add [email protected]
-</code></pre></div></div>
-
-<p>Would result in <code>package.json</code> containing the following
entries:</p>
-
-<div class="language-json highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nl">"devDependencies"</span><span
class="p">:</span><span class="w"> </span><span class="p">{</span><span
class="w">
- </span><span class="nl">"cordova-android"</span><span
class="p">:</span><span class="w"> </span><span
class="s2">"^13.0.0"</span><span class="p">,</span><span class="w">
- </span><span class="nl">"cordova-plugin-device"</span><span
class="p">:</span><span class="w"> </span><span class="s2">"^3.0.0"</span><span
class="w">
-</span><span class="p">}</span><span class="err">,</span><span class="w">
-</span><span class="nl">"cordova"</span><span class="p">:</span><span
class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nl">"platforms"</span><span class="p">:</span><span
class="w"> </span><span class="p">[</span><span class="w">
- </span><span class="s2">"android"</span><span class="w">
- </span><span class="p">],</span><span class="w">
- </span><span class="nl">"plugins"</span><span class="p">:</span><span
class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nl">"cordova-plugin-device"</span><span
class="p">:</span><span class="w"> </span><span class="p">{}</span><span
class="w">
+<div class="language-json highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="nl">"cordova"</span><span class="p">:</span><span
class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="nl">"plugins"</span><span class="p">:</span><span
class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="nl">"cordova-plugin-camera"</span><span
class="p">:</span><span class="w"> </span><span class="p">{},</span><span
class="w">
+ </span><span class="nl">"cordova-plugin-some-plugin"</span><span
class="p">:</span><span class="w"> </span><span class="p">{</span><span
class="w">
+ </span><span class="nl">"API_KEY"</span><span class="p">:</span><span
class="w"> </span><span class="s2">"my-api-key"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
</span><span class="p">}</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
-<p>When restoring a Cordova project, this metadata determines which platforms
and plugins will be installed.</p>
-
-<hr />
-
-<h3>Various <code>add</code> Examples</h3>
-
-<ul>
- <li>
- <p><strong>Cordova Resolved Names for Platforms:</strong></p>
-
- <div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> cordova platform add android
-</code></pre></div> </div>
-
- <p>If no tag or version is specified, the Cordova CLI will fetch the
latest release.</p>
-
- <div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> cordova platform add electron@latest
-</code></pre></div> </div>
-
- <p>NPM tags are supported and can be appended to the end of the package
specification.</p>
-
- <div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> cordova platform add [email protected]
-</code></pre></div> </div>
-
- <p>Exact release versions published to the npm registry are also supported
and can be appended to the end of the package specification.</p>
- </li>
- <li>
- <p><strong>npm Package:</strong></p>
-
- <div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> cordova platform add cordova-android
- cordova platform add cordova-android@latest
- cordova platform add [email protected]
-
- cordova platform add @cordova/some-platform
- cordova platform add @cordova/some-platform@latest
- cordova platform add @cordova/[email protected]
-
- cordova plugin some-cordova-plugin
- cordova plugin some-cordova-plugin@latest
-
- cordova plugin add @cordova/some-plugin
- cordova plugin add @cordova/some-plugin@latest
- cordova plugin add @cordova/[email protected]
-</code></pre></div> </div>
-
- <p>Scoped and non-scope npm packages are supported for both platforms and
plugins. Optionally, npm package tags or released versions can be targeted by
appending to the end of the package name. (e.g.
<code>package-name@latest</code>).</p>
-
- <p>Please note that the scoped packages shown above are only examples and
do not exist.</p>
- </li>
- <li>
- <p><strong>Git remote URL:</strong></p>
-
- <div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> cordova platform add
git://github.com/apache/cordova-android.git
- cordova platform add
git://github.com/apache/cordova-android.git#feature-branch
- cordova platform add git://github.com/apache/cordova-android.git#rel/13.0.0
-
- cordova platform add https://github.com/apache/cordova-android.git
- cordova platform add
https://github.com/apache/cordova-android.git#feature-branch
- cordova platform add https://github.com/apache/cordova-android.git#rel/13.0.0
-
- cordova platform add https://github.com/apache/cordova-android
- cordova platform add https://github.com/apache/cordova-android#feature-branch
- cordova platform add https://github.com/apache/cordova-android#rel/13.0.0
-</code></pre></div> </div>
-
- <p>Various Git URL formats are supported for installing platforms and
plugins. Optionally, a treeish (branch name, tag, or commit ID) can be
specified by appending <code>#<treeish></code> to the URL.</p>
-
- <p>When targeting a treeish, ensure it is production-ready before using it
in a production environment. This functionality is useful for testing and
reviewing pull requests, future releases, or release votes.</p>
- </li>
- <li>
- <p><strong>Git service short hand:</strong></p>
-
- <div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> cordova platform add github:apache/cordova-android
- cordova platform add github:apache/cordova-android#feature-branch
- cordova platform add github:apache/cordova-android#rel/13.0.0
-</code></pre></div> </div>
-
- <p>Platforms and plugins can also be checked out from Git repositories
using a shorthand format.</p>
-
- <p>If your repository is hosted on another Git service, such as Bitbucket
or GitLab, you can modify the command to target these services.</p>
-
- <p>Branches and tags can also be targeted using the shorthand format.
However, ensure that the specified branch or version is production-ready before
using it in production.</p>
- </li>
- <li>
- <p><strong>Tarball Archive:</strong></p>
-
- <div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> cordova platform add ~/path/to/a/tarbal.tgz
-</code></pre></div> </div>
-
- <p>Currently, <strong>only platforms</strong> support installation from a
tarball package. The supported archive formats are <code>.tar.gz</code>,
<code>.tgz,</code> and <code>.tar</code>.</p>
- </li>
- <li>
- <p><strong>Local Directory Path:</strong></p>
-
- <div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> cordova platform add ~/path/to/a/cordova-platform
- cordova plugin add ~/path/to/a/cordova-plugin
-
- cordova platform add C:/Path/to/a/cordova-platform
- cordova plugin add C:/Path/to/a/cordova-plugin
-</code></pre></div> </div>
-
- <p>Platforms and plugins can be installed from a local directory path.</p>
- </li>
-</ul>
-
-<h2>Removing Platforms and Plugins</h2>
-
-<p><strong>Command Syntax:</strong></p>
-
-<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova <platform | plugin> remove
<package-name>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova plugin add cordova-plugin-camera
+cordova plugin add cordova-plugin-some-plugin <span
class="nt">--variable</span> <span class="nv">API_KEY</span><span
class="o">=</span>my-api-key
</code></pre></div></div>
-<p>The <code>remove</code> command also has an alias of <code>rm</code>.</p>
-
-<p>The <code>package-name</code> argument must be the name of the platform or
plugin you want to remove.</p>
-
-<p>For Apache Cordova's platforms, you <strong>MUST</strong> use the <a
href="#Cordova-Resolved-Names">Cordova Resolved Names</a> when removing
them.</p>
-
-<p>The <code>--nosave</code> flag could be appended to the command to prevent
removal of specified platform and plugins from the <code>package.json</code>
file.</p>
+<h2>devDependencies</h2>
-<hr />
+<p>A standard npm field, not unique to Cordova. See npm's docs on <a
href="https://docs.npmjs.com/cli/v12/configuring-npm/package-json#devdependencies";><code>devDependencies</code></a>
for the general behavior. When a platform or plugin is installed,
Cordova's tooling also records it here as an npm dependency, alongside its
installed version number. This is separate from <a
href="#cordovaplatforms"><code>cordova.platforms</code></a> and <a
href="#cordovaplugins"><code>cordova.plu [...]
-<h3>Various <code>remove</code> Examples</h3>
+<p>Automatic saving can be turned off with the <a
href="#cli---nosave-flag"><code>--nosave</code> flag</a>.</p>
-<ul>
- <li>
- <p><strong>Removing platforms:</strong></p>
+<p>Examples:</p>
- <div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> cordova platform remove android
-</code></pre></div> </div>
-
- <p>The above command will remove the <code>cordova-android</code> platform
from the project and <code>package.json</code> file.</p>
-
- <p><em>Note: If the platform definition existed in <code>config.xml</code>
from older version's of Cordova CLI, it will also be removed from
<code>config.xml</code>.</em></p>
- </li>
- <li>
- <p><strong>Removing plugins:</strong></p>
-
- <div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> cordova plugin remove cordova-plugin-device
-</code></pre></div> </div>
-
- <p>The above command will remove the <code>cordova-plugin-device</code>
plugin from the project and <code>package.json</code> file.</p>
-
- <p><em>Note: If the plugin definition existed in <code>config.xml</code>
from older version's of Cordova CLI, it will also be removed from
<code>config.xml</code>.</em></p>
- </li>
-</ul>
-
-<h2>Important Notes on Platform Restoration</h2>
-
-<ol>
- <li>
- <p>What version is installed when using <code>cordova platform add
android</code> and the platform is defined in <code>config.xml</code>?</p>
-
- <p>If the <code>config.xml</code> file contains the following entry:</p>
-
- <div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> <span class="cp"><?xml version='1.0'
encoding='utf-8'?></span>
- ...
- <span class="nt"><engine</span> <span class="na">name=</span><span
class="s">"android"</span> <span class="na">spec=</span><span
class="s">"13.0.0"</span> <span class="nt">/></span>
- ...
- <span class="nt"></xml></span>
-</code></pre></div> </div>
-
- <p>When running the <strong><code>cordova platform add
android</code></strong> command with no version provided, it will use the
<code>spec</code> version defined in <code>config.xml</code>. In this example
it would be <code>13.0.0</code>.</p>
- </li>
- <li>
- <p>What version is restored if a platform is defined in both
<code>config.xml</code> and <code>package.json</code>?</p>
-
- <p>Suppose your project has the following configurations:</p>
-
- <p><strong><code>config.xml</code></strong>:</p>
-
- <div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> <span class="nt"><engine</span> <span
class="na">name=</span><span class="s">"android"</span> <span
class="na">spec=</span><span class="s">“12.0.0”</span> <span
class="nt">/></span>
-</code></pre></div> </div>
-
- <p><strong><code>package.json</code></strong>:</p>
+<div class="language-json highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="nl">"devDependencies"</span><span
class="p">:</span><span class="w"> </span><span class="p">{</span><span
class="w">
+ </span><span class="nl">"cordova-android"</span><span
class="p">:</span><span class="w"> </span><span
class="s2">"^13.0.0"</span><span class="p">,</span><span class="w">
+ </span><span class="nl">"cordova-plugin-camera"</span><span
class="p">:</span><span class="w"> </span><span class="s2">"^7.0.0"</span><span
class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
- <div class="language-json highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="w"> </span><span
class="nl">"cordova"</span><span class="p">:</span><span class="w">
</span><span class="p">{</span><span class="w">
- </span><span class="nl">"platforms"</span><span class="p">:</span><span
class="w"> </span><span class="p">[</span><span class="w">
- </span><span class="s2">"android"</span><span class="w">
- </span><span class="p">]</span><span class="w">
- </span><span class="p">}</span><span class="err">,</span><span class="w">
- </span><span class="nl">"dependencies"</span><span class="p">:</span><span
class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="nl">"cordova-android"</span><span
class="p">:</span><span class="w"> </span><span
class="s2">"^13.0.0"</span><span class="w">
- </span><span class="p">}</span><span class="w">
-</span></code></pre></div> </div>
+<h2>CLI --nosave Flag</h2>
- <p>When <code>cordova prepare</code> is executed, the version from
<code>package.json</code> has higher priority over <code>config.xml</code>. It
will install version <code>^13.0.0</code>.</p>
- </li>
-</ol>
+<p>By default, <code>cordova platform add</code> and <code>cordova plugin
add</code> automatically save what you installed into
<code>package.json</code>. If you'd rather install something without
permanently adding it to your project's configuration, for example, to test
a plugin temporarily, pass the <code>--nosave</code> flag:</p>
-<h2>Cordova Resolved Names</h2>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova platform add android <span
class="nt">--nosave</span>
+cordova plugin add cordova-plugin-camera <span class="nt">--nosave</span>
+</code></pre></div></div>
-<table>
- <thead>
- <tr>
- <th>Cordova Resolved Name</th>
- <th>NPM Package Name</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>android</code></td>
- <td><code>cordova-android</code></td>
- </tr>
- <tr>
- <td><code>electron</code></td>
- <td><code>cordova-electron</code></td>
- </tr>
- <tr>
- <td><code>ios</code></td>
- <td><code>cordova-ios</code></td>
- </tr>
- <tr>
- <td><code>browser</code></td>
- <td><code>cordova-browser</code></td>
- </tr>
- </tbody>
-</table>
+<p>This applies to <code>cordova.platforms</code>,
<code>cordova.plugins</code>, and <code>devDependencies</code> all at once,
there's a single flag, not one per field.</p>
</div>
diff --git a/docs/en/latest/platform_pinning/index.html
b/docs/en/latest/platform_pinning/index.html
index 1f0184af26..0b20bd5238 100644
--- a/docs/en/latest/platform_pinning/index.html
+++ b/docs/en/latest/platform_pinning/index.html
@@ -810,6 +810,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/platform_plugin_versioning_ref/index.html
b/docs/en/latest/platform_plugin_versioning_ref/index.html
index ad79acde8d..0c447079a1 100644
--- a/docs/en/latest/platform_plugin_versioning_ref/index.html
+++ b/docs/en/latest/platform_plugin_versioning_ref/index.html
@@ -810,6 +810,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/plugin_ref/plugman.html
b/docs/en/latest/plugin_ref/plugman.html
index 661a3dee73..0e0dbfcb27 100644
--- a/docs/en/latest/plugin_ref/plugman.html
+++ b/docs/en/latest/plugin_ref/plugman.html
@@ -810,6 +810,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/plugin_ref/spec.html
b/docs/en/latest/plugin_ref/spec.html
index f75566ec39..2b2dd90b63 100644
--- a/docs/en/latest/plugin_ref/spec.html
+++ b/docs/en/latest/plugin_ref/spec.html
@@ -808,6 +808,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="this-page" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="this-page" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/reference/cordova-cli/index.html
b/docs/en/latest/reference/cordova-cli/index.html
index a98d3dbc69..5534d9229a 100644
--- a/docs/en/latest/reference/cordova-cli/index.html
+++ b/docs/en/latest/reference/cordova-cli/index.html
@@ -810,6 +810,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/reference/cordova-plugin-battery-status/index.html
b/docs/en/latest/reference/cordova-plugin-battery-status/index.html
index 7b22340603..6ee9ed68d1 100644
--- a/docs/en/latest/reference/cordova-plugin-battery-status/index.html
+++ b/docs/en/latest/reference/cordova-plugin-battery-status/index.html
@@ -808,6 +808,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/reference/cordova-plugin-camera/index.html
b/docs/en/latest/reference/cordova-plugin-camera/index.html
index 6a5259a9db..44c7bbeb99 100644
--- a/docs/en/latest/reference/cordova-plugin-camera/index.html
+++ b/docs/en/latest/reference/cordova-plugin-camera/index.html
@@ -808,6 +808,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/reference/cordova-plugin-device/index.html
b/docs/en/latest/reference/cordova-plugin-device/index.html
index 98c792859a..755b42b976 100644
--- a/docs/en/latest/reference/cordova-plugin-device/index.html
+++ b/docs/en/latest/reference/cordova-plugin-device/index.html
@@ -808,6 +808,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/reference/cordova-plugin-dialogs/index.html
b/docs/en/latest/reference/cordova-plugin-dialogs/index.html
index 5b2bf41e05..2791b3f7f2 100644
--- a/docs/en/latest/reference/cordova-plugin-dialogs/index.html
+++ b/docs/en/latest/reference/cordova-plugin-dialogs/index.html
@@ -808,6 +808,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/reference/cordova-plugin-file/index.html
b/docs/en/latest/reference/cordova-plugin-file/index.html
index 86e85686b4..3e20c3cbda 100644
--- a/docs/en/latest/reference/cordova-plugin-file/index.html
+++ b/docs/en/latest/reference/cordova-plugin-file/index.html
@@ -808,6 +808,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
@@ -2144,7 +2179,15 @@
<h1>cordova-plugin-file</h1>
-<p><a
href="https://github.com/apache/cordova-plugin-file/actions/workflows/android.yml";><img
src="https://github.com/apache/cordova-plugin-file/actions/workflows/android.yml/badge.svg";
alt="Android Testsuite" /></a> <a
href="https://github.com/apache/cordova-plugin-file/actions/workflows/chrome.yml";><img
src="https://github.com/apache/cordova-plugin-file/actions/workflows/chrome.yml/badge.svg";
alt="Chrome Testsuite" /></a> <a
href="https://github.com/apache/cordova-plugin-file/actions/w [...]
+<p><a href="https://npmjs.com/package/cordova-plugin-file";><img
src="https://img.shields.io/npm/v/cordova-plugin-file/latest?label=Latest%20Release%20(npm)"
alt="npm - Latest" /></a>
+<a href="https://github.com/apache/cordova-plugin-file";><img
src="https://img.shields.io/github/package-json/v/apache/cordova-plugin-file?label=Development%20(Git)"
alt="GitHub" /></a></p>
+
+<p><a
href="https://github.com/apache/cordova-plugin-file/actions/workflows/ci.yml?query=branch%3Amaster";><img
src="https://github.com/apache/cordova-plugin-file/actions/workflows/ci.yml/badge.svg?branch=master";
alt="GitHub - Node Workflow" /></a>
+<a
href="https://github.com/apache/cordova-plugin-file/actions/workflows/android.yml";><img
src="https://github.com/apache/cordova-plugin-file/actions/workflows/android.yml/badge.svg";
alt="Android Testsuite" /></a>
+<a
href="https://github.com/apache/cordova-plugin-file/actions/workflows/chrome.yml";><img
src="https://github.com/apache/cordova-plugin-file/actions/workflows/chrome.yml/badge.svg";
alt="Chrome Testsuite" /></a>
+<a
href="https://github.com/apache/cordova-plugin-file/actions/workflows/ios.yml";><img
src="https://github.com/apache/cordova-plugin-file/actions/workflows/ios.yml/badge.svg";
alt="iOS Testsuite" /></a>
+<a
href="https://github.com/apache/cordova-plugin-file/actions/workflows/lint.yml";><img
src="https://github.com/apache/cordova-plugin-file/actions/workflows/lint.yml/badge.svg";
alt="Lint Test" /></a>
+<a
href="https://github.com/apache/cordova-plugin-file/actions/workflows/release-audit.yml?query=branch%3Amaster";><img
src="https://github.com/apache/cordova-plugin-file/actions/workflows/release-audit.yml/badge.svg?branch=master";
alt="GitHub - Release Audit Workflow" /></a></p>
<p>This plugin implements a File API allowing read/write access to files
residing on the device, based on the following W3C specifications:</p>
@@ -2185,8 +2228,6 @@ function onDeviceReady() {
<ul>
<li>Android</li>
<li>iOS</li>
- <li>OS X</li>
- <li>Windows*</li>
<li>Browser</li>
</ul>
@@ -2201,25 +2242,25 @@ Each URL is in the form <em>file:///path/to/spot/</em>,
and can be converted to
<ul>
<li>
<p><code>cordova.file.applicationDirectory</code> - Read-only directory
where the application
-is installed. (<em>iOS</em>, <em>Android</em>, <em>BlackBerry 10</em>,
<em>OSX</em>, <em>windows</em>)</p>
+is installed. (<em>iOS</em>, <em>Android</em>)</p>
</li>
<li>
<p><code>cordova.file.applicationStorageDirectory</code> - Root directory
of the application's
-sandbox; on iOS & windows this location is read-only (but specific
subdirectories [like
-<code>/Documents</code> on iOS or <code>/localState</code> on windows] are
read-write). All data contained within
-is private to the app. (<em>iOS</em>, <em>Android</em>, <em>BlackBerry
10</em>, <em>OSX</em>)</p>
+sandbox; on iOS this location is read-only (but specific subdirectories [like
+<code>/Documents</code> on iOS] is read-write). All data contained within
+is private to the app. (<em>iOS</em>, <em>Android</em>)</p>
</li>
<li>
<p><code>cordova.file.dataDirectory</code> - Persistent and private data
storage within the
application's sandbox using internal memory (on Android, if you need to use
external memory, use <code>.externalDataDirectory</code>). On iOS, this
directory is not
-synced with iCloud (use <code>.syncedDataDirectory</code>). (<em>iOS</em>,
<em>Android</em>, <em>BlackBerry 10</em>, <em>windows</em>)</p>
+synced with iCloud (use <code>.syncedDataDirectory</code>). (<em>iOS</em>,
<em>Android</em>)</p>
</li>
<li>
<p><code>cordova.file.cacheDirectory</code> - Directory for cached data
files or any files
that your app can re-create easily. The OS may delete these files when the
device
runs low on storage, nevertheless, apps should not rely on the OS to delete
files
-in here. (<em>iOS</em>, <em>Android</em>, <em>BlackBerry 10</em>,
<em>OSX</em>, <em>windows</em>)</p>
+in here. (<em>iOS</em>, <em>Android</em>)</p>
</li>
<li>
<p><code>cordova.file.externalApplicationStorageDirectory</code> -
Application space on
@@ -2234,23 +2275,20 @@ external storage. (<em>Android</em>). See <a
href="#androids-external-storage-qu
(<em>Android</em>). See <a
href="#androids-external-storage-quirks">Quirks</a>.</p>
</li>
<li>
- <p><code>cordova.file.externalRootDirectory</code> - External storage (SD
card) root. (<em>Android</em>, <em>BlackBerry 10</em>). See <a
href="#androids-external-storage-quirks">Quirks</a>.</p>
+ <p><code>cordova.file.externalRootDirectory</code> - External storage (SD
card) root. (<em>Android</em>). See <a
href="#androids-external-storage-quirks">Quirks</a>.</p>
</li>
<li>
<p><code>cordova.file.tempDirectory</code> - Temp directory that the OS
can clear at will. Do not
rely on the OS to clear this directory; your app should always remove files as
-applicable. (<em>iOS</em>, <em>OSX</em>, <em>windows</em>)</p>
+applicable. (<em>iOS</em>)</p>
</li>
<li>
<p><code>cordova.file.syncedDataDirectory</code> - Holds app-specific
files that should be synced
-(e.g. to iCloud). (<em>iOS</em>, <em>windows</em>)</p>
+(e.g. to iCloud). (<em>iOS</em>)</p>
</li>
<li>
<p><code>cordova.file.documentsDirectory</code> - Files private to the
app, but that are meaningful
-to other application (e.g. Office files). Note that for <em>OSX</em> this is
the user's <code>~/Documents</code> directory. (<em>iOS</em>,
<em>OSX</em>)</p>
- </li>
- <li>
- <p><code>cordova.file.sharedDirectory</code> - Files globally available to
all applications (<em>BlackBerry 10</em>)</p>
+to other application (e.g. Office files). (<em>iOS</em>)</p>
</li>
</ul>
@@ -2391,6 +2429,19 @@ the <code>cordova.file.*</code> properties map to
physical paths on a real devic
necessary, but do not rely on this. You should clear this directory as
appropriate for your application.</p>
+<h4>iOS <code>assets-library</code> compatibility root</h4>
+
+<p>On iOS, this plugin also registers a read-only <code>assets-library</code>
filesystem root. It maps native <code>asset-library://...</code> URLs to
internal <code>cdvfile://localhost/assets-library/...</code> URLs so they can
be resolved through the File plugin APIs. This behavior is implemented by the
iOS class <code>CDVAssetLibraryFilesystem</code>.</p>
+
+<p>These URLs are legacy identifiers from Apple's deprecated <a
href="https://developer.apple.com/documentation/assetslibrary";>AssetsLibrary
API</a>. The AssetsLibrary API is for accessing pictures and videos managed by
the Photos application.
+They typically appear when another plugin, custom native code, or older
application code passes an <code>asset-library://</code> URL for an item in the
user's photo library into the File plugin.</p>
+
+<p>This compatibility root is limited to reading metadata and file contents
for an existing asset. Operations that would create, modify, remove, list, or
otherwise manage directories are not supported for <code>assets-library</code>
URLs.</p>
+
+<p>Apple has deprecated <code>AssetsLibrary</code> in favor of the Photos
framework. New code should not introduce dependencies on
<code>asset-library://</code> URLs. This plugin currently preserves support
only as a compatibility layer for existing integrations that still provide
those legacy URLs.</p>
+
+<p>When building an app with an iOS deployment target of 26.0 or later, Apple
obsoletes the underlying <code>AssetsLibrary</code> APIs. In that configuration
this compatibility layer is not registered and <code>asset-library://</code>
URLs are not supported by this plugin.</p>
+
<h3>Android File System Layout</h3>
<table>
@@ -2525,155 +2576,6 @@ partially work again.</p>
<p>If interfacing with the external file system is a requirement for your
application, consider using a <a
href="https://www.npmjs.com/search?q=ecosystem%3Acordova%20storage%20access%20framework";>MediaStore</a>
plugin instead.</p>
-<h3>OS X File System Layout</h3>
-
-<table>
- <thead>
- <tr>
- <th style="text-align: left">Device Path</th>
- <th style="text-align: left"><code>cordova.file.*</code></th>
- <th style="text-align: left"><code>iosExtraFileSystems</code></th>
- <th style="text-align: center">r/w?</th>
- <th style="text-align: center">OS clears</th>
- <th style="text-align: center">private</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td style="text-align:
left"><code>/Applications/<appname>.app/</code></td>
- <td style="text-align: left">-</td>
- <td style="text-align: left">bundle</td>
- <td style="text-align: center">r</td>
- <td style="text-align: center">N/A</td>
- <td style="text-align: center">Yes</td>
- </tr>
- <tr>
- <td style="text-align:
left">    <code>Content/Resources/</code></td>
- <td style="text-align: left">applicationDirectory</td>
- <td style="text-align: left">-</td>
- <td style="text-align: center">r</td>
- <td style="text-align: center">N/A</td>
- <td style="text-align: center">Yes</td>
- </tr>
- <tr>
- <td style="text-align: left"><code>~/Library/Application
Support/<bundle-id>/</code></td>
- <td style="text-align: left">applicationStorageDirectory</td>
- <td style="text-align: left">-</td>
- <td style="text-align: center">r/w</td>
- <td style="text-align: center">No</td>
- <td style="text-align: center">Yes</td>
- </tr>
- <tr>
- <td style="text-align:
left">    <code>files/</code></td>
- <td style="text-align: left">dataDirectory</td>
- <td style="text-align: left">-</td>
- <td style="text-align: center">r/w</td>
- <td style="text-align: center">No</td>
- <td style="text-align: center">Yes</td>
- </tr>
- <tr>
- <td style="text-align: left"><code>~/Documents/</code></td>
- <td style="text-align: left">documentsDirectory</td>
- <td style="text-align: left">documents</td>
- <td style="text-align: center">r/w</td>
- <td style="text-align: center">No</td>
- <td style="text-align: center">No</td>
- </tr>
- <tr>
- <td style="text-align:
left"><code>~/Library/Caches/<bundle-id>/</code></td>
- <td style="text-align: left">cacheDirectory</td>
- <td style="text-align: left">cache</td>
- <td style="text-align: center">r/w</td>
- <td style="text-align: center">No</td>
- <td style="text-align: center">Yes</td>
- </tr>
- <tr>
- <td style="text-align: left"><code>/tmp/</code></td>
- <td style="text-align: left">tempDirectory</td>
- <td style="text-align: left">-</td>
- <td style="text-align: center">r/w</td>
- <td style="text-align: center">Yes*</td>
- <td style="text-align: center">Yes</td>
- </tr>
- <tr>
- <td style="text-align: left"><code>/</code></td>
- <td style="text-align: left">rootDirectory</td>
- <td style="text-align: left">root</td>
- <td style="text-align: center">r/w</td>
- <td style="text-align: center">No**</td>
- <td style="text-align: center">No</td>
- </tr>
- </tbody>
-</table>
-
-<p><strong>Note</strong>: This is the layout for non sandboxed applications. I
you enable sandboxing, the <code>applicationStorageDirectory</code> will be
below ` ~/Library/Containers/<bundle-id>/Data/Library/Application
Support`.</bundle-id></p>
-
-<p>* Files persist across app restarts and upgrades, but this directory can
- be cleared whenever the OS desires. Your app should be able to recreate
any
- content that might be deleted. You should clear this directory as
- appropriate for your application.</p>
-
-<p>** Allows access to the entire file system. This is only available for non
sandboxed apps.</p>
-
-<h3>Windows File System Layout</h3>
-
-<table>
- <thead>
- <tr>
- <th style="text-align: left">Device Path</th>
- <th style="text-align: left"><code>cordova.file.*</code></th>
- <th style="text-align: center">r/w?</th>
- <th style="text-align: center">persistent?</th>
- <th style="text-align: center">OS clears</th>
- <th style="text-align: center">private</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td style="text-align: left"><code>ms-appdata:///</code></td>
- <td style="text-align: left">applicationDirectory</td>
- <td style="text-align: center">r</td>
- <td style="text-align: center">N/A</td>
- <td style="text-align: center">N/A</td>
- <td style="text-align: center">Yes</td>
- </tr>
- <tr>
- <td style="text-align: left">   <code>local/</code></td>
- <td style="text-align: left">dataDirectory</td>
- <td style="text-align: center">r/w</td>
- <td style="text-align: center">Yes</td>
- <td style="text-align: center">No</td>
- <td style="text-align: center">Yes</td>
- </tr>
- <tr>
- <td style="text-align: left">   <code>temp/</code></td>
- <td style="text-align: left">cacheDirectory</td>
- <td style="text-align: center">r/w</td>
- <td style="text-align: center">No</td>
- <td style="text-align: center">Yes*</td>
- <td style="text-align: center">Yes</td>
- </tr>
- <tr>
- <td style="text-align: left">   <code>temp/</code></td>
- <td style="text-align: left">tempDirectory</td>
- <td style="text-align: center">r/w</td>
- <td style="text-align: center">No</td>
- <td style="text-align: center">Yes*</td>
- <td style="text-align: center">Yes</td>
- </tr>
- <tr>
- <td style="text-align: left">   <code>roaming/</code></td>
- <td style="text-align: left">syncedDataDirectory</td>
- <td style="text-align: center">r/w</td>
- <td style="text-align: center">Yes</td>
- <td style="text-align: center">No</td>
- <td style="text-align: center">Yes</td>
- </tr>
- </tbody>
-</table>
-
-<p>* The OS may periodically clear this directory</p>
-
<h2>Android Quirks</h2>
<h3>Android Persistent storage location</h3>
@@ -2946,6 +2848,8 @@ Otherwise it will return the app's scheme path.</p>
<p><code>cdvfile://localhost/persistent|temporary|another-fs-root*/path/to/file</code>
can be used for platform-independent file paths.
cdvfile paths are supported by core plugins - for example you can download an
mp3 file to cdvfile-path via <code>cordova-plugin-file-transfer</code> and play
it via <code>cordova-plugin-media</code>.</p>
+<p>On iOS, <code>cdvfile://localhost/assets-library/...</code> is also
recognized as a legacy compatibility form for native
<code>asset-library://...</code> photo-library URLs. This root is read-only and
exists only for older integrations that still surface
<code>asset-library://</code> identifiers.</p>
+
<p><strong>*Note</strong>: See <a href="#where-to-store-files">Where to Store
Files</a>, <a href="#file-system-layouts">File System Layouts</a> and <a
href="#configuring-the-plugin-optional">Configuring the Plugin</a> for more
details about available fs roots.</p>
<p>To use <code>cdvfile</code> as a tag' <code>src</code> you can convert
it to native path via <code>toURL()</code> method of the resolved fileEntry,
which you can get via <code>resolveLocalFileSystemURL</code> - see examples
below.</p>
@@ -2986,11 +2890,6 @@ cdvfile paths are supported by core plugins - for
example you can download an mp
<span class="nx">my_media</span><span class="p">.</span><span
class="nf">play</span><span class="p">();</span>
</code></pre></div></div>
-<h4>cdvfile quirks</h4>
-<ul>
- <li>Using <code>cdvfile://</code> paths in the DOM is not supported on
Windows platform (a path can be converted to native instead).</li>
-</ul>
-
<h2>List of Error Codes and Meanings</h2>
<p>When an error is thrown, one of the following codes will be used.</p>
@@ -3111,7 +3010,7 @@ Android also supports a special filesystem named
"documents", which re
<p>Here is a request for persistent storage.</p>
<blockquote>
- <p><em>Note</em> When targeting WebView clients (instead of a browser) or
native apps (Windows), you dont need to use <code>requestQuota</code> before
using persistent storage.</p>
+ <p><em>Note</em> When targeting WebView clients (instead of a browser), you
dont need to use <code>requestQuota</code> before using persistent storage.</p>
</blockquote>
<div class="language-js highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nb">window</span><span
class="p">.</span><span class="nf">requestFileSystem</span><span
class="p">(</span><span class="nx">LocalFileSystem</span><span
class="p">.</span><span class="nx">PERSISTENT</span><span class="p">,</span>
<span class="mi">0</span><span class="p">,</span> <span class="nf">function
</span><span class="p">(</span><span class="nx">fs</span><span
class="p">)</span [...]
@@ -3366,11 +3265,6 @@ Android also supports a special filesystem named
"documents", which re
<span class="p">}</span>
</code></pre></div></div>
-<p>If you are using some platform-specific URIs instead of a FileEntry and you
want to display an image, you may need to include the main part of the URI in
the Content-Security-Policy <meta /> element in index.html. For example, on
Windows 10, you can include <code>ms-appdata:</code> in your <meta /> element.
Here is an example.</p>
-
-<div class="language-html highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nt"><meta</span> <span
class="na">http-equiv=</span><span class="s">"Content-Security-Policy"</span>
<span class="na">content=</span><span class="s">"default-src 'self' data: gap:
ms-appdata: https://ssl.gstatic.com 'unsafe-eval'; style-src 'self'
'unsafe-inline'; media-src *"</span><span class="nt">></span>
-</code></pre></div></div>
-
<h2>Create Directories <a name="createDir"></a></h2>
<p>In the code here, you create directories in the root of the app storage
location. You could use this code with any writable storage location (that is,
any DirectoryEntry). Here, you write to the application cache (assuming that
you used window.TEMPORARY to get your FileSystem object) by passing fs.root
into this function.</p>
diff --git a/docs/en/latest/reference/cordova-plugin-geolocation/index.html
b/docs/en/latest/reference/cordova-plugin-geolocation/index.html
index 8eb9582f45..dbbe912269 100644
--- a/docs/en/latest/reference/cordova-plugin-geolocation/index.html
+++ b/docs/en/latest/reference/cordova-plugin-geolocation/index.html
@@ -808,6 +808,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/reference/cordova-plugin-inappbrowser/index.html
b/docs/en/latest/reference/cordova-plugin-inappbrowser/index.html
index a5b5e2ce4e..f2a3330124 100644
--- a/docs/en/latest/reference/cordova-plugin-inappbrowser/index.html
+++ b/docs/en/latest/reference/cordova-plugin-inappbrowser/index.html
@@ -808,6 +808,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
@@ -2442,7 +2477,7 @@ Since the introduction of iPadOS 13, iPads try to adapt
their content mode / use
<p>Sometimes you may want to respond to an event happening on the page loaded
in the browser,
for example a button to open the barcode scanner, or closing the browser when
a login flow
-was finished. This can done by navigating to a URL with a custom scheme listed
in the
+was finished. This can be done by navigating to a URL with a custom scheme
listed in the
<code>AllowedSchemes</code> preference in <code>config.xml</code>, triggering
a <code>customscheme</code> event on the
browser. Multiple values are separated by comma's.</p>
diff --git a/docs/en/latest/reference/cordova-plugin-media-capture/index.html
b/docs/en/latest/reference/cordova-plugin-media-capture/index.html
index 2db02927cd..b1260ef545 100644
--- a/docs/en/latest/reference/cordova-plugin-media-capture/index.html
+++ b/docs/en/latest/reference/cordova-plugin-media-capture/index.html
@@ -808,6 +808,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/reference/cordova-plugin-media/index.html
b/docs/en/latest/reference/cordova-plugin-media/index.html
index 9ad5f19988..a547abcde5 100644
--- a/docs/en/latest/reference/cordova-plugin-media/index.html
+++ b/docs/en/latest/reference/cordova-plugin-media/index.html
@@ -808,6 +808,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git
a/docs/en/latest/reference/cordova-plugin-network-information/index.html
b/docs/en/latest/reference/cordova-plugin-network-information/index.html
index f4cbad7f34..c2e3657376 100644
--- a/docs/en/latest/reference/cordova-plugin-network-information/index.html
+++ b/docs/en/latest/reference/cordova-plugin-network-information/index.html
@@ -808,6 +808,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git
a/docs/en/latest/reference/cordova-plugin-screen-orientation/index.html
b/docs/en/latest/reference/cordova-plugin-screen-orientation/index.html
index 2b3809a161..f3a8f1cca2 100644
--- a/docs/en/latest/reference/cordova-plugin-screen-orientation/index.html
+++ b/docs/en/latest/reference/cordova-plugin-screen-orientation/index.html
@@ -808,6 +808,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/reference/cordova-plugin-splashscreen/index.html
b/docs/en/latest/reference/cordova-plugin-splashscreen/index.html
index 85bb9e73d0..76fe28ce3a 100644
--- a/docs/en/latest/reference/cordova-plugin-splashscreen/index.html
+++ b/docs/en/latest/reference/cordova-plugin-splashscreen/index.html
@@ -808,6 +808,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/reference/cordova-plugin-statusbar/index.html
b/docs/en/latest/reference/cordova-plugin-statusbar/index.html
index 0c2fbbca1a..0dc263a8c3 100644
--- a/docs/en/latest/reference/cordova-plugin-statusbar/index.html
+++ b/docs/en/latest/reference/cordova-plugin-statusbar/index.html
@@ -808,6 +808,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
@@ -2144,7 +2179,15 @@
<h1>cordova-plugin-statusbar</h1>
-<p><a
href="https://github.com/apache/cordova-plugin-statusbar/actions/workflows/android.yml";><img
src="https://github.com/apache/cordova-plugin-statusbar/actions/workflows/android.yml/badge.svg";
alt="Android Testsuite" /></a> <a
href="https://github.com/apache/cordova-plugin-statusbar/actions/workflows/chrome.yml";><img
src="https://github.com/apache/cordova-plugin-statusbar/actions/workflows/chrome.yml/badge.svg";
alt="Chrome Testsuite" /></a> <a href="https://github.com/apache/cordova-p
[...]
+<p><a href="https://npmjs.com/package/cordova-plugin-statusbar";><img
src="https://img.shields.io/npm/v/cordova-plugin-statusbar/latest?label=Latest%20Release%20(npm)"
alt="npm - Latest" /></a>
+<a href="https://github.com/apache/cordova-plugin-statusbar";><img
src="https://img.shields.io/github/package-json/v/apache/cordova-plugin-statusbar?label=Development%20(Git)"
alt="GitHub" /></a></p>
+
+<p><a
href="https://github.com/apache/cordova-plugin-statusbar/actions/workflows/ci.yml?query=branch%3Amaster";><img
src="https://github.com/apache/cordova-plugin-statusbar/actions/workflows/ci.yml/badge.svg?branch=master";
alt="GitHub - Node Workflow" /></a>
+<a
href="https://github.com/apache/cordova-plugin-statusbar/actions/workflows/android.yml";><img
src="https://github.com/apache/cordova-plugin-statusbar/actions/workflows/android.yml/badge.svg";
alt="Android Testsuite" /></a>
+<a
href="https://github.com/apache/cordova-plugin-statusbar/actions/workflows/chrome.yml";><img
src="https://github.com/apache/cordova-plugin-statusbar/actions/workflows/chrome.yml/badge.svg";
alt="Chrome Testsuite" /></a>
+<a
href="https://github.com/apache/cordova-plugin-statusbar/actions/workflows/ios.yml";><img
src="https://github.com/apache/cordova-plugin-statusbar/actions/workflows/ios.yml/badge.svg";
alt="iOS Testsuite" /></a>
+<a
href="https://github.com/apache/cordova-plugin-statusbar/actions/workflows/lint.yml";><img
src="https://github.com/apache/cordova-plugin-statusbar/actions/workflows/lint.yml/badge.svg";
alt="Lint Test" /></a>
+<a
href="https://github.com/apache/cordova-plugin-statusbar/actions/workflows/release-audit.yml?query=branch%3Amaster";><img
src="https://github.com/apache/cordova-plugin-statusbar/actions/workflows/release-audit.yml/badge.svg?branch=master";
alt="GitHub - Release Audit Workflow" /></a></p>
<blockquote>
<p>The <code>StatusBar</code> object provides some functions to customize
the iOS and Android StatusBar.</p>
@@ -2173,15 +2216,26 @@
<div class="language-plaintext highlighter-rouge"><div
class="highlight"><pre class="highlight"><code> <preference
name="StatusBarOverlaysWebView" value="true" />
</code></pre></div> </div>
+ <p>##### iOS Specifics</p>
+
+ <p>The status bar will be transparent if
<code>StatusBarOverlaysWebView</code> is set to <code>true</code>. A background
color cannot be applied. Since iOS 11 you must also include
<code>viewport-fit=cover</code> in your <code><meta name="viewport"
content="..."></code> tag if you want the status bar to overlay the
webview:</p>
+
+ <div class="language-html highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> <span class="nt"><meta</span> <span
class="na">name=</span><span class="s">"viewport"</span> <span
class="na">content=</span><span class="s">"initial-scale=1, width=device-width,
viewport-fit=cover"</span><span class="nt">></span>
+</code></pre></div> </div>
+
<p>##### Android Quirks</p>
<p>Only supported on Android 5 or later. Earlier versions will ignore this
preference.</p>
</li>
<li>
- <p><strong>StatusBarBackgroundColor</strong> (color hex string, no default
value). Set the background color of the statusbar by a hex string (#RRGGBB) at
startup. If this value is not set, the background color will be transparent. If
<code>StatusBarOverlaysWebView</code> is set to true, then a 8 digit hex
(#AARRGGBB) string can optionally be used to define the transparency.</p>
+ <p><strong>StatusBarBackgroundColor</strong> (color hex string, no default
value). Set the background color of the statusbar by a hex string (#RRGGBB) at
startup. If this value is not set, the background color will be transparent.</p>
<div class="language-plaintext highlighter-rouge"><div
class="highlight"><pre class="highlight"><code> <preference
name="StatusBarBackgroundColor" value="#000000" />
</code></pre></div> </div>
+
+ <p>#### Android Specifics</p>
+
+ <p>If <code>StatusBarOverlaysWebView</code> is set to true, then a 8 digit
hex (#AARRGGBB) string can optionally be used to define the transparency.</p>
</li>
<li>
<p><strong>StatusBarStyle</strong> (status bar style, defaults to
lightcontent). Set the status bar style (e.g. text color). Available options:
<code>default</code>, <code>lightcontent</code>.</p>
@@ -2213,12 +2267,6 @@
<span class="p">}</span>
</code></pre></div></div>
-<h3>iOS Quirks</h3>
-<p>Starting with iOS 11 you must include <code>viewport-fit=cover</code> in
your viewport meta tag if you want the status bar to overlay the webview:</p>
-
-<div class="language-html highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nt"><meta</span> <span
class="na">name=</span><span class="s">"viewport"</span> <span
class="na">content=</span><span class="s">"initial-scale=1, width=device-width,
viewport-fit=cover"</span><span class="nt">></span>
-</code></pre></div></div>
-
<h2>Hiding at startup</h2>
<p>During runtime you can use the StatusBar.hide function below, but if you
want the StatusBar to be hidden at app startup on iOS, you must modify your
app's Info.plist file.</p>
@@ -2348,9 +2396,9 @@ StatusBar.overlaysWebView(false);
StatusBar.backgroundColorByHexString("#FAB"); // => #FFAABB
</code></pre></div></div>
-<p>On iOS, when you set StatusBar.overlaysWebView to false, you can set the
background color of the statusbar by a hex string (#RRGGBB).</p>
+<p>On iOS you can set the background color of the statusbar by a hex string
(#RRGGBB) if StatusBar.overlaysWebView is false.</p>
-<p>On Android, when StatusBar.overlaysWebView is true, and on WP7&8, you
can also specify values as #AARRGGBB, where AA is an alpha value.</p>
+<p>On Android, when StatusBar.overlaysWebView is true you can also specify
values as #AARRGGBB, where AA is an alpha value.</p>
<h2>Supported Platforms</h2>
diff --git a/docs/en/latest/reference/cordova-plugin-vibration/index.html
b/docs/en/latest/reference/cordova-plugin-vibration/index.html
index bb226655fb..ea7be1734c 100644
--- a/docs/en/latest/reference/cordova-plugin-vibration/index.html
+++ b/docs/en/latest/reference/cordova-plugin-vibration/index.html
@@ -808,6 +808,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/docs/en/latest/third-party/index.html
b/docs/en/latest/third-party/index.html
index f081891e56..a7b70224be 100644
--- a/docs/en/latest/third-party/index.html
+++ b/docs/en/latest/third-party/index.html
@@ -808,6 +808,26 @@
+ <li>
+
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+
+
+
+
+
+
+
+ </li>
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
@@ -1755,6 +1775,21 @@
+<li>
+ <a class="" href="/docs/en/latest/package_ref/index.html">
+ package.json API
+ </a>
+</li>
+
+
+
+
+
+
+
+
+
+
<li>
<a class="" href="/docs/en/latest/plugin_ref/spec.html">
Plugin.xml API
diff --git a/feed.xml b/feed.xml
index b19cfce168..5f6184c68c 100644
--- a/feed.xml
+++ b/feed.xml
@@ -6,8 +6,8 @@
</description>
<link>https://cordova.apache.org/</link>
<atom:link href="https://cordova.apache.org/feed.xml"; rel="self"
type="application/rss+xml"/>
- <pubDate>Mon, 10 Aug 2026 12:11:17 +0000</pubDate>
- <lastBuildDate>Mon, 10 Aug 2026 12:11:17 +0000</lastBuildDate>
+ <pubDate>Sat, 26 Sep 2026 07:46:57 +0000</pubDate>
+ <lastBuildDate>Sat, 26 Sep 2026 07:46:57 +0000</lastBuildDate>
<generator>Jekyll v4.4.1</generator>
<item>
diff --git a/sitemap.xml b/sitemap.xml
index b4209c68cf..253d034768 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -1681,7 +1681,7 @@
<url>
- <loc>https://cordova.apache.org/plugins/</loc>
+ <loc>https://cordova.apache.org/contribute/</loc>
</url>
@@ -1690,7 +1690,9 @@
<url>
- <loc>https://cordova.apache.org/contact/</loc>
+ <loc>https://cordova.apache.org/blog/</loc>
+ <changefreq>weekly</changefreq>
+ <priority>0.7</priority>
</url>
@@ -1699,9 +1701,7 @@
<url>
- <loc>https://cordova.apache.org/blog/</loc>
- <changefreq>weekly</changefreq>
- <priority>0.7</priority>
+ <loc>https://cordova.apache.org/plugins/</loc>
</url>
@@ -1710,7 +1710,7 @@
<url>
- <loc>https://cordova.apache.org/contribute/</loc>
+ <loc>https://cordova.apache.org/contact/</loc>
</url>
@@ -1748,7 +1748,16 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/config_ref/</loc>
+ <loc>https://cordova.apache.org/downloads/</loc>
+</url>
+
+
+
+
+
+
+ <url>
+
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-media/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -1759,7 +1768,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/config_ref/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-media/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -1767,7 +1776,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/platform_pinning/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-screen-orientation/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -1778,7 +1787,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/platform_pinning/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-screen-orientation/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -1786,7 +1795,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/guide/next/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-media-capture/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -1797,7 +1806,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/guide/next/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-media-capture/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -1805,7 +1814,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/guide/appdev/hooks/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-file/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -1816,7 +1825,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/guide/appdev/hooks/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-file/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -1824,7 +1833,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/guide/appdev/privacy/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-vibration/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -1835,7 +1844,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/guide/appdev/privacy/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-vibration/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -1843,7 +1852,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/guide/appdev/security/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-splashscreen/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -1854,7 +1863,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/guide/appdev/security/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-splashscreen/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -1862,7 +1871,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/guide/appdev/allowlist/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-device/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -1873,7 +1882,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/guide/appdev/allowlist/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-device/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -1881,7 +1890,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/guide/overview/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-inappbrowser/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -1892,7 +1901,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/guide/overview/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-inappbrowser/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -1900,7 +1909,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/guide/platforms/ios/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-geolocation/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -1911,7 +1920,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/guide/platforms/ios/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-geolocation/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -1919,7 +1928,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/android/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-statusbar/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -1930,7 +1939,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/android/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-statusbar/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -1938,7 +1947,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/electron/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-battery-status/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -1949,7 +1958,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/electron/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-battery-status/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -1957,7 +1966,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/guide/cli/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/reference/cordova-cli/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -1968,7 +1977,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/guide/cli/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/reference/cordova-cli/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -1976,7 +1985,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/guide/hybrid/plugins/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-network-information/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -1987,7 +1996,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/guide/hybrid/plugins/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-network-information/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -1995,7 +2004,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/guide/hybrid/webviews/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-camera/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -2006,7 +2015,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/guide/hybrid/webviews/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-camera/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -2014,7 +2023,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/guide/support/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-dialogs/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -2025,7 +2034,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/guide/support/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-dialogs/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -2033,7 +2042,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-media/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/config_ref/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -2044,7 +2053,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-media/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/config_ref/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -2052,7 +2061,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/reference/cordova-cli/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/third-party/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -2063,7 +2072,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/reference/cordova-cli/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/third-party/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -2071,7 +2080,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-camera/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/platform_plugin_versioning_ref/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -2082,7 +2091,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-camera/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/platform_plugin_versioning_ref/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -2090,7 +2099,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-dialogs/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/platform_pinning/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -2101,7 +2110,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-dialogs/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/platform_pinning/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -2109,7 +2118,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-battery-status/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/core/features/splashscreen/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -2120,7 +2129,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-battery-status/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/core/features/splashscreen/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -2128,7 +2137,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-network-information/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/guide/support/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -2139,7 +2148,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-network-information/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/guide/support/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -2147,7 +2156,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-vibration/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/guide/appdev/allowlist/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -2158,7 +2167,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-vibration/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/guide/appdev/allowlist/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -2166,7 +2175,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-file/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/guide/appdev/privacy/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -2177,7 +2186,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-file/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/guide/appdev/privacy/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -2185,7 +2194,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-geolocation/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/guide/appdev/security/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -2196,7 +2205,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-geolocation/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/guide/appdev/security/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -2204,7 +2213,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-device/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/guide/appdev/hooks/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -2215,7 +2224,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-device/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/guide/appdev/hooks/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -2223,7 +2232,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-inappbrowser/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/guide/next/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -2234,7 +2243,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-inappbrowser/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/guide/next/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -2242,7 +2251,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-media-capture/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/guide/hybrid/plugins/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -2253,7 +2262,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-media-capture/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/guide/hybrid/plugins/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -2261,7 +2270,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-screen-orientation/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/guide/hybrid/webviews/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -2272,7 +2281,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-screen-orientation/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/guide/hybrid/webviews/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -2280,7 +2289,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-splashscreen/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/guide/cli/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -2291,7 +2300,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-splashscreen/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/guide/cli/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -2299,7 +2308,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-statusbar/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/electron/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -2310,7 +2319,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-statusbar/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/electron/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -2318,7 +2327,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/third-party/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/android/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -2329,7 +2338,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/third-party/</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/android/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -2337,7 +2346,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/core/features/splashscreen/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/guide/platforms/ios/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -2348,7 +2357,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/core/features/splashscreen/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/guide/platforms/ios/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -2356,7 +2365,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/platform_plugin_versioning_ref/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/guide/overview/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -2367,7 +2376,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/platform_plugin_versioning_ref/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/guide/overview/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -2375,7 +2384,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/package_ref/</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -2386,7 +2395,7 @@
<url>
- <loc>https://cordova.apache.org/docs/en/latest/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/package_ref/</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -2394,13 +2403,23 @@
<url>
- <loc>https://cordova.apache.org/downloads/</loc>
+ <loc>https://cordova.apache.org/docs/en/latest/</loc>
+ <changefreq>monthly</changefreq>
+ <priority>0.8</priority>
</url>
+
+ <url>
+ <loc>https://cordova.apache.org/docs/en/latest/</loc>
+ <changefreq>monthly</changefreq>
+ <priority>0.9</priority>
+</url>
+
+
<url>
<loc>https://cordova.apache.org/docs/en/latest/guide/cli/installation.html</loc>
@@ -2449,7 +2468,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/ios/plugin.html</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/android/plugin.html</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -2460,7 +2479,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/ios/plugin.html</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/android/plugin.html</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -2468,7 +2487,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/android/plugin.html</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/ios/plugin.html</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -2479,7 +2498,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/android/plugin.html</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/ios/plugin.html</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -2609,7 +2628,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/ios/upgrade.html</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/android/upgrade.html</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -2620,7 +2639,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/ios/upgrade.html</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/android/upgrade.html</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -2628,7 +2647,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/android/upgrade.html</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/ios/upgrade.html</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -2639,7 +2658,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/android/upgrade.html</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/ios/upgrade.html</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -2647,7 +2666,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/ios/webview.html</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/android/webview.html</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -2658,7 +2677,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/ios/webview.html</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/android/webview.html</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
@@ -2666,7 +2685,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/android/webview.html</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/ios/webview.html</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
@@ -2677,7 +2696,7 @@
<url>
-
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/android/webview.html</loc>
+
<loc>https://cordova.apache.org/docs/en/latest/guide/platforms/ios/webview.html</loc>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
diff --git a/static/css/main.css b/static/css/main.css
index 29e6a4fa7a..fc2a89d244 100644
--- a/static/css/main.css
+++ b/static/css/main.css
@@ -8240,12 +8240,12 @@ header .btn.search-button {
color: #999999;
}
header .btn.search-button:hover {
- color: rgb(229.5, 229.5, 229.5);
+ color: rgb(90%, 90%, 90%);
}
/* footer */
footer {
- background-color: rgb(242.25, 242.25, 242.25);
+ background-color: rgb(95%, 95%, 95%);
position: relative;
}
footer strong {
@@ -8257,7 +8257,7 @@ footer h1 {
}
footer h2 {
text-transform: uppercase;
- color: rgb(127.5, 127.5, 127.5);
+ color: rgb(50%, 50%, 50%);
font-size: 1em;
font-weight: bold;
}
@@ -8308,7 +8308,7 @@ h1 {
}
h2 {
- color: rgb(127.5, 127.5, 127.5);
+ color: rgb(50%, 50%, 50%);
font-size: 18px;
}
@@ -8492,7 +8492,7 @@ html {
width: 100%;
}
#hero #hero_section .hero_content p {
- color: rgb(229.5, 229.5, 229.5);
+ color: rgb(90%, 90%, 90%);
font-weight: 300;
color: rgb(166, 178, 180);
}
@@ -8658,7 +8658,7 @@ img#logo_top {
.well_code, .well_code div {
padding-bottom: 69px;
position: relative;
- background-color: rgb(229.5, 229.5, 229.5);
+ background-color: rgb(90%, 90%, 90%);
margin-top: 25px;
}
.well_code div {
@@ -8689,7 +8689,7 @@ img#logo_top {
********* Showcase Section ***********
*/
.dark {
- background-color: rgb(25.5, 25.5, 25.5);
+ background-color: rgb(10%, 10%, 10%);
}
.dark, .dark .container-fluid { /* Fixes an overflow problem in the showcase
sections */
@@ -8725,7 +8725,7 @@ img#logo_top {
}
.supported_platforms {
- background-color: rgb(38.25, 38.25, 38.25);
+ background-color: rgb(15%, 15%, 15%);
margin-left: -15px;
margin-right: -15px;
margin-bottom: 40px;
@@ -8749,7 +8749,7 @@ img#logo_top {
padding: 8px;
}
.card_gallery .card .card_inner {
- background-color: rgb(38.25, 38.25, 38.25);
+ background-color: rgb(15%, 15%, 15%);
padding: 32px 16px 24px 16px;
}
.card_gallery .card .card_inner .card_title {
@@ -9354,7 +9354,7 @@ img#logo_top {
width: 320px;
overflow-y: scroll;
overflow-x: hidden;
- background: rgb(38.25, 38.25, 38.25);
+ background: rgb(15%, 15%, 15%);
}
.docs .site-toc-container .site-toc {
padding: 10px 15px;
@@ -9700,7 +9700,7 @@ html[lang=ru] .docs #old-home ul li {
padding: 0;
}
.contribute-help .list li {
- background: rgb(229.5, 229.5, 229.5);
+ background: rgb(90%, 90%, 90%);
position: relative;
list-style: none;
margin-bottom: 16px;
@@ -9827,7 +9827,7 @@ html[lang=ru] .docs #old-home ul li {
padding: 0;
}
.contact .list li {
- background: rgb(229.5, 229.5, 229.5);
+ background: rgb(90%, 90%, 90%);
position: relative;
list-style: none;
margin-bottom: 16px;
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
![https://github.com/apache/cordova-plugin-file/actions/workflows/android.yml/badge.svg"](https://github.com/apache/cordova-plugin-file/actions/workflows/android.yml/badge.svg"){kind=link}
![https://github.com/apache/cordova-plugin-file/actions/workflows/chrome.yml/badge.svg"](https://github.com/apache/cordova-plugin-file/actions/workflows/chrome.yml/badge.svg"){kind=link}
![https://github.com/apache/cordova-plugin-file/actions/workflows/ci.yml/badge.svg?branch=master"](https://github.com/apache/cordova-plugin-file/actions/workflows/ci.yml/badge.svg?branch=master"){kind=link}
![https://github.com/apache/cordova-plugin-file/actions/workflows/ios.yml/badge.svg"](https://github.com/apache/cordova-plugin-file/actions/workflows/ios.yml/badge.svg"){kind=link}
![https://github.com/apache/cordova-plugin-file/actions/workflows/lint.yml/badge.svg"](https://github.com/apache/cordova-plugin-file/actions/workflows/lint.yml/badge.svg"){kind=link}
![https://github.com/apache/cordova-plugin-file/actions/workflows/release-audit.yml/badge.svg?branch=master"](https://github.com/apache/cordova-plugin-file/actions/workflows/release-audit.yml/badge.svg?branch=master"){kind=link}
![https://github.com/apache/cordova-plugin-statusbar/actions/workflows/android.yml/badge.svg"](https://github.com/apache/cordova-plugin-statusbar/actions/workflows/android.yml/badge.svg"){kind=link}
![https://github.com/apache/cordova-plugin-statusbar/actions/workflows/chrome.yml/badge.svg"](https://github.com/apache/cordova-plugin-statusbar/actions/workflows/chrome.yml/badge.svg"){kind=link}
![https://github.com/apache/cordova-plugin-statusbar/actions/workflows/ci.yml/badge.svg?branch=master"](https://github.com/apache/cordova-plugin-statusbar/actions/workflows/ci.yml/badge.svg?branch=master"){kind=link}
![https://github.com/apache/cordova-plugin-statusbar/actions/workflows/ios.yml/badge.svg"](https://github.com/apache/cordova-plugin-statusbar/actions/workflows/ios.yml/badge.svg"){kind=link}
![https://github.com/apache/cordova-plugin-statusbar/actions/workflows/lint.yml/badge.svg"](https://github.com/apache/cordova-plugin-statusbar/actions/workflows/lint.yml/badge.svg"){kind=link}
![https://github.com/apache/cordova-plugin-statusbar/actions/workflows/release-audit.yml/badge.svg?branch=master"](https://github.com/apache/cordova-plugin-statusbar/actions/workflows/release-audit.yml/badge.svg?branch=master"){kind=link}