initial commit

3 files changed, 276 insertions, 0 deletions

diff --git a/files/ru/tools/remote_debugging/debugging_firefox_desktop/index.html b/files/ru/tools/remote_debugging/debugging_firefox_desktop/index.html
new file mode 100644
index 0000000000..89fc9d3890
--- /dev/null
+++ b/files/ru/tools/remote_debugging/debugging_firefox_desktop/index.html
@@ -0,0 +1,84 @@
+---
+title: Отладка Firefox Desktop
+slug: Tools/Remote_Debugging/Debugging_Firefox_Desktop
+tags:
+  - Debug
+  - Debugging
+  - Guide
+  - Tools
+  - Отладка
+translation_of: Tools/Remote_Debugging/Debugging_Firefox_Desktop
+---
+<div>{{ToolsSidebar}}</div><p>Это руководство объясняет, как использовать <a href="/ru/docs/Tools">Инструменты разработчика Firefox</a> для отладки различных версий десктопного Firefox, запущенного на том же компьютере. В этом документе экземпляр Firefox, который будет отлаживаться, назовём <em>отлаживаемый(</em><em>debuggee</em><em>)</em>, а тот, с которого производится отладка - <em>отлаживающий</em> (<em>debugger, отладчик</em>).</p>
+
+<h2 id="Включение_удалённой_отладки">Включение удалённой отладки</h2>
+
+<p>Во-первых, убедитесь, что в обоих Firefox (отлаживаемый и отлаживающий) установлены галочки "Включить удалённую отладку" (Enable remote debugging) и "Включить инструменты отладки browser chrome и дополнений" (Enable chrome and add-on debugging), которые находятся в настройках <a href="/ru/docs/Tools">Инструментов разработчика Firefox</a>. Если у вас используется <a href="/en-US/Firefox/Developer_Edition">Firefox Developer Edition</a>, то галочки уже установлены по умолчанию.</p>
+
+<p>Это потребуется сделать только однажды. После перезагрузки настройки сохранятся.</p>
+
+<h2 id="Запуск_сервера_отладчика">Запуск сервера отладчика</h2>
+
+<p>Далее нужно стартовать сервер отладчика в отлаживаемом Firefox.</p>
+
+<h3 id="До_Firefox_37">До Firefox 37</h3>
+
+<p>До Firefox 37: открыть <a href="/ru/docs/Tools/GCLI">Панель разработчика</a> и введите команду:</p>
+
+<pre>listen 6000</pre>
+
+<p>Это укажет отлаживаемому прослушивать клиентов-отладчиков на порту 6000. Кроме этого нигде больше не используйте порт 6000.</p>
+
+<p>После перезагрузки нужно будет ввести команду заново.</p>
+
+<h3 id="После_Firefox_37">После Firefox 37</h3>
+
+<p>Начиная с Firefox 37 и далее описанный метод работает, но есть другой: запустите <em>отлаживаемый </em>из командной строки, передав ему параметр <code>--start-debugger-server</code>:</p>
+
+<pre>/path/to/firefox --start-debugger-server</pre>
+
+<p>Без аргументов  параметр <code>--start-debugger-server</code> запустит прослушивание сервером 6000 порта. Для использования другого порта передайте его номер:</p>
+
+<pre>/path/to/firefox --start-debugger-server 1234</pre>
+
+<p>Отметьте: в Windows вызов <code>start-debugger-server</code> записывается с одним "минусом":</p>
+
+<pre>firefox.exe -start-debugger-server 1234</pre>
+
+<div class="note">
+<p><strong>Примечание</strong>: По умолчанию и по соображениям безопасности включена (через about:config) опция<code> devtools.debugger.force-local</code>. Если нужно отлаживать Firefox с другого компьютера, то измените её, но только в безопасной сети или за файерволом, чтобы предотвратить несанкционированный доступ.</p>
+</div>
+
+<h2 id="Подключение">Подключение</h2>
+
+<p>Есть два способа подключения: "Экран подключения" и "WebIDE".</p>
+
+<h3 id="Экран_подключения">Экран подключения</h3>
+
+<p>На <em>отлаживающем </em>Firefox в меню "Разработка" есть пункт "Соединиться...". Кликните его и увидите страницу:</p>
+
+<p><img alt="" src="https://mdn.mozillademos.org/files/14157/connect1.png" style="display: block; height: 441px; margin-left: auto; margin-right: auto; width: 606px;"></p>
+
+<p>Введите номер порта,  заданный для <em>отлаживаемого</em> и нажмите "Connect". В <em>отлаживаемом</em> увидите диалог для подтверждения подключения:</p>
+
+<p><img alt="" src="https://mdn.mozillademos.org/files/10073/remote-warning.png" style="display: block; height: 193px; margin-left: auto; margin-right: auto; width: 502px;">Нажмите"OK" и вернитесь в отладчик. Появится такая страница:</p>
+
+<p><img alt="" src="https://mdn.mozillademos.org/files/10065/remote-connect-2.png" style="display: block; margin-left: auto; margin-right: auto; width: 640px;"></p>
+
+<ul>
+ <li>Под "Available remote tabs" (Доступные удалённые вкладки) находится список всех вкладок <em>отлаживаемого</em>. Кликните в одну для соединения Инструментов разработчика Firefox c ней.</li>
+ <li>Под "Available remote add-ons" (Доступные удалёныне дополнения) находится список всех дополнений на <em>отлаживаемом</em>. Кликните в один для соединения Инструментов разработчика Firefox.</li>
+ <li>Под "Available remote processes" (Доступные удалённые процессы) - список процессов, запущенных в Firefox. Кликните "Main process" (Главный процесс) для соединения Инструментов разработчика с самим браузером.</li>
+</ul>
+
+<h3 id="WebIDE">WebIDE</h3>
+
+<p>На <em>отлаживающем </em>Firefox откройте WebIDE кликните "Select Runtime"/"Remote Runtime" (Удалённый Runtime):</p>
+
+<p><img alt="" src="https://mdn.mozillademos.org/files/14153/webide_select_runtime1.png" style="display: block; height: 580px; margin-left: auto; margin-right: auto; width: 819px;">Вас попросят предоставить имя компьютера и порт. Введите "localhost:6000" или другой номер порта, если прислушивается иной порт (смотря какой вы указали).</p>
+
+<p>На <em>отлаживаемом </em>Firefox появится предупреждение:</p>
+
+<p><img alt="" src="https://mdn.mozillademos.org/files/10073/remote-warning.png" style="display: block; height: 193px; margin-left: auto; margin-right: auto; width: 502px;">Кликните OK. WebIDE подключится к главному процессу. Если вы захотите подключиться к вкладке, то в списке слева выберите нужную вкладку, которую будете отлаживать.</p>
+
+<p><img alt="" src="https://mdn.mozillademos.org/files/14159/webide_select_tab1.png" style="display: block; height: 569px; margin-left: auto; margin-right: auto; width: 818px;"></p>
diff --git a/files/ru/tools/remote_debugging/firefox_for_android/index.html b/files/ru/tools/remote_debugging/firefox_for_android/index.html
new file mode 100644
index 0000000000..6bcd7b2b47
--- /dev/null
+++ b/files/ru/tools/remote_debugging/firefox_for_android/index.html
@@ -0,0 +1,146 @@
+---
+title: Remotely debugging Firefox for Android
+slug: Tools/Remote_Debugging/Firefox_for_Android
+translation_of: Tools/Remote_Debugging/Firefox_for_Android
+---
+<div>{{ToolsSidebar}}</div><p>This guide explains how to use <a href="/docs/Tools/Remote_Debugging">remote debugging </a>to inspect or debug code running in <a href="/en-US/docs/Mozilla/Firefox_for_Android">Firefox for Android </a>over USB.</p>
+
+<div class="note">
+<p>Мы недавно сильно упростили процесс подключения инструментов разработки к Firefox для Android. Если вы работаете с Firefox Desktop 36 или новее, и Firefox для Android 35 или новее, то <a href="/en-US/docs/Tools/Remote_Debugging/Debugging_Firefox_for_Android_with_WebIDE">попробуйте новый процесс</a> вместо этого.</p>
+</div>
+
+<p><img alt="" src="https://mdn.mozillademos.org/files/5833/remote-debugging-overview.png" style="display: block; margin-left: auto; margin-right: auto;"></p>
+
+<p>This guide's split into two parts: the first part, "Prerequisites" covers stuff you only need to do once, while the second part, "Connecting", covers stuff you need to do each time you connect the device. </p>
+
+<h2 id="Prerequisites">Prerequisites</h2>
+
+<p>First, you'll need:</p>
+
+<ul>
+ <li>a desktop or laptop computer with Firefox 15 or higher running on it</li>
+ <li>an Android device <a href="https://support.mozilla.org/en-US/kb/will-firefox-work-my-mobile-device" title="https://support.mozilla.org/en-US/kb/will-firefox-work-my-mobile-device">capable of running Firefox for Android</a> with Firefox for Android 15 or higher running on it</li>
+ <li>a USB cable to connect the two devices</li>
+</ul>
+
+<h3 id="ADB_setup">ADB setup</h3>
+
+<p>Next, you'll need to get the desktop and the Android device talking to each other using the <a href="https://developer.android.com/tools/help/adb.html" title="https://developer.android.com/tools/help/adb.html">adb</a> command-line tool.</p>
+
+<h4 class="note" id="On_the_Android_device">On the Android device</h4>
+
+<ul>
+ <li><a href="http://developer.android.com/guide/developing/device.html#setting-up" title="http://developer.android.com/guide/developing/device.html#setting-up">Enable USB debugging (step 2 of this link only)</a>.</li>
+ <li>Attach the device to the desktop via USB.</li>
+</ul>
+
+<h4 class="note" id="On_the_desktop">On the desktop</h4>
+
+<ul>
+ <li>Установите корректную версию  <a href="http://developer.android.com/sdk/index.html" title="http://developer.android.com/sdk/index.html">Android SDK</a> для вашего устройства.</li>
+ <li>С помощью Android SDK установите инструменты платформы <a href="http://developer.android.com/sdk/installing.html#components" title="http://developer.android.com/sdk/installing.html#components">Android Platform Tools</a>.</li>
+ <li>Платформа Android Tools устанавливает adb (Android Debug Bridge) в директорию "Platform-инструментов", в которой установлена Android SDK. Убедитесь, что каталог "инструментов платформы" находится в переменной окружения path.</li>
+</ul>
+
+<p>To check it worked, open up a command shell on the desktop and type:</p>
+
+<pre>adb devices</pre>
+
+<p>You should see some output like:</p>
+
+<pre>List of devices attached
+51800F220F01564 device
+</pre>
+
+<p>(The long hex string will be different.)</p>
+
+<p>If you do, then <code>adb</code> has found your device and you've successfully set up ADB.</p>
+
+<h3 id="Enable_remote_debugging">Enable remote debugging</h3>
+
+<p>Next, you need to enable remote debugging on both the Android device and the desktop.</p>
+
+<h4 id="Firefox_for_Android_24_and_earlier">Firefox for Android 24 and earlier</h4>
+
+<p>To enable remote debugging on the device, you need to set the <code>devtools.debugger.remote-enabled</code> preference to <code>true</code>.</p>
+
+<p>Go to <code>about:config</code> in Firefox for Android, type "devtools" into the search box and press the Search key. You'll see all the devtools preferences. Find the <code>devtools.debugger.remote-enabled</code> preference, and press "Toggle".</p>
+
+<p><img alt="" src="https://mdn.mozillademos.org/files/5803/remote-debugger-about-config-toggle.png" style="display: block; margin-left: auto; margin-right: auto;"></p>
+
+<h4 class="note" id="Firefox_for_Android_25_and_later">Firefox for Android 25 and later</h4>
+
+<p>On Firefox for Android 25 and later, there's a menu item to enable remote debugging. Open the menu, select "Settings", then "Developer tools" (on some Android devices you may need to select "More" to see the "Settings" option). Check the "Remote debugging" box:</p>
+
+<p><img alt="" src="https://mdn.mozillademos.org/files/5829/remote-debugging-device-enable.png" style="display: block; margin-left: auto; margin-right: auto;"></p>
+
+<p>The browser will display a notification reminding you to set up port forwarding, which we'll do later on.</p>
+
+<h4 id="On_the_desktop_2">On the desktop</h4>
+
+<p>On the desktop, 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" style="display: block; margin-left: auto; margin-right: auto;"></p>
+
+<div class="Note">If you're using a version of Firefox older than 27, you'll need to restart the browser for the setting to take effect.</div>
+
+<p>You'll then see a new option in the Web Developer menu labeled "Connect...":</p>
+
+<p><img alt="" src="https://mdn.mozillademos.org/files/5811/remote-debugging-connect-menuitem.png" style="display: block; margin-left: auto; margin-right: auto;"></p>
+
+<h2 id="Connecting">Connecting</h2>
+
+<p>Now you can connect the remote debugging tools to the device. First, attach the device to the desktop with a USB cable, if you haven't already.</p>
+
+<h4 class="note" id="On_the_desktop_3">On the desktop</h4>
+
+<p>For Firefox for Android 35 and later, go to a command prompt, and type:</p>
+
+<pre>adb forward tcp:6000 localfilesystem:/data/data/org.mozilla.firefox/firefox-debugger-socket</pre>
+
+<p>For Firefox for Android builds in other channels, the <code>org.mozilla.firefox</code> part should be changed to:</p>
+
+<ul>
+ <li><code>org.mozilla.firefox_beta</code> for Beta</li>
+ <li><code>org.mozilla.fennec_aurora</code> for Aurora</li>
+ <li><code>org.mozilla.fennec</code> for Nightly</li>
+</ul>
+
+<p>For Firefox for Android 34 and earlier, type:</p>
+
+<pre>adb forward tcp:6000 tcp:6000</pre>
+
+<p>(If you've changed the value the Android device uses for a debugging port, you'll need to adjust this accordingly.)</p>
+
+<p>For Firefox OS, type:</p>
+
+<pre>adb forward tcp:6000 localfilesystem:/data/local/debugger-socket</pre>
+
+<p>You'll need to reissue this command each time you physically attach desktop and device with the USB cable.</p>
+
+<p>Then go to the Web Developer menu on Firefox, and select "Connect...". You'll see a page that looks like this:</p>
+
+<p><img alt="" src="https://mdn.mozillademos.org/files/5813/remote-debugging-desktop-connect.png" style="display: block; margin-left: auto; margin-right: auto;">Unless you've changed the port numbers, choose 6000 and press the "Connect" button.</p>
+
+<h4 class="note" id="On_the_Android_device_2">On the Android device</h4>
+
+<p>Next you'll see a dialog on the Android device asking you to confirm the connection:</p>
+
+<p><img alt="" src="https://mdn.mozillademos.org/files/5815/remote-debugging-device-connect.png" style="display: block; margin-left: auto; margin-right: auto;">Press "OK". The desktop waits for a few seconds to give you time to acknowledge this dialog: if it times out, just press "Connect" in the desktop dialog again.</p>
+
+<h4 class="note" id="On_the_desktop_4">On the desktop</h4>
+
+<p>Next, the desktop shows you a dialog that looks something like this:</p>
+
+<p><img alt="" src="https://mdn.mozillademos.org/files/5819/remote-debugging-desktop-select-target.png" style="display: block; margin-left: auto; margin-right: auto;">This is asking whether you want to debug web content running in a browser tab, or to debug the browser code itself.</p>
+
+<ul>
+ <li>You'll see one entry under "Available remote tabs" for each open tab, and clicking it will attach the debugging tools to the web content hosted by that tab. If you want to debug your web content, you'll choose the relevant content tab.</li>
+ <li>You'll see one entry under "Available remote processes": this is the browser process itself. You'll choose this option if you want to debug the browser's own code.</li>
+</ul>
+
+<p>Let's choose to attach to the mozilla.org website. The Toolbox will open in its own window, attached to the Firefox for Android tab that's currently hosting mozilla.org:</p>
+
+<p><img alt="" src="https://mdn.mozillademos.org/files/5821/remote-debugging-console.png" style="display: block; margin-left: auto; margin-right: auto;"></p>
+
+<p>The Toolbox, and the tools it hosts, work in just the same way as they do when attached to local content.<img alt="" src="https://mdn.mozillademos.org/files/5823/remote-debugging-debugger.png" style="display: block; margin-left: auto; margin-right: auto;"></p>
diff --git a/files/ru/tools/remote_debugging/index.html b/files/ru/tools/remote_debugging/index.html
new file mode 100644
index 0000000000..85483004df
--- /dev/null
+++ b/files/ru/tools/remote_debugging/index.html
@@ -0,0 +1,46 @@
+---
+title: Отладка удалённых скриптов
+slug: Tools/Remote_Debugging
+tags:
+  - Tools
+  - 'l10n:priority'
+  - Отладка
+  - инструменты
+translation_of: Tools/Remote_Debugging
+---
+<div>{{ToolsSidebar}}</div><p>Вы можете использовать <a href="/ru/docs/Tools">Инструменты разработчика Firefox</a> на вашем компьютере для отладки веб-сайтов и веб-приложений, запущенных в других браузерах или программах. Другие браузеры могут быть на том же устройстве, где запущены Инструменты, или же на другом, например, на телефоне, подключенном через USB.</p>
+
+<p>Конкретные инструкции по подключению Инструментов специфичны для каждой из сред.</p>
+
+<h2 id="Среды_выполнения_основанные_на_Gecko">Среды выполнения, основанные на <a href="/ru/docs/Glossary/Gecko">Gecko</a></h2>
+
+<p>В первую очередь можете подключить Инструмены разработчика к Gecko-программам, таких как Firefox Desktop, Firefox для Android, Firefox OS или Thunderbird.</p>
+
+<ul>
+ <li><a href="/en-US/docs/Tools/Remote_Debugging/Debugging_Firefox_Desktop">Firefox Desktop</a></li>
+ <li>Firefox for Android
+  <ul>
+   <li><a href="/en-US/docs/Tools/Remote_Debugging/Debugging_Firefox_for_Android_with_WebIDE">over USB</a></li>
+   <li><a href="/en-US/docs/Tools/Remote_Debugging/Debugging_Firefox_for_Android_over_Wifi">over WiFi</a></li>
+  </ul>
+ </li>
+ <li>Firefox OS
+  <ul>
+   <li><a href="/en-US/docs/Tools/Remote_Debugging/Debugging_Firefox_OS_over_USB">over USB</a></li>
+   <li><a href="/en-US/docs/Tools/Remote_Debugging/Debugging_Firefox_OS_over_Wifi">over WiFi</a></li>
+  </ul>
+ </li>
+ <li><a href="/en-US/docs/Tools/Remote_Debugging/Thunderbird">Thunderbird</a></li>
+</ul>
+
+<h2 id="Другие_варианты_сред">Другие варианты сред</h2>
+
+<p>Экспериментальное дополнение <a href="/en-US/docs/Tools/Valence">Valence</a> позволяет отлаживать веб-сайты в средах выполнения отличных от Gecko, например, Google Chrome Desktop, Chrome для Android или Safari на iOS.</p>
+
+<p>Valence по умолчанию включен в <a href="/en-US/Firefox/Developer_Edition">Firefox Developer Edition</a>.</p>
+
+<ul>
+ <li><a href="/en-US/docs/Tools/Valence">Chrome для Android</a></li>
+ <li><a href="/en-US/docs/Tools/Remote_Debugging/Chrome_Desktop">Chrome Desktop</a></li>
+ <li><a href="/en-US/docs/Tools/Valence">Safari на iOS</a></li>
+</ul>