
SYNTAX
	mfpdev app register [<server <runtime>> [--password|-p <password>]]
	[--windows|-w <windowsPlatforms>]

DESCRIPTION
	Registers an application with a MobileFirst Server. The application's name,
	version, and app ID are sent to the server. After registration, the server
	recognizes the application and information about the app is displayed in
	the IBM MobileFirst Platform Foundation Console.
	
	You must run this command from the root directory of your app or one of 
	its subdirectories. At least one server profile must exist. 

	The data about the app is extracted from the following platform properties
	files, depending on the app type:

	   Cordova - config.xml
	   iOS native - Info.plist
	   Android native - AndroidManifest.xml
	   Windows native - .appxmanifest

	If the application name, version number, or app ID cannot be determined,
	you are prompted to enter them.

	The client properties file is updated with the URL of the specified server.
	The following files are updated, depending on the app type:

	  Cordova - /config.xml
	  iOS native - /mfpclient.plist
	  Android native - /app/src/main/assets/mfpclient.properties
	  Windows native (Windows 10 UWP and Windows 8.1) - /strings/mfpclient.resw

	Note: If your Windows 8.1 native project contains both Windows 8.1 desktop 
	and Windows Phone 8.1, two client properties files exist and are updated:

	  Windows Phone 8.1 - /WindowsPhone/strings/mfpclient.resw
	  Windows 8.1 desktop  - /Windows/strings/mfpclient.resw

	If the client properties file is not found, one is generated that includes
	the server's URL.

OPTIONS
	<server>:  Name of an existing MobileFirst Server to register the app with.
	This parameter is optional. If you do not provide this parameter, the
	default server is used.

	You can set the default server when you define a server profile with
	'mfpdev server add' or you can make an existing server the default when you
	run 'mfpdev server edit'. If you do not explicitly define a default server
	and a MobileFirst server is detected that is running locally at
	http://localhost:9080, then this local server is used as the default, and it
	is given the name 'local'.

	<runtime>: Only valid when provided with a server name. Specifies
	the runtime on the server that the application will be registered to. The
	default runtime is 'mfp'

	If this parameter is not specified and there are multiple runtimes on the
	server, then you are prompted to choose a specific runtime. If the specified
	runtime does not exist on the server, you are prompted to choose an
	existing runtime.

	[--password|-p <password>]: The password for the server's administrative
	login ID.  The password specified here must match the password that is
	defined on the MobileFirst Server. If you do not set this password, you are
	prompted for the administrative password for all server management tasks.
	There is no default password.

	[--windows|-w <windowsPlatforms>]: (Cordova only) Specifies which
	Windows platforms to register to the server for your Cordova app. This 
	option takes a comma-separated list of the Windows platforms that you want
	to register to the server. The following are valid values:
	
	  'windows' - specifies Windows 10 Universal Windows Platform (UWP)
	  'windowsphone8' - specifies Windows Phone 8.1
	  'windows8 ' - specifies Windows 8.1 desktop

	For Windows 8.1 native apps, two separate client properties files are
	created if you run this command from above the Windows or WindowsPhone
	directories in your app. One is created in the Windows
	directory, for the Windows 8.1 desktop portion of your application, and the
	other is created in the WindowsPhone directory, for the Windows Phone 8.1 
	portion of your app.  If you run this command from within the Windows or 
	WindowsPhone subdirectories, only one client properties file is created, 
	that is applicable to the platform in that directory..

EXAMPLES
	$ mfpdev app register myServer runtimeA --password secretPassword
	
	Registers the app with server myServer, using the runtimeA runtime. The
	server password is 'secretPassword'.
	
	$mfpdev app register --windows windows windows8
	
	Registers a Cordova app with the server that is configured as the 
	default server, and registers it for Windows UWP and Windows 8.1 desktop.
	
