Github user nikhilkh commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/463#discussion_r51637888 --- Diff: www/docs/en/dev/config_ref/index.md --- @@ -39,222 +39,357 @@ Note that before version 3.3.1-0.2.0, the file existed at `app/www/config.xml`, and that having it here is still supported. When using the CLI to build a project, versions of this file are -passively copied into various `platforms/` subdirectories, for example: +passively copied into various `platforms/` subdirectories. +For example: app/platforms/ios/AppName/config.xml app/platforms/blackberry10/www/config.xml app/platforms/android/res/xml/config.xml -This section details global and cross-platform configuration options. -See the following sections for platform-specific options: - -- [iOS Configuration](../guide/platforms/ios/config.html) -- [Android Configuration](../guide/platforms/android/config.html) -- [BlackBerry 10 Configuration](../guide/platforms/blackberry10/config.html) - 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 [Icons and Splash Screens](images.html) for more information. -## Core Configuration Elements - -This example shows the default `config.xml` generated by the CLI's -`create` command, described in [The Command-Line Interface](../guide/cli/index.html): - - <widget id="com.example.hello" version="0.0.1"> - <name>HelloWorld</name> - <description> - A sample Apache Cordova application that responds to the deviceready event. - </description> - <author email="d...@callback.apache.org" href="http://cordova.io"> - Apache Cordova Team - </author> - <content src="index.html" /> - <access origin="*" /> - </widget> +# widget + Root element of the config.xml document. + + Attributes(type) | Description + ---------------- | ------------ + id(string) | *Required* <br/> Specifies the app's reverse-domain identifier, and the `version` its full version number expressed in major/minor/patch notation. + version(string) | *Required* <br/> Full version number expressed in major/minor/patch notation. + versionCode(string) | **Platforms supported: Android** <br/> Alternative version for Android. + CFBundleVersion(string) | **Platforms supported: iOS** <br/> Alternative version for iOS. + packageVersion(string) | **Platforms supported: Windows** <br/> Alternative version for Windows. + packageName(string) | *Default: Cordova.Example* <br/> **Platforms supported: Windows** <br/> Package name for Windows. + xmlns(string) | *Required* <br/> Namespace for the config.xml document. + xmlns:cdv(string) | *Required* <br/> Namespace prefix. + + Examples: -The following configuration elements appear in the top-level -`config.xml` file, and are supported across all supported Cordova -platforms: + <widget id="io.cordova.hellocordova" version="0.0.1" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0"> + </widget> -- The `<widget>` element's `id` attribute provides the app's - reverse-domain identifier, and the `version` its full version number - expressed in major/minor/patch notation. + <!-- Android --> + <widget versionCode="0.1.3"> --- End diff -- Needs to be an integer as far as I understand.
--- If your project is set up for it, you can reply to this email and have your reply appear on GitHub as well. If your project does not have this feature enabled and wishes so, or if the feature is enabled but not working, please contact infrastructure at infrastruct...@apache.org or file a JIRA ticket with INFRA. --- --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@cordova.apache.org For additional commands, e-mail: dev-h...@cordova.apache.org