Print info message upon android version code change

TP reference: [Inform the user about number appending upon android version code change](http://teampulse.telerik.com/view#item/306369)

Author: Dimitar Kerezov

docs/man_pages/project/configuration/prop-print-androidversioncode.md

@@ -0,0 +1,31 @@
+prop print AndroidVersionCode
+==========
+
+Usage | Synopsis
+------|-------
+General | `$ appbuilder prop print AndroidVersionCode [--valid-value]`
+
+Prints information about the configuration of the AndroidVersionCode property.
+
+<% if((isConsole && (isNativeScript || isCordova)) || isHtml) { %>
+### Options
+* `--valid-value` - When set, prints a description for the AndroidVersionCode property.
+<% } %>
+<% if(isHtml) { %>
+### Related Commands
+
+Command | Description
+----------|----------
+[edit-configuration](edit-configuration.html) | `<ConfigurationFile>` is the configuration file that you want to open.
+[mobileframework](mobileframework.html) | Lists all supported versions of the current development framework.
+[mobileframework set](mobileframework-set.html) | Sets the selected development framework version for the project.
+[prop](prop.html) | Lets you manage the properties for your project.
+[prop print](prop-print.html) | Prints information about the configuration of the project or the selected property.
+[prop add](prop-add.html) | Enables more options for the selected project property, if the property accepts multiple values.
+[prop remove](prop-remove.html) | Disables options for the selected project property, if the property accepts multiple values.
+[prop set](prop-set.html) | Sets the selected project property and overwrites its current value.
+[resource](resource.html) | Lists information about the image resources for all mobile platforms.
+[resource create](resource-create.html) | Creates image resources for all mobile platforms from a single high-resolution image.
+[webview](webview.html) | Lists the available web views for iOS and Android.
+[webview set](webview-set.html) | Sets the selected web view for the current project.
+<% } %>

docs/man_pages/project/configuration/prop-set-androidversioncode.md

@@ -0,0 +1,27 @@
+prop set AndroidVersionCode
+==========
+
+Usage | Synopsis
+------|-------
+General | `$ appbuilder prop set AndroidVersionCode <Integer Value>`
+
+Sets the AndroidVersionCode project property and overwrites its current value.
+
+<% if(isHtml) { %>
+### Related Commands
+
+Command | Description
+----------|----------
+[edit-configuration](edit-configuration.html) | `<ConfigurationFile>` is the configuration file that you want to open.
+[mobileframework](mobileframework.html) | Lists all supported versions of the current development framework.
+[mobileframework set](mobileframework-set.html) | Sets the selected development framework version for the project.
+[prop](prop.html) | Lets you manage the properties for your project.
+[prop print](prop-print.html) | Prints information about the configuration of the project or the selected property.
+[prop set](prop-set.html) | Sets the selected project property and overwrites its current value.
+[prop add](prop-add.html) | Enables more options for the selected project property, if the property accepts multiple values.
+[prop remove](prop-remove.html) | Disables options for the selected project property, if the property accepts multiple values.
+[resource](resource.html) | Lists information about the image resources for all mobile platforms.
+[resource create](resource-create.html) | Creates image resources for all mobile platforms from a single high-resolution image.
+[webview](webview.html) | Lists the available web views for iOS and Android.
+[webview set](webview-set.html) | Sets the selected web view for the current project.
+<% } %>

lib/bootstrap.ts

@@ -102,6 +102,8 @@ $injector.requireCommand("prop|remove", "./commands/prop/prop-remove");
 $injector.requireCommand("prop|print", "./commands/prop/prop-print");
 $injector.requireCommand("prop|print|frameworkversion", "./commands/framework-versions/print-versions");
 $injector.requireCommand("prop|set|frameworkversion", "./commands/framework-versions/set-version");
+$injector.requireCommand("prop|set|androidversioncode", "./commands/prop/prop-set-android-version-code");
+$injector.requireCommand("prop|print|androidversioncode", "./commands/prop/prop-print-android-version-code");
 
 $injector.requireCommand("cloud|*list", "./commands/cloud-projects");
 $injector.requireCommand("cloud|export", "./commands/cloud-projects");

lib/commands/prop/prop-print-android-version-code.ts

@@ -0,0 +1,26 @@
+///<reference path="../../.d.ts"/>
+"use strict";
+import {PrintProjectCommand} from "./prop-print";
+
+export class PrintAndroidVersionCodeCommand extends PrintProjectCommand implements ICommand {
+	constructor($staticConfig: IStaticConfig,
+		$injector: IInjector,
+		protected $options: IOptions,
+		private $logger: ILogger,
+		private $projectConstants: Project.IProjectConstants) {
+		super($staticConfig, $injector, $options);
+	}
+
+	public execute(args:string[]): IFuture<void> {
+		return ((): void => {
+			super.execute(["AndroidVersionCode"]).wait();
+			if (this.$project.projectData.Framework === this.$projectConstants.TARGET_FRAMEWORK_IDENTIFIERS.Cordova && !this.$options.validValue) {
+				this.$logger.printMarkdown("Your final AndroidVersionCode will be `%s2` because Apache Cordova automatically appends a specific number to the version code based on the target Android SDK and architecture. For more information, see https://issues.apache.org/jira/browse/CB-8976.", this.$project.projectData.AndroidVersionCode);
+			}
+
+		}).future<void>()();
+	}
+
+	allowedParameters:ICommandParameter[] = [];
+}
+$injector.registerCommand("prop|print|androidversioncode", PrintAndroidVersionCodeCommand);

lib/commands/prop/prop-print.ts

@@ -5,7 +5,7 @@ import * as projectPropertyCommandBaseLib from "./prop-command-base";
 export class PrintProjectCommand extends projectPropertyCommandBaseLib.ProjectPropertyCommandBase implements ICommand {
 	constructor($staticConfig: IStaticConfig,
 		$injector: IInjector,
-		private $options: IOptions) {
+		protected $options: IOptions) {
 		super($staticConfig, $injector);
 		if(!this.$options.validValue) {
 			this.$project.ensureProject();

lib/commands/prop/prop-set-android-version-code.ts

@@ -0,0 +1,27 @@
+///<reference path="../../.d.ts"/>
+"use strict";
+import {SetProjectPropertyCommand} from "./prop-set";
+
+export class SetAndroidVersionCodeCommand extends SetProjectPropertyCommand implements ICommand {
+	constructor($staticConfig: IStaticConfig,
+		$injector: IInjector,
+		private $logger: ILogger,
+		private $projectConstants: Project.IProjectConstants) {
+		super($staticConfig, $injector);
+	}
+
+	canExecute(args: string[]): IFuture<boolean> {
+		return this.$project.validateProjectProperty("AndroidVersionCode", args, "set");
+	}
+
+	public execute(args: string[]): IFuture<void> {
+		return ((): void => {
+			super.execute(["AndroidVersionCode", args[0]]).wait();
+			if (this.$project.projectData.Framework === this.$projectConstants.TARGET_FRAMEWORK_IDENTIFIERS.Cordova) {
+				this.$logger.printMarkdown("Your final AndroidVersionCode will be `%s2` because Apache Cordova automatically appends a specific number to the version code based on the target Android SDK and architecture. For more information, see https://issues.apache.org/jira/browse/CB-8976.", args[0]);
+			}
+
+		}).future<void>()();
+	}
+}
+$injector.registerCommand("prop|set|androidversioncode", SetAndroidVersionCodeCommand);