diff options
Diffstat (limited to 'files/pt-pt/tools/remote_debugging')
3 files changed, 107 insertions, 0 deletions
diff --git a/files/pt-pt/tools/remote_debugging/debugging_firefox_desktop/index.html b/files/pt-pt/tools/remote_debugging/debugging_firefox_desktop/index.html new file mode 100644 index 0000000000..0099b3a81d --- /dev/null +++ b/files/pt-pt/tools/remote_debugging/debugging_firefox_desktop/index.html @@ -0,0 +1,42 @@ +--- +title: Depurar Firefox para PC +slug: Tools/Remote_Debugging/Debugging_Firefox_Desktop +tags: + - Depuração + - Ferramentas + - Guía +translation_of: Tools/Remote_Debugging/Debugging_Firefox_Desktop +--- +<p>{{draft}}</p> + +<p>{{ToolsSidebar}}</p> + +<p>This guide explains how you can use the Firefox Developer Tools to debug a different instance of desktop Firefox running on the same machine. In this guide, the instance of Firefox being debugged is called the <em>debuggee</em>, and the instance of Firefox doing the debugging is called the <em>debugger</em>.</p> + +<h2 id="Enable_remote_debugging">Enable remote debugging</h2> + +<p>First, you'll need to ensure that both debugger and debuggee have the "Enable browser chrome and add-on debugging toolboxes" and "Enable remote debugging" settings checked in the <a href="/en-US/docs/Tools/Tools_Toolbox#Settings">Developer Tools Settings</a>. If you're using <a href="/en-US/Firefox/Developer_Edition">Firefox Developer Edition</a>, they are checked by default.</p> + +<p><img alt="" src="https://mdn.mozillademos.org/files/16905/remote_debug_settings.png" style="border: 1px solid black; display: block; margin: 0 auto;"></p> + +<p>You only need to do this once: the setting values persist across restarts.</p> + +<h2 id="Start_the_debugger_server">Start the debugger server</h2> + +<p>Next, you need to start the debugger server in the debuggee.</p> + +<p>Run the debuggee from the command line, passing it the <code>--start-debugger-server</code> option:</p> + +<pre>/path/to/firefox --start-debugger-server</pre> + +<p>Passed with no arguments, --start-debugger-server makes the debugger server listen on port 6000. To use a different port, pass the desired port number:</p> + +<pre>/path/to/firefox --start-debugger-server 1234</pre> + +<p>Note: in Windows, the <code>start-debugger-server</code> call will only have one dash:</p> + +<pre>firefox.exe -start-debugger-server 1234</pre> + +<div class="note"> +<p><strong>Note</strong>: By default, and for security reasons, the <code>devtools.debugger.force-local</code> option is set. If you want to debug a Firefox instance from an external machine, you can change this option, but only do this on a trusted network or set a strong firewall rule to lock down which machines can access it.</p> +</div> diff --git a/files/pt-pt/tools/remote_debugging/depuracao_remota_thunderbird/index.html b/files/pt-pt/tools/remote_debugging/depuracao_remota_thunderbird/index.html new file mode 100644 index 0000000000..31f3278847 --- /dev/null +++ b/files/pt-pt/tools/remote_debugging/depuracao_remota_thunderbird/index.html @@ -0,0 +1,44 @@ +--- +title: Depurar remotamente o Thunderbird +slug: Tools/Remote_Debugging/Depuracao_remota_Thunderbird +tags: + - Tutorial + - depurar + - thunderbird +translation_of: Tools/Remote_Debugging/Thunderbird +--- +<div>{{ToolsSidebar}}</div><p>This guide explains how to use <a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_usage_tips/Remote_debugging">remote debugging </a>to inspect or debug code running in <a href="/en-US/docs/Mozilla/Thunderbird">Thunderbird</a>.</p> + +<p>Various developer tools are supported by Thunderbird using the remote connection mechanism in Firefox. The currently supported toolset is the Web Console, Inspector, Debugger, Style Editor, Profiler and Network Monitor. Other Tools may become available in the future.</p> + +<h2 id="Configurar_o_Thunderbird">Configurar o Thunderbird</h2> + +<p>All that needs to be done in Thunderbird is enabling the debugger server. This can be done using <code>Tools</code> from the Menu Bar (alt + Tools) and selecting <code>Allow Remote Debugging</code>. By default, a debugger server will be started on port 6000. If you would like to change this port, for example to debug multiple profiles, you must open the advanced config editor and change the preference <code>devtools.debugger.remote-port</code>.</p> + +<h2 id="Configurar_o_Firefox">Configurar o Firefox</h2> + +<p>Firefox acts as the client and provides the user interface to control the developer tools for Thunderbird. It's best to use a Firefox and Thunderbird version with a matching major version number, but in some cases it will work even with differing versions.</p> + +<p>To set up Firefox, remote debugging is enabled by a setting in the Toolbox. <a href="/en-US/docs/Tools_Toolbox" title="/en-US/docs/Tools_Toolbox">Open the Toolbox</a>, click the "Settings" button in the <a href="/en-US/docs/Tools_Toolbox#Toolbar" title="/en-US/docs/Tools_Toolbox#Toolbar">toolbar</a>, and check "Enable remote debugging" in the <a href="/en-US/docs/Tools_Toolbox#Settings" title="/en-US/docs/Tools_Toolbox#Settings">Settings </a>tab:</p> + +<p><img alt="" src="https://mdn.mozillademos.org/files/5827/remote-debugger-toolbox-settings.png"></p> + +<p>Now you can open the connection page in Firefox via the tools menu:</p> + +<p><img alt="" src="https://mdn.mozillademos.org/files/5811/remote-debugging-connect-menuitem.png" style="height: 503px; width: 583px;"></p> + +<p>A page will open in the browser; you can add this to your bookmarks toolbar if you like. In case you didn't change the remote port, the fields will already be filled out correctly. Click on the Connect button to initiate the developer tools remote connection.</p> + +<p><img alt="" src="https://mdn.mozillademos.org/files/5813/remote-debugging-desktop-connect.png" style="height: 686px; width: 732px;"></p> + +<p>Afterwards you will be presented with a list of remote tabs and processes. As Thunderbird's notion of tabs doesn't match Firefox, the remote tabs area shows all xul:browser elements in Thunderbird. This can be a content tab, or the message reader. In most cases you will want to select "Main Process" to debug the Thunderbird code itself. A new window opens containing a set of developer tools that can be used with your Thunderbird instance.</p> + +<p><img alt="" src="https://mdn.mozillademos.org/files/5819/remote-debugging-desktop-select-target.png"></p> + +<h2 id="Utilizar_as_Ferramentas_de_Desenvolvimento">Utilizar as Ferramentas de Desenvolvimento</h2> + +<p>Usage of the tools is mostly self explanatory. If you are having trouble with a certain tool, check the <a href="/en-US/docs/Tools/Remote_Debugging">Developer Tools documentation</a>. Due to a remote connection being used there might be some slight differences. Some tools might not be available, and it is also possible that performance is not comparable. For example, using the remote debugger tool takes quite some time to load because the files must be transferred over an internal network connection.</p> + +<h2 id="Resolução_de_problemas">Resolução de problemas</h2> + +<p>If you encounter an error, the first thing you should check is if you are using matching version numbers. If you are using Thunderbird 24, you should also use Firefox 24 to connect. Next, it important to figure out if it is a problem with the Firefox Developer Tools or with the remote connection code in Thunderbird. To verify this, please try to reproduce the problem using only Firefox. For example, if you notice that you cannot set an attribute value in the Inspector tool, try changing an attribute in the Browser Debugger in Firefox. If you cannot reproduce it there, file a bug in the Thunderbird product, otherwise file a bug in Firefox/Developer Tools.</p> diff --git a/files/pt-pt/tools/remote_debugging/index.html b/files/pt-pt/tools/remote_debugging/index.html new file mode 100644 index 0000000000..a0eb56ab9a --- /dev/null +++ b/files/pt-pt/tools/remote_debugging/index.html @@ -0,0 +1,21 @@ +--- +title: Depuração Remota +slug: Tools/Remote_Debugging +tags: + - Ferramentas + - 'l10n:prioridade' +translation_of: Tools/Remote_Debugging +--- +<div>{{ToolsSidebar}}</div> + +<p>Pode utilizar as <a href="/pt-PT/docs/Tools">ferramentas de desenvolvimento do Firefox</a> no seu PC para depurar sites da Web e aplicação da Web em execução em outros navegadores ou tempos de execução. O outro navegador poderá estar no mesmo dispositivo que as próprias ferramentas ou num dispositivo diferente, tal como um telefone ligrado através de USB.</p> + +<p>As instruções detalhadas para ligar às ferramentas de programador são específicas de tempo de execução.</p> + +<p>Pode ligar às ferramentas de programador para os tempos de execução naseados em Gecko, tais como Firefox para PC, Firefox para Android, e Thunderbird.</p> + +<ul> + <li><a href="/pt-PT/docs/Tools/Remote_Debugging/Debugging_Firefox_Desktop">Firefox para PC</a></li> + <li>Firefox para Android <a href="/pt-PT/docs/Tools/about:debugging">através de USB</a></li> + <li><a href="/pt-PT/docs/Tools/Remote_Debugging/Depuracao_remota_Thunderbird">Thunderbird</a></li> +</ul> |