You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by gi...@apache.org on 2023/06/01 04:09:04 UTC
[cordova-docs] branch asf-site updated: Deploying to asf-site from @ apache/cordova-docs@8941c83a5fe3d8326e1a09d8fe757e5406cf5ad2 🚀
This is an automated email from the ASF dual-hosted git repository.
github-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 ce2145f2b1 Deploying to asf-site from @ apache/cordova-docs@8941c83a5fe3d8326e1a09d8fe757e5406cf5ad2 🚀
ce2145f2b1 is described below
commit ce2145f2b1ca8ec6b8ea5f0785df981f29523af2
Author: erisu <er...@users.noreply.github.com>
AuthorDate: Thu Jun 1 04:09:00 2023 +0000
Deploying to asf-site from @ apache/cordova-docs@8941c83a5fe3d8326e1a09d8fe757e5406cf5ad2 🚀
---
docs/en/dev/config_ref/index.html | 223 ++++++++++--------
docs/en/dev/guide/appdev/security/index.html | 6 +-
docs/en/dev/guide/cli/index.html | 1 -
docs/en/dev/guide/platforms/android/index.html | 177 +++++++++------
docs/en/dev/guide/platforms/ios/plugin.html | 4 +-
docs/en/dev/guide/support/index.html | 79 ++-----
docs/en/dev/plugin_ref/spec.html | 299 +++++++++----------------
feed.xml | 4 +-
8 files changed, 368 insertions(+), 425 deletions(-)
diff --git a/docs/en/dev/config_ref/index.html b/docs/en/dev/config_ref/index.html
index a5b9fe6adb..51d36750e3 100644
--- a/docs/en/dev/config_ref/index.html
+++ b/docs/en/dev/config_ref/index.html
@@ -2280,42 +2280,68 @@
<h1>Config.xml</h1>
-<p><code>config.xml</code> is a global configuration file that controls many aspects
-of a cordova application's behavior. This
-platform-agnostic XML file is arranged based on the W3C's <a href="https://www.w3.org/TR/widgets/">Packaged
-Web Apps (Widgets)</a> specification, and
-extended to specify core Cordova API features, plugins, and
-platform-specific settings.</p>
-
-<p>For projects created with the Cordova CLI (described in <a href="../guide/cli/index.html">The
-Command-Line Interface</a>), this file can be found in the top-level
-directory:</p>
-
-<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>app/config.xml
+<p>The <code>config.xml</code> file is a global configuration file that manages various aspects of a Cordova application's behavior. It is written in XML format and follows the structure outlined in the W3C's <a href="https://www.w3.org/TR/widgets/">Packaged Web Apps (Widgets)</a> specification. Additionally, it is extended to include core Cordova API features, plugins, and platform-specific settings.</p>
+
+<p>If you are using the Cordova CLI to create your project (as explained in <a href="../guide/cli/index.html">The Command-Line Interface</a>), you can locate the <code>config.xml</code> file in the top-level directory of your project.</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>./hellocordova
+└── config.xml
+</code></pre></div></div>
+
+<p>When using the CLI to build a project, versions of this file are passively copied into various <code>platforms/</code> subdirectories. For example:</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>./hellocordova
+└── platforms
+ ├── android
+ │  └── app
+ │  └── src
+ │  └── main
+ │  └── res
+ │  └── xml
+ │  └── config.xml
+ └── ios
+ └── HelloCordova
+ └── config.xml
</code></pre></div></div>
-<p>Note that before version 3.3.1-0.2.0, the file existed at <code>app/www/config.xml</code>,
-and that having it here is still supported.</p>
+<p>Some platforms offer integrated development environments (IDEs) like Xcode for iOS and Android Studio for Android, which allow you to build and test your application. If you choose to use these IDEs for building and testing your project, it is recommended to run the <code>cordova prepare</code> CLI command whenever you make changes to the Cordova application's <code>config.xml</code>. This ensures that the updated configurations are copied into the respective <code>platforms/</cod [...]
+
+<p>In addition to the configuration options described below, you have the ability to customize the core set of images for your application on each target platform. For more information, please refer to the topic on <a href="images.html">Customizing Icons</a>.</p>
+
+<p><strong>Sample <code>config.xml</code>:</strong></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"><widget</span> <span class="na">xmlns=</span><span class="s">"http://www.w3.org/ns/widgets"</span>
+ <span class="na">xmlns:cdv=</span><span class="s">"http://cordova.apache.org/ns/1.0"</span>
+ <span class="na">id=</span><span class="s">"io.cordova.hellocordova"</span>
+ <span class="na">version=</span><span class="s">"1.0.0"</span><span class="nt">></span>
+ <span class="nt"><name></span>HelloCordova<span class="nt"></name></span>
+ <span class="nt"><description></span>Sample Apache Cordova App<span class="nt"></description></span>
+ <span class="nt"><author</span> <span class="na">email=</span><span class="s">"dev@cordova.apache.org"</span> <span class="na">href=</span><span class="s">"https://cordova.apache.org"</span><span class="nt">></span>
+ Apache Cordova Team
+ <span class="nt"></author></span>
-<p>When using the CLI to build a project, versions of this file are
-passively copied into various <code>platforms/</code> subdirectories.
-For example:</p>
+ <span class="nt"><content</span> <span class="na">src=</span><span class="s">"index.html"</span> <span class="nt">/></span>
-<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>app/platforms/ios/AppName/config.xml
-app/platforms/android/res/xml/config.xml
+ <span class="c"><!-- Security Related Settings --></span>
+ <span class="nt"><access</span> <span class="na">origin=</span><span class="s">"https://cordova.apache.org"</span> <span class="nt">/></span>
+ <span class="nt"><allow-intent</span> <span class="na">href=</span><span class="s">"http://*/*"</span> <span class="nt">/></span>
+ <span class="nt"><allow-intent</span> <span class="na">href=</span><span class="s">"https://*/*"</span> <span class="nt">/></span>
+
+ <span class="c"><!-- Platform Configs & Platform Overriding Configs --></span>
+ <span class="nt"><platform</span> <span class="na">name=</span><span class="s">"android"</span><span class="nt">></platform></span>
+ <span class="nt"><platform</span> <span class="na">name=</span><span class="s">"ios"</span><span class="nt">></platform></span>
+<span class="nt"></widget></span>
</code></pre></div></div>
-<p>In addition to the various configuration options detailed below, you
-can also configure an application's core set of images for each target
-platform. See <a href="images.html">Customize icons topic</a> for more information.</p>
+<h2>widget</h2>
-<h1>widget</h1>
<p>Root element of the config.xml document.</p>
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
@@ -2334,19 +2360,19 @@ platform. See <a href="images.html">Customize icons topic</a> for more informati
</tr>
<tr>
<td>ios-CFBundleVersion<br /><span class="cdv-var-type string">String</span> <svg class="platform-icon ios"><use href="#ios"></use></svg></td>
- <td>Alternative version for iOS. For further details, see <a href="https://developer.apple.com/library/ios/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/20001431-102364">iOS versioning</a>.</td>
+ <td>Alternative version for iOS. For further details, see <a href="https://developer.apple.com/documentation/bundleresources/information_property_list/cfbundleversion">Apple Developer - CFBundleVersion</a>.</td>
</tr>
<tr>
<td>android-packageName<br /><span class="cdv-var-type string">String</span> <svg class="platform-icon android"><use href="#android"></use></svg></td>
- <td>Alternative package name for Android, overrides <code>id</code>.</td>
+ <td>This preference overrides the id attribute with an alternative package name specifically for Android.</td>
</tr>
<tr>
- <td>ios-CFBundleIdentifier<br /><span class="cdv-var-type string">String</span> <br /> <svg class="platform-icon ios"><use href="#ios"></use></svg></td>
- <td>Alternative bundle id for iOS. Overrides <code>id</code>.</td>
+ <td>ios-CFBundleIdentifier<br /><span class="cdv-var-type string">String</span> <svg class="platform-icon ios"><use href="#ios"></use></svg></td>
+ <td>This preference overrides the id attribute with an alternative bundle ID specifically for iOS.</td>
</tr>
<tr>
- <td>defaultlocale <br /> <svg class="platform-icon ios"><use href="#ios"></use></svg></td>
- <td>Specified the default language of the app, as an IANA language code.</td>
+ <td>defaultlocale <br /> <span class="cdv-var-type string">String</span><svg class="platform-icon ios"><use href="#ios"></use></svg></td>
+ <td>Specify the default language of the app using an IANA language code. This preference key explicitly sets the value for <a href="https://developer.apple.com/documentation/bundleresources/information_property_list/cfbundledevelopmentregion">CFBundleDevelopmentRegion</a>. For example, you can use values like <code>en</code> or <code>en_US</code>.</td>
</tr>
<tr>
<td>android-activityName<br /><span class="cdv-var-type string">String</span> <svg class="platform-icon android"><use href="#android"></use></svg></td>
@@ -2375,6 +2401,7 @@ platform. See <a href="images.html">Customize icons topic</a> for more informati
</code></pre></div></div>
<h2>name</h2>
+
<p>Specifies the app's formal name, as it appears on the device's home screen and within app-store interfaces.</p>
<p>Examples:</p>
@@ -2385,6 +2412,7 @@ platform. See <a href="images.html">Customize icons topic</a> for more informati
</code></pre></div></div>
<h3>short name</h3>
+
<p>Specifies an optional display name for the app. Sometimes the app name should be displayed differently on device's home screen than on informational and app-store interfaces due to limited space.</p>
<p>Examples:</p>
@@ -2395,6 +2423,7 @@ platform. See <a href="images.html">Customize icons topic</a> for more informati
</code></pre></div></div>
<h2>description</h2>
+
<p>Specifies metadata that may appear within app-store listings.</p>
<p>Examples:</p>
@@ -2405,12 +2434,13 @@ platform. See <a href="images.html">Customize icons topic</a> for more informati
</code></pre></div></div>
<h2>author</h2>
+
<p>Specifies contact information that may appear within app-store listings.</p>
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
@@ -2434,12 +2464,13 @@ platform. See <a href="images.html">Customize icons topic</a> for more informati
</code></pre></div></div>
<h2>content</h2>
+
<p>Defines the app's starting page in the top-level web assets directory. The default value is index.html, which customarily appears in a project's top-level <code>www</code> directory.</p>
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
@@ -2459,19 +2490,20 @@ platform. See <a href="images.html">Customize icons topic</a> for more informati
</code></pre></div></div>
<h2>access</h2>
-<p>Defines the set of external domains the app is allowed to communicate with. The default value shown above allows it to access any server. See the Domain <a href="../guide/appdev/allowlist/index.html">Whitelist Guide</a> for details.</p>
+
+<p>Defines the external domains that the app is allowed to communicate with. When the access origin is set to "*", the app can access any server, but this can potentially create a security risk. It is recommended to explicitly specify the permitted URLs to ensure a secure configuration. For detailed instructions, please refer to the <a href="../guide/appdev/allowlist/index.html">Allow List Guide</a>.</p>
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>origin<br /><span class="cdv-var-type string">String</span></td>
- <td><em>Required</em> <br /> Defines the set of external domains the app is allowed to communicate with. The default value shown above allows it to access any server. See the Domain <a href="../guide/appdev/allowlist/index.html">Whitelist Guide</a> for details.</td>
+ <td><em>Required</em> <br /> Defines the external domain URL or URL pattern that the app is allowed to communicate with.</td>
</tr>
</tbody>
</table>
@@ -2488,19 +2520,20 @@ platform. See <a href="images.html">Customize icons topic</a> for more informati
</code></pre></div></div>
<h2>allow-navigation</h2>
-<p>Controls which URLs the WebView itself can be navigated to. Applies to top-level navigations only.</p>
+
+<p>Controls which URLs the WebView can be navigated to. Applies to top-level navigations only. See the <a href="../guide/appdev/allowlist/index.html#navigation-allow-list">Allow List Guide</a> for details.</p>
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>href<br /><span class="cdv-var-type string">String</span></td>
- <td><em>Required</em> <br /> Defines the set of external domains the WebView is allowed to navigate to. See the <a href="../guide/appdev/allowlist/index.html#navigation-allow-list">Allow List Guide</a> for details.</td>
+ <td><em>Required</em> <br /> Defines the external domain or domain pattern that the WebView is allowed to navigate to.</td>
</tr>
</tbody>
</table>
@@ -2515,19 +2548,20 @@ platform. See <a href="images.html">Customize icons topic</a> for more informati
</code></pre></div></div>
<h2>allow-intent</h2>
-<p>Controls which URLs the app is allowed to ask the system to open. By default, no external URLs are allowed.</p>
+
+<p>Controls which URLs the app is allowed to ask the system to open. By default, no external URLs are allowed. See the <a href="../guide/appdev/allowlist/index.html#intent-allow-list">Allow List Guide</a> for details.</p>
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>href<br /><span class="cdv-var-type string">String</span></td>
- <td><em>Required</em> <br /> Defines which URLs the app is allowed to ask the system to open. See the <a href="../guide/appdev/allowlist/index.html#intent-allow-list">Allow List Guide</a> for details.</td>
+ <td><em>Required</em> <br /> Defines the URL or URL pattern that the app is allowed to ask the system to open.</td>
</tr>
</tbody>
</table>
@@ -2539,6 +2573,7 @@ platform. See <a href="images.html">Customize icons topic</a> for more informati
<span class="nt"><allow-intent</span> <span class="na">href=</span><span class="s">"tel:*"</span> <span class="nt">/></span>
<span class="nt"><allow-intent</span> <span class="na">href=</span><span class="s">"sms:*"</span> <span class="nt">/></span>
</code></pre></div></div>
+
<h2>edit-config</h2>
<p>See <a href="../plugin_ref/spec.html#edit-config"><config-file> docs</a> for plugin.xml.</p>
@@ -2548,12 +2583,13 @@ platform. See <a href="images.html">Customize icons topic</a> for more informati
<p>See <a href="../plugin_ref/spec.html#config-file"><config-file> docs</a> for plugin.xml.</p>
<h2>engine</h2>
+
<p>Specifies details about what platform to restore during a prepare.</p>
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
@@ -2576,6 +2612,7 @@ platform. See <a href="images.html">Customize icons topic</a> for more informati
</code></pre></div></div>
<h2>plugin</h2>
+
<p>Specifies details about what plugin to restore during a prepare. This element
is automatically added to a project's <code>config.xml</code> when a plugin is added using
the <code>--save</code> flag. See the <a href="../reference/cordova-cli/index.html#cordova-plugin-command">CLI reference</a> for more information on
@@ -2586,7 +2623,7 @@ adding plugins.</p>
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
@@ -2609,6 +2646,7 @@ adding plugins.</p>
</code></pre></div></div>
<h3>variable</h3>
+
<p>Persists the value of a CLI variable to be used when restoring a plugin during a
prepare. This element is added to <code>config.xml</code> when a plugin that uses CLI variables
is added using the <code>--save</code> flag. See the <a href="../reference/cordova-cli/index.html#cordova-plugin-command">CLI reference</a> for more
@@ -2623,7 +2661,7 @@ project and restore it by running <code>cordova prepare</code>. See the
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
@@ -2647,13 +2685,14 @@ project and restore it by running <code>cordova prepare</code>. See the
</code></pre></div></div>
<h2>preference</h2>
+
<p>Sets various options as pairs of name/value attributes. Each preference's name is case-insensitive. Many preferences are unique to specific platforms,
and will be indicated as such.</p>
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
@@ -2680,11 +2719,47 @@ and will be indicated as such.</p>
</tr>
<tr>
<td>android-minSdkVersion<br /><span class="cdv-var-type number">Number</span> <svg class="platform-icon android"><use href="#android"></use></svg></td>
- <td><em>Default: Dependent on cordova-android Version</em> <br /> Sets the <code>minSdkVersion</code> attribute of the <code><uses-sdk></code> tag in the project's <code>AndroidManifest.xml</code> (see <a href="https://developer.android.com/guide/topics/manifest/uses-sdk-element.html">here</a>).</td>
+ <td><em>Default: <a href="../../guide/platforms/android/index.html#android-api-level-support">Dependent on cordova-android Version</a></em> <br /> Sets the <code>minSdkVersion</code> attribute of the <code><uses-sdk></code> tag in the project's <code>AndroidManifest.xml</code> (see <a href="https://developer.android.com/guide/topics/manifest/uses-sdk-element.html">here</a>).</td>
</tr>
<tr>
<td>android-targetSdkVersion<br /><span class="cdv-var-type number">Number</span> <svg class="platform-icon android"><use href="#android"></use></svg></td>
- <td><em>Default: Dependent on cordova-android Version</em> <br /> Sets the <code>targetSdkVersion</code> attribute of the <code><uses-sdk></code> tag in the project's <code>AndroidManifest.xml</code> (see <a href="https://developer.android.com/guide/topics/manifest/uses-sdk-element.html">here</a>).</td>
+ <td><em>Default: <a href="../../guide/platforms/android/index.html#android-api-level-support">Dependent on cordova-android Version</a></em> <br /> Sets the <code>targetSdkVersion</code> attribute of the <code><uses-sdk></code> tag in the project's <code>AndroidManifest.xml</code> (see <a href="https://developer.android.com/guide/topics/manifest/uses-sdk-element.html">here</a>).</td>
+ </tr>
+ <tr>
+ <td>android-compileSdkVersion<br /><span class="cdv-var-type number">Number</span> <svg class="platform-icon android"><use href="#android"></use></svg></td>
+ <td><em>Default: <a href="../../guide/platforms/android/index.html#android-api-level-support">Dependent on cordova-android Version</a></em> <br /> Sets the <code>compileSdkVersion</code> attribute.</td>
+ </tr>
+ <tr>
+ <td>android-buildToolsVersion<br /><span class="cdv-var-type semver">Semver</span> <svg class="platform-icon android"><use href="#android"></use></svg></td>
+ <td><em>Default: <a href="../../guide/platforms/android/index.html#android-api-level-support">Dependent on cordova-android Version</a></em> <br /> Expects a full version string eg. "32.0.0". Changing this may also requires changing the PATH environment variable to find the proper build tools.<br /><br />This preference is primarily for cordova development, for testing upcoming versions of the Android SDK. Changing this has a high risk of breaking builds as newer build too [...]
+ </tr>
+ <tr>
+ <td>GradleVersion<br /><span class="cdv-var-type string">String</span> <svg class="platform-icon android"><use href="#android"></use></svg></td>
+ <td><em>Default: <a href="../../guide/platforms/android/index.html#android-api-level-support">Dependent on cordova-android Version</a></em> <br /> Sets the gradle wrapper version to use.<br /> <br />This preference is primarily for cordova development, for testing upcoming versions of the Android SDK. Changing this has a high risk of breaking builds as newer build tools frequently introduce breaking changes.</td>
+ </tr>
+ <tr>
+ <td>AndroidGradlePluginVersion<br /><span class="cdv-var-type semver">Semver</span> <svg class="platform-icon android"><use href="#android"></use></svg></td>
+ <td><em>Default: <a href="../../guide/platforms/android/index.html#android-api-level-support">Dependent on cordova-android Version</a></em> <br /> Sets the Android Gradle Plugin version to use.<br /> <br />This preference is primarily for cordova development, for testing upcoming versions of the Android SDK. Changing this has a high risk of breaking builds as newer build tools frequently introduce breaking changes.</td>
+ </tr>
+ <tr>
+ <td>AndroidXAppCompatVersion<br /><span class="cdv-var-type semver">Semver</span> <svg class="platform-icon android"><use href="#android"></use></svg></td>
+ <td><em>Default: <a href="../../guide/platforms/android/index.html#android-api-level-support">Dependent on cordova-android Version</a></em> <br /> Overrides Android App Compat library version.</td>
+ </tr>
+ <tr>
+ <td>AndroidXWebKitVersion<br /><span class="cdv-var-type semver">Semver</span> <svg class="platform-icon android"><use href="#android"></use></svg></td>
+ <td><em>Default: <a href="../../guide/platforms/android/index.html#android-api-level-support">Dependent on cordova-android Version</a></em> <br />Overrides Android WebKit library version.</td>
+ </tr>
+ <tr>
+ <td>AndroidGradlePluginGoogleServicesVersion<br /><span class="cdv-var-type semver">Semver</span> <svg class="platform-icon android"><use href="#android"></use></svg></td>
+ <td><em>Default: <a href="../../guide/platforms/android/index.html#android-api-level-support">Dependent on cordova-android Version</a></em> <br />Overrides the Google Services library version.</td>
+ </tr>
+ <tr>
+ <td>AndroidGradlePluginGoogleServicesEnabled<br /><span class="cdv-var-type boolean">Boolean</span> <svg class="platform-icon android"><use href="#android"></use></svg></td>
+ <td><em>Default: false</em> <br />Enables Google Services. The <code>google-services.json</code> file will be required.</td>
+ </tr>
+ <tr>
+ <td>GradlePluginKotlinEnabled<br /><span class="cdv-var-type boolean">Boolean</span> <svg class="platform-icon android"><use href="#android"></use></svg></td>
+ <td><em>Default: false</em> <br />Enables Kotlin plugin for Kotline support.</td>
</tr>
<tr>
<td>AppendUserAgent<br /><span class="cdv-var-type string">String</span> <svg class="platform-icon android"><use href="#android"></use></svg> <svg class="platform-icon ios"><use href="#ios"></use></svg></td>
@@ -2715,12 +2790,8 @@ and will be indicated as such.</p>
<td><em>Default: false</em> <br /> Set to true to allow a viewport meta tag to either disable or restrict the range of user scaling, which is enabled by default. Place a viewport such as the following in the HTML to disable scaling and fit content flexibly within the rendering WebView: <br /> <code><meta name='viewport' content='width=device-width, initial-scale=1, user-scalable=no' /></code></td>
</tr>
<tr>
- <td>ErrorUrl<br /><span class="cdv-var-type url">Url</span> <svg class="platform-icon android"><use href="#android"></use></svg></td>
- <td><em>Default: null</em> <br /> If set, will display the referenced page upon an error in the application instead of a dialog with the title "Application Error".</td>
- </tr>
- <tr>
- <td>ErrorUrl<br /><span class="cdv-var-type string">String</span> <svg class="platform-icon ios"><use href="#ios"></use></svg></td>
- <td>If set, will display the referenced local page upon an error in the application.</td>
+ <td>ErrorUrl<br /><span class="cdv-var-type url">Url</span> <svg class="platform-icon android"><use href="#android"></use></svg> <svg class="platform-icon ios"><use href="#ios"></use></svg></td>
+ <td><em>Default: null</em> <br />When this preference is set, the application will display the specified local page upon encountering an error. Additionally, if this preference is set, the Android system will suppress the default dialog titled "Application Error".</td>
</tr>
<tr>
<td>FullScreen<br /><span class="cdv-var-type boolean">Boolean</span> <svg class="platform-icon android"><use href="#android"></use></svg></td>
@@ -2909,6 +2980,7 @@ and will be indicated as such.</p>
</code></pre></div></div>
<h2>feature</h2>
+
<p>If you use the CLI to build applications, you use the plugin command to enable device APIs. This does not modify the top-level config.xml file, so the <feature> element does not apply to your workflow. If you work directly in an SDK and using the platform-specific config.xml file as source, you use the <feature> tag to enable device-level APIs and external plugins. They often appear with custom values in platform-specific config.xml files. See the API Reference for details on how to s [...]
the [Plugin Development Guide](../guide/hybrid/plugins/index.html) for more information on plugins.
NOTE: Most of the time, you do NOT want to set this directly.</feature></feature></p>
@@ -2916,7 +2988,7 @@ NOTE: Most of the time, you do NOT want to set this directly.</feature></feature
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
@@ -2929,12 +3001,13 @@ NOTE: Most of the time, you do NOT want to set this directly.</feature></feature
</table>
<h3>param</h3>
+
<p>Used to specify certain plugin parameters such as: what package to retrieve the plugin code from, and whether the plugin code is to be initialized during the Webview's initialization.</p>
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
@@ -2944,7 +3017,7 @@ NOTE: Most of the time, you do NOT want to set this directly.</feature></feature
<td><em>Required</em> <br /> Allowed values: android-package, ios-package, onload. <br /> 'ios-package' and 'android-package' are used to specify the name of the package (as specified by the 'value' attribute) to be used to initialize the plugin code, while 'onload' is used to specify whether the corresponding plugin (as specified in the 'value' attribute) is to be instantiated when the controller is initialized.</td>
</tr>
<tr>
- <td>value(string or boolean) <br /> <svg class="platform-icon ios"><use href="#ios"></use></svg> <svg class="platform-icon android"><use href="#android"></use></svg></td>
+ <td>value <br /> <span class="cdv-var-type string/boolean">String/boolean</span> <svg class="platform-icon ios"><use href="#ios"></use></svg> <svg class="platform-icon android"><use href="#android"></use></svg></td>
<td><em>Required</em> <br /> Specifies the name of the package to be used to initialize the plugin code (when the 'name' attribute is android-package or ios-package), specifies the name of the plugin to be loaded during controller initialization (when 'name' attribute is set to 'onload').</td>
</tr>
</tbody>
@@ -2965,12 +3038,13 @@ NOTE: Most of the time, you do NOT want to set this directly.</feature></feature
</code></pre></div></div>
<h2>platform</h2>
+
<p>When using the CLI to build applications, it is sometimes necessary to specify preferences or other elements specific to a particular platform. Use the <platform> element to specify configuration that should only appear in a single platform-specific config.xml file.</platform></p>
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
@@ -2990,6 +3064,7 @@ NOTE: Most of the time, you do NOT want to set this directly.</feature></feature
</code></pre></div></div>
<h2>hook</h2>
+
<p>Represents your custom script which will be called by Cordova when
certain action occurs (for example, after plugin is added or platform
prepare logic is invoked). This is useful when you need to extend
@@ -2998,7 +3073,7 @@ default Cordova functionality. See <a href="../guide/appdev/hooks/index.html">Ho
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
@@ -3026,7 +3101,7 @@ default Cordova functionality. See <a href="../guide/appdev/hooks/index.html">Ho
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
@@ -3048,36 +3123,6 @@ default Cordova functionality. See <a href="../guide/appdev/hooks/index.html">Ho
<div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt"><resource-file</span> <span class="na">src=</span><span class="s">"FooPluginStrings.xml"</span> <span class="na">target=</span><span class="s">"res/values/FooPluginStrings.xml"</span> <span class="nt">/></span>
</code></pre></div></div>
-<h1>Sample config.xml</h1>
-<p>Below is a sample config.xml file:</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"><widget</span> <span class="na">id=</span><span class="s">"io.cordova.hellocordova"</span> <span class="na">version=</span><span class="s">"0.0.1"</span> <span class="na">xmlns=</span><span class="s">"http://www.w3.org/ns/widgets"</span> <span class="na">xmlns:cdv=</span><span class="s">"http://cordova.apache.org/ns/1.0"</span><span class="nt">></span>
- <span class="nt"><name></span>HelloCordova<span class="nt"></name></span>
- <span class="nt"><description></span>
- A sample Apache Cordova application that responds to the deviceready event.
- <span class="nt"></description></span>
- <span class="nt"><author</span> <span class="na">email=</span><span class="s">"dev@cordova.apache.org"</span> <span class="na">href=</span><span class="s">"https://cordova.io"</span><span class="nt">></span>
- Apache Cordova Team
- <span class="nt"></author></span>
- <span class="nt"><content</span> <span class="na">src=</span><span class="s">"index.html"</span> <span class="nt">/></span>
- <span class="nt"><access</span> <span class="na">origin=</span><span class="s">"*"</span> <span class="nt">/></span>
- <span class="nt"><allow-intent</span> <span class="na">href=</span><span class="s">"http://*/*"</span> <span class="nt">/></span>
- <span class="nt"><allow-intent</span> <span class="na">href=</span><span class="s">"https://*/*"</span> <span class="nt">/></span>
- <span class="nt"><allow-intent</span> <span class="na">href=</span><span class="s">"tel:*"</span> <span class="nt">/></span>
- <span class="nt"><allow-intent</span> <span class="na">href=</span><span class="s">"sms:*"</span> <span class="nt">/></span>
- <span class="nt"><allow-intent</span> <span class="na">href=</span><span class="s">"mailto:*"</span> <span class="nt">/></span>
- <span class="nt"><allow-intent</span> <span class="na">href=</span><span class="s">"geo:*"</span> <span class="nt">/></span>
- <span class="nt"><platform</span> <span class="na">name=</span><span class="s">"android"</span><span class="nt">></span>
- <span class="nt"><allow-intent</span> <span class="na">href=</span><span class="s">"market:*"</span> <span class="nt">/></span>
- <span class="nt"></platform></span>
- <span class="nt"><platform</span> <span class="na">name=</span><span class="s">"ios"</span><span class="nt">></span>
- <span class="nt"><allow-intent</span> <span class="na">href=</span><span class="s">"itms:*"</span> <span class="nt">/></span>
- <span class="nt"><allow-intent</span> <span class="na">href=</span><span class="s">"itms-apps:*"</span> <span class="nt">/></span>
- <span class="nt"></platform></span>
-<span class="nt"></widget></span>
-</code></pre></div></div>
-
</div>
diff --git a/docs/en/dev/guide/appdev/security/index.html b/docs/en/dev/guide/appdev/security/index.html
index 09fb56fb57..06295cadf7 100644
--- a/docs/en/dev/guide/appdev/security/index.html
+++ b/docs/en/dev/guide/appdev/security/index.html
@@ -2298,7 +2298,7 @@
<h2>Iframes and the Callback Id Mechanism</h2>
-<p>If content is served in an iframe from a whitelisted domain, that domain will have access to the native Cordova bridge. This means that if you whitelist a third-party advertising network and serve those ads through an iframe, it is possible that a malicious ad will be able to break out of the iframe and perform malicious actions. Because of this, you should generally not use iframes unless you control the server that hosts the iframe content. Also note that there are third party plug [...]
+<p>If content is served in an iframe from a allow listed domain, that domain will have access to the native Cordova bridge. This means that if you allow a third-party advertising network and serve those ads through an iframe, it is possible that a malicious ad will be able to break out of the iframe and perform malicious actions. Because of this, you should generally not use iframes unless you control the server that hosts the iframe content. Also note that there are third party plugins [...]
<h2>Certificate Pinning</h2>
@@ -2338,12 +2338,12 @@
<ul>
<li>Set your min-target-sdk level higher than 10. API 10 is Gingerbread, and Gingerbread is no longer supported by Google or device manufacturers, and is therefore not recommend by the Cordova team.</li>
<li>Gingerbread has been shown to be insecure and one of the most targeted mobile OSs <a href="https://bgr.com/2012/11/06/android-security-gingerbread-malware/">https://www.mobilemag.com/2012/11/06/andriod-2-3-gingerbread-security/</a>.</li>
- <li>The Whitelist on Android does not work with Gingerbread or lower. This means an attacker can load malicious code in an iframe that would then have access to all of the Cordova APIs and could use that access to steal personal data, send SMS messages to premium-rate numbers, and perform other malicious acts.</li>
+ <li>The Allowlist on Android does not work with Gingerbread or lower. This means an attacker can load malicious code in an iframe that would then have access to all of the Cordova APIs and could use that access to steal personal data, send SMS messages to premium-rate numbers, and perform other malicious acts.</li>
</ul>
<h3>Use InAppBrowser for outside links</h3>
<ul>
- <li>Use the InAppBrowser when opening links to any outside website. This is much safer than whitelisting a domain name and including the content directly in your application because the InAppBrowser will use the native browser's security features and will not give the website access to your Cordova environment. Even if you trust the third party website and include it directly in your application, that third party website could link to malicious web content.</li>
+ <li>Use the InAppBrowser when opening links to any outside website. This is much safer than allow listing a domain name and including the content directly in your application because the InAppBrowser will use the native browser's security features and will not give the website access to your Cordova environment. Even if you trust the third party website and include it directly in your application, that third party website could link to malicious web content.</li>
</ul>
<h3>Validate all user input</h3>
diff --git a/docs/en/dev/guide/cli/index.html b/docs/en/dev/guide/cli/index.html
index 4f14d79a29..841766298f 100644
--- a/docs/en/dev/guide/cli/index.html
+++ b/docs/en/dev/guide/cli/index.html
@@ -2468,7 +2468,6 @@ Installing <span class="s2">"cordova-plugin-camera"</span> <span class="k">for <
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>cordova plugin <span class="nb">ls
</span>cordova-plugin-camera 2.1.0 <span class="s2">"Camera"</span>
-cordova-plugin-whitelist 1.2.1 <span class="s2">"Whitelist"</span>
</code></pre></div></div>
<p><strong>See Also:</strong></p>
diff --git a/docs/en/dev/guide/platforms/android/index.html b/docs/en/dev/guide/platforms/android/index.html
index 17ffec7a13..6974dd3b48 100644
--- a/docs/en/dev/guide/platforms/android/index.html
+++ b/docs/en/dev/guide/platforms/android/index.html
@@ -2287,70 +2287,117 @@
<p>The supported <a href="https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels">Android API Levels</a> (versions of Android) corresponding with the Cordova-Android released versions are listed in the table below:</p>
<table>
- <thead>
- <tr>
- <th>cordova-android Version</th>
- <th>Supported Android API-Levels</th>
- <th>Equivalent Android Version</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>12.X.X</td>
- <td>24 - 33</td>
- <td>7.0 - 13.0.0</td>
- </tr>
- <tr>
- <td>11.X.X</td>
- <td>22 - 32</td>
- <td>5.1 - 12.0.0 (L)</td>
- </tr>
- <tr>
- <td>10.X.X</td>
- <td>22 - 30</td>
- <td>5.1 - 11.0.0</td>
- </tr>
- <tr>
- <td>9.X.X</td>
- <td>22 - 29</td>
- <td>5.1 - 10.0.0</td>
- </tr>
- <tr>
- <td>8.X.X</td>
- <td>19 - 28</td>
- <td>4.4 - 9.0.0</td>
- </tr>
- <tr>
- <td>7.X.X</td>
- <td>19 - 27</td>
- <td>4.4 - 8.1</td>
- </tr>
- <tr>
- <td>6.X.X</td>
- <td>16 - 26</td>
- <td>4.1 - 8.0.0</td>
- </tr>
- <tr>
- <td>5.X.X</td>
- <td>14 - 23</td>
- <td>4.0 - 6.0.1</td>
- </tr>
- <tr>
- <td>4.1.X</td>
- <td>14 - 22</td>
- <td>4.0 - 5.1</td>
- </tr>
- <tr>
- <td>4.0.X</td>
- <td>10 - 22</td>
- <td>2.3.3 - 5.1</td>
- </tr>
- <tr>
- <td>3.7.X</td>
- <td>10 - 21</td>
- <td>2.3.3 - 5.0.2</td>
- </tr>
- </tbody>
+ <thead>
+ <tr>
+ <th>cordova-android Version</th>
+ <th>Android API-Levels (Android Version)</th>
+ <th>Library & Tooling Version</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>12.0.x</td>
+ <td>24 (7.0) - 33 (13.0)</td>
+ <td>
+ <ul>
+ <li>Build Tools: ^33.0.2</li>
+ <li>Kotlin: 1.7.21</li>
+ <li>Gradle: 7.6</li>
+ <li>Android Gradle Plugin: 7.4.2</li>
+ <li>AndroidX Compat Library: 1.6.1</li>
+ <li>AndroidX WebKit Library: 1.6.0</li>
+ <li>AndroidX Core SplashScreen: 1.0.0</li>
+ <li>Google Services Gradle Plugin: 4.3.15</li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td>11.0.x</td>
+ <td>22 (5.1) - 32 (12L)</td>
+ <td>
+ <ul>
+ <li>Build Tools: ^32.0.0</li>
+ <li>Kotlin: 1.7.21</li>
+ <li>Gradle: 7.4.2</li>
+ <li>Android Gradle Plugin: 7.2.1</li>
+ <li>AndroidX Compat Library: 1.4.2</li>
+ <li>AndroidX WebKit Library: 1.4.0</li>
+ <li>AndroidX Core SplashScreen: 1.0.0-rc01</li>
+ <li>Google Services Gradle Plugin: 4.3.10</li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td>10.1.x</td>
+ <td>22 (5.1) - 30 (11.0)</td>
+ <td>
+ <ul>
+ <li>Build Tools: ^30.0.3</li>
+ <li>Kotlin: 1.5.21</li>
+ <li>Gradle: 7.1.1</li>
+ <li>Android Gradle Plugin: 4.2.2</li>
+ <li>AndroidX Compat Library: 1.3.1</li>
+ <li>AndroidX WebKit Library: 1.4.0</li>
+ <li>Google Services Gradle Plugin: 4.3.8</li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td>10.0.x</td>
+ <td>22 (5.1) - 30 (11.0)</td>
+ <td>
+ <ul>
+ <li>Build Tools: ^30.0.3</li>
+ <li>Kotlin: 1.5.20</li>
+ <li>Gradle: 7.1.1</li>
+ <li>Android Gradle Plugin: 4.2.2</li>
+ <li>AndroidX Compat Library: 1.3.0</li>
+ <li>AndroidX WebKit Library: 1.4.0</li>
+ <li>Google Services Gradle Plugin: 4.3.5</li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td>9.X.X</td>
+ <td>22 (5.1) - 29 (10.0)</td>
+ <td>-</td>
+ </tr>
+ <tr>
+ <td>8.X.X</td>
+ <td>19 (4.4) - 28 (9.0)</td>
+ <td>-</td>
+ </tr>
+ <tr>
+ <td>7.X.X</td>
+ <td>19 (4.4) - 27 (8.1)</td>
+ <td>-</td>
+ </tr>
+ <tr>
+ <td>6.X.X</td>
+ <td>16 (4.1) - 26 (8.0)</td>
+ <td>-</td>
+ </tr>
+ <tr>
+ <td>5.X.X</td>
+ <td>14 (4.0) - 23 (6.0)</td>
+ <td>-</td>
+ </tr>
+ <tr>
+ <td>4.1.X</td>
+ <td>14 (4.0) - 22 (5.1)</td>
+ <td>-</td>
+ </tr>
+ <tr>
+ <td>4.0.X</td>
+ <td>10 (2.3.3) - 22 (5.1)</td>
+ <td>-</td>
+ </tr>
+ <tr>
+ <td>3.7.X</td>
+ <td>10 (2.3.3) - 21 (5.0)</td>
+ <td>-</td>
+ </tr>
+ </tbody>
</table>
<p><em><strong>Note:</strong> The <a href="https://github.com/apache/cordova-android">cordova-android</a> versions listed above are not the Cordova CLI versions.</em></p>
@@ -2915,8 +2962,6 @@ Webview.</p>
<li><a href="https://developer.android.com/studio/run/index.html">Build and run your app</a></li>
</ul>
-<p><img src="/static/img/guide/platforms/android/asdk_import_done.png" alt="" /></p>
-
<p><img src="/static/img/guide/platforms/android/android-studio-electric-eel-20220101-2/hello-cordova-main-activity.png" style="width: 100%;" alt="Hello Cordova MainActivity" /></p>
<h2>Upgrading</h2>
diff --git a/docs/en/dev/guide/platforms/ios/plugin.html b/docs/en/dev/guide/platforms/ios/plugin.html
index 09e9251802..0174da7c23 100644
--- a/docs/en/dev/guide/platforms/ios/plugin.html
+++ b/docs/en/dev/guide/platforms/ios/plugin.html
@@ -2515,8 +2515,8 @@ For JavaScript, you can attach Safari to the app running within the iOS Simulato
forget, an error is logged in the Xcode console.</p>
</li>
<li>
- <p>Don't forget to add any hosts you connect to in the whitelist, as
-described in Domain <a href="../../appdev/whitelist/index.html">Whitelist Guide</a>. If you forget, an error is
+ <p>Don't forget to add any hosts you connect to in the allow list, as
+described in Domain <a href="../../appdev/allowlist/index.html">Allow List Guide</a>. If you forget, an error is
logged in the Xcode console.</p>
</li>
</ul>
diff --git a/docs/en/dev/guide/support/index.html b/docs/en/dev/guide/support/index.html
index 990fc15269..d66891ea7c 100644
--- a/docs/en/dev/guide/support/index.html
+++ b/docs/en/dev/guide/support/index.html
@@ -2278,10 +2278,9 @@
<div id="page-toc-source">
<h1>Platform Support</h1>
-<p>The following shows the set of development tools and device APIs
-available for each platform. The device APIs listed here are provided by
-the core plugins, additional APIs are available via
-<a href="http://plugins.cordova.io">third-party plugins</a>.</p>
+<p>The table below provides a comprehensive overview of the supported development platforms, core plugins, and features for each platform.</p>
+
+<p>For additional functionality, you can explore a wide range of third-party plugins available on the <a href="https://www.npmjs.com/search?q=keywords:ecosystem:cordova">npm registry</a>.</p>
<!-- START HTML -->
@@ -2289,65 +2288,48 @@ the core plugins, additional APIs are available via
<thead>
<tr>
- <th>Platform:</th>
+ <th></th>
+ <th colspan="3">Platforms</th>
+ </tr>
+ <tr>
+ <th></th>
<th><a href="../platforms/android/index.html">Android</a></th>
<th><a href="../platforms/ios/index.html">iOS</a></th>
- <th><a href="../platforms/osx/index.html">OS X</a></th>
- <th><a href="../platforms/windows/index.html">Windows<br />8.1, Phone 8.1, 10</a></th>
<th><a href="../platforms/electron/index.html">Electron</a></th>
</tr>
- <tr>
- <th>CLI shorthand:</th>
- <th>android</th>
- <th>ios</th>
- <th>osx</th>
- <th>windows</th>
- <th>electron</th>
- </tr>
-
</thead>
<tbody>
<tr>
- <th></th>
- <th colspan="20"><h2><a href="../cli/index.html">Cordova CLI</a> Development Platform</h2></th>
+ <th colspan="4"><h2><a href="../cli/index.html">Cordova CLI</a> Development Platform</h2></th>
</tr>
<tr>
<th>Mac</th>
<td data-col="android" class="y"></td>
<td data-col="ios" class="y"></td>
- <td data-col="osx" class="y"></td>
- <td data-col="windows" class="n"></td>
<td data-col="electron" class="y"></td>
</tr>
<tr>
<th>Windows</th>
<td data-col="android" class="y"></td>
<td data-col="ios" class="n"></td>
- <td data-col="osx" class="n"></td>
- <td data-col="windows" class="y"></td>
<td data-col="electron" class="y"></td>
</tr>
<tr>
<th>Linux</th>
<td data-col="android" class="y"></td>
<td data-col="ios" class="n"></td>
- <td data-col="osx" class="n"></td>
- <td data-col="windows" class="n"></td>
<td data-col="electron" class="y"></td>
</tr>
<tr>
- <th></th>
- <th colspan="20"><h2>Core Plugin APIs</h2></th>
+ <th colspan="4"><h2>Core Plugin APIs</h2></th>
</tr>
<tr>
<th><a href="../../reference/cordova-plugin-battery-status/">BatteryStatus</a></th>
<td data-col="android" class="y"></td>
<td data-col="ios" class="y"></td>
- <td data-col="osx" class="n"></td>
- <td data-col="windows" class="y">Windows Phone 8.1 only</td>
<td data-col="electron" class="p">Tests Pending</td>
</tr>
@@ -2355,8 +2337,6 @@ the core plugins, additional APIs are available via
<th><a href="../../reference/cordova-plugin-camera/">Camera</a></th>
<td data-col="android" class="y"></td>
<td data-col="ios" class="y"></td>
- <td data-col="osx" class="n"></td>
- <td data-col="windows" class="y"></td>
<td data-col="electron" class="y"></td>
</tr>
@@ -2364,8 +2344,6 @@ the core plugins, additional APIs are available via
<th><a href="../../reference/cordova-plugin-media-capture/">Capture</a></th>
<td data-col="android" class="y"></td>
<td data-col="ios" class="y"></td>
- <td data-col="osx" class="n"></td>
- <td data-col="windows" class="y"></td>
<td data-col="electron" class="p">Tests Pending</td>
</tr>
@@ -2373,8 +2351,6 @@ the core plugins, additional APIs are available via
<th><a href="../../reference/cordova-plugin-network-information/">Connection</a></th>
<td data-col="android" class="y"></td>
<td data-col="ios" class="y"></td>
- <td data-col="osx" class="n"></td>
- <td data-col="windows" class="y"></td>
<td data-col="electron" class="p">Tests Pending</td>
</tr>
@@ -2382,8 +2358,6 @@ the core plugins, additional APIs are available via
<th><a href="../../reference/cordova-plugin-device/">Device</a></th>
<td data-col="android" class="y"></td>
<td data-col="ios" class="y"></td>
- <td data-col="osx" class="y"></td>
- <td data-col="windows" class="y"></td>
<td data-col="electron" class="p">Tests Pending</td>
</tr>
@@ -2391,8 +2365,6 @@ the core plugins, additional APIs are available via
<th><a href="../../cordova/events/events.html">Events</a></th>
<td data-col="android" class="y"></td>
<td data-col="ios" class="y"></td>
- <td data-col="osx" class="n"></td>
- <td data-col="windows" class="y"></td>
<td data-col="electron" class="p">Tests Pending</td>
</tr>
@@ -2400,8 +2372,6 @@ the core plugins, additional APIs are available via
<th><a href="../../reference/cordova-plugin-file">File</a></th>
<td data-col="android" class="y"></td>
<td data-col="ios" class="y"></td>
- <td data-col="osx" class="y"></td>
- <td data-col="windows" class="y"></td>
<td data-col="electron" class="p">Tests Pending</td>
</tr>
@@ -2409,8 +2379,6 @@ the core plugins, additional APIs are available via
<th><a href="../../reference/cordova-plugin-geolocation/">Geolocation</a></th>
<td data-col="android" class="y"></td>
<td data-col="ios" class="y"></td>
- <td data-col="osx" class="n"></td>
- <td data-col="windows" class="y"></td>
<td data-col="electron" class="p">Tests Pending</td>
</tr>
@@ -2418,8 +2386,6 @@ the core plugins, additional APIs are available via
<th><a href="../../reference/cordova-plugin-globalization/">Globalization</a></th>
<td data-col="android" class="y"></td>
<td data-col="ios" class="y"></td>
- <td data-col="osx" class="n"></td>
- <td data-col="windows" class="y"></td>
<td data-col="electron" class="p">Tests Pending</td>
</tr>
@@ -2427,8 +2393,6 @@ the core plugins, additional APIs are available via
<th><a href="../../reference/cordova-plugin-inappbrowser/">InAppBrowser</a></th>
<td data-col="android" class="y"></td>
<td data-col="ios" class="y"></td>
- <td data-col="osx" class="n"></td>
- <td data-col="windows" class="p">uses iframe</td>
<td data-col="electron" class="p">Tests Pending</td>
</tr>
@@ -2436,8 +2400,6 @@ the core plugins, additional APIs are available via
<th><a href="../../reference/cordova-plugin-media/">Media</a></th>
<td data-col="android" class="y"></td>
<td data-col="ios" class="y"></td>
- <td data-col="osx"></td>
- <td data-col="windows" class="y"></td>
<td data-col="electron" class="p">Tests Pending</td>
</tr>
@@ -2445,8 +2407,6 @@ the core plugins, additional APIs are available via
<th><a href="../../reference/cordova-plugin-dialogs/">Notification</a></th>
<td data-col="android" class="y"></td>
<td data-col="ios" class="y"></td>
- <td data-col="osx" class="n"></td>
- <td data-col="windows" class="y"></td>
<td data-col="electron" class="p">Tests Pending</td>
</tr>
@@ -2454,8 +2414,6 @@ the core plugins, additional APIs are available via
<th><a href="../../reference/cordova-plugin-splashscreen/">Splashscreen</a></th>
<td data-col="android" class="y"></td>
<td data-col="ios" class="y"></td>
- <td data-col="osx" class="n"></td>
- <td data-col="windows" class="y"></td>
<td data-col="electron" class="p">Tests Pending</td>
</tr>
@@ -2463,8 +2421,6 @@ the core plugins, additional APIs are available via
<th><a href="../../reference/cordova-plugin-statusbar/">Status Bar</a></th>
<td data-col="android" class="y"></td>
<td data-col="ios" class="y"></td>
- <td data-col="osx" class="n"></td>
- <td data-col="windows" class="y">WP 8.1 only</td>
<td data-col="electron" class="p">Tests Pending</td>
</tr>
@@ -2472,8 +2428,6 @@ the core plugins, additional APIs are available via
<th><a href="../../cordova/storage/storage.html">Storage</a></th>
<td data-col="android" class="y"></td>
<td data-col="ios" class="y"></td>
- <td data-col="osx" class="n"></td>
- <td data-col="windows" class="y">localStorage &<br /> indexedDB</td>
<td data-col="electron" class="p">Tests Pending</td>
</tr>
@@ -2481,30 +2435,23 @@ the core plugins, additional APIs are available via
<th><a href="../../reference/cordova-plugin-vibration/">Vibration</a></th>
<td data-col="android" class="y"></td>
<td data-col="ios" class="y"></td>
- <td data-col="osx" class="n"></td>
- <td data-col="windows" class="y">WP 8.1 only</td>
<td data-col="electron" class="n"></td>
</tr>
<tr>
- <th></th>
- <th colspan="20"><h2>Platform Features</h2></th>
+ <th colspan="4"><h2>Platform Features</h2></th>
</tr>
<tr>
<th><a href="../hybrid/plugins/index.html">Plugin<br />Interface</a></th>
<td data-col="android" class="y"><a href="../platforms/android/plugin.html">(see details)</a></td>
<td data-col="ios" class="y"><a href="../platforms/ios/plugin.html">(see details)</a></td>
- <td data-col="osx" class="y"></td>
- <td data-col="windows" class="y"></td>
- <td data-col="electron" class="p">Tests Pending</td>
+ <td data-col="electron"> - </td>
</tr>
<tr>
<th><a href="../hybrid/webviews/index.html">Embedded<br />WebView</a></th>
<td data-col="android" class="y"><a href="../platforms/android/webview.html">(see details)</a></td>
<td data-col="ios" class="y"><a href="../platforms/ios/webview.html">(see details)</a></td>
- <td data-col="osx" class="y"></td>
- <td data-col="windows" class="n"></td>
- <td data-col="electron" class="p">Tests Pending</td>
+ <td data-col="electron"> - </td>
</tr>
</tbody>
</table>
diff --git a/docs/en/dev/plugin_ref/spec.html b/docs/en/dev/plugin_ref/spec.html
index 8c9a9c4e99..d49c4b463b 100644
--- a/docs/en/dev/plugin_ref/spec.html
+++ b/docs/en/dev/plugin_ref/spec.html
@@ -2291,21 +2291,21 @@
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
- <td>xmlns(string)</td>
+ <td>xmlns<br /><span class="cdv-var-type string">String</span></td>
<td><em>Required</em> <br /> The plugin namespace, <code>http://apache.org/cordova/ns/plugins/1.0</code>. If the document contains XML from other namespaces, such as tags to be added to the <code>AndroidManifest.xml</code> file in the case of Android, those namespaces should also be included in the <plugin> element.</plugin></td>
</tr>
<tr>
- <td>id(string)</td>
+ <td>id<br /><span class="cdv-var-type string">String</span></td>
<td><em>Required</em> <br /> A npm-style identifier for the plugin.</td>
</tr>
<tr>
- <td>version(string)</td>
+ <td>version<br /><span class="cdv-var-type string">String</span></td>
<td><em>Required</em> <br /> A version number for the plugin. <a href="https://semver.org/">Semver</a> syntax is supported.</td>
</tr>
</tbody>
@@ -2332,25 +2332,25 @@ for more information</p>
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
- <td>name(string)</td>
- <td><em>Required</em> <br /> Name of the engine. Here are the default engines that are supported : <ul><li> <code>cordova</code> </li> <li> <code>cordova-plugman</code> </li> <li> <code>cordova-android</code> </li> <li> <code>cordova-browser</code> </li> <li> <code>cordova-ios</code> </li> <li> <code>cordova-windows</code> </li> <li> <code>cordova-osx</code> </li> <li> <code>windows-os</ [...]
+ <td>name<br /><span class="cdv-var-type string">String</span></td>
+ <td><em>Required</em> <br />Name of the engine. Here are the default engines that are supported: <code>cordova</code>, <code>cordova-plugman</code>, <code>cordova-android</code>, <code>cordova-browser</code>, <code>cordova-ios</code>, <code>windows-os</code>, <code>android-sdk</code> (returns the highest Android api level installed) , <code>apple-xcode</code> (returns the xcode version), <code>apple-ios</code> (returns the highest iOS version installed), <code>apple-osx</code> (ret [...]
</tr>
<tr>
- <td>version(string)</td>
+ <td>version<br /><span class="cdv-var-type string">String</span></td>
<td><em>Required</em> <br /> The version that your framework must have in order to install. Semver syntax is supported.</td>
</tr>
<tr>
- <td>scriptSrc(string)</td>
+ <td>scriptSrc<br /><span class="cdv-var-type string">String</span></td>
<td><strong>For custom frameworks only</strong> <br /> <em>Required</em> <br /> The script file that tells plugman the version of the custom framework. Ideally, this file should be within the top level directory of your plugin directory.</td>
</tr>
<tr>
- <td>platform(string)</td>
+ <td>platform<br /><span class="cdv-var-type string">String</span></td>
<td><strong>For custom frameworks only</strong> <br /> <em>Required</em> <br /> The platforms your framework supports. You may use the wildcard <code>*</code> to say supported for all platforms, specify multiple with a pipe character like <code>android|ios</code> or just a single platform like <code>android</code>.</td>
</tr>
</tbody>
@@ -2431,17 +2431,17 @@ for more information</p>
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
- <td>src(string)</td>
+ <td>src<br /><span class="cdv-var-type string">String</span></td>
<td><em>Required</em> <br /> Where the file or directory is located in the plugin package, relative to the <code>plugin.xml</code> document. If a file does not exist at the specified src location, the CLI stops and reverses the installation process, issues a notification about the conflict, and exits with a non-zero code.</td>
</tr>
<tr>
- <td>target(string)</td>
+ <td>target<br /><span class="cdv-var-type string">String</span></td>
<td><em>Required</em> <br /> Where the file or directory should be located in the Cordova app, relative to the <code>www</code> directory. If a file already exists at the target location, the CLI stops and reverses the installation process, issues a notification about the conflict, and exits with a non-zero code.</td>
</tr>
</tbody>
@@ -2465,17 +2465,17 @@ for more information</p>
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
- <td>src(string)</td>
+ <td>src<br /><span class="cdv-var-type string">String</span></td>
<td>References a file in the plugin directory relative to the <code>plugin.xml</code> file. If src does not resolve to an existing file, the CLI stops and reverses the installation, issues a notification of the problem, and exits with a non-zero code.</td>
</tr>
<tr>
- <td>name(string)</td>
+ <td>name<br /><span class="cdv-var-type string">String</span></td>
<td>Provides the last part of the module name. It can generally be whatever you like, and it only matters if you want to use cordova.require to import other parts of your plugins in your JavaScript code. The module name for a <code><js-module></code> is your plugin's id followed by the value of name.</td>
</tr>
</tbody>
@@ -2497,13 +2497,13 @@ like. Any object not available on <code>window</code> is created.</p>
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
- <td>target(string)</td>
+ <td>target<br /><span class="cdv-var-type string">String</span></td>
<td>The namespace where module.exports gets inserted to.</td>
</tr>
</tbody>
@@ -2523,13 +2523,13 @@ like. Any object not available on <code>window</code> is created.</p>
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
- <td>target(string)</td>
+ <td>target<br /><span class="cdv-var-type string">String</span></td>
<td>The namespace which module.exports gets merged to.</td>
</tr>
</tbody>
@@ -2559,29 +2559,29 @@ like. Any object not available on <code>window</code> is created.</p>
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
- <td>id(string)</td>
+ <td>id<br /><span class="cdv-var-type string">String</span></td>
<td>Provides the ID of the plugin.</td>
</tr>
<tr>
- <td>url(string)</td>
+ <td>url<br /><span class="cdv-var-type string">String</span></td>
<td>A URL for the plugin. This should reference a git repository, which the CLI attempts to clone.</td>
</tr>
<tr>
- <td>commit(string)</td>
+ <td>commit<br /><span class="cdv-var-type string">String</span></td>
<td>This is any git reference understood by <code>git checkout</code>: a branch or tag name (e.g., <code>master</code>, <code>0.3.1</code>), or a commit hash (e.g., <code>975ddb228af811dd8bb37ed1dfd092a3d05295f9</code>).</td>
</tr>
<tr>
- <td>subdir(string)</td>
+ <td>subdir<br /><span class="cdv-var-type string">String</span></td>
<td>Specifies that the targeted plugin dependency exists as a subdirectory of the git repository. This is helpful because it allows the repository to contain several related plugins, each specified individually. <br /> If you set the <code>url</code> of a <code><dependency></code> tag to <code>"."</code> and provide a <code>subdir</code>, the dependent plugin is installed from the same local or remote git repository as the parent plugin that specifies the <code><dependency [...]
</tr>
<tr>
- <td>version(string)</td>
+ <td>version<br /><span class="cdv-var-type string">String</span></td>
<td>The version of the plugin depended on. Semver syntax is supported.</td>
</tr>
</tbody>
@@ -2599,14 +2599,14 @@ like. Any object not available on <code>window</code> is created.</p>
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
- <td>name(string)</td>
- <td><em>Required</em> <br /> Allowed values: ios, android, windows, browser, osx <br /> Identifies a platform as supported, associating the element's children with that platform.</td>
+ <td>name<br /><span class="cdv-var-type string">String</span></td>
+ <td><em>Required</em> <br /> Allowed values: ios, android, browser, electron <br /> Identifies a platform as supported, associating the element's children with that platform.</td>
</tr>
</tbody>
</table>
@@ -2624,25 +2624,25 @@ like. Any object not available on <code>window</code> is created.</p>
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
- <td>src(string)</td>
+ <td>src<br /><span class="cdv-var-type string">String</span></td>
<td><em>Required</em> <br /> Location of the file relative to <code>plugin.xml</code>. If the src file can't be found, the CLI stops and reverses the installation, issues a notification about the problem, and exits with a non-zero code.</td>
</tr>
<tr>
- <td>target-dir(string)</td>
+ <td>target-dir<br /><span class="cdv-var-type string">String</span></td>
<td>A directory into which the files should be copied, relative to the root of the Cordova project. In practice, this is most important for Java-based platforms, where a file in the <code>com.alunny.foo</code> package must be located within the <code>com/alunny/foo</code> directory. For platforms where the source directory is not important, this attribute should be omitted.</td>
</tr>
<tr>
- <td>framework(boolean) <br /> <svg class="platform-icon ios"><use href="#ios"></use></svg></td>
+ <td>framework<br /><span class="cdv-var-type boolean">Boolean</span> <svg class="platform-icon ios"><use href="#ios"></use></svg></td>
<td><em>Default: false</em> <br /> If set to true, also adds the specified file as a framework to the project.</td>
</tr>
<tr>
- <td>compiler-flags(string) <br /> <svg class="platform-icon ios"><use href="#ios"></use></svg></td>
+ <td>compiler-flags<br /><span class="cdv-var-type string">String</span> <svg class="platform-icon ios"><use href="#ios"></use></svg></td>
<td>If set, assigns the specified compiler flags for the particular source file.</td>
</tr>
</tbody>
@@ -2659,26 +2659,26 @@ like. Any object not available on <code>window</code> is created.</p>
<h2>header-file</h2>
-<p>This is like <code><source-file></code> element but specifically for platforms such as iOS and Android that distinguish between source files, headers, and resources. This is not supported by Windows.</p>
+<p>This is like <code><source-file></code> element but specifically for platforms such as iOS and Android that distinguish between source files, headers, and resources.</p>
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
- <td>src(string)</td>
+ <td>src<br /><span class="cdv-var-type string">String</span></td>
<td><em>Required</em> <br /> Location of the file relative to <code>plugin.xml</code>. If the src file can't be found, the CLI stops and reverses the installation, issues a notification about the problem, and exits with a non-zero code.</td>
</tr>
<tr>
- <td>target-dir(string)</td>
+ <td>target-dir<br /><span class="cdv-var-type string">String</span></td>
<td>A directory into which the files should be copied, relative to the root of the Cordova project.</td>
</tr>
<tr>
- <td>type(string) <br /> <svg class="platform-icon ios"><use href="#ios"></use></svg></td>
+ <td>type<br /><span class="cdv-var-type string">String</span> <svg class="platform-icon ios"><use href="#ios"></use></svg></td>
<td>If this value is <code>BridgingHeader</code>, the file is imported in the <code>Bridging-Header.h</code> and can be called from swift program.</td>
</tr>
</tbody>
@@ -2698,53 +2698,27 @@ like. Any object not available on <code>window</code> is created.</p>
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
- <td>src(string)</td>
+ <td>src<br /><span class="cdv-var-type string">String</span></td>
<td><em>Required</em> <br /> Location of the file relative to <code>plugin.xml</code>. If the src file can't be found, the CLI stops and reverses the installation, issues a notification about the problem, and exits with a non-zero code.</td>
</tr>
<tr>
- <td>target(string)</td>
+ <td>target<br /><span class="cdv-var-type string">String</span></td>
<td>Path to where the file will be copied in your directory.</td>
</tr>
- <tr>
- <td>arch(string) <br /> <svg class="platform-icon windows"><use href="#windows"></use></svg></td>
- <td>Allowed values: <code>x86</code>, <code>x64</code> or <code>ARM</code>. <br /> Indicates that the file should only be included when building for the specified architecture.</td>
- </tr>
- <tr>
- <td>device-target <br /> <svg class="platform-icon windows"><use href="#windows"></use></svg></td>
- <td>Allowed values: <code>win</code> (or <code>windows</code>), <code>phone</code> or <code>all</code>. <br /> Indicates that the file should only be included when building for the specified target device type.</td>
- </tr>
- <tr>
- <td>versions <br /> <svg class="platform-icon windows"><use href="#windows"></use></svg></td>
- <td>Indicates that the file should only be included when building for versions that match the specified version string. Value can be any valid node semantic version range string.</td>
- </tr>
- <tr>
- <td>reference <br /> <svg class="platform-icon windows"><use href="#windows"></use></svg></td>
- <td>Indicates that the file should be referenced from the src rather than copied to the target destination. The file will appear in Visual Studio with the file name specified by target, however will point to the respective src, depending on the architecture.</td>
- </tr>
</tbody>
</table>
-<p>Examples:</p>
+<p>Android Examples:</p>
-<p>For Android:</p>
<div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt"><resource-file</span> <span class="na">src=</span><span class="s">"FooPluginStrings.xml"</span> <span class="na">target=</span><span class="s">"res/values/FooPluginStrings.xml"</span> <span class="nt">/></span>
</code></pre></div></div>
-<p>For Windows:</p>
-<div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt"><resource-file</span> <span class="na">src=</span><span class="s">"src/windows/win81/MobServices.pri"</span> <span class="na">target=</span><span class="s">"win81\MobServices.pri"</span> <span class="na">device-target=</span><span class="s">"windows"</span> <span class="na">versions=</span><span class="s">"8.1"</span> <span class="na">arch=</span><span class="s">"x64"</span [...]
-
-<span class="c"><!-- Example of referencing --></span>
-<span class="nt"><resource-file</span> <span class="na">src=</span><span class="s">"x86/foo.dll"</span> <span class="na">target=</span><span class="s">"foo.dll"</span> <span class="na">arch=</span><span class="s">"x86"</span> <span class="na">reference=</span><span class="s">"true"</span> <span class="nt">/></span>
-<span class="nt"><resource-file</span> <span class="na">src=</span><span class="s">"x64/foo.dll"</span> <span class="na">target=</span><span class="s">"foo.dll"</span> <span class="na">arch=</span><span class="s">"x64"</span> <span class="na">reference=</span><span class="s">"true"</span> <span class="nt">/></span>
-</code></pre></div></div>
-<p><strong>NOTE</strong>: <code>target</code> should use backslashes to avoid DEP2100 deploy error in Visual Studio.</p>
-
<h2>config-file</h2>
<p>Identifies an XML-based configuration file to be modified, where in that document the modification should take place, and what should be modified.
@@ -2754,30 +2728,22 @@ The <code>config-file</code> element only allows you to append new children to a
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
- <td>target(string)</td>
+ <td>target<br /><span class="cdv-var-type string">String</span></td>
<td>The file to be modified, and the path relative to the root of the Cordova project. If the specified file does not exist, the tool ignores the configuration change and continues installation. <br /> The target can include wildcard (<code>*</code>) elements. In this case, the CLI recursively searches through the project directory structure and uses the first match. <br /> On iOS, the location of configuration files relative to the project directory root is not known, so specifyin [...]
</tr>
<tr>
- <td>parent(string)</td>
+ <td>parent<br /><span class="cdv-var-type string">String</span></td>
<td>An XPath selector referencing the parent of the elements to be added to the config file. If you use absolute selectors, you can use a wildcard (<code>*</code>) to specify the root element, e.g., <code>/*/plugins</code>. If the selector does not resolve to a child of the specified document, the tool stops and reverses the installation process, issues a warning, and exits with a non-zero code. <br /> For <code>plist</code> files, the <code>parent</code> determines under what pare [...]
</tr>
<tr>
- <td>after(string)</td>
- <td>A prioritized list of accepted siblings after which to add the XML snippet. Useful for specifying changes in files which require strict ordering of XML elements like <a href="https://msdn.microsoft.com/en-us/library/windowsphone/develop/ff769509%28v=vs.105%29.aspx#BKMK_EXTENSIONSelement">this</a>.</td>
- </tr>
- <tr>
- <td>device-target(string) <br /> <svg class="platform-icon windows"><use href="#windows"></use></svg></td>
- <td>Allowed values: <code>win</code>, <code>phone</code>, <code>all</code>. <br /> Applicable when affecting the meta-name <code>package.appxmanifest</code>, this attribute indicates that the file should only be modified when building for the specified target device type.</td>
- </tr>
- <tr>
- <td>versions(string) <br /> <svg class="platform-icon windows"><use href="#windows"></use></svg></td>
- <td>Applicable when affecting the meta-name <code>package.appxmanifest</code>, this attribute indicates that app manifests for specific Windows versions should only be altered for versions that match the specified version string. Value can be any valid node semantic version range string.</td>
+ <td>after<br /><span class="cdv-var-type string">String</span></td>
+ <td>A prioritized list of accepted siblings after which to add the XML snippet. Useful for specifying changes in files which require strict ordering of XML elements.</td>
</tr>
</tbody>
</table>
@@ -2804,38 +2770,27 @@ The <code>config-file</code> element only allows you to append new children to a
<span class="nt"></config-file></span>
</code></pre></div></div>
-<p>For windows-specific attributes:</p>
-<div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt"><config-file</span> <span class="na">target=</span><span class="s">"package.appxmanifest"</span> <span class="na">parent=</span><span class="s">"/Package/Capabilities"</span> <span class="na">versions=</span><span class="s">"&lt;8.1.0"</span><span class="nt">></span>
- <span class="nt"><Capability</span> <span class="na">Name=</span><span class="s">"picturesLibrary"</span> <span class="nt">/></span>
- <span class="nt"><DeviceCapability</span> <span class="na">Name=</span><span class="s">"webcam"</span> <span class="nt">/></span>
-<span class="nt"></config-file></span>
-<span class="nt"><config-file</span> <span class="na">target=</span><span class="s">"package.appxmanifest"</span> <span class="na">parent=</span><span class="s">"/Package/Capabilities"</span> <span class="na">versions=</span><span class="s">">=8.1.0"</span> <span class="na">device-target=</span><span class="s">"phone"</span><span class="nt">></span>
- <span class="nt"><DeviceCapability</span> <span class="na">Name=</span><span class="s">"webcam"</span> <span class="nt">/></span>
-<span class="nt"></config-file></span>
-</code></pre></div></div>
-<p>The above example will set pre-8.1 platforms (Windows 8, specifically) to require the <code>webcam</code> device capability and the <code>picturesLibrary</code> general capability, and apply the <code>webcam</code> device capability only to Windows 8.1 projects that build for Windows Phone. Windows desktop 8.1 systems are unmodified.</p>
-
<h2>edit-config</h2>
<p>Similar to <code>config-file</code>, <code>edit-config</code> identifies an XML-based configuration file to be modified, where in that document the modification should take place, and what should be modified. Instead of appending new children to an XML document tree, <code>edit-config</code> makes modifications to attributes of XML elements. There are two modes which will determine what type of attribute modification will be made, <code>merge</code> or <code>overwrite</code>. <code>ed [...]
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
- <td>file(string)</td>
+ <td>file<br /><span class="cdv-var-type string">String</span></td>
<td>The file to be modified, and the path relative to the root of the Cordova project. If the specified file does not exist, the tool ignores the configuration change and continues installation. <br /> The target can include wildcard (<code>*</code>) elements. In this case, the CLI recursively searches through the project directory structure and uses the first match. <br /> On iOS, the location of configuration files relative to the project directory root is not known, so specifyin [...]
</tr>
<tr>
- <td>target(string)</td>
+ <td>target<br /><span class="cdv-var-type string">String</span></td>
<td>An XPath selector referencing the target element to make attribute modifications to. If you use absolute selectors, you can use a wildcard (<code>*</code>) to specify the root element, e.g., <code>/*/plugins</code>. If the selector does not resolve to a child of the specified document, the tool stops and reverses the installation process, issues a warning, and exits with a non-zero code.</td>
</tr>
<tr>
- <td>mode(string)</td>
+ <td>mode<br /><span class="cdv-var-type string">String</span></td>
<td>The mode that determines what type of attribute modifications will be made. <br /> <code>merge</code> - Adds the specified attributes to the target element. Will replace the attribute values if the specified attributes already exist in the target element. <br /> <code>overwrite</code> - Replaces all attributes in the target element with the attributes specified.</td>
</tr>
</tbody>
@@ -2939,49 +2894,28 @@ The <code>config-file</code> element only allows you to append new children to a
<div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt"><plugins-plist</span> <span class="na">key=</span><span class="s">"Foo"</span> <span class="na">string=</span><span class="s">"CDVFoo"</span> <span class="nt">/></span>
</code></pre></div></div>
-<h2>lib-file</h2>
+<h2>lib-file <svg class="platform-icon android"><use href="#android"></use></svg></h2>
-<p>Like source, resource, and header files, but specifically for platforms such as BlackBerry 10 that use user-generated libraries. For the Windows platform, the <code><lib-file></code> element allows the inclusion of an <code><SDKReference></code> in the generated Windows project files.</p>
+<p>The <code><lib-file></code> element can be used for installing <strong>.jar</strong> files in the project's <strong>libs directory</strong>.</p>
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
- <td>src(string)</td>
- <td><em>Required</em> <br /> The location of the file relative to <code>plugin.xml</code>. If <code>src</code> can't be found, the CLI stops and reverses the installation, issues a warning about the problem, and exits with a non-zero code. <br /> For Windows, it indicates the name of the SDK to include (which will be used as value of the <code>Include</code> attribute of the generated <code><SDKReference></code> element).</td>
- </tr>
- <tr>
- <td>arch(string)</td>
- <td>The architecture for which the <code>.so</code> file has been built, either <code>device</code> or <code>simulator</code>. <br /> For Windows, it indicates that the <code><SDKReference></code> should only be included when building for the specified architecture. Supported values are <code>x86</code>, <code>x64</code> or <code>ARM</code>.</td>
- </tr>
- <tr>
- <td>device-target(string) <br /> <svg class="platform-icon windows"><use href="#windows"></use></svg></td>
- <td>Allowed values: <code>win</code> (or <code>windows</code>), <code>phone</code> or <code>all</code>. <br /> Indicates that the <code><SDKReference></code> should only be included when building for the specified target device type.</td>
- </tr>
- <tr>
- <td>versions(string) <br /> <svg class="platform-icon windows"><use href="#windows"></use></svg></td>
- <td>Indicates that the <code><SDKReference></code> should only be included when building for versions that match the specified version string. Value can be any valid node semantic version range string.</td>
+ <td>src<br /><span class="cdv-var-type string">String</span></td>
+ <td><em>Required</em> <br /> The location of the <code>.jar</code> file relative to <code>plugin.xml</code>. If <code>src</code> file can't be found, the CLI stops and reverses the installation, issues a warning about the problem, and exits with a non-zero code.</td>
</tr>
</tbody>
</table>
-<p>For Android, the <code><lib-file></code> element is used for installing <strong>.jar</strong> files in the project's <strong>libs directory</strong>. It supports only the <code>src</code> attribute which contains the relative path to the .jar file.</p>
-
<p>Examples:</p>
-<div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt"><lib-file</span> <span class="na">src=</span><span class="s">"src/BlackBerry10/native/device/libfoo.so"</span> <span class="na">arch=</span><span class="s">"device"</span> <span class="nt">/></span>
-<span class="nt"><lib-file</span> <span class="na">src=</span><span class="s">"src/BlackBerry10/native/simulator/libfoo.so"</span> <span class="na">arch=</span><span class="s">"simulator"</span> <span class="nt">/></span>
-</code></pre></div></div>
-<p>For Windows:</p>
-<div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt"><lib-file</span> <span class="na">src=</span><span class="s">"Microsoft.WinJS.2.0, Version=1.0"</span> <span class="na">arch=</span><span class="s">"x86"</span> <span class="nt">/></span>
-<span class="nt"><lib-file</span> <span class="na">src=</span><span class="s">"Microsoft.WinJS.2.0, Version=1.0"</span> <span class="na">versions=</span><span class="s">">=8.1"</span> <span class="nt">/></span>
-<span class="nt"><lib-file</span> <span class="na">src=</span><span class="s">"Microsoft.WinJS.2.0, Version=1.0"</span> <span class="na">target=</span><span class="s">"phone"</span> <span class="nt">/></span>
-<span class="nt"><lib-file</span> <span class="na">src=</span><span class="s">"Microsoft.WinJS.2.0, Version=1.0"</span> <span class="na">target=</span><span class="s">"win"</span> <span class="na">versions=</span><span class="s">"8.0"</span> <span class="na">arch=</span><span class="s">"x86"</span> <span class="nt">/></span>
+<div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt"><lib-file</span> <span class="na">src=</span><span class="s">"src/android/libs/foobar.jar"</span><span class="nt">/></span>
</code></pre></div></div>
<h2>framework</h2>
@@ -2991,61 +2925,41 @@ The <code>config-file</code> element only allows you to append new children to a
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
- <td>src(string)</td>
+ <td>src<br /><span class="cdv-var-type string">String</span></td>
<td><em>Required</em> <br /> The name of the system framework or the relative path to one which is included as part of your plugin files.</td>
</tr>
<tr>
- <td>custom(boolean)</td>
+ <td>custom<br /><span class="cdv-var-type boolean">Boolean</span></td>
<td>Indicates whether the framework is included as part of your plugin files.</td>
</tr>
<tr>
- <td>weak(boolean)</td>
+ <td>weak<br /><span class="cdv-var-type boolean">Boolean</span></td>
<td><em>Default: false</em> <br /> Indicates whether the framework should be weakly linked.</td>
</tr>
<tr>
- <td>type(string)</td>
+ <td>type<br /><span class="cdv-var-type string">String</span></td>
<td>Indicates the type of framework to add.</td>
</tr>
<tr>
- <td>parent(string)</td>
+ <td>parent<br /><span class="cdv-var-type string">String</span></td>
<td><em>Default: .</em> <br /> Sets the relative path to the directory containing the sub-project to which to add the reference. The default, <code>.</code>, implies the application project.</td>
</tr>
<tr>
- <td>arch(string) <br /> <svg class="platform-icon windows"><use href="#windows"></use></svg></td>
- <td>Allowed values: <code>x86</code>, <code>x64</code> or <code>ARM</code>. <br /> Indicates that the framework should only be included when building for the specified architecture.</td>
- </tr>
- <tr>
- <td>device-target(string) <br /> <svg class="platform-icon windows"><use href="#windows"></use></svg></td>
- <td>Allowed values: <code>win</code> (or <code>windows</code>), <code>phone</code> or <code>all</code>. <br /> Indicates that the framework should only be included when building for the specified target device type.</td>
- </tr>
- <tr>
- <td>versions(string) <br /> <svg class="platform-icon windows"><use href="#windows"></use></svg></td>
- <td>Indicates that the framework should only be included when building for versions that match the specified version string. Value can be any valid node semantic version range string.</td>
- </tr>
- <tr>
- <td>target-dir(string) <br /> <svg class="platform-icon windows"><use href="#windows"></use></svg></td>
- <td>Indicates a subdirectory into which the framework should be copied. In practice, this is most important when plugin contains different framework versions for different chip architectures or device targets, but which have the same name. This allows you to specify different subfolders for each framework version so that they don't overlap each other.</td>
- </tr>
- <tr>
- <td>implementation(string) <br /> <svg class="platform-icon windows"><use href="#windows"></use></svg></td>
- <td>Sets the relative path to <code>.dll</code> file that contains implementation for WinMD component, written in C++.</td>
- </tr>
- <tr>
- <td>spec(string) <br /> <svg class="platform-icon ios"><use href="#ios"></use></svg></td>
+ <td>spec<br /><span class="cdv-var-type string">String</span> <svg class="platform-icon ios"><use href="#ios"></use></svg></td>
<td>Paired with <code>type="podspec"</code>, this is the spec string for the CocoaPod you want to install (static library only). CocoaPod support only exists in <code>cordova-ios 4.3.0</code> and <code>cordova-cli 6.4.0</code>. For your plugin, make sure you add the appropriate <code><engine></code> tags and <code>package.json</code> <a href="../guide/hybrid/plugins/index.html#specifying-cordova-dependencies">dependencies</a> to ensure backwards-compatible support.</td>
</tr>
<tr>
- <td>embed(boolean) <br /> <svg class="platform-icon ios"><use href="#ios"></use></svg></td>
+ <td>embed<br /><span class="cdv-var-type boolean">Boolean</span> <svg class="platform-icon ios"><use href="#ios"></use></svg></td>
<td><em>Default: false</em> <br />Paired with <code>custom="true"</code>, this is set to true if you want to embed your custom framework into your app bundle, so it can be dynamically loaded at runtime (dynamic framework). This puts your custom framework in the 'Embedded Binaries' section of your Xcode Project Settings. Only supported with the combination of <code>cordova-ios@4.4.0</code> and <code>cordova-cli@7.0.0</code></td>
</tr>
<tr>
- <td>link(boolean) <br /> <svg class="platform-icon ios"><use href="#ios"></use></svg></td>
+ <td>link<br /><span class="cdv-var-type boolean">Boolean</span> <svg class="platform-icon ios"><use href="#ios"></use></svg></td>
<td><em>Default: !embed</em> <br /> Set this to true if you want to link the framework. This puts the framework in the 'Link Binaries with Libraries' section of your Xcode Project Settings.</td>
</tr>
</tbody>
@@ -3054,6 +2968,7 @@ The <code>config-file</code> element only allows you to append new children to a
<p>Examples:</p>
<p>For iOS:</p>
+
<div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt"><framework</span> <span class="na">src=</span><span class="s">"libsqlite3.dylib"</span> <span class="nt">/></span>
<span class="nt"><framework</span> <span class="na">src=</span><span class="s">"social.framework"</span> <span class="na">weak=</span><span class="s">"true"</span> <span class="nt">/></span>
<span class="nt"><framework</span> <span class="na">src=</span><span class="s">"relative/path/to/my.framework"</span> <span class="na">custom=</span><span class="s">"true"</span> <span class="nt">/></span>
@@ -3061,6 +2976,7 @@ The <code>config-file</code> element only allows you to append new children to a
</code></pre></div></div>
<p>On Android (as of cordova-android@4.0.0), framework tags are used to include Maven dependencies, or to include bundled library projects.</p>
+
<div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c"><!-- Depend on latest version of GCM from play services --></span>
<span class="nt"><framework</span> <span class="na">src=</span><span class="s">"com.google.android.gms:play-services-gcm:+"</span> <span class="nt">/></span>
<span class="c"><!-- Depend on v21 of appcompat-v7 support library --></span>
@@ -3070,32 +2986,11 @@ The <code>config-file</code> element only allows you to append new children to a
</code></pre></div></div>
<p>Framework can also be used to have custom <code>.gradle</code> files sub-included into the main project's <code>build.gradle</code> file:</p>
-<div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt"><framework</span> <span class="na">src=</span><span class="s">"relative/path/rules.gradle"</span> <span class="na">custom=</span><span class="s">"true"</span> <span class="na">type=</span><span class="s">"gradleReference"</span> <span class="nt">/></span>
-</code></pre></div></div>
-
-<p>On Windows, using <code>custom='true'</code> and <code>type='projectReference'</code> will add a reference to the project which will be added to the compile+link steps of the cordova project. This essentially is the only way currently that a 'custom' framework can target multiple architectures as they are explicitly built as a dependency by the referencing cordova application.</p>
-<div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt"><framework</span> <span class="na">src=</span><span class="s">"path/to/project/LibProj.csproj"</span> <span class="na">custom=</span><span class="s">"true"</span> <span class="na">type=</span><span class="s">"projectReference"</span><span class="nt">/></span>
-</code></pre></div></div>
-
-<p>Examples of using these Windows specific attributes:</p>
-<div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt"><framework</span> <span class="na">src=</span><span class="s">"src/windows/example.dll"</span> <span class="na">arch=</span><span class="s">"x64"</span> <span class="nt">/></span>
-<span class="nt"><framework</span> <span class="na">src=</span><span class="s">"src/windows/example.dll"</span> <span class="na">versions=</span><span class="s">">=8.0"</span> <span class="nt">/></span>
-<span class="nt"><framework</span> <span class="na">src=</span><span class="s">"src/windows/example.vcxproj"</span> <span class="na">type=</span><span class="s">"projectReference"</span> <span class="na">target=</span><span class="s">"win"</span> <span class="nt">/></span>
-<span class="nt"><framework</span> <span class="na">src=</span><span class="s">"src/windows/example.vcxproj"</span> <span class="na">type=</span><span class="s">"projectReference"</span> <span class="na">target=</span><span class="s">"all"</span> <span class="na">versions=</span><span class="s">"8.1"</span> <span class="na">arch=</span><span class="s">"x86"</span> <span class="nt">/></span>
-<span class="nt"><framework</span> <span class="na">src=</span><span class="s">"src/windows/example.dll"</span> <span class="na">target-dir=</span><span class="s">"bin/x64"</span> <span class="na">arch=</span><span class="s">"x64"</span> <span class="na">custom=</span><span class="s">"true"</span><span class="nt">/></span>
-</code></pre></div></div>
-<p>Another example of using Windows-specific attributes to add a reference to WinMD components, written in C# and C++, whose API will be available at runtime:</p>
-
-<div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c"><!-- C# component that consists of one .winmd file --></span>
-<span class="nt"><framework</span> <span class="na">src=</span><span class="s">"lib\windows\component.winmd"</span> <span class="na">versions=</span><span class="s">"<10.0"</span> <span class="nt">/></span>
-<span class="c"><!-- C++ component with separated metadata and implementation--></span>
-<span class="nt"><framework</span> <span class="na">src=</span><span class="s">"lib\windows\x86\cppcomponent.winmd"</span>
- <span class="na">implementation=</span><span class="s">"lib\windows\x86\cppcomponent.dll"</span>
- <span class="na">target-dir=</span><span class="s">"component\x86"</span> <span class="na">arch=</span><span class="s">"x86"</span> <span class="na">versions=</span><span class="s">">=10.0"</span> <span class="nt">/></span>
+<div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt"><framework</span> <span class="na">src=</span><span class="s">"relative/path/rules.gradle"</span> <span class="na">custom=</span><span class="s">"true"</span> <span class="na">type=</span><span class="s">"gradleReference"</span> <span class="nt">/></span>
</code></pre></div></div>
-<h2>podspec (<svg class="platform-icon ios"><use href="#ios"></use></svg>)</h2>
+<h2>podspec <svg class="platform-icon ios"><use href="#ios"></use></svg></h2>
<p>Identifies the CocoaPods <code>Podfile</code> that provides the dependencies in which the plugin depends on.</p>
<p>This element contains a <code><config></code> and a <code><pods></code> tag.</p>
@@ -3106,9 +3001,21 @@ The <code>config-file</code> element only allows you to append new children to a
<p>This element contains one or more <code><source></code> tags.</p>
<h4>source</h4>
-<p>Attributes(type) | Description
-—————- | ————
-url | <em>Required</em> <br /> The source url of pods spec.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Attributes</th>
+ <th>Description</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>url<br /><span class="cdv-var-type string">String</span></td>
+ <td><em>Required</em> <br /> The source url of pods spec.</td>
+ </tr>
+ </tbody>
+</table>
<h3>pods</h3>
<p>The <code><pods></code> element identifies CocoaPods libraries.</p>
@@ -3118,17 +3025,17 @@ url | <em>Required</em> <br /> The source url of pods spec.</p>
<table>
<thead>
<tr>
- <th>Attributes(type)</th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
- <td>use-frameworks(string)</td>
+ <td>use-frameworks<br /><span class="cdv-var-type boolean">Boolean</span></td>
<td>Default: false <br /> If <code>true</code>, the <code>use_frameworks!</code> attribute is declared in the Podfile.</td>
</tr>
<tr>
- <td>inhibit-all-warnings(string)</td>
+ <td>inhibit-all-warnings<br /><span class="cdv-var-type boolean">Boolean</span></td>
<td>Default: false <br /> If <code>true</code>, the <code>inhibit_all_warnings!</code> attribute is declared in the Podfile.</td>
</tr>
</tbody>
@@ -3145,47 +3052,47 @@ url | <em>Required</em> <br /> The source url of pods spec.</p>
</thead>
<tbody>
<tr>
- <td>name</td>
+ <td>name<br /><span class="cdv-var-type string">String</span></td>
<td><em>Required</em><br /> Pod name</td>
</tr>
<tr>
- <td>spec</td>
+ <td>spec<br /><span class="cdv-var-type string">String</span></td>
<td>Pod spec</td>
</tr>
<tr>
- <td>swift-version</td>
+ <td>swift-version<br /><span class="cdv-var-type string">String</span></td>
<td>Specify swift version of the CocoaPods library</td>
</tr>
<tr>
- <td>git</td>
+ <td>git<br /><span class="cdv-var-type string">String</span></td>
<td>Pod <code>git</code> option.</td>
</tr>
<tr>
- <td>branch</td>
+ <td>branch<br /><span class="cdv-var-type string">String</span></td>
<td>Pod <code>branch</code> option.</td>
</tr>
<tr>
- <td>tag</td>
+ <td>tag<br /><span class="cdv-var-type string">String</span></td>
<td>Pod <code>tag</code> option.</td>
</tr>
<tr>
- <td>commit</td>
+ <td>commit<br /><span class="cdv-var-type string">String</span></td>
<td>Pod <code>commit</code> option.</td>
</tr>
<tr>
- <td>configurations</td>
+ <td>configurations<br /><span class="cdv-var-type string">String</span></td>
<td>Pod <code>configurations</code> option. For multiple values, separate them with a comma.</td>
</tr>
<tr>
- <td>http</td>
+ <td>http<br /><span class="cdv-var-type string">String</span></td>
<td>Pod <code>http</code> option.</td>
</tr>
<tr>
- <td>path</td>
+ <td>path<br /><span class="cdv-var-type string">String</span></td>
<td>Pod <code>path</code> option. Pod located on the local file system.</td>
</tr>
<tr>
- <td>options</td>
+ <td>options<br /><span class="cdv-var-type string">String</span></td>
<td>Pod options declared in raw format. If declared, the other Pod options are overwritten.<br />Example: <code>options=":git => 'https://github.com/Alamofire/Alamofire.git', :tag => '3.1.1'"</code></td>
</tr>
</tbody>
@@ -3284,17 +3191,17 @@ Preferences can be referenced elsewhere in <code>plugin.xml</code> using the syn
<table>
<thead>
<tr>
- <th>Attributes(type) <br /> <span class="sub-header">Only for platform:</span></th>
+ <th>Attributes</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
- <td>name(string)</td>
+ <td>name<br /><span class="cdv-var-type string">String</span></td>
<td><em>Required</em> <br /> Name of the variable. Can only contain capital letters, digits, and underscores.</td>
</tr>
<tr>
- <td>default(string)</td>
+ <td>default<br /><span class="cdv-var-type string">String</span></td>
<td>Default value of the variable. If present, its value will be used and no error will be emitted in case user does not enter any value.</td>
</tr>
</tbody>
diff --git a/feed.xml b/feed.xml
index d50db27adf..d572b19586 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>Tue, 30 May 2023 12:45:37 +0000</pubDate>
- <lastBuildDate>Tue, 30 May 2023 12:45:37 +0000</lastBuildDate>
+ <pubDate>Thu, 01 Jun 2023 04:07:49 +0000</pubDate>
+ <lastBuildDate>Thu, 01 Jun 2023 04:07:49 +0000</lastBuildDate>
<generator>Jekyll v4.3.2</generator>
<item>
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org