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 85e19fec6b Deploying to asf-site from @
apache/cordova-docs@4480a5d8d71b052ba7dc167b9bc31031d605be89 🚀
85e19fec6b is described below
commit 85e19fec6b86819461f4bc2d0912055872ba0310
Author: erisu <[email protected]>
AuthorDate: Wed May 24 12:47:18 2023 +0000
Deploying to asf-site from @
apache/cordova-docs@4480a5d8d71b052ba7dc167b9bc31031d605be89 🚀
---
docs/en/dev/guide/platforms/android/index.html | 108 +++++++++++++++------
feed.xml | 4 +-
.../hello-cordova-main-activity.png | Bin 0 -> 822698 bytes
.../sdk-manager/android-emulator.png | Bin 0 -> 653703 bytes
.../sdk-manager/command-line-tools-latest.png | Bin 0 -> 676007 bytes
.../sdk-manager/sdk-build-tools.png | Bin 0 -> 588155 bytes
.../sdk-manager/sdk-platform-tools.png | Bin 0 -> 651736 bytes
.../sdk-manager/sdk-platform.png | Bin 0 -> 683722 bytes
.../welcome-to-android-studio.png | Bin 0 -> 506771 bytes
9 files changed, 83 insertions(+), 29 deletions(-)
diff --git a/docs/en/dev/guide/platforms/android/index.html
b/docs/en/dev/guide/platforms/android/index.html
index f5b170ecc8..17ffec7a13 100644
--- a/docs/en/dev/guide/platforms/android/index.html
+++ b/docs/en/dev/guide/platforms/android/index.html
@@ -2278,9 +2278,9 @@
<div id="page-toc-source">
<h1>Android Platform Guide</h1>
-<p>This guide will help set up your development environment for building
Cordova apps for Android devices and optionally use Android-specific
command-line tools within your development workflow.</p>
+<p>This guide will assist you in setting up your development environment for
building Cordova apps on Android devices. Additionally, it provides the option
to incorporate Android-specific command-line tools into your development
workflow.</p>
-<p>You will need to install and set up the requirements regardless of whether
you want to use the Android-specific command-line tools or Cordova CLI
commands.</p>
+<p>Regardless of whether you intend to utilize Android-specific command-line
tools or Cordova CLI commands, you will need to install and configure the
necessary requirements.</p>
<h2>Android API Level Support</h2>
@@ -2295,6 +2295,11 @@
</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>
@@ -2348,17 +2353,17 @@
</tbody>
</table>
-<p><em><strong>Note:</strong> The <a
href="https://github.com/apache/cordova-android";>cordova-android</a> versions
listed above are not for the Cordova CLI.</em></p>
+<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>
-<p>To determine what version of the Cordova-Android package is installed in
your Cordova project, run the command <code>cordova platform ls</code> in your
project's root directory.</p>
+<p>To find out the version of the Cordova-Android package installed in your
Cordova project, navigate to the root directory of your project and execute the
command <code>cordova platform ls</code>.</p>
-<p>As a general rule, Android versions become unsupported by Cordova as they
dip below 5% on Google's <a
href="https://developer.android.com/about/dashboards/index.html";>distribution
dashboard</a>.</p>
+<p>Cordova generally ceases support for Android versions that fall below 5% on
Google's distribution dashboard. You can refer to Google's <a
href="https://developer.android.com/about/dashboards/index.html";>Distribution
dashboard</a> for more information.</p>
<h2>System Requirements</h2>
-<p>Cordova-Android requires the Android SDK, which can be installed on either
macOS, Linux, or Windows.</p>
+<p>Cordova-Android relies on the Android SDK, which can be installed on macOS,
Linux, or Windows operating systems.</p>
-<p>For the base system requirements, see the Android Studio's <a
href="https://developer.android.com/studio#Requirements";>System
Requirements</a>.</p>
+<p>To ensure your system meets the necessary requirements, please refer to the
"<a href="https://developer.android.com/studio/install";>Install Android
Studio</a>" guide provided by Google.</p>
<h2>The Required Software & Tools</h2>
@@ -2384,31 +2389,79 @@
<p>Opening Android Studio for the first time will guide you through the
process of installing the Android SDK packages.</p>
-<h4>Adding SDK Packages</h4>
+<h4>SDK Packages</h4>
-<p>It is recommended to install the highest supported version of the SDK
Platform and Build Tools based on the project's installed version of
Cordova-Android. Please see the <a href="#android-api-level-support">Android
API Level Support</a> to find the supported version based on the
Cordova-Android versions.</p>
+<p>It is recommended to install the latest version of the SDK Platform &
SDK Tools based on the project's installed version of Cordova-Android.
Refer to the <a href="#android-api-level-support">Android API Level Support</a>
section to find which version is supported based on the Cordova-Android
version.</p>
-<p>In the Android Studio, open the <strong>SDK Manager</strong> (<code>Tools
> SDK Manager</code>) and confirm that the following are installed for the
targeted version of Android.:</p>
+<h5>Installing SDK Platform</h5>
-<ul>
- <li>Android's <strong>SDK Platform</strong> for your targeted API
Level</li>
- <li><strong>Android SDK Build-Tools</strong> under the <strong>SDK
Tools</strong> tab, for the targeted version.</li>
- <li><strong>Android SDK Command-line Tools (latest)</strong> under the
<strong>SDK Tools</strong> tab, for the latest version.</li>
-</ul>
+<ol>
+ <li>Open Android Studio's</li>
+ <li>Open <strong>SDK Manager</strong> (<code>Tools > SDK
Manager</code>)</li>
+ <li>Click on the <strong>SDK Platforms</strong> tab</li>
+ <li>Select the Android version which matches the highest supported SDK based
from the <a href="#android-api-level-support">Android API Level Support</a></li>
+ <li>Click Apply</li>
+</ol>
+
+<p>For example: If the project has installed
<code>[email protected]</code>, the highest supported SDK is 33. In step
3, of the above, "Android 13.0 (Tiramisu)", should have been
selected.</p>
+
+<p><img
src="/static/img/guide/platforms/android/android-studio-electric-eel-20220101-2/sdk-manager/sdk-platform.png"
style="width: 100%;" alt="Android SDK Platform" /></p>
+
+<h5>Installing Android SDK Build-Tools</h5>
+
+<ol>
+ <li>Open Android Studio's</li>
+ <li>Open <strong>SDK Manager</strong> (<code>Tools > SDK
Manager</code>)</li>
+ <li>Click on the <strong>SDK Tools</strong> tab</li>
+ <li>Check <strong>Show Package Details</strong></li>
+ <li>Expand <strong>Android SDK Build-Tool</strong></li>
+ <li>Check the highest supported Build-Tools based on the <a
href="#android-api-level-support">Android API Level Support</a>.</li>
+ <li>Click Apply</li>
+</ol>
-<h4>Android SDK Tools</h4>
+<p>For example: If the project has installed
<code>[email protected]</code>, the highest supported SDK is 33. We want
to select the highest available version of 33.x. At the time of this writing,
"33.0.2" should have been selected in step 6.</p>
-<p>In Android Studio 3.6 or later, the obsolete Android SDK Tools will need to
be intalled. To do this:</p>
+<p><img
src="/static/img/guide/platforms/android/android-studio-electric-eel-20220101-2/sdk-manager/sdk-build-tools.png"
style="width: 100%;" alt="Android SDK Build-Tools" /></p>
+
+<h5>Installing SDK Command-line Tools (latest)</h5>
+
+<ol>
+ <li>Open Android Studio's</li>
+ <li>Open <strong>SDK Manager</strong> (<code>Tools > SDK
Manager</code>)</li>
+ <li>Click on the <strong>SDK Tools</strong> tab</li>
+ <li>Check <strong>Show Package Details</strong></li>
+ <li>Expand <strong>Android SDK Command-line Tools (latest)</strong></li>
+ <li>Check <strong>Android SDK Command-line Tools (latest)</strong></li>
+ <li>Click Apply</li>
+</ol>
+
+<p><img
src="/static/img/guide/platforms/android/android-studio-electric-eel-20220101-2/sdk-manager/command-line-tools-latest.png"
style="width: 100%;" alt="SDK Command-line Tools (latest)" /></p>
+
+<h5>Installing Android SDK Platform-Tools</h5>
<ol>
- <li>Open the Android Studio</li>
- <li>Open the <strong>SDK Manager</strong> (<code>Tools > SDK
Manager</code>)</li>
- <li>Navigate to the <strong>SDK Tools</strong> tab</li>
- <li>Uncheck <code>Hide Obsolete Packages</code></li>
- <li>Check <code>Android SDK Tools (Obsolete)</code></li>
+ <li>Open Android Studio's</li>
+ <li>Open <strong>SDK Manager</strong> (<code>Tools > SDK
Manager</code>)</li>
+ <li>Click on the <strong>SDK Tools</strong> tab</li>
+ <li>Check <strong>Show Package Details</strong></li>
+ <li>Check <strong>Android SDK Platform-Tool</strong></li>
+ <li>Click Apply</li>
</ol>
-<p>See Android's documentation on how to <a
href="https://developer.android.com/studio/intro/update#sdk-manager";>Update
your tools with the SDK Manager</a> for more details.</p>
+<p><img
src="/static/img/guide/platforms/android/android-studio-electric-eel-20220101-2/sdk-manager/sdk-platform-tools.png"
style="width: 100%;" alt="Android SDK Platform-Tools" /></p>
+
+<h5>Installing Android Emulator</h5>
+
+<ol>
+ <li>Open Android Studio's</li>
+ <li>Open <strong>SDK Manager</strong> (<code>Tools > SDK
Manager</code>)</li>
+ <li>Click on the <strong>SDK Tools</strong> tab</li>
+ <li>Check <strong>Show Package Details</strong></li>
+ <li>Check <strong>Android Emulator</strong></li>
+ <li>Click Apply</li>
+</ol>
+
+<p><img
src="/static/img/guide/platforms/android/android-studio-electric-eel-20220101-2/sdk-manager/android-emulator.png"
style="width: 100%;" alt="Android Emulator" /></p>
<h3>Setting environment variables</h3>
@@ -2848,10 +2901,9 @@ Webview.</p>
<ol>
<li>Launch <strong>Android Studio</strong></li>
<li>Click the <strong>Open</strong> button
- <img src="/static/img/guide/platforms/android/asdk_import_project.png" alt=""
/></li>
- <li>Navigate to the project's Android platform directory:
(<code><project-root>/platforms/android</code>)
- <img
src="/static/img/guide/platforms/android/asdk_import_select_location.png"
alt="" /></li>
- <li>For the <code>Gradle Sync</code> question you can simply answer
<strong>Yes</strong>.</li>
+ <img
src="/static/img/guide/platforms/android/android-studio-electric-eel-20220101-2/welcome-to-android-studio.png"
style="width: 100%;" alt="Welcome to Android Studio" /></li>
+ <li>Navigate to the project's Android platform directory:
(<code><project-root>/platforms/android</code>)</li>
+ <li>Click <strong>Open</strong></li>
</ol>
<p>Once it finishes importing, you should be able to build and run the app
directly from <strong>Android Studio</strong>.</p>
@@ -2865,6 +2917,8 @@ Webview.</p>
<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>
<p>Refer to <a href="./upgrade.html">this</a> article for instructions to
upgrade your <code>cordova-android</code> version.</p>
diff --git a/feed.xml b/feed.xml
index 0cb8135edf..e98d633f46 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>Wed, 24 May 2023 12:44:33 +0000</pubDate>
- <lastBuildDate>Wed, 24 May 2023 12:44:33 +0000</lastBuildDate>
+ <pubDate>Wed, 24 May 2023 12:45:42 +0000</pubDate>
+ <lastBuildDate>Wed, 24 May 2023 12:45:42 +0000</lastBuildDate>
<generator>Jekyll v4.3.2</generator>
<item>
diff --git
a/static/img/guide/platforms/android/android-studio-electric-eel-20220101-2/hello-cordova-main-activity.png
b/static/img/guide/platforms/android/android-studio-electric-eel-20220101-2/hello-cordova-main-activity.png
new file mode 100644
index 0000000000..2652fa8933
Binary files /dev/null and
b/static/img/guide/platforms/android/android-studio-electric-eel-20220101-2/hello-cordova-main-activity.png
differ
diff --git
a/static/img/guide/platforms/android/android-studio-electric-eel-20220101-2/sdk-manager/android-emulator.png
b/static/img/guide/platforms/android/android-studio-electric-eel-20220101-2/sdk-manager/android-emulator.png
new file mode 100644
index 0000000000..89f78def14
Binary files /dev/null and
b/static/img/guide/platforms/android/android-studio-electric-eel-20220101-2/sdk-manager/android-emulator.png
differ
diff --git
a/static/img/guide/platforms/android/android-studio-electric-eel-20220101-2/sdk-manager/command-line-tools-latest.png
b/static/img/guide/platforms/android/android-studio-electric-eel-20220101-2/sdk-manager/command-line-tools-latest.png
new file mode 100644
index 0000000000..24deaba244
Binary files /dev/null and
b/static/img/guide/platforms/android/android-studio-electric-eel-20220101-2/sdk-manager/command-line-tools-latest.png
differ
diff --git
a/static/img/guide/platforms/android/android-studio-electric-eel-20220101-2/sdk-manager/sdk-build-tools.png
b/static/img/guide/platforms/android/android-studio-electric-eel-20220101-2/sdk-manager/sdk-build-tools.png
new file mode 100644
index 0000000000..c5cc641af5
Binary files /dev/null and
b/static/img/guide/platforms/android/android-studio-electric-eel-20220101-2/sdk-manager/sdk-build-tools.png
differ
diff --git
a/static/img/guide/platforms/android/android-studio-electric-eel-20220101-2/sdk-manager/sdk-platform-tools.png
b/static/img/guide/platforms/android/android-studio-electric-eel-20220101-2/sdk-manager/sdk-platform-tools.png
new file mode 100644
index 0000000000..8340d567aa
Binary files /dev/null and
b/static/img/guide/platforms/android/android-studio-electric-eel-20220101-2/sdk-manager/sdk-platform-tools.png
differ
diff --git
a/static/img/guide/platforms/android/android-studio-electric-eel-20220101-2/sdk-manager/sdk-platform.png
b/static/img/guide/platforms/android/android-studio-electric-eel-20220101-2/sdk-manager/sdk-platform.png
new file mode 100644
index 0000000000..def9fefcf1
Binary files /dev/null and
b/static/img/guide/platforms/android/android-studio-electric-eel-20220101-2/sdk-manager/sdk-platform.png
differ
diff --git
a/static/img/guide/platforms/android/android-studio-electric-eel-20220101-2/welcome-to-android-studio.png
b/static/img/guide/platforms/android/android-studio-electric-eel-20220101-2/welcome-to-android-studio.png
new file mode 100644
index 0000000000..778682c404
Binary files /dev/null and
b/static/img/guide/platforms/android/android-studio-electric-eel-20220101-2/welcome-to-android-studio.png
differ
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
