Running Phoney from the Command Line

Option and Description

{--accelerate_images | -ai}

Enables image acceleration, speeding up 32-bit images.

{--device | -fd} device_name

Forces Phoney to emulate the dimensions and keys of the specified device. For device_name specify the name you selected from the Choose your handset list in the Add Handset dialog when you added the device to the project. For example, for the Microsoft Surface RT device, use WN8_Microsoft_SurfaceRT for device_name .

{--dimensions | -d} widthxheight

Specifies the canvas dimensions. The default is 176x220 pixels.

Note:

If you also specify the {--device | -fd} option, the dimensions you specify with the {--dimensions | -d} option override the dimension specified with the {--device | -fd} option. Other settings specified with the {--device | -fd} option still apply.

{--fc_pim_roots | -rt} simulated_drives

Specifies one or more simulated drives that Phoney uses when executing FileConnection classes.

To specify a drive use the format:

fake_root_name,path

For example, to simulate the D:\ drive in C:\fake\d, use the following

D:\,C:\fake\d

Use a semicolon-separated list to specify multiple simulated drives. For example, to simulate the D:\ drive in C:\fake\d and the E:\drive in C:\fake\e, use the following

D:\,C:\fake\d;E:\,C:\fake\e

The default is the following:

C:\,%FCDIR%/c/

For the default, %FCDIR% maps to the following directory:

Mobile Designer_directory \Tools\Phoney\FC_PIM_fake_roots

{--fixed_frame_rate | -ff}

Specifies you want to Phoney to create AVI files using fixed frame rate. If you do not specify this option, Phoney uses variable rate.

{--frame_rate | -fr} rate

Specifies that you want Phoney to record everything that is displayed in the Phoney window in an AVI file. Specify rate to indicate the frame rate (frames per second) to use to record the movie. The default frame rate value is 25fps.

Using this option allows you to record a movie of your application, for example, to use as a demonstration video.

{--invert | -i}

Inverts the number pad so that it behaves like a phone keypad.

{--jad_param | -jp} parameters

Specifies Java Application Descriptor (JAD) parameters. If a JAD file is present, the parameters you specify override the parameters in the JAD file. You can specify the {--jad_param | -jp} startup option multiple times.

{--location_position | -lp} latitude;longitude;altitude

Specifies the default position returned by the Location API. The default is "51:30:26;-0:7:39;24" (London).

{--max_scale | -ms}

Sets the scale of the current screen to the maximum that is allowable given the current screen resolution.

{--metrics_mem_limit_kb | -mm} megabytes

Specifies the maximum number of kilobytes to use for memory before issuing warnings. Phoney signals a warning if an application's memory usage is approaching or exceeding configured limit. The default is 51200 KB (50 MB). For more information, see Using Phoney to Monitor an Application’s Memory and Thread Usage.

Note:

It is recommended that you do not change the default. If you need to change it, do so for specific devices rather than the entire project.

{--metrics_thread_limit | -mt} number

Specifies the maximum number of threads to use before issuing warnings. Phoney signals a warning if an application's thread usage is approaching or exceeding configured limit. The default is 15 threads. For more information, see Using Phoney to Monitor an Application’s Memory and Thread Usage.

Note:

It is recommended that you do not change the default. If you need to change it, do so for specific devices rather than the entire project.

{--no_connectivity | -nc}

Start phoney up with all virtual network connections disabled. This can be used to simulate a device in a no-coverage area, or in Airplane mode.

{--no_fake_fc_pim_roots | -fk}

Disables the behavior of the {--fc_pim_roots | -rt} startup option.

Caution:

When you use {--no_fake_fc_pim_roots | -fk}, Phoney lists your computer’s root devices directly. As a result, your mobile application has direct access to the root drives, for example, C:\.

{--no_file_connection | -fc}

Disables the FileConnection portion of FC-PIM. Use this option when you want to simulate devices that do not support the FileConnection API.

{--no_menus | -nm}

Disables the menu bar.

{--no_pim | -np}

Disables the reading of the Phoney Contacts file.

{--no_settings | -ns}

Specifies that you want Phoney to only use the command-line options for user settings and ignore settings in user settings files.

By default, Phoney retains settings from previous sessions in a properties file so they can be used again. Using this property ensures that Phoney does not use previously saved settings.

{--open_dialog | -od}

Shows the file open dialog so that you can have Phoney load a JAD or JAR file at startup.

{--open_screenshot | -os}

Indicates that you want Phoney to automatically open any screen shot you take using F1. The screen shot is open using the system-defined application for viewing PNG images.

{--pim_root | -pr}

Specifies where to locate the Phoney Contacts file.

The default is the following:

%PIMDIR%

For the default, %PIMDIR% maps to the following directory:

Mobile Designer_directory \Tools\Phoney\FC_PIM_Contacts

{--properties | -p} filename

Specifies you want Phoney to use device settings in the specified properties file.

Important:

Be sure to specify this setting so that Phoney automatically represents the activated device.

{--redirect_output | -ro}

Redirects all stdout and stderr text to an internal buffer that you can then view from the Phoney > Console menu item.

{--repaint_sleep | -rs} milliseconds

Specifies the number of milliseconds the MIDP repaint calls sleeps, allowing time for the paint thread to service the queue.

{--rms_files | -r}

Specifies you want to store RMS data in files.

Phoney uses RMS files for the RecordStore class read/write processes. If you do not use file-based RMS, the save/load operations do not persist between Phoney sessions.

{--scale | -s} number

Specifies the window scale multiplier. The default is 1.

Note:

While running Phoney, you can change the screen scale by pressing the '+' or '-' key to increase or decrease the scale.

{--single_keypress | -sk}

Disables multiple simultaneous key presses. By default, multiple simultaneous key presses are enabled.

{--slow_rms | -sr} milliseconds

Specifies you want to emulate a record store that performs slowly. Specify the number of milliseconds you want the RecordStore class to use to perform an add or set operation.

Note:

This is mostly useful for legacy J2ME devices that sometimes had issues writing to the RecordStore, causing a lag when trying to save too frequently or not allowing enough time for the write operations to complete. By simulating the time that the device takes, you can determine how the application will perform on devices that exhibit this issue.

{--softkeys | -k}

Forces a system soft-key area for LCDUI soft keys.

{--start_landscape | -sl}

Starts Phoney up and immediately rotates the device by 90 degrees (normally landscape mode for most devices).

{--sound | -so}

Enables sound playback using the JDK 1.5 Java Sound API.

{--verbose | -v}

Specifies you want verbose output.

{--verbose_mmapi | -vm}

Specifies you want verbose debug information from the MMAPI code.