This is an automated email from the ASF dual-hosted git repository.
erisu pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/cordova-docs.git
The following commit(s) were added to refs/heads/master by this push:
new 5c70ec2dd7 doc: various improvements for 12.x docs (#1330)
5c70ec2dd7 is described below
commit 5c70ec2dd709a5846f51b14dc3de09081bc29293
Author: エリス <er...@users.noreply.github.com>
AuthorDate: Wed Sep 6 10:06:51 2023 +0900
doc: various improvements for 12.x docs (#1330)
* doc: improve app template page
* doc: remove mention of deprecated globalization plugin
* doc: update splashscreen link on platform support
* doc(ios): refactor requirements and support section
* doc(menu): relabel Introduction to Getting Started
* doc(menu): move & relabel Creating an App to Getting Started
* doc(menu): create & move project related items to Cordova Projects
* doc(menu): relabel Platform Support
* doc(menu): relabel Platform Pinning
* doc(menu): relabel Version Management
* doc(menu): relabel section Create Apps to App Development
* doc(menu): move Platform App Development section
* doc(menu): update App Development items order, labels & sections
* doc(menu): relabel Plugin Development section
* doc(menu): update Plugin Development item labels
* doc(menu): remove Windows from Plugin Development
* doc(menu): move References below Plugin Development
* doc(menu): create Resources section
* doc(menu): move Plugins section below Resources
* doc(menu): relabel References section items
* doc(menu): relabel App Templates
* doc(menu): add installation page
* doc(top-page): remove hidden deprecated platforms
* doc(storage): remove windows platform information
---
www/_data/toc/en_dev-src.yml | 106 ++++++++++++---------
www/docs/en/dev/config_ref/images.md | 6 +-
www/docs/en/dev/config_ref/index.md | 4 +-
www/docs/en/dev/cordova/events/events.md | 2 +-
www/docs/en/dev/cordova/storage/storage.md | 21 +---
www/docs/en/dev/guide/appdev/allowlist/index.md | 4 +-
www/docs/en/dev/guide/appdev/privacy/index.md | 6 +-
www/docs/en/dev/guide/appdev/security/index.md | 6 +-
www/docs/en/dev/guide/cli/index.md | 48 ++--------
www/docs/en/dev/guide/cli/installation.md | 86 +++++++++++++++++
www/docs/en/dev/guide/cli/template.md | 33 ++++---
www/docs/en/dev/guide/hybrid/plugins/index.md | 8 +-
www/docs/en/dev/guide/platforms/ios/index.md | 64 ++++++++++---
www/docs/en/dev/guide/support/index.md | 13 +--
www/docs/en/dev/platform_pinning/index.md | 2 +-
.../en/dev/platform_plugin_versioning_ref/index.md | 8 +-
www/docs/en/dev/plugin_ref/spec.md | 6 +-
.../img/guide/cli/npm-cordova-template-082023.png | Bin 0 -> 73944 bytes
18 files changed, 259 insertions(+), 164 deletions(-)
diff --git a/www/_data/toc/en_dev-src.yml b/www/_data/toc/en_dev-src.yml
index d6ea62fe5d..4948dfdf9c 100644
--- a/www/_data/toc/en_dev-src.yml
+++ b/www/_data/toc/en_dev-src.yml
@@ -1,71 +1,85 @@
-
- name: Introduction
+ name: Getting Started
children:
- url: guide/overview/index.html
+ - url: guide/cli/installation.html
+ - url: guide/cli/index.html
+
-
- name: Create apps
+ name: Cordova Projects
children:
- - url: guide/cli/index.html
- - url: guide/cli/template.html
+ - url: reference/cordova-cli/index.html
- url: guide/support/index.html
- - url: third-party/index.html
+ - url: platform_pinning/index.html
+ - url: platform_plugin_versioning_ref/index.html
+ - url: guide/appdev/hooks/index.html
+
+-
+ name: App Development
+ children:
-
- name: Develop for platforms
+ name: Platforms
children:
- url: guide/platforms/android/index.html
- url: guide/platforms/ios/index.html
- - url: guide/platforms/windows/index.html
- - url: guide/platforms/osx/index.html
- url: guide/platforms/electron/index.html
- - url: platform_plugin_versioning_ref/index.html
- - url: platform_pinning/index.html
- - url: config_ref/images.html
+ -
+ name: Customization
+ children:
+ - url: config_ref/images.html
+ - url: core/features/splashscreen/index.html
+ -
+ name: Security & Privacy
+ children:
+ - url: guide/appdev/security/index.html
+ - url: guide/appdev/privacy/index.html
+ - url: guide/appdev/allowlist/index.html
- url: cordova/storage/storage.html
- - url: guide/appdev/privacy/index.html
- - url: guide/appdev/security/index.html
- - url: guide/appdev/allowlist/index.html
+
-
- name: Create plugins
+ name: Plugin Development
children:
- url: guide/hybrid/plugins/index.html
-
- name: Develop for platforms
+ name: Support a Platform
children:
- url: guide/platforms/android/plugin.html
- url: guide/platforms/ios/plugin.html
- - url: guide/platforms/windows/plugin.html
- url: plugin_ref/plugman.html
+
-
- name: Advanced Topics
+ name: References
children:
- - url: guide/hybrid/webviews/index.html
+ - url: config_ref/index.html
+ - url: plugin_ref/spec.html
+ - url: cordova/events/events.html
+
+-
+ name: Resources
+ children:
+ - url: third-party/index.html
+ - url: guide/cli/template.html
- url: guide/next/index.html
+
-
- name: Reference
+ name: Plugins
children:
- - url: config_ref/index.html
- - url: cordova/events/events.html
- - url: reference/cordova-cli/index.html
- - url: guide/appdev/hooks/index.html
- -
- name: Core Features
- children:
- - url: core/features/splashscreen/index.html
- - url: plugin_ref/spec.html
- -
- name: Plugins
- children:
- - url: reference/cordova-plugin-battery-status/index.html
- - url: reference/cordova-plugin-camera/index.html
- - url: reference/cordova-plugin-device/index.html
- - url: reference/cordova-plugin-dialogs/index.html
- - url: reference/cordova-plugin-file/index.html
- - url: reference/cordova-plugin-geolocation/index.html
- - url: reference/cordova-plugin-inappbrowser/index.html
- - url: reference/cordova-plugin-media/index.html
- - url: reference/cordova-plugin-media-capture/index.html
- - url: reference/cordova-plugin-network-information/index.html
- - url: reference/cordova-plugin-screen-orientation/index.html
- - url: reference/cordova-plugin-splashscreen/index.html
- - url: reference/cordova-plugin-statusbar/index.html
- - url: reference/cordova-plugin-vibration/index.html
+ - url: reference/cordova-plugin-battery-status/index.html
+ - url: reference/cordova-plugin-camera/index.html
+ - url: reference/cordova-plugin-device/index.html
+ - url: reference/cordova-plugin-dialogs/index.html
+ - url: reference/cordova-plugin-file/index.html
+ - url: reference/cordova-plugin-geolocation/index.html
+ - url: reference/cordova-plugin-inappbrowser/index.html
+ - url: reference/cordova-plugin-media/index.html
+ - url: reference/cordova-plugin-media-capture/index.html
+ - url: reference/cordova-plugin-network-information/index.html
+ - url: reference/cordova-plugin-screen-orientation/index.html
+ - url: reference/cordova-plugin-splashscreen/index.html
+ - url: reference/cordova-plugin-statusbar/index.html
+ - url: reference/cordova-plugin-vibration/index.html
+
+-
+ name: Advanced Topics
+ children:
+ - url: guide/hybrid/webviews/index.html
diff --git a/www/docs/en/dev/config_ref/images.md
b/www/docs/en/dev/config_ref/images.md
index 4573542965..4a08e0e8da 100644
--- a/www/docs/en/dev/config_ref/images.md
+++ b/www/docs/en/dev/config_ref/images.md
@@ -17,14 +17,14 @@ license: >
specific language governing permissions and limitations
under the License.
-title: Customize app icons
-toc_title: Customize icons
+title: Customize App Icons
+toc_title: Icons
description: Learn how to customize icons for your Cordova application.
---
{% cdv_platform inject %}
-# Customize Icons
+# Icons
This section shows how to configure an application's icon for various
platforms. Documentation about splash screen images can be found in the
Cordova-Plugin-Splashscreen documentation [Splashscreen plugin
docs][splashscreen_plugin].
diff --git a/www/docs/en/dev/config_ref/index.md
b/www/docs/en/dev/config_ref/index.md
index 795b1c4d28..ecbd30ec7b 100644
--- a/www/docs/en/dev/config_ref/index.md
+++ b/www/docs/en/dev/config_ref/index.md
@@ -17,13 +17,13 @@ license: >
specific language governing permissions and limitations
under the License.
-title: Config.xml
+title: Config.xml API
description: List of supported tags in the config.xml file.
---
{% cdv_platform inject %}
-# Config.xml
+# Config.xml API
The `config.xml` 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 [Packaged Web Apps
(Widgets)](https://www.w3.org/TR/widgets/) specification. Additionally, it is
extended to include core Cordova API features, plugins, and platform-specific
settings.
diff --git a/www/docs/en/dev/cordova/events/events.md
b/www/docs/en/dev/cordova/events/events.md
index 3e1f1bea1b..505640f8aa 100644
--- a/www/docs/en/dev/cordova/events/events.md
+++ b/www/docs/en/dev/cordova/events/events.md
@@ -17,7 +17,7 @@ license: >
specific language governing permissions and limitations
under the License.
-title: Events
+title: Cordova JavaScript API
description: List of Cordova JavaScript run-time events.
---
diff --git a/www/docs/en/dev/cordova/storage/storage.md
b/www/docs/en/dev/cordova/storage/storage.md
index 8eb8ea7c97..de74c52e3a 100644
--- a/www/docs/en/dev/cordova/storage/storage.md
+++ b/www/docs/en/dev/cordova/storage/storage.md
@@ -17,12 +17,12 @@ license: >
specific language governing permissions and limitations
under the License.
-title: Storage
-toc_title: Store data
+title: Data Storage
+toc_title: Data Storage
description: Storing data on the device.
---
-# Storage
+# Data Storage
Several storage APIs are available for Cordova applications.
See html5rocks [storage overview][Html5RocksStorageOverview] and
@@ -86,10 +86,7 @@ IndexedDB provides a simple and easy to understand data
model, much like LocalSt
But unlike LocalStorage, you can create multiple databases, with multiple
stores per
database, and its asynchronous API and search indexes provide performance
benefits.
-IndexedDB is supported by the underlying WebView on all platforms, with known
limitations on the following platforms:
-
-- browser
-- Windows
+IndexedDB is supported by the underlying WebView on all platforms, with known
limitations on the `browser` platform.
### Web browser limitations
@@ -97,16 +94,6 @@ The actual behavior may depend on which browser is used.
There could be differences between the behavior on the Safari and Firefox
browsers,
for example.
-### Windows Limitations
-
-Windows platform support for IndexedDB is incomplete. For example, it lacks
-the following features:
-
-- Not available in web workers.
-- Doesn't support array keyPaths.
-- Doesn't support array keys.
-- Doesn't support object lookup via compound index.
-
### Usage Summary
- IndexedDB works asynchronously - you request a particular database
diff --git a/www/docs/en/dev/guide/appdev/allowlist/index.md
b/www/docs/en/dev/guide/appdev/allowlist/index.md
index cbf1b69c90..4f930ee216 100644
--- a/www/docs/en/dev/guide/appdev/allowlist/index.md
+++ b/www/docs/en/dev/guide/appdev/allowlist/index.md
@@ -17,12 +17,12 @@ license: >
specific language governing permissions and limitations
under the License.
-title: Allow List Guide
+title: Manage App's Allow List
toc_title: Allow List
description: Securely grant an application access to external resources.
---
-# Allow List Guide
+# Allow List
Domain allow listing is a security model that controls access to external
domains over which your application has no control. Cordova provides a
configurable security policy to define which external sites may be accessed.
diff --git a/www/docs/en/dev/guide/appdev/privacy/index.md
b/www/docs/en/dev/guide/appdev/privacy/index.md
index ae6f6afd61..3f952921f4 100644
--- a/www/docs/en/dev/guide/appdev/privacy/index.md
+++ b/www/docs/en/dev/guide/appdev/privacy/index.md
@@ -17,12 +17,12 @@ license: >
specific language governing permissions and limitations
under the License.
-title: Privacy Guide
-toc_title: Manage privacy
+title: Manage App's Privacy
+toc_title: Privacy
description: Learn about important mobile privacy issues.
---
-# Privacy Guide
+# Privacy
Mobile privacy is a critical issue that every app developer must
address. Your users expect that their private information will be
diff --git a/www/docs/en/dev/guide/appdev/security/index.md
b/www/docs/en/dev/guide/appdev/security/index.md
index 71e3e33110..29671e9770 100644
--- a/www/docs/en/dev/guide/appdev/security/index.md
+++ b/www/docs/en/dev/guide/appdev/security/index.md
@@ -17,12 +17,12 @@ license: >
specific language governing permissions and limitations
under the License.
-title: Security Guide
-toc_title: Manage security
+title: Manage App's Security
+toc_title: Security
description: Information and tips for building a secure application.
---
-# Security Guide
+# Security
The following guide includes some security best practices that you should
consider when developing a Cordova application. Please be aware that security
is a very complicated topic and therefore this guide is not exhaustive. If you
believe you can contribute to this guide, please feel free to create a pull
request in Cordova's
[cordova-docs](https://github.com/apache/cordova-docs/issues) repository. This
guide is designed to be applicable to general Cordova development (all
platforms) but [...]
diff --git a/www/docs/en/dev/guide/cli/index.md
b/www/docs/en/dev/guide/cli/index.md
index e7e633b2a5..167ad69fc5 100644
--- a/www/docs/en/dev/guide/cli/index.md
+++ b/www/docs/en/dev/guide/cli/index.md
@@ -17,58 +17,28 @@ license: >
specific language governing permissions and limitations
under the License.
-title: Creating your first Cordova app
+title: Creating an App
description: Learn how to create your first Cordova hybrid app using Cordova
CLI.
-toc_title: Create your first app
+toc_title: Creating an App
---
-# Create your first Cordova app
+# Creating an App
This guide shows you how to create a JS/HTML Cordova application and deploy
them to various native mobile platforms using the `cordova` command-line
interface (CLI). For detailed reference on Cordova command-line, review the
[CLI reference]
-## Installing the Cordova CLI
+## Creating the Cordova Project Space
-The Cordova command-line tool is distributed as an npm package.
+In terminal, go to the directory where you would like to create your Cordova's
project.
-To install the `cordova` command-line tool, follow these steps:
-
-1. Download and install [Node.js](https://nodejs.org/en/download/). On
installation you should be able to invoke `node` and `npm` on your line.
-
-1. (Optional) Download and install a [git
client](http://git-scm.com/downloads), if you don't already have one. Following
installation, you should be able to invoke `git` on your command line. The CLI
uses it to download assets when they are referenced using a url to a git repo.
-
-1. Install the `cordova` module using `npm` utility of Node.js. The `cordova`
module will automatically be downloaded by the `npm` utility.
-
- - on macOS and Linux:
-
- ```bash
- npm install -g cordova
- ```
-
- For macOS and Linux users, you might need to use the `sudo` prefix when
running the `npm` command to install this utility in restricted directories
like `/usr/local/share`. However, if you are using the optional nvm/nave tool
or have write access to the installation directory, you may be able to omit the
`sudo` prefix.
-
- It is also worth noting that it is generally recommended to avoid using
`sudo` with `npm` to prevent potential issues with permissions and package
installations.
-
- Instead, it's recommended to use a version manager like nvm (Node
Version Manager) or nave to manage Node.js and npm installations, which
typically avoids the need for `sudo` when installing packages.
-
- - on Windows:
-
- ```bash
- C:\>npm install -g cordova
- ```
-
- The `-g` flag above tells `npm` to install `cordova` globally. Otherwise it
will be installed in the `node_modules` subdirectory of the current working
directory.
-
- Following installation, you should be able to run `cordova` on the command
line with no arguments and it should print help text.
-
-## Create the App
-
-Go to the directory where you maintain your source code, and create a cordova
project:
+Note that the next command will create a new project directory where your
source code, resource files, configuration, and build artifacts will reside.
```bash
cordova create hello com.example.hello HelloWorld
```
-This creates the required directory structure for your cordova app. By
default, the `cordova create` script generates a skeletal web-based application
whose home page is the project's `www/index.html` file.
+The above command will create a project directory named "hello" with the
required directory structure for your Cordova app.
+
+By default, the `cordova create` script generates a skeletal web-based
application where the apps landing page is the project's `www/index.html` file.
### See Also
diff --git a/www/docs/en/dev/guide/cli/installation.md
b/www/docs/en/dev/guide/cli/installation.md
new file mode 100644
index 0000000000..f3ff7a37f0
--- /dev/null
+++ b/www/docs/en/dev/guide/cli/installation.md
@@ -0,0 +1,86 @@
+---
+license: >
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+title: Installation
+description: Installing Cordova CLI
+toc_title: Installation
+---
+
+# Installation
+
+The Cordova command-line tool (CLI) is distributed as an npm package.
+
+To install the `cordova` CLI tool, follow these steps:
+
+1. Download and install [Node.js](https://nodejs.org/en/download/). On
installation you should be able to invoke `node` and `npm` on your line.
+
+2. (Optional) Download and install a [git
client](http://git-scm.com/downloads), if you don't already have one. Following
installation, you should be able to invoke the `git` command in your command
promt (terminal). The Cordova cli and npm invokes the git command when download
assets that were referenced with a git repo url.
+
+3. Install the `cordova` module using `npm` utility of Node.js. The `cordova`
module will automatically be downloaded by the `npm` utility.
+
+ - on macOS and Linux:
+
+ ```bash
+ npm install -g cordova
+ ```
+
+ For macOS and Linux users, you might need to use the `sudo` prefix when
running the `npm` command to install this utility in restricted directories
like `/usr/local/share`. However, if you are using the optional nvm/nave tool
or have write access to the installation directory, you may be able to omit the
`sudo` prefix.
+
+ It is also worth noting that it is generally recommended to avoid using
`sudo` with `npm` to prevent potential issues with permissions and package
installations.
+
+ Instead, it's recommended to use a version manager like nvm (Node
Version Manager) or nave to manage Node.js and npm installations, which
typically avoids the need for `sudo` when installing packages.
+
+ - on Windows:
+
+ ```bash
+ C:\>npm install -g cordova
+ ```
+
+ The `-g` flag above tells `npm` to install `cordova` globally. Otherwise it
will be installed in the `node_modules` subdirectory of the current working
directory.
+
+ Following installation, you should be able to run `cordova` on the command
line with no arguments and it should print help text.
+
+## Requirements and Support
+
+<table>
+ <thead>
+ <tr>
+ <th>Cordova CLI Version</th>
+ <th>Node.js Supported Version</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>12.x</td>
+ <td>>=16.13.0</td>
+ </tr>
+ <tr>
+ <td>11.x</td>
+ <td>>=12.0.0</td>
+ </tr>
+ <tr>
+ <td>10.x</td>
+ <td>>=10.0.0</td>
+ </tr>
+ <tr>
+ <td>9.x</td>
+ <td>>=6.0.0</td>
+ </tr>
+ </tbody>
+</table>
diff --git a/www/docs/en/dev/guide/cli/template.md
b/www/docs/en/dev/guide/cli/template.md
index 769f6c85d6..d5cb54763b 100644
--- a/www/docs/en/dev/guide/cli/template.md
+++ b/www/docs/en/dev/guide/cli/template.md
@@ -17,29 +17,28 @@ license: >
specific language governing permissions and limitations
under the License.
-title: Cordova App Templates
+title: App Templates
description: Learn how to find, use, and create templates in Cordova.
-toc_title: Templates for apps
+toc_title: App Templates
---
-# Cordova App Templates
+# App Templates
## Use a Template
Templates allow you to use preexisting code to jumpstart your project.
-
+
Find a template to create your app from by seaching for the keyword
`cordova:template` on [npm](https://www.npmjs.com/search?q=cordova%3Atemplate).
You can also use local templates on your computer, or a Git repository.
After locating a template you wish to use. Create your project using that
template, by specifying the `--template` flag during the `create` command,
followed by your template source.
Creating a cordova project from an NPM package, Git repository, or local path:
-```
-$ cordova create hello com.example.hello HelloWorld --template
<npm-package-name>
-$ cordova create hello com.example.hello HelloWorld --template <git-remote-url>
-$ cordova create hello com.example.hello HelloWorld --template
<path-to-template>
+
+```bash
+cordova create hello com.example.hello HelloWorld --template
<npm-package-name|git-repo|local-dir-path>
```
After succesfully using a template to create your project, you'll want to
indicate the platforms that you intend to target with your app. Go into your
project folder and [add
platforms](https://cordova.apache.org/docs/en/latest/guide/cli/index.html#add-platforms).
@@ -48,17 +47,21 @@ After succesfully using a template to create your project,
you'll want to indica
Begin by creating a cordova app that will become the basis for your template.
Then you'll take the contents of your app and put them into the following
structure. When your template is used, all of the contents within
`template_src` will be used to create the new project, so be sure to include
any necessary files in that folder. Reference [this
example](https://github.com/apache/cordova-app-hello-world) for details.
+```text
+template_package
+├── package.json (for your template package to be published on npm)
+├── index.js (required)
+└── template_src (required - contains template files)
+ ├── package.json
+ ├── config.xml
+ └── (files and folders that make up the template)
```
-template_package/
-├── package.json (optional; needed to publish template on npm)
-├── index.js (required)
-└── template_src/ (required)
- └── CONTENTS OF APP TEMPLATE
-```
+
> __NOTE__: `index.js` should export a reference to `template_src` and
> `package.json` should reference `index.js`. See [the
> example](https://github.com/apache/cordova-app-hello-world) for details on
> how that is done.
To finish off your template, edit `package.json` to contain the keyword
`"cordova:template"`.
-```javascript
+
+```json
{
...
"keywords": [
diff --git a/www/docs/en/dev/guide/hybrid/plugins/index.md
b/www/docs/en/dev/guide/hybrid/plugins/index.md
index c56705f00b..095ab7744d 100644
--- a/www/docs/en/dev/guide/hybrid/plugins/index.md
+++ b/www/docs/en/dev/guide/hybrid/plugins/index.md
@@ -17,12 +17,12 @@ license: >
specific language governing permissions and limitations
under the License.
-title: Plugin Development Guide
-toc_title: Create a plugin
-description: Develop your own plugin.
+title: Create a Plugin
+toc_title: Create a Plugin
+description: Develop your own Cordova plugin.
---
-# Plugin Development Guide
+# Create a Plugin
A _plugin_ is a package of injected code that allows the Cordova webview within
which the app renders to communicate with the native platform on
diff --git a/www/docs/en/dev/guide/platforms/ios/index.md
b/www/docs/en/dev/guide/platforms/ios/index.md
index 9a3d47e1aa..187328e13e 100644
--- a/www/docs/en/dev/guide/platforms/ios/index.md
+++ b/www/docs/en/dev/guide/platforms/ios/index.md
@@ -34,17 +34,59 @@ For details on the CLI, see [Cordova CLI Reference][cli].
## Requirements and Support
-Apple® tools required to build iOS applications only run on the OS X
-operating system on Intel-based Macs. Xcode® 11.0 (the minimum required
-version) runs only on OS X version 10.14.4 (Mojave) or greater, and
-includes the iOS 13 SDK (Software Development Kit). To submit apps to
-the Apple App Store℠ requires the latest versions of the Apple tools.
-
-You can test many of the Cordova features using the iOS simulator
-installed with the iOS SDK and Xcode, but you need an actual device to
-fully test all of the app's device features before submitting to the
-App Store. The device must have at least iOS 11 installed, the
-minimum iOS version supported since the release of cordova-ios v6.0.0.
+Apple® tools used for building iOS applications can only operate within the
macOS environment. Xcode®, the primary tool for iOS application development,
incorporates the iOS SDK (Software Development Kit). For submission to the
Apple App Store℠, apps must be built using the most recent versions of these
Apple tools.
+
+You can evaluate many Cordova features by utilizing the iOS simulator
integrated with the iOS SDK and Xcode. However, testing all of an app's
device-specific functionalities requires an actual device before final
submission to the App Store.
+
+The table below outlines Cordova-iOS's prerequisites by version. Additionally,
Xcode has its own set of system requirements and it is advisable to refer to
the [Minimum requirements and supported
SDKs](https://developer.apple.com/support/xcode/#:~:text=Minimum%20requirements%20and%20supported%C2%A0SDKs)
documentation for verification.
+
+<table>
+ <thead>
+ <tr>
+ <th>Cordova-iOS Version</th>
+ <th>iOS Minimum-Support</th>
+ <th>Tooling Version</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>7.x</td>
+ <td>11.0</td>
+ <td>
+ <ul>
+ <li>Cocoapods: >=1.8.0</li>
+ <li>ios-deploy: >=1.9.2</li>
+ <li>Node: >=16.13.0</li>
+ <li>Xcode (xcodebuild): >=11.0.0</li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td>6.x</td>
+ <td>11.0</td>
+ <td>
+ <ul>
+ <li>Cocoapods: >=1.8.0</li>
+ <li>ios-deploy: >=1.9.2</li>
+ <li>Node: >=10.0.0</li>
+ <li>Xcode (xcodebuild): >=11.0.0</li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td>5.x</td>
+ <td>10.0</td>
+ <td>
+ <ul>
+ <li>Cocoapods: >=1.0.1</li>
+ <li>ios-deploy: >=1.9.2</li>
+ <li>Node: >=6.0.0</li>
+ <li>Xcode (xcodebuild): >=10.0.0</li>
+ </ul>
+ </td>
+ </tr>
+ </tbody>
+</table>
## Installing the Requirements
diff --git a/www/docs/en/dev/guide/support/index.md
b/www/docs/en/dev/guide/support/index.md
index 515490bcd8..818ef451a4 100644
--- a/www/docs/en/dev/guide/support/index.md
+++ b/www/docs/en/dev/guide/support/index.md
@@ -17,8 +17,8 @@ license: >
specific language governing permissions and limitations
under the License.
-title: Cordova support by platform
-toc_title: Platform support
+title: Platform Support
+toc_title: Platform Support
description: Compatibility table for all major plugins and features.
---
@@ -128,13 +128,6 @@ For additional functionality, you can explore a wide range
of third-party plugin
<td data-col="electron" class="p">Tests Pending</td>
</tr>
- <tr>
- <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="electron" class="p">Tests Pending</td>
- </tr>
-
<tr>
<th><a
href="../../reference/cordova-plugin-inappbrowser/">InAppBrowser</a></th>
<td data-col="android" class="y"></td>
@@ -157,7 +150,7 @@ For additional functionality, you can explore a wide range
of third-party plugin
</tr>
<tr>
- <th><a
href="../../reference/cordova-plugin-splashscreen/">Splashscreen</a></th>
+ <th><a
href="../../core/features/splashscreen/index.html">Splashscreen</a></th>
<td data-col="android" class="y"></td>
<td data-col="ios" class="y"></td>
<td data-col="electron" class="p">Tests Pending</td>
diff --git a/www/docs/en/dev/platform_pinning/index.md
b/www/docs/en/dev/platform_pinning/index.md
index 5b403330d7..3db0b0b86d 100644
--- a/www/docs/en/dev/platform_pinning/index.md
+++ b/www/docs/en/dev/platform_pinning/index.md
@@ -18,7 +18,7 @@ license: >
under the License.
title: Platform Pinning
-toc_title: Platform pinning
+toc_title: Platform Pinning
description: Cordova CLI pinned platform versions.
---
diff --git a/www/docs/en/dev/platform_plugin_versioning_ref/index.md
b/www/docs/en/dev/platform_plugin_versioning_ref/index.md
index ac45023539..e9c65eeaa7 100644
--- a/www/docs/en/dev/platform_plugin_versioning_ref/index.md
+++ b/www/docs/en/dev/platform_plugin_versioning_ref/index.md
@@ -17,12 +17,12 @@ license: >
specific language governing permissions and limitations
under the License.
-title: Platforms and Plugins Version Management
-toc_title: Manage versions and platforms
-description: How to manage platforms and Cordova CLI versions.
+title: Version Management
+toc_title: Version Management
+description: How to manage platforms & plugins versions.
---
-# Platforms and Plugins Version Management
+# Version Management
Cordova provides the ability to save and restore platforms and plugins.
diff --git a/www/docs/en/dev/plugin_ref/spec.md
b/www/docs/en/dev/plugin_ref/spec.md
index 4d1ce952e7..818c515a37 100644
--- a/www/docs/en/dev/plugin_ref/spec.md
+++ b/www/docs/en/dev/plugin_ref/spec.md
@@ -17,14 +17,14 @@ license: >
specific language governing permissions and limitations
under the License.
-title: Plugin.xml reference documentation
-toc_title: Plugin.xml
+title: Plugin.xml API
+toc_title: Plugin.xml API
description: List of supported tags in the plugin.xml file.
---
{% cdv_platform inject %}
-# Plugin.xml
+# Plugin.xml API
Plugin.xml file defines the structure and settings required for your plugin.
It has several elements to provide details about your plugin.
diff --git a/www/static/img/guide/cli/npm-cordova-template-082023.png
b/www/static/img/guide/cli/npm-cordova-template-082023.png
new file mode 100644
index 0000000000..844874a495
Binary files /dev/null and
b/www/static/img/guide/cli/npm-cordova-template-082023.png differ
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@cordova.apache.org
For additional commands, e-mail: commits-h...@cordova.apache.org
