This is an automated email from the ASF dual-hosted git repository.
github-actions[bot] pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/cordova-docs.git
The following commit(s) were added to refs/heads/asf-site by this push:
new f7e8475935 Deploying to asf-site from @
apache/cordova-docs@5d0b6641def5d851411b2c23b3cbc188fcd4153a 🚀
f7e8475935 is described below
commit f7e84759355582b9c54a3ce2f00aee645bab5a8b
Author: GitToTheHub <[email protected]>
AuthorDate: Sun Oct 11 10:32:23 2026 +0000
Deploying to asf-site from @
apache/cordova-docs@5d0b6641def5d851411b2c23b3cbc188fcd4153a 🚀
---
docs/en/latest/guide/cli/index.html | 19 ++++++++++++
docs/en/latest/guide/platforms/android/index.html | 28 ++++++++++++++---
docs/en/latest/guide/platforms/ios/index.html | 7 +++--
docs/en/latest/reference/cordova-cli/index.html | 37 +++++++++++++++++++----
feed.xml | 4 +--
5 files changed, 80 insertions(+), 15 deletions(-)
diff --git a/docs/en/latest/guide/cli/index.html
b/docs/en/latest/guide/cli/index.html
index bb6c53a8db..a5e4719e78 100644
--- a/docs/en/latest/guide/cli/index.html
+++ b/docs/en/latest/guide/cli/index.html
@@ -2241,10 +2241,29 @@ Error: Some of requirements check failed
<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova build ios
</code></pre></div></div>
+<h3>Passing Platform-Specific Arguments</h3>
+
+<p>When using <code>cordova build</code> or <code>cordova run</code>, you can
pass platform-specific options (such as signing flags or Gradle parameters) by
prefixing them with the <code>--</code> pass-through separator:</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="c"># Example passing Gradle flags on
Android</span>
+cordova build android <span class="nt">--</span> <span
class="nt">--gradleArg</span><span class="o">=</span><span
class="nt">-PcdvMinSdkVersion</span><span class="o">=</span>20
+
+<span class="c"># Example passing signing flags on Android</span>
+cordova build android <span class="nt">--release</span> <span
class="nt">--</span> <span class="nt">--packageType</span><span
class="o">=</span>apk
+</code></pre></div></div>
+
+<blockquote>
+ <p><strong>Note for Windows users:</strong> On Windows (Command Prompt and
PowerShell), the <code>--</code> separator must be enclosed in quotation marks
(<code>"--"</code>) so that the shell forwards the arguments to platform build
scripts correctly, for example:</p>
+ <div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova build android <span class="nt">--release</span>
<span class="s2">"--"</span> <span class="nt">--packageType</span><span
class="o">=</span>apk
+</code></pre></div> </div>
+</blockquote>
+
<p><strong>See Also:</strong></p>
<ul>
<li><a
href="../../reference/cordova-cli/index.html#cordova-build-command">Cordova
build command reference documentation</a></li>
+ <li><a href="../../guide/platforms/android/index.html">Android Platform
Guide</a></li>
+ <li><a href="../../guide/platforms/ios/index.html">iOS Platform
Guide</a></li>
</ul>
<h2>Test the App</h2>
diff --git a/docs/en/latest/guide/platforms/android/index.html
b/docs/en/latest/guide/platforms/android/index.html
index 06f2553dfd..fbd1ec8837 100644
--- a/docs/en/latest/guide/platforms/android/index.html
+++ b/docs/en/latest/guide/platforms/android/index.html
@@ -2662,7 +2662,7 @@ C:\Users\[your user]\AppData\Local\Android\Sdk\emulator
<li>
<p>Using an Environment Variables:</p>
- <p><strong>Example:</strong></p>
+ <p><strong>Example (Unix/macOS):</strong></p>
<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> <span class="nb">export </span><span
class="nv">ORG_GRADLE_PROJECT_cdvMinSdkVersion</span><span class="o">=</span>20
cordova build android
@@ -2671,10 +2671,15 @@ C:\Users\[your user]\AppData\Local\Android\Sdk\emulator
<li>
<p>Using the <code>--gradleArg</code> flag with the Cordova
<code>build</code> or <code>run</code> command:</p>
- <p><strong>Example:</strong></p>
+ <p><strong>Example (Unix/macOS):</strong></p>
<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> cordova run android <span class="nt">--</span> <span
class="nt">--gradleArg</span><span class="o">=</span><span
class="nt">-PcdvMinSdkVersion</span><span class="o">=</span>20
</code></pre></div> </div>
+
+ <p><strong>Example (Windows):</strong></p>
+
+ <div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> cordova run android <span class="s2">"--"</span>
<span class="nt">--gradleArg</span><span class="o">=</span><span
class="nt">-PcdvMinSdkVersion</span><span class="o">=</span>20
+</code></pre></div> </div>
</li>
<li>
<p>Creating a <code>gradle.properties</code> in the project's Android
platform directory</p>
@@ -2749,7 +2754,14 @@ C:\Users\[your user]\AppData\Local\Android\Sdk\emulator
<p>By default, JVM args has a value of <code>-Xmx2048m</code>. To increase the
maximum allowed memory, use the <code>-Xmx</code> JVM arg. Example given
below:</p>
-<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova build android -- --jvmargs='-Xmx4g'
+<p><strong>Example (Unix/macOS):</strong></p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova build android <span class="nt">--</span> <span
class="nt">--jvmargs</span><span class="o">=</span><span
class="s1">'-Xmx4g'</span>
+</code></pre></div></div>
+
+<p><strong>Example (Windows):</strong></p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova build android <span class="s2">"--"</span>
<span class="nt">--jvmargs</span><span class="o">=</span><span
class="s2">"-Xmx4g"</span>
</code></pre></div></div>
<p>The following units are supported:</p>
@@ -2851,9 +2863,15 @@ will happen regardless of whether the version code is
taken from the <code>andro
<p><em><strong>Note</strong>: You should use double <code>--</code> to
indicate that these are platform-specific arguments.</em></p>
-<p>Example:</p>
+<p><strong>Example (Unix/macOS):</strong></p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova run android <span class="nt">--release</span>
<span class="nt">--</span> <span class="nt">--keystore</span><span
class="o">=</span>../my-release-key.keystore <span
class="nt">--storePassword</span><span class="o">=</span>password <span
class="nt">--alias</span><span class="o">=</span>alias_name <span
class="nt">--password</span><span class="o">=</span>password <span
class="nt">--packa [...]
+</code></pre></div></div>
-<p><code>cordova run android --release --
--keystore=../my-release-key.keystore --storePassword=password
--alias=alias_name --password=password --packageType=bundle</code>.</p>
+<p><strong>Example (Windows):</strong></p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova run android <span class="nt">--release</span>
<span class="s2">"--"</span> <span class="nt">--keystore</span><span
class="o">=</span>../my-release-key.keystore <span
class="nt">--storePassword</span><span class="o">=</span>password <span
class="nt">--alias</span><span class="o">=</span>alias_name <span
class="nt">--password</span><span class="o">=</span>password <span
class="nt">--pac [...]
+</code></pre></div></div>
<h3>Using <code>build.json</code></h3>
diff --git a/docs/en/latest/guide/platforms/ios/index.html
b/docs/en/latest/guide/platforms/ios/index.html
index ba4fe94308..d1093fc0c4 100644
--- a/docs/en/latest/guide/platforms/ios/index.html
+++ b/docs/en/latest/guide/platforms/ios/index.html
@@ -2416,9 +2416,12 @@ and the <a
href="https://developer.apple.com/library/prerelease/ios/documentatio
<p>These parameters can be specified using the command line arguments above to
the Cordova CLI <code>build</code> or <code>run</code> commands.</p>
-<p><strong>Note</strong>: You should use double <code>--</code> to indicate
that these are platform-specific arguments, for example:</p>
+<p><strong>Note</strong>: You should use double <code>--</code> to indicate
that these are platform-specific arguments.</p>
-<p><code>cordova run ios --release -- --codeSignIdentity="iPhone Developer"
--developmentTeam=FG35JLLMXX4A --packageType=development</code>.</p>
+<p><strong>Example (Unix/macOS):</strong></p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova run ios <span class="nt">--release</span> <span
class="nt">--</span> <span class="nt">--codeSignIdentity</span><span
class="o">=</span><span class="s2">"iPhone Developer"</span> <span
class="nt">--developmentTeam</span><span class="o">=</span>FG35JLLMXX4A <span
class="nt">--packageType</span><span class="o">=</span>development
+</code></pre></div></div>
<h3>Using build.json</h3>
diff --git a/docs/en/latest/reference/cordova-cli/index.html
b/docs/en/latest/reference/cordova-cli/index.html
index 5534d9229a..618a84eebc 100644
--- a/docs/en/latest/reference/cordova-cli/index.html
+++ b/docs/en/latest/reference/cordova-cli/index.html
@@ -2173,9 +2173,16 @@
<h2>CLI Syntax</h2>
+<p><strong>Unix/macOS:</strong></p>
+
<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova <<span class="nb">command</span><span
class="o">></span> <span class="o">[</span>options] <span
class="nt">--</span> <span class="o">[</span>platformOpts]
</code></pre></div></div>
+<p><strong>Windows:</strong></p>
+
+<div class="language-text highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova <command> [options] "--" [platformOpts]
+</code></pre></div></div>
+
<h2>Global Command List</h2>
<p>These commands are available at all times.</p>
@@ -2289,6 +2296,10 @@
<p>Certain commands have options (<code>platformOpts</code>) that are specific
to a particular platform. They can be provided to the cordova-cli with a
'--' separator that stops the command parsing within the cordova-lib
module and passes through rest of the options for platforms to parse.</p>
+<blockquote>
+ <p><strong>Note for Windows users:</strong> On Windows (Command Prompt and
PowerShell), the <code>--</code> separator must be enclosed in quotation marks
(<code>"--"</code>) so that the shell forwards the arguments to platform build
scripts correctly.</p>
+</blockquote>
+
<h2>CLI Usage Example</h2>
<p>The following example illustrates how to utilize Cordova CLI to perform
various tasks such as:</p>
@@ -2342,7 +2353,14 @@
<li>
<p>Build Project for Android in Release Mode with Signing Parameters</p>
- <div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> cordova build android <span
class="nt">--release</span> <span class="nt">--</span> <span
class="nt">--keystore</span><span class="o">=</span><span
class="s2">"..</span><span class="se">\a</span><span
class="s2">ndroid.keystore"</span> <span class="nt">--storePassword</span><span
class="o">=</span>android <span class="nt">--alias</span><span
class="o">=</span>mykey
+ <p><strong>Unix/macOS:</strong></p>
+
+ <div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> cordova build android <span
class="nt">--release</span> <span class="nt">--</span> <span
class="nt">--keystore</span><span class="o">=</span><span
class="s2">"../android.keystore"</span> <span
class="nt">--storePassword</span><span class="o">=</span>android <span
class="nt">--alias</span><span class="o">=</span>mykey
+</code></pre></div> </div>
+
+ <p><strong>Windows:</strong></p>
+
+ <div class="language-text highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> cordova build android --release "--"
--keystore="../android.keystore" --storePassword=android --alias=mykey
</code></pre></div> </div>
</li>
</ol>
@@ -2844,7 +2862,7 @@ It only performs the compilation step without doing
prepare. It's common to
</tr>
<tr>
<td><code><platformOpts></code></td>
- <td>To provide platform specific options, you must include them after
<code>--</code> separator. Review platform guide docs for more details.</td>
+ <td>To provide platform specific options, you must include them after
<code>--</code> separator (on Windows shells, enclose in quotes:
<code>"--"</code>). Review platform guide docs for more details.</td>
</tr>
</tbody>
</table>
@@ -2862,14 +2880,21 @@ It only performs the compilation step without doing
prepare. It's common to
<li>Build for <code>android</code> platform in <code>release</code> mode and
use the specified build configuration:</li>
</ul>
-<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova build android <span class="nt">--release</span>
<span class="nt">--buildConfig</span><span class="o">=</span>..<span
class="se">\m</span>yBuildConfig.json
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova build android <span class="nt">--release</span>
<span class="nt">--buildConfig</span><span class="o">=</span><span
class="s2">"../myBuildConfig.json"</span>
</code></pre></div></div>
<ul>
<li>Build for <code>android</code> platform in release mode and pass custom
platform options to android build process:</li>
</ul>
-<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova build android <span class="nt">--release</span>
<span class="nt">--</span> <span class="nt">--keystore</span><span
class="o">=</span><span class="s2">"..</span><span class="se">\a</span><span
class="s2">ndroid.keystore"</span> <span class="nt">--storePassword</span><span
class="o">=</span>android <span class="nt">--alias</span><span
class="o">=</span>mykey
+<p><strong>Unix/macOS:</strong></p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova build android <span class="nt">--release</span>
<span class="nt">--</span> <span class="nt">--keystore</span><span
class="o">=</span><span class="s2">"../android.keystore"</span> <span
class="nt">--storePassword</span><span class="o">=</span>android <span
class="nt">--alias</span><span class="o">=</span>mykey
+</code></pre></div></div>
+
+<p><strong>Windows:</strong></p>
+
+<div class="language-text highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova build android --release "--"
--keystore="../android.keystore" --storePassword=android --alias=mykey
</code></pre></div></div>
<h2><code>cordova run</code> command</h2>
@@ -2937,7 +2962,7 @@ It only performs the compilation step without doing
prepare. It's common to
</tr>
<tr>
<td><code><platformOpts></code></td>
- <td>To provide platform specific options, you must include them after
<code>--</code> separator. Review platform guide docs for more details.</td>
+ <td>To provide platform specific options, you must include them after
<code>--</code> separator (on Windows shells, enclose in quotes:
<code>"--"</code>). Review platform guide docs for more details.</td>
</tr>
</tbody>
</table>
@@ -2948,7 +2973,7 @@ It only performs the compilation step without doing
prepare. It's common to
<li>Run a release build of current cordova project on <code>android</code>
platform emulator named <code>Nexus_5_API_23_x86</code>. Use the spcified build
configuration when running:</li>
</ul>
-<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova run android <span class="nt">--release</span>
<span class="nt">--buildConfig</span><span class="o">=</span>..<span
class="se">\m</span>yBuildConfig.json <span class="nt">--target</span><span
class="o">=</span>Nexus_5_API_23_x86
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova run android <span class="nt">--release</span>
<span class="nt">--buildConfig</span><span class="o">=</span><span
class="s2">"../myBuildConfig.json"</span> <span class="nt">--target</span><span
class="o">=</span>Nexus_5_API_23_x86
</code></pre></div></div>
<ul>
diff --git a/feed.xml b/feed.xml
index 31c81383a4..ad92ffc92d 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>Sun, 11 Oct 2026 07:24:16 +0000</pubDate>
- <lastBuildDate>Sun, 11 Oct 2026 07:24:16 +0000</lastBuildDate>
+ <pubDate>Sun, 11 Oct 2026 10:32:14 +0000</pubDate>
+ <lastBuildDate>Sun, 11 Oct 2026 10:32:14 +0000</lastBuildDate>
<generator>Jekyll v4.4.1</generator>
<item>
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
