Requirements for Debugging on Device

Debugging on device is an experimental feature. You can debug on device from the classic Windows desktop client, the extension for Visual Studio or the command-line interface.

In the Microsoft Visual Studio 2013 and later, you can debug on device using the AppBuilder debug tools or the built-in Microsoft Visual Studio debugger. For earlier versions of Microsoft Visual Studio, you can debug on device only using the AppBuilder debug tools.

To debug your application on device, verify that you meet the following requirements.

General Requirements

  • An Internet connection for debugging on Android.
  • Verify that you are running the classic Windows desktop client, the extension for Visual Studio or the command-line interface.
  • If you want to debug on device using the Microsoft Visual Studio built-in debugger, verify that you are running the extension for Visual Studio on Microsoft Visual Studio 2013 or later.
  • If you want to debug your TypeScript sources on device instead of the transpiled JavaScript files, verify that you meet the following requirements:
    • You are running the extension for Visual Studio on Microsoft Visual Studio 2013 or later.
    • In tsconfig.json file for your project, the sourceMap property is set to true.
    • Automatic transpilation is enabled.

Android Requirements

Android Device Requirements

  • To debug with the built-in Web Inspector, verify that your device is running Android 4.4 or later.
  • To debug with the Microsoft Visual Studio built-in debugger, verify that your device is running Android 4.4 or later.
  • To debug on devices running Android 4.3 or earlier with jsHybugger, verify that your application meets the mobile application requirements.
  • To debug on devices running Android 4.3 or earlier with jsHybugger, verify that you have uninstalled all other applications using the jsHybugger custom plugin from the device.
  • Verify that you have connected the physical or virtual device to your system and AppBuilder recognizes it.
    For more information, see Connect Android Device.

Android Application Requirements

  • To debug on devices running Android 4.3 or earlier, verify that you have added the jsHybugger custom plugin.
    You cannot debug on Android 4.3 and earlier devices with the Microsoft Visual Studio built-in debugger.
    1. In your browser, navigate to the Download section of the jsHybugger web site.
      Keep in mind that without a license, jsHybugger limits your debugging sessions to two minutes.
    2. Download the plugin as a ZIP archive.
    3. Open your app in the classic Windows desktop client or the extension for Visual Studio.
    4. If you are running the classic Windows desktop client, follow these steps to import the custom plugin.
      1. In the Project Navigator, double-click Properties.
      2. In the Plugins tab, navigate to the Custom Plugins section and expand it, if needed.
      3. Click Import and confirm the operation.
      4. Browse and locate the archive that you want to import in AppBuilder, select it and click Open.
      5. Confirm the operation.
    5. If you are running the extension for Visual Studio, follow these steps to import the custom plugin.
      1. In the Solution Explorer, right-click Plugins.
      2. Select Import Plugin.
      3. Browse and locate the archive that you want to import in AppBuilder, select it and click Open.
    6. If you are running the command-line interface, follow these steps to add the custom plugin.
      1. In your browser, navigate to the Download section of the jsHybugger web site.
      2. Download the plugin as a ZIP archive and extract it.
      3. Place the extracted plugin in the Plugins folder in your app.
  • Verify that the application is built with the debug build configuration.
  • Verify that the application is deployed on device.
  • Verify that the application is running on the device.

iOS Requirements

iOS Device Requirements

  • Verify that your device is running iOS 7.0 or later.
  • If you want to track and examine network requests, verify that your device is running iOS 8.0 or later.
  • On the device, verify that SettingsSafariAdvancedWeb Inspector is enabled.
  • Verify that you have connected the device to your system and AppBuilder recognizes it.

iOS Application Requirements

  • Verify that the application is signed with a development certificate and provisioning profile.
    You will not be able to debug your app on device, if it is signed with Ad Hoc or App Store production certificate and distribution provisioning profile. For more information about how to manually set the current cryptographic identity for your app, see Configure the Code Signing Identity for Your iOS App.
  • Verify that the application is built with the debug build configuration.
  • Verify that the application is deployed on device.
  • Verify that the application is running on the device.

Windows Phone Requirements

You cannot debug on Windows Phone devices.

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.