Repository: cordova-docs Updated Branches: refs/heads/master 0a5980644 -> 1d07d1d38
CB-5093 Document versionCode & CFBundleVersion in config.xml Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/1d07d1d3 Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/1d07d1d3 Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/1d07d1d3 Branch: refs/heads/master Commit: 1d07d1d38fa485d7d308a7ecbe753ff119ac52f5 Parents: 0a59806 Author: Mark Koudritsky <[email protected]> Authored: Tue Jul 22 18:28:38 2014 -0400 Committer: Mark Koudritsky <[email protected]> Committed: Tue Jul 22 18:28:38 2014 -0400 ---------------------------------------------------------------------- docs/en/edge/config_ref/index.md | 28 +++++++++++++++++++++++++++- 1 file changed, 27 insertions(+), 1 deletion(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/1d07d1d3/docs/en/edge/config_ref/index.md ---------------------------------------------------------------------- diff --git a/docs/en/edge/config_ref/index.md b/docs/en/edge/config_ref/index.md index 9c32672..0a67d53 100644 --- a/docs/en/edge/config_ref/index.md +++ b/docs/en/edge/config_ref/index.md @@ -78,6 +78,10 @@ platforms: reverse-domain identifier, and the `version` its full version number expressed in major/minor/patch notation. + The widget tag can also have attributes that specify alternative versions, + namely versionCode for Android and CFBundleVersion for iOS. See the + Additional Versioning section below for details. + - The `<name>` element specifies the app's formal name, as it appears on the device's home screen and within app-store interfaces. @@ -99,6 +103,28 @@ platforms: platforms, as listed at the top of this page. The following sections detail preferences that apply to more than one platform. +### Additional Versioning + +Both, Android and iOS support a second version string (or number) in addition +to the one visible in app stores, +[versionCode](http://developer.android.com/tools/publishing/versioning.html) +for Android and +[CFBundleVersion](http://stackoverflow.com/questions/4933093/cfbundleversion-in-the-info-plist-upload-error) +for iOS. +Below is an example that explicitly sets versionCode and CFBundleVersion + + <widget id="io.cordova.hellocordova" + version="0.0.1" + android-versionCode="7" + ios-CFBundleVersion="3.3.3"> + +If alternative version is not specified, the following +defaults will be used: + + // assuming version = MAJOR.MINOR.PATCH-whatever + versionCode = PATCH + MINOR * 100 + MAJOR * 10000 + CFBundleVersion = "MAJOR.MINOR.PATCH" + ## Global Preferences The following global preferences apply to all platforms: @@ -151,7 +177,7 @@ all of them: <preference name="HideKeyboardFormAccessoryBar" value="true"/> - Applies to iOS and BlackBerry. + Applies to iOS and BlackBerry. ## The _feature_ Element
