Package com.smartgwt.client.docs

# Interface RemoteDebugging

public interface RemoteDebugging

### Remote Debugging

In Pro and better builds (and also the Eval build), the Smart GWT `Developer Console` supports debugging remote pages, including those running on mobile devices. With remote debugging, you can use all of the powerful debugging features of the `Developer Console` - the component hierarchy (Watch tab), client/server requests (RPC tab), logs and log categories - using the large screen and physical keyboard of a desktop machine.

#### Using Remote Debugging

To enable remote debugging on a page, just add `isc_remoteDebug=true` to the page URL. For example:

http://localhost:8080/?isc_remoteDebug=true

Note in the URL above, set localhost to the actual hostname or IP address of the machine running the SDK.

You'll also need to be sure that your `isomorphicDir` has been set up correctly and that messaging is enabled on your server as noted below.

Then direct your desktop browser to the Developer Console in the `system/helpers/` subdirectory of your isomorphic dir - typically:

http://localhost:8080/showcase/sc/system/helpers/Log.html

At top right of the page, you will see a "Remote" dropdown that lists the devices and URLs that have registered for remote debugging (by passing the `isc_remoteDebug` parameter). As you roll over the available remote targets in this dropdown, the target page will glow blue to make it easy to tell which page you will be selecting for debugging - this is particularly handy when you have a lot of devices. Pick the page to debug and just starting using the `Developer Console` as normal.

If you reload the page on your mobile device, the remote Developer Console automatically re-establishes the connection. And any settings - such as Logging Preferences or Watch tab settings - automatically persist as they normally would.

#### Licensing

Anyone with a Pro or better license can use the Remote Debugging feature. Under the covers, the Remote Debugging feature actually uses the Real-time Messaging module, which is not a Pro feature. However we've rearranged things so that Pro users can use Real-time Messaging just for Remote Debugging. This does mean that, if you are upgrading your environment to the current release and you don't already have Real-time Messaging, you will need to follow the installation steps normally required for Real-time Messaging before the Remote Debugging feature will work. See the `Messaging` documentation for details.

See Also:
  - `Debugging`