Configure the Simulated Device

Filter by IDE
Select the Progress AppBuilder client you are currently using for development.

IDE

In the simulator, you can select device model, mobile platform and device orientation. This way you can simulate how your app will run on a wide range of devices.

The device simulator provides a wide selection of default generic and custom devices. In the classic Windows desktop client, the extension for Visual Studio and command-line interface, you can also run your app on your own custom devices that you have manually defined in the configuration files of AppBuilder. For more information about how to add custom devices, see Create Custom Simulated Devices.

Prerequisites

  • Verify that your preferred AppBuilder client is running and you are logged in.
  • Verify that you have opened the code for your app in AppBuilder.
  • Verify that the simulator is running.

Procedure

In-Browser

  • When you click Run in the main menu to launch the simulator, select a simulated device from the list.
  • To change the selected device, click the device drop-down menu and select a simulated device from the list.
  • In the main menu of the simulator, click Version and select an option from the list.

    Device option Platform option
    iPhone Version 8.0
    Version 7.0
    Version 6.0
    Version 5.1
    Version 4.3
    iPhone 5 Version 10.0
    Version 9.1
    Version 9.0
    Version 8.0
    Version 7.0
    Version 6.0
    iPhone 6 Version 10.0
    Version 9.1
    Version 9.0
    Version 8.0
    iPhone 6 Plus Version 10.0
    Version 9.1
    Version 9.0
    Version 8.0
    iPad Version 10.0
    Version 9.1
    Version 9.0
    Version 8.0
    Version 7.0
    Version 6.0
    Version 5.1
    Version 4.3
    iPad Pro Version 10.0
    Version 9.1
    Version 9.0
    Version 8.0
    Version 7.0
    Android Phone Version 6.0
    Version 5.1
    Version 5.0
    Version 4.4
    Version 4.3
    Version 4.2
    Version 4.1
    Version 4.0
    Version 2.3
    Version 2.2
    Android Tablet Version 6.0
    Version 5.1
    Version 5.0
    Version 4.4
    Version 4.3
    Version 4.2
    Version 4.1
    Version 4.0
    Version 3.2
    Windows Phone Version 8.0
    Version 8.1
    Custom → Google Nexus 4 Version Android 5.0
    Version Android 4.4
    Version Android 4.3
    Custom → Google Nexus 7 (2013) Version Android 5.0
    Version Android 4.4
    Version Android 4.3
    Custom → HTC One X Version Android 4.2
    Version Android 4.1
    Version Android 4.0
    Custom → Nokia Lumia 820 Version Windows Phone 8.1
    Version Windows Phone 8
    Custom → Nokia Lumia 1020 Version Windows Phone 8.1
    Version Windows Phone 8
    Custom → Samsung Galaxy S4 Version Android 4.4
    Version Android 4.3
    Version Android 4.2
    Custom → Samsung Galaxy Tab S Version Android 4.4
    Custom → Sony Xperia Z Version Android 4.4
    Version Android 4.3
    Version Android 4.2
    Version Android 4.1
    Custom → LG Nexus 5 Version Android 5.0
    Version Android 4.4
    Version Android 4.3
    Custom → Samsung Nexus 10 Version Android 5.0
    Version Android 4.4
    Version Android 4.3
    Version Android 4.2
  • Set the current build configuration from the configuration drop-down menu, marked with a cogwheel.

    Option Description
    Debug
    • Adds the plugins that you have enabled for this configuration and sets their plugin variables with the correct values.
    • Includes any *.debug.* files in your application package, removes the debug modifiers from the file names and renames them to *.*.
    Release
    • Adds the plugins that you have enabled for this configuration and sets their plugin variables with the correct values.
    • Includes any *.release.* files in your application package, removes the release modifiers from the file names and renames them to *.*.
  • Set device orientation.
    • In the main menu of the simulator, click Flip to flip the device.
    • In the main menu of the simulator, click 90° CCW to rotate the device counterclockwise.
    • In the main menu of the simulator, click 90° CW to rotate the device clockwise.
  • If you have selected to run your app on a custom device, set the user agent.
    • In the UA text box, provide the user agent that you want to use.

Windows

  • To select device model, in the main menu of the simulator, click the device icon and select a simulated device from the list.
  • In the main menu of the simulator, click Version and select an option from the list.

    Device option Platform option
    iPhone Version 8.0
    Version 7.0
    Version 6.0
    Version 5.1
    Version 4.3
    iPhone 5 Version 10.0
    Version 9.1
    Version 9.0
    Version 8.0
    Version 7.0
    Version 6.0
    iPhone 6 Version 10.0
    Version 9.1
    Version 9.0
    Version 8.0
    iPhone 6 Plus Version 10.0
    Version 9.1
    Version 9.0
    Version 8.0
    iPad Version 10.0
    Version 9.1
    Version 9.0
    Version 8.0
    Version 7.0
    Version 6.0
    Version 5.1
    Version 4.3
    iPad Pro Version 10.0
    Version 9.1
    Version 9.0
    Version 8.0
    Version 7.0
    Android Phone Version 6.0
    Version 5.1
    Version 5.0
    Version 4.4
    Version 4.3
    Version 4.2
    Version 4.1
    Version 4.0
    Version 2.3
    Version 2.2
    Android Tablet Version 6.0
    Version 5.1
    Version 5.0
    Version 4.4
    Version 4.3
    Version 4.2
    Version 4.1
    Version 4.0
    Version 3.2
    Windows Phone Version 8.0
    Version 8.1
    Custom → Google Nexus 4 Version Android 5.0
    Version Android 4.4
    Version Android 4.3
    Custom → Google Nexus 7 (2013) Version Android 5.0
    Version Android 4.4
    Version Android 4.3
    Custom → HTC One X Version Android 4.2
    Version Android 4.1
    Version Android 4.0
    Custom → Nokia Lumia 820 Version Windows Phone 8.1
    Version Windows Phone 8
    Custom → Nokia Lumia 1020 Version Windows Phone 8.1
    Version Windows Phone 8
    Custom → Samsung Galaxy S4 Version Android 4.4
    Version Android 4.3
    Version Android 4.2
    Custom → Samsung Galaxy Tab S Version Android 4.4
    Custom → Sony Xperia Z Version Android 4.4
    Version Android 4.3
    Version Android 4.2
    Version Android 4.1
    Custom → LG Nexus 5 Version Android 5.0
    Version Android 4.4
    Version Android 4.3
    Custom → Samsung Nexus 10 Version Android 5.0
    Version Android 4.4
    Version Android 4.3
    Version Android 4.2
  • Set the current build configuration from the configuration drop-down menu, marked with a cogwheel.

    Option Description
    Debug
    • Adds the plugins that you have enabled for this configuration and sets their plugin variables with the correct values.
    • Includes any *.debug.* files in your application package, removes the debug modifiers from the file names and renames them to *.*.
    Release
    • Adds the plugins that you have enabled for this configuration and sets their plugin variables with the correct values.
    • Includes any *.release.* files in your application package, removes the release modifiers from the file names and renames them to *.*.
  • Set device orientation.
    • In the main menu of the simulator, click Flip to flip the device.
    • In the main menu of the simulator, click 90° CCW to rotate the device counterclockwise.
    • In the main menu of the simulator, click 90° CW to rotate the device clockwise.

Visual Studio

  • In the main menu of the simulator, click the device icon and select a simulated device from the list.
  • In the main menu of the simulator, click Version and select an option from the list.

    Device option Platform option
    iPhone Version 8.0
    Version 7.0
    Version 6.0
    Version 5.1
    Version 4.3
    iPhone 5 Version 10.0
    Version 9.1
    Version 9.0
    Version 8.0
    Version 7.0
    Version 6.0
    iPhone 6 Version 10.0
    Version 9.1
    Version 9.0
    Version 8.0
    iPhone 6 Plus Version 10.0
    Version 9.1
    Version 9.0
    Version 8.0
    iPad Version 10.0
    Version 9.1
    Version 9.0
    Version 8.0
    Version 7.0
    Version 6.0
    Version 5.1
    Version 4.3
    iPad Pro Version 10.0
    Version 9.1
    Version 9.0
    Version 8.0
    Version 7.0
    Android Phone Version 6.0
    Version 5.1
    Version 5.0
    Version 4.4
    Version 4.3
    Version 4.2
    Version 4.1
    Version 4.0
    Version 2.3
    Version 2.2
    Android Tablet Version 6.0
    Version 5.1
    Version 5.0
    Version 4.4
    Version 4.3
    Version 4.2
    Version 4.1
    Version 4.0
    Version 3.2
    Windows Phone Version 8.0
    Version 8.1
    Custom → Google Nexus 4 Version Android 5.0
    Version Android 4.4
    Version Android 4.3
    Custom → Google Nexus 7 (2013) Version Android 5.0
    Version Android 4.4
    Version Android 4.3
    Custom → HTC One X Version Android 4.2
    Version Android 4.1
    Version Android 4.0
    Custom → Nokia Lumia 820 Version Windows Phone 8.1
    Version Windows Phone 8
    Custom → Nokia Lumia 1020 Version Windows Phone 8.1
    Version Windows Phone 8
    Custom → Samsung Galaxy S4 Version Android 4.4
    Version Android 4.3
    Version Android 4.2
    Custom → Samsung Galaxy Tab S Version Android 4.4
    Custom → Sony Xperia Z Version Android 4.4
    Version Android 4.3
    Version Android 4.2
    Version Android 4.1
    Custom → LG Nexus 5 Version Android 5.0
    Version Android 4.4
    Version Android 4.3
    Custom → Samsung Nexus 10 Version Android 5.0
    Version Android 4.4
    Version Android 4.3
    Version Android 4.2
  • Set the current build configuration from the configuration drop-down menu, marked with a cogwheel.

    Option Description
    Debug
    • Adds the plugins that you have enabled for this configuration and sets their plugin variables with the correct values.
    • Includes any *.debug.* files in your application package, removes the debug modifiers from the file names and renames them to *.*.
    Release
    • Adds the plugins that you have enabled for this configuration and sets their plugin variables with the correct values.
    • Includes any *.release.* files in your application package, removes the release modifiers from the file names and renames them to *.*.
  • Set device orientation.
    • In the main menu of the simulator, click Flip to flip the device.
    • In the main menu of the simulator, click 90° CCW to rotate the device counterclockwise.
    • In the main menu of the simulator, click 90° CW to rotate the device clockwise.

CLI

If you are running the command-line interface on a Windows system, perform the following steps.

  • In the main menu of the simulator, click the device icon and select a simulated device from the list.
  • In the main menu of the simulator, click Version and select an option from the list.

    Device option Platform option
    iPhone Version 8.0
    Version 7.0
    Version 6.0
    Version 5.1
    Version 4.3
    iPhone 5 Version 10.0
    Version 9.1
    Version 9.0
    Version 8.0
    Version 7.0
    Version 6.0
    iPhone 6 Version 10.0
    Version 9.1
    Version 9.0
    Version 8.0
    iPhone 6 Plus Version 10.0
    Version 9.1
    Version 9.0
    Version 8.0
    iPad Version 10.0
    Version 9.1
    Version 9.0
    Version 8.0
    Version 7.0
    Version 6.0
    Version 5.1
    Version 4.3
    iPad Pro Version 10.0
    Version 9.1
    Version 9.0
    Version 8.0
    Version 7.0
    Android Phone Version 6.0
    Version 5.1
    Version 5.0
    Version 4.4
    Version 4.3
    Version 4.2
    Version 4.1
    Version 4.0
    Version 2.3
    Version 2.2
    Android Tablet Version 6.0
    Version 5.1
    Version 5.0
    Version 4.4
    Version 4.3
    Version 4.2
    Version 4.1
    Version 4.0
    Version 3.2
    Windows Phone Version 8.0
    Version 8.1
    Custom → Google Nexus 4 Version Android 5.0
    Version Android 4.4
    Version Android 4.3
    Custom → Google Nexus 7 (2013) Version Android 5.0
    Version Android 4.4
    Version Android 4.3
    Custom → HTC One X Version Android 4.2
    Version Android 4.1
    Version Android 4.0
    Custom → Nokia Lumia 820 Version Windows Phone 8.1
    Version Windows Phone 8
    Custom → Nokia Lumia 1020 Version Windows Phone 8.1
    Version Windows Phone 8
    Custom → Samsung Galaxy S4 Version Android 4.4
    Version Android 4.3
    Version Android 4.2
    Custom → Samsung Galaxy Tab S Version Android 4.4
    Custom → Sony Xperia Z Version Android 4.4
    Version Android 4.3
    Version Android 4.2
    Version Android 4.1
    Custom → LG Nexus 5 Version Android 5.0
    Version Android 4.4
    Version Android 4.3
    Custom → Samsung Nexus 10 Version Android 5.0
    Version Android 4.4
    Version Android 4.3
    Version Android 4.2
  • Set the current build configuration from the configuration drop-down menu, marked with a cogwheel.

    Option Description
    Debug
    • Adds the plugins that you have enabled for this configuration and sets their plugin variables with the correct values.
    • Includes any *.debug.* files in your application package, removes the debug modifiers from the file names and renames them to *.*.
    Release
    • Adds the plugins that you have enabled for this configuration and sets their plugin variables with the correct values.
    • Includes any *.release.* files in your application package, removes the release modifiers from the file names and renames them to *.*.
  • Set device orientation.
    • In the main menu of the simulator, click Flip to flip the device.
    • In the main menu of the simulator, click 90° CCW to rotate the device counterclockwise.
    • In the main menu of the simulator, click 90° CW to rotate the device clockwise.

If you are running the command-line interface on a macOS system, perform the following steps.

  • In the title bar of the simulator, select DeviceType and select a simulated device from the list.
  • In the title bar of the simulator, select DeviceOS Version and select an option from the list.

    Device option Platform option
    iPhone Version 8.0
    Version 7.0
    Version 6.0
    Version 5.1
    Version 4.3
    iPhone 5 Version 9.1
    Version 9.0
    Version 8.0
    Version 7.0
    Version 6.0
    iPhone 6 Version 9.1
    Version 9.0
    Version 8.0
    iPhone 6 Plus Version 9.1
    Version 9.0
    Version 8.0
    iPad Version 9.1
    Version 9.0
    Version 8.0
    Version 7.0
    Version 6.0
    Version 5.1
    Version 4.3
    Android Phone Version 6.0
    Version 5.1
    Version 5.0
    Version 4.4
    Version 4.3
    Version 4.2
    Version 4.1
    Version 4.0
    Version 2.3
    Version 2.2
    Android Tablet Version 6.0
    Version 5.1
    Version 5.0
    Version 4.4
    Version 4.3
    Version 4.2
    Version 4.1
    Version 4.0
    Version 3.2
    Windows Phone Version 8.0
    Version 8.1
    Custom → Google Nexus 4 Version Android 5.0
    Version Android 4.4
    Version Android 4.3
    Google Nexus 7 (2013) Version Android 5.0
    Version Android 4.4
    Version Android 4.3
    HTC One X Version Android 4.2
    Version Android 4.1
    Version Android 4.0
    Nokia Lumia 820 Version Windows Phone 8.1
    Version Windows Phone 8
    Nokia Lumia 1020 Version Windows Phone 8.1
    Version Windows Phone 8
    Samsung Galaxy S4 Version Android 4.4
    Version Android 4.3
    Version Android 4.2
    Samsung Galaxy Tab S Version Android 4.4
    Sony Xperia Z Version Android 4.4
    Version Android 4.3
    Version Android 4.2
    Version Android 4.1
    LG Nexus 5 Version Android 5.0
    Version Android 4.4
    Version Android 4.3
    Samsung Nexus 10 Version Android 5.0
    Version Android 4.4
    Version Android 4.3
    Version Android 4.2
  • In the title bar of the simulator, select DeviceConfiguration and select the build configuration that you want to apply.

    Option Description
    Debug
    • Adds the plugins that you have enabled for this configuration and sets their plugin variables with the correct values.
    • Includes any *.debug.* files in your application package, removes the debug modifiers from the file names and renames them to *.*.
    Release
    • Adds the plugins that you have enabled for this configuration and sets their plugin variables with the correct values.
    • Includes any *.release.* files in your application package, removes the release modifiers from the file names and renames them to *.*.
  • In the title bar of the simulator, select ToolsRotate and choose a direction in which to rotate the device.

Next Steps

Simulate changes in the user location and network connection type.

See Also

Start a free trial Request a demo
Contact us: +1-888-365-2779
sales@telerik.com
Copyright © 2016-2017, Progress Software Corporation and/or its subsidiaries or affiliates. All rights reserved.