Run Your App in the Native Windows Phone Emulator

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

IDE

The Windows Phone 8.0 and Windows Phone 8.1 software development kits (SDKs) for native Windows Phone development provide native emulators. In AppBuilder, you can run your hybrid apps in the native Windows Phone emulators.

To test your app during development, you can build and deploy it in the native device emulator. This way you can test your app on the predefined device configurations without actually deploying the app on a physical device.

When you select to run your app in the native emulator, AppBuilder builds an application package (XAP) and loads it in the emulator. After the application package is deployed, AppBuilder automatically LiveSyncs changes on Save.

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 you have installed the Windows Phone SDK.
    For more information about downloading and installing the Windows Phone 8.0 SDK or the Windows Phone 8.1 SDK, see Windows Phone SDK archives.
  • Verify that your operating system is Windows 8 or later.

Procedure

In-Browser

This operation is not available in the in-browser client.

Windows

  1. In the top menu bar, select RunNative Emulator.
  2. Select Windows Phone, select a predefined configuration and click Launch Emulator.
  3. If Launch Emulator is inactive, you need to configure the native emulator.
    Download and install the Windows Phone 8.0 SDK or the Windows Phone 8.1 SDK. After the installation completes, click Refresh.
  4. Wait for the emulator to load.

Your app launches automatically in the emulator.

Visual Studio

  1. In the top menu bar, select AppBuilderRun Native Emulator.
  2. Select Windows Phone
  3. Select a predefined configuration.1. Select build configuration.
    Option Description
    Debug
    • Enables LiveSync. Users can receive the latest changes to your app by tapping and holding with three fingers on their device screens. LiveSync might not be available for some changes and users might need to reinstall the updated and rebuilt package.
      Enabling LiveSync enables the INTERNET Android permission.
      When LiveSync is enabled, you can use the LiveSync JavaScript API to work with LiveSync programmatically.
    • Enables debugging for the app, if applicable to the selected mobile platform.
    Release
    • Disables LiveSync. Users cannot receive the latest changes to your app by tapping and holding with three fingers on their device screens and users need to reinstall the updated and rebuilt package.
      Disables the INTERNET Android permission, if you have not manually enabled it. This might cause your app to stop working as expected.
    • Disables debugging for the app, if applicable to the selected mobile platform.
  4. Click Launch Emulator.
  5. If Launch Emulator is inactive, you need to configure the native emulator.
    Download and install the Windows Phone 8.0 SDK or the Windows Phone 8.1 SDK. After the installation completes, click Refresh.
  6. Wait for the emulator to load.

Your app launches automatically in the emulator.

CLI

  1. Run the following command.

    appbuilder emulate wp8
    
  2. Wait for the emulator to load and unlock its screen, if locked.

Your app launches automatically in the emulator.

Next Steps

Continue development. After modifying your code, refresh or re-deploy your app.

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.