SYNTAX mfpdev app preview [ [--type|-t ] [--watch+copy|-wc | --watch+prepare|-wp | --serve|-s] ] [--clientid ] [--secret ] [--noserver] DESCRIPTION Opens a browser or browser simulator and displays a preview of a Cordova application. In interactive mode, this command asks you what platform to preview and what type of display to use: either the MobileFirst Mobile Browser Simulator or a simple browser. The --watch+copy option is set by default in interactive mode. When running in preview mode, the app will not be able to communicate with the MobileFirst Server in the same way as when it runs in a simulator or device. In preview mode, the only communication that the app can have with the MobileFirst Server is through the use of the WLResource JavaScript API, which is used to call adapters. All adapter calls go through without any type of authentication challenge. When an adapter is called during preview, the call is run through the preview's development proxy server with the clientid and secret to retrieve an Oauth Confidential Client token. This allows the adapter to be accessed without any authentication challenges. The command will prompt for server details, as needed, for preview to server connectivity. You can view or change the clientid and secret with the 'mfpdev adapter call' command or in the MobileFirst Operations Console. Cordova apps only: * The cordova-plugin-whitelist plugin is temporarily removed during preview so that the preview can display in a browser. * With simple browser preview there is no Cordova simulation. Use the Mobile Browser Simulator to preview Cordova apps. OPTIONS : Platforms to preview (valid values are ios, android, windows). If you specify more than one platform, specify them by using a comma-separated list. If your comma-separated list of platforms contains one or more supported platform, then those platforms are used. If the platforms that are passed in do not exist in the application or are invalid platforms, your app is previewed by using the first valid platform in the application. [--type|-t ]: The type of browser with which you preview your app. Valid values are 'browser' or 'mbs'. Specifying 'browser' starts your app in your system's default web browser. Specifying 'mbs' starts the Mobile Browser Simulator. If no type is specified, the default browser type is used. You can define the default browser type with the 'mfpdev config' command. [--watch+copy|-wc]: Specifies to watch the app's root www directory, and when a file changes, to copy it directly to the corresponding platforms//www directory for each platform in your app. This also triggers a live reload. Only the changed files are copied. This option is enabled by default. [--watch+prepare|-wp:] Specifies to watch the app's root www directory and to run the 'cordova prepare' command when a file changes. Running 'cordova prepare' copies all of the current files in the root www directory to all of the platforms//www directories. This also triggers a live reload. [--serve|-s]: Specifies to serve the app to the browser, but to not watch any directory for changes or copy changes anywhere. A live reload occurs only when the 'cordova prepare' command is run. [--clientid ]: The client ID for an Oauth Confidential Client token. Required for calling an adapter on a MobileFirst Server. The default value is 'test'. [--secret ]: The secret for an Oauth Confidential Client token. Required for calling an adapter on a MobileFirst Server. The default value is 'test'. [--noserver]: Speeds up the time needed to display the preview if there's no need to connect to a MobileFirst Server. When this option is specified, no request is issued for server connectivity information. EXAMPLES Interactive mode: $ mfpdev app preview Displays a series of prompts to ask you how you want to preview the app. Use the up and down arrow keys on your keyboard to move through the selections, and press the Enter key to select. Direct mode: $ mfpdev app preview ios --type mbs -wp Displays a preview of the iOS version of the app in the Mobile Browser Simulator. The root www directory is watched, and if a file changes, the 'cordova prepare' command is run, propagating the change to all platforms. Then, a live reload occurs.