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 cd785c04a4 Deploying to asf-site from @
apache/cordova-docs@53a86050ab07b2f333cdd3d8ca2fef1b4def6351 🚀
cd785c04a4 is described below
commit cd785c04a4177ff33906c4b2832d9ffc94ef5580
Author: erisu <[email protected]>
AuthorDate: Fri May 26 11:22:28 2023 +0000
Deploying to asf-site from @
apache/cordova-docs@53a86050ab07b2f333cdd3d8ca2fef1b4def6351 🚀
---
.../dev/platform_plugin_versioning_ref/index.html | 90 +++++++++++++++++-----
feed.xml | 4 +-
2 files changed, 74 insertions(+), 20 deletions(-)
diff --git a/docs/en/dev/platform_plugin_versioning_ref/index.html
b/docs/en/dev/platform_plugin_versioning_ref/index.html
index 2e3e0c7877..f7371490bc 100644
--- a/docs/en/dev/platform_plugin_versioning_ref/index.html
+++ b/docs/en/dev/platform_plugin_versioning_ref/index.html
@@ -2297,7 +2297,9 @@
<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova platform add <platform[@<version>] |
directory | git_url>
</code></pre></div></div>
-<p>After running the above command, the
<strong><code>package.json</code></strong> should contain something as seen
below:</p>
+<p>After running the above command, the
<strong><code>package.json</code></strong> should update with the platform
dependency and cordova related information.</p>
+
+<p>Example:</p>
<div class="language-json highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nl">"cordova"</span><span
class="p">:</span><span class="w"> </span><span class="p">{</span><span
class="w">
</span><span class="nl">"platforms"</span><span class="p">:</span><span
class="w"> </span><span class="p">[</span><span class="w">
@@ -2309,33 +2311,85 @@
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
-<p>The <code>--nosave</code> flag prevents adding and deleting specified
platforms to the <code>package.json</code> file. To prevent saving a platform,
issue the following command:</p>
+<p>The <code>--nosave</code> flag prevents adding and deleting the specified
platform from the <code>package.json</code> file.</p>
+
+<p>Example:</p>
<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova platform add <platform[@<version>] |
directory | git_url> <span class="nt">--nosave</span>
</code></pre></div></div>
-<p>Some Examples:</p>
+<p>The examples below fetch the package, extract it to
<code>node_modules</code> and update the <code>package.json</code> file
accordingly. Under the covers, this process is controlled by the npm CLI. Here
are various ways to add platforms.</p>
-<ul>
- <li>
- <p><strong><code>cordova platform add android</code></strong></p>
+<p><em>Adding with Cordova resolved name:</em></p>
- <p>Retrieves the pinned version of <code>cordova-android</code> platform
from npm, adds it to the project and updates the <code>package.json</code>
file.</p>
- </li>
- <li>
- <p><strong><code>cordova platform add [email protected]</code></strong></p>
+<p>Example:</p>
- <p>Retrieves the <code>cordova-android</code> platform version
<code>7.1.4</code> from npm, adds it to the project and updates the
<code>package.json</code> file.</p>
- </li>
- <li>
- <p><strong><code>cordova platform add
https://github.com/apache/cordova-android.git</code></strong></p>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova platform add android
+</code></pre></div></div>
- <p><strong><code>cordova platform add
https://github.com/apache/cordova-android</code></strong></p>
+<p>The avaialble Cordova resolved names are:</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Cordova Resolved Name</th>
+ <th>NPM Package Name</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><code>android</code></td>
+ <td><code>cordova-android</code></td>
+ </tr>
+ <tr>
+ <td><code>electron</code></td>
+ <td><code>cordova-electron</code></td>
+ </tr>
+ <tr>
+ <td><code>ios</code></td>
+ <td><code>cordova-ios</code></td>
+ </tr>
+ <tr>
+ <td><code>browser</code></td>
+ <td><code>cordova-browser</code></td>
+ </tr>
+ </tbody>
+</table>
+
+<p><em>Adding with Cordova resolved name and pinned version:</em></p>
- <p><strong><code>cordova platform add
github:apache/cordova-android</code></strong></p>
+<p>Example:</p>
- <p>npm retrieves the <code>cordova-android</code> platform from the git
repository, adds it to the project and updates the
<code>package.json</code>.</p>
- </li>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova platform add [email protected]
+</code></pre></div></div>
+
+<p>This command will explicitly fetch for version <code>7.1.4</code>.</p>
+
+<p><em>Adding with npm package name:</em></p>
+
+<p>Example:</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova platform add cordova-android
+</code></pre></div></div>
+
+<p><em>Adding with Git URL:</em></p>
+
+<p>Example:</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova platform add
https://github.com/apache/cordova-android.git
+</code></pre></div></div>
+
+<p>or</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova platform add
https://github.com/apache/cordova-android
+</code></pre></div></div>
+
+<p>or</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova platform add github:apache/cordova-android
+</code></pre></div></div>
+
+<ul>
<li>
<p><strong><code>cordova platform add
C:/path/to/android/platform</code></strong></p>
diff --git a/feed.xml b/feed.xml
index c8e32c0362..cc4ce59bed 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>Fri, 26 May 2023 05:06:18 +0000</pubDate>
- <lastBuildDate>Fri, 26 May 2023 05:06:18 +0000</lastBuildDate>
+ <pubDate>Fri, 26 May 2023 11:20:53 +0000</pubDate>
+ <lastBuildDate>Fri, 26 May 2023 11:20:53 +0000</lastBuildDate>
<generator>Jekyll v4.3.2</generator>
<item>
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
