Emulator (Android Only)

This page will guide you through the steps to set-up and use the emulator feature. This process is easy and is done entirely through the Workstation interface.

Android Emulator

Given the inherent slowness of the Android emulator, it is important that your VM/Hardware be configured to provide the best experience possible. Please use the recommended settings below:

  • 2 Processors

  • At least 2GB of memory

Please note that at this time the emulator feature is only available for Android.

Setting it up

Configuring Workstation to use an emulator can be done in two ways: through the Device Manager and through the Preferences.

Device Manager

  1. Open the Device Manager by clicking the button labeled “Device Manager”, located in the bottom-left of the Workstation UI

  2. Enable the emulator by clicking the button labeled “Enable emulator mode”, located at the bottom of the open Device Manager window

  3. Accept the emulator install by clicking “OK” (if prompted)

  4. Unplug any connected physical Android devices and restart NowSecure Lab by clicking the Reset button (once the emulator package has been installed)

Device Manager

Preferences

  1. Open Preferences by clicking on the “Options” button in the upper-right corner of Workstation and selecting “Preferences”

  2. Navigate to the “Emulator” tab in the Preferences

  3. Check the box labeled “Use an android emulator”

  4. Accept the emulator install by clicking “OK’

  5. Unplug any connected physical Android devices and restart Workstation by clicking the Restart button (once the emulator package has been installed).

Device Disconnected

Using the emulator

Using the emulator is much like using a physical device to perform mobile security assessments in Workstation, with some minor differences.

When NowSecure Lab starts in emulator mode you will notice that in the bottom-left of the screen there is a “Loading…” spinner. At this point Workstation is loading the installed emulator and you should see it open in a separate window, though it won’t be connected (connecting will take approximately 1 to 3 minutes).

Device Disconnected

Once the emulator connects you will see the device icon in the bottom-left and the spinner change to “Enabling…”. At this point services on the device, necessary to work with Workstation, are being started (starting services will take approximately 1 to 3 minutes).

Device Connected

New projects can not be created until the emulator is completely connected (not in a Loading or Enabling state). Projects can be opened but will be in view-only mode until the emulator is completely connected.

Device Connected

The Network Setup step is not required for the emulator. Communication between the emulator and Workstation will be set up automatically. This also means that settings related to the network will be disabled in the preferences.

Disabling the emulator

Like setting up the emulator, disabling the feature can be done in the Device Manager or in the Preferences

Device Manager

  1. Open the Device Manager by clicking the button labeled “Device Manager” located in the bottom-left of the Workstation UI

  2. Disable the emulator by clicking the button labeled “Disable emulator mode” located at the bottom of the Device Manager window

  3. Plug in a physical device and click the “OK” button to restart Workstation

Disable Emulator

Preferences

  1. Open Preferences by clicking on the “Options” button in the upper-right corner of Workstation and selecting “Preferences”

  2. Navigate to the “Emulator” tab of the Preferences

  3. Uncheck the box labeled “Use an android emulator”

  4. Plug in a physical device and click “OK” to restart Workstation

Disable Emulator

If you are experiencing issues, please review the steps described at the bottom of the Troubleshooting section (Emulator section) or contact NowSecure.