Remoting Prototype

From FirebugWiki

(Difference between revisions)
Jump to: navigation, search
(Prototype)
m (Fixed formatting and spelling mistakes)
Line 6: Line 6:
== Prototype ==
== Prototype ==
-
The current development happens on [https://github.com/firebug/firebug/tree/jsd2 jsd2] branch.
+
The current development happens on the [https://github.com/firebug/firebug/tree/jsd2 jsd2] branch.
=== Setup ===
=== Setup ===
See how to setup your environment to successfully connect Firebug to remote browser instance. Note that you need to install Firebug on both sides, client and server.
See how to setup your environment to successfully connect Firebug to remote browser instance. Note that you need to install Firebug on both sides, client and server.
-
Following preferences need to be set (use about:config)
+
Following preferences need to be set (use <code>about:config</code>)
-
* Server
+
==== Server ====
-
** <code>devtools.debugger.remote-enabled</code> - must be set to ''true''
+
* <code>devtools.debugger.remote-enabled</code> - must be set to <code>true</code>
-
** <code>extensions.firebug.serverMode</code>  - must be set to ''true''
+
* <code>extensions.firebug.serverMode</code>  - must be set to <code>true</code>
-
** <code>devtools.debugger.force-local</code> - set to ''false'' if you want to connect to browser instance on another machine
+
* <code>devtools.debugger.force-local</code> - set to <code>false</code> if you want to connect to browser instance on another machine
-
* Client
+
==== Client ====
-
** <code>extensions.firebug.serverHost</code> - name of the remote host (''localhost'' by default)
+
* <code>extensions.firebug.serverHost</code> - name of the remote host (<code>localhost</code> by default)
-
** <code>extensions.firebug.serverPort</code> - remote port (5999 by default)
+
* <code>extensions.firebug.serverPort</code> - remote port (<code>5999</code> by default)
-
 
+
In order to make a connection start both browser instances (use two Firefox profiles if testing on one machine). The client side should automatically try to connect the server according to the settings. See the ''Connecting...'' button in the main Firebug toolbar.
-
In order to make a connection start both browser instances (use two Firefox profiles if tested on one machine). The client side should automatically try to connect the server according to the prefs settings. See the ''Connecting...'' button in the main Firebug toolbar.
+
=== FBTrace ===
=== FBTrace ===
Line 29: Line 28:
* Server:
* Server:
-
* Client: CONNECTION
+
* Client: ''CONNECTION''
=== Implementation ===
=== Implementation ===
-
Rough summary of steps to implement remotable Firebug prototype (starting with the Script and Net panels).
+
Rough summary of steps to implement a remotable Firebug prototype (starting with the [[Script Panel|Script]] and [[Net Panel]]).
* Create a simple server side to connect to
* Create a simple server side to connect to
Line 38: Line 37:
* Provide simple UI to allow the user to connect the server
* Provide simple UI to allow the user to connect the server
* Implement custom actors on the server side
* Implement custom actors on the server side
-
* Implement new ''Script'' panel supporting remotable architectur
+
* Implement new ''Script'' panel supporting remotable architecture
-
* Implement Script panel proxy on top of the connection object
+
* Implement ''Script'' panel proxy on top of the connection object
-
* Move UI pieces from the old (JSD1 based) Script panel step by step into the new Script panel (JSD2 based).
+
* Move UI pieces from the old (JSD1 based) ''Script'' panel step by step into the new (JSD2 based) ''Script'' panel.
* Connect existing built-in script-debugger actors
* Connect existing built-in script-debugger actors

Revision as of 08:29, 20 August 2012

This page is intended to provide detailed instructions about how to use remote capabilities in Firebug.

Contents

Resources

Prototype

The current development happens on the jsd2 branch.

Setup

See how to setup your environment to successfully connect Firebug to remote browser instance. Note that you need to install Firebug on both sides, client and server.

Following preferences need to be set (use about:config)

Server

  • devtools.debugger.remote-enabled - must be set to true
  • extensions.firebug.serverMode - must be set to true
  • devtools.debugger.force-local - set to false if you want to connect to browser instance on another machine

Client

  • extensions.firebug.serverHost - name of the remote host (localhost by default)
  • extensions.firebug.serverPort - remote port (5999 by default)

In order to make a connection start both browser instances (use two Firefox profiles if testing on one machine). The client side should automatically try to connect the server according to the settings. See the Connecting... button in the main Firebug toolbar.

FBTrace

In order to see/filter logs on the server and client you should use following options in the FBTrace console.

  • Server:
  • Client: CONNECTION

Implementation

Rough summary of steps to implement a remotable Firebug prototype (starting with the Script and Net Panel).

  • Create a simple server side to connect to
  • Implement basic connection object
  • Provide simple UI to allow the user to connect the server
  • Implement custom actors on the server side
  • Implement new Script panel supporting remotable architecture
  • Implement Script panel proxy on top of the connection object
  • Move UI pieces from the old (JSD1 based) Script panel step by step into the new (JSD2 based) Script panel.
  • Connect existing built-in script-debugger actors
Personal tools