aboutsummaryrefslogtreecommitdiff
path: root/files/pl/tools/about_colon_debugging/index.html
blob: 762314d69920febd62b4967603a99fed60366586 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
---
title: about:debugging
slug: Tools/about:debugging
translation_of: Tools/about:debugging
original_slug: Narzędzia/about:debugging
---
<p><font><font>Zakładka about:debugging gromadzi narzędzia developerskie Firefoxa i pozwala używać ich do testowania i debugowania wielu celów (dodatków). Na chwilę obecną wspiera trzy główne rodzaje celów: dodatki niewymagające restartu przeglądarki, karty (zakładki) i workersy (zadania w tle).</font></font></p>

<h2 id="Otwieranie_zakładki_aboutdebugging"><font><font>Otwieranie zakładki about:debugging</font></font></h2>

<p><font><font>Zakładkę about:debugging można otworzyć na kilka sposobów:</font></font></p>

<ul>
 <li><font><font>Wpisać "about:debugging" w pasku URL Firefoxa.</font></font></li>
 <li><em><font><font>Od Firefoxa 47</font></font></em><font><font> : w menu Narzędzia &gt; Dla twórców witryn, kliknij "Wątki usługowe".</font></font></li>
 <li><em><font><font>Od Firefoxa 47</font></font></em><font><font> : kliknij ikonę klucza ( </font></font><img alt="" src="https://mdn.mozillademos.org/files/12710/wrench-icon.png" style="height: 21px; width: 21px;"><font><font>), który jest w głównym pasku narzędzi lub w menu Hamburger ( </font></font><img alt="" src="https://mdn.mozillademos.org/files/12712/hamburger.png" style="height: 20px; width: 22px;"><font><font>), a następnie wybierz „Wątki usługowe”.</font></font></li>
</ul>

<p><font><font>Gdy otworzy się zakładka about:debugging, po lewej stronie zobaczysz sidebara umożliwiającego przełączanie pomiędzy dwoma widokami: jednym dla dodatków, drugim dla zadań w tle (Workers).</font></font></p>

<h2 id="Dodatki"><font><font>Dodatki</font></font></h2>

<div class="note">
<p><font><font>Sekcja Dodatki w zakładce about:debugging obsługuje tylko dodatki niewymagające restartu przeglądarki, w tym </font></font><a href="/en-US/Add-ons/Bootstrapped_extensions"><font><font>basic bootstrapped extensions (niewspierane od FF &gt; 57)</font></font></a><font><font> , </font></font><a href="/en-US/Add-ons/SDK"><font><font>Add-on SDK Add-ons</font></font></a><font><font> i </font></font><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions"><font><font>WebExtensions (jedyne wspierane od FF &gt; 57)</font></font></a><font><font> .</font></font></p>
</div>

<p><font><font>Ta sekcja pozwala zrobić dwie rzeczy:</font></font></p>

<ul>
 <li><font><font>Załadować dodatek tymczasowo z dysku</font></font></li>
 <li><font><font>Podłączyć </font></font><a href="/en-US/Add-ons/Add-on_Debugger"><font><font>Add-on Debugger</font></font></a><font><font> do dodatku niewymagającego restartu.</font></font></li>
</ul>

<p><img alt="" src="https://mdn.mozillademos.org/files/15009/debugger-revised.png" style="display: block; height: 612px; margin-left: auto; margin-right: auto; width: 700px;"></p>

<h3 id="Podłączanie_Add-on_Debuggera"><font><font>Podłączanie Add-on Debuggera</font></font></h3>

<div class="note">
<p><font><font>Należy zauważyć, że obecnie do debugowania WebExtensions zaleca się korzystanie z Narzędzi Przeglądarki (Browser Toolbox) zamiast Add-on Debuggera.</font><font> Szczegóły są opisane w artykule </font></font><a href="/en-US/Add-ons/WebExtensions/Debugging"><font><font>Debugowanie WebExtensions</font></font></a><font><font>.</font></font></p>
</div>

<p><font><font>Sekcja Dodatki w zakładce about:debugging wyświetla wszystkie zainstalowane dodatki niewymagające restartu przeglądarki (lista może zawierać dodatki preinstalowane razem z Firefoxem). Przy każdym wyświetlonym dodatku znajduje się przycisk z etykietą "Debuguj".</font></font></p>

<p><font><font>Jeżeli ww. przycisk jest nieaktywny należy zaznaczyć checkboxa "Debugowanie dodatków." na górze sekcji.</font></font></p>

<p><font><font>Gdy klikniesz w przycisk "Debuguj" zobaczysz okno dialogowe z pytaniem o akceptację przychodzących połączeń. Kliknij "OK", a Add-on Debugger włączy się w oddzielnym oknie. Czasami okno debuggera może być schowane za głównym oknem Firefoxa. </font></font></p>

<p>{{EmbedYouTube("tGGcA3bT3VA")}}</p>

<p><font><font>By zobaczyć co możesz zrobić z Add-on Debuggerem zajrzyj do artykułu </font></font><a href="/en-US/docs/Mozilla/Add-ons/Add-on_Debugger"><font><font>Add-on Debugger</font></font></a>.</p>

<div class="note">
<p><a id="Enabling_add-on_debugging" name="Enabling_add-on_debugging"><font><font>Przycisk "Włącz debugowanie" zmienia wartości ustawień </font></font></a><code>devtools.chrome.enabled </code><font><font>i </font></font><code>devtools.debugger.remote-enabled</code><font><font>. </font><font>Obie opcje muszą mieć wartość</font><font> </font></font><code>true</code><font><font>, żeby debugowanie było dostępne. Zaznaczenie checkboxa ustawia obie wartości na <code>true</code>, odznaczenie go ustawia obie wartości na <code>false</code>.</font></font></p>

<p><font><font>Można również zmodyfikować ustawienia bezpośrednio w about:config lub zaznaczając „Narzędzia debugowania chrome przeglądarki i dodatków” i „Debugowanie zdalne” w </font></font><a href="/en-US/docs/Tools/Tools_Toolbox#Settings"><font><font>Ustawieniach Narzędzia dla programistów</font></font></a><font><font> .</font></font></p>
</div>

<h3 id="Ładowanie_dodatku_tymczasowego"><font><font>Ładowanie dodatku tymczasowego</font></font></h3>

<p><font><font>Przycisk "Wczytaj tymczasowy dodatek" pozwala wczytać jakikolwiek dodatek (niewymagający restartu) z katalogu na dysku. Wystarczy kliknąć przycisk, wybrać folder zawierający pliki dodatku i zaznaczyć dowolny plik w tym katalogu. Dodatek tymczasowy będzie wyświetlany pod etykietą "Tymczaowe rozszerzenia".</font></font></p>

<p><font><font>Nie musisz pakować ani podpisywać dodatku. Będzie on zainstalowany do następnego restartu Firefoxa.</font></font></p>

<p><font><font>{{EmbedYouTube("sAM78GU4P34")}}</font></font></p>

<p><font><font>Największymi zaletami tej metody w porównaniu z instalacją dodatku z XPI są:</font></font></p>

<ul>
 <li><font><font>Nie musisz rebuildować XPI i reinstalować dodatku po zmianie kodu.</font></font></li>
 <li><font><font>Możesz załadować dodatek bez podpisywania go, ani wyłączania wymagania podpisów.</font></font></li>
</ul>

<h3 id="Aktualizacja_dodatku_tymczasowego"><font><font>Aktualizacja dodatku tymczasowego</font></font></h3>

<p><font><font>Co się dzieje jeśli zainstalujesz dodatek tym sposobem i zaktualizujesz jego pliki?</font></font></p>

<h4 id="Przed_Firefoxem_48"><font><font>Przed Firefoxem 48</font></font></h4>

<ul>
 <li><font><font>Jeżeli zmienisz pliki, które są ładowane na żądanie, jak </font></font><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Content_scripts"><font><font>skrypty treści</font></font></a><font><font> lub </font></font><a href="/en-US/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Browser_actions_2"><font><font>pop-upy</font></font></a><font><font> wprowadzone zmiany są odbierane automatycznie i zobaczysz je po ponownym załadowaniu skryptu treści lub podczas wyswietlania pop-upa.</font></font></li>
 <li><font><font>Jeżeli zmienisz pliki załadowane pozostawać przez cały czas, jak </font></font><a href="/en-US/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Background_scripts"><font><font>skrypty tła</font></font></a><font><font> , a następnie można odebrać zmiany dokonane przez wyłączenie i ponowne włączenie narzutu na temat: strony dodatków.</font></font></li>
 <li><font><font>Jeżeli zmienisz pliki, które są przetwarzane tylko w czasie instalacji, jak </font></font><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json"><font><font>manifest.json</font></font></a><font><font> pliku, musisz ponownie uruchomić Firefoksa, a następnie załadować dodatek ponownie.</font></font></li>
</ul>

<div class="note">
<p><font><font>Należy pamiętać, że przed Firefox 48, ładowanie dodatek ponownie naciskając przycisk „Załaduj Temporary add-on” bez ponownego uruchamiania Firefox </font></font><em><font><font>nie działa</font></font></em><font><font> .</font></font></p>
</div>

<h4 id="Firefox_48_r"><font><font>Firefox 48 r</font></font></h4>

<ul>
</ul>

<p><font><font>Firefox 48 z roku:</font></font></p>

<ul>
 <li><font><font>jak poprzednio: jeśli zmienisz pliki, które są ładowane na żądanie, jak </font></font><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Content_scripts"><font><font>skrypty treści</font></font></a><font><font> lub </font></font><a href="/en-US/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Browser_actions_2"><font><font>pop-upów</font></font></a><font><font> , a zmiany wprowadzane są odbierane automatycznie, a zobaczysz je następnym razem treść skryptu jest załadowany lub popup jest wyświetlany.</font></font></li>
 <li><font><font>istnieje lepszy sposób obsługiwać inne przypadki: kliknij przycisk „Odśwież” obok przycisku „Debug”. </font><font>To robi to, co mówi:</font></font>
  <ul>
   <li><font><font>przeładunku żadnych trwałych skryptów, takich jak </font></font><a href="/en-US/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Background_scripts"><font><font>skrypty tle</font></font></a></li>
   <li><font><font>ponownie parsowania pliku manifest.json, tak aby zmiany </font></font><code><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions">permissions</a></code><font><font>, </font></font><code><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts">content_scripts</a></code><font><font>, </font></font><code><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/browser_action">browser_action</a></code><font><font>lub jakiekolwiek inne klawisze nie przyniosą efektu.</font></font></li>
  </ul>
 </li>
</ul>

<div class="note">
<p><font><font>Zauważ, że w Firefoksie 49 r, przycisk Odśwież jest dostępna tylko dla tymczasowych dodatków. </font><font>zostanie ona wyłączona dla wszystkich innych dodatków.</font></font></p>
</div>

<h2 id="Tabs"><font><font>Tabs</font></font></h2>

<p><font><font>Firefox 49 roku, strona jest dostępna w Tabs </font></font><code>about:debugging</code><font><font>- to zapewnia pełną listę wszystkich debuggable otwartych kart w bieżącej instancji Firefox.</font></font></p>

<p><img alt="" src="https://mdn.mozillademos.org/files/13617/about-debugging-tabs.png" style="display: block; height: 628px; margin: 0px auto; width: 900px;"></p>

<p><font><font>Każdy wpis ma zakładka </font></font><em><font><font>Debug</font></font></em><font><font> przycisk obok niego - po kliknięciu, to otworzy się zestaw narzędzi specyficznych dla tej zakładki, co pozwala na debugowanie że zawartość Tab.</font></font></p>

<p><img alt="" src="https://mdn.mozillademos.org/files/13619/about-debugging-tabs-toolbox.png" style="display: block; height: 628px; margin: 0px auto; width: 900px;"></p>

<div class="note">
<p><font><font>Zauważ, że ta funkcja nie jest bezpośrednio przydatna do debugowania kart pulpitu - można otworzyć zestaw narzędzi do debugowania kartę już dosyć łatwo - ale to będzie znacznie bardziej przydatna, gdy </font></font><code>about:debugging</code><font><font>zacznie obsługiwać zdalne debugowanie, a ta strona może zacząć notować kartach do debugowania na urządzeniu mobilnym przeglądarek symulatorów itp Zobacz {{bug (1212802)}} za ostatni na tej pracy.</font></font></p>
</div>

<h2 id="Pracownicy"><font><font>Pracownicy</font></font></h2>

<p><font><font>Strona Pracownicy pokazuje swoim pracownikom, podzielone w następujący sposób:</font></font></p>

<ul>
 <li><font><font>Wszyscy zarejestrowani </font></font><a href="/en-US/docs/Web/API/Service_Worker_API"><font><font>pracownicy usług</font></font></a></li>
 <li><font><font>Wszystkie zarejestrowane </font></font><a href="/en-US/docs/Web/API/SharedWorker"><font><font>Pracownicy Shared</font></font></a></li>
 <li><font><font>Inni pracownicy, w tym </font></font><a href="/en-US/docs/Web/API/ChromeWorker"><font><font>Chrome Robotników</font></font></a><font><font>  i </font></font><a href="/en-US/docs/Web/API/Web_Workers_API/Using_web_workers#Dedicated_workers"><font><font>Pracowników dedykowane</font></font></a></li>
</ul>

<p><font><font>Można podłączyć narzędzi programistycznych do każdego pracownika, a także wysyłać powiadomień push do pracowników usług.</font></font></p>

<p><img alt="" src="https://mdn.mozillademos.org/files/13058/about-debugging-workers.png" style="display: block; height: 642px; margin-left: auto; margin-right: auto; width: 784px;"></p>

<h3 id="Pracownik_serwisu_stan"><font><font>Pracownik serwisu stan</font></font></h3>

<p><font><font>Z Firefoksa 52, lista pracowników służby pokazuje stan pracownika serwisu w jego </font></font><a href="https://developers.google.com/web/fundamentals/instant-and-offline/service-worker/lifecycle"><font><font>cyklu życia</font></font></a><font><font> . </font><font>Trzy stany wyróżnia się:</font></font></p>

<ul>
 <li><em><font><font>„Rejestrowanie”</font></font></em><font><font> : obejmuje wszystkie stany pomiędzy pracownikiem serwisowego pierwszej rejestracji, a jego przejęcia kontroli stron. </font><font>Oznacza to, że podsumowuje „Instalowanie”, „aktywacji” i „Oczekiwanie”, stwierdza.</font></font></li>
 <li><em><font><font>„Running”</font></font></em><font><font> : pracownik usług jest obecnie uruchomiony. </font><font>Jest zainstalowany i aktywowany, a obecnie obsługi zdarzeń.</font></font></li>
 <li><em><font><font>„Stopped”</font></font></em><font><font> : pracownik usługa jest zainstalowany i aktywowany, ale została rozwiązana po bezczynności.</font></font></li>
</ul>

<p><img alt="" src="https://mdn.mozillademos.org/files/14488/service-worker-status.png" style="display: block; height: 555px; margin-left: auto; margin-right: auto; width: 900px;"></p>

<div class="note">
<p><font><font>Ta sekcja używa prostego ServiceWorker demo, którego gospodarzem w </font></font><a href="https://serviceworke.rs/push-simple/"><font><font>https://serviceworke.rs/push-simple/</font></font></a><font><font> .</font></font></p>
</div>

<h3 id="pracownicy_debugowania"><font><font>pracownicy debugowania</font></font></h3>

<p><font><font>Dla pracownika serwisu, jeśli jest już uruchomiony, zobaczysz dwa przyciski obok niej, oznaczony „Debug” i „push”. </font><font>Jeśli nie jest już uruchomiony, zobaczysz jeden przycisk, oznaczony „Start”: Kliknij, aby rozpocząć pracownika serwisu.</font></font></p>

<p><font><font>Kliknięcie „Debug” łączy debugger JavaScript i konsolę do tego pracownika. </font><font>Można ustawić punkty przerwania, krok za pomocą kodu, obserwować zmienne, ocenić kod i tak dalej:</font></font></p>

<p><font><font>{{EmbedYouTube("Z8ax79sHWDU")}}</font></font></p>

<h3 id="pracownicy_rejestrowanie"><font><font>pracownicy rejestrowanie</font></font></h3>

<p><font><font>Po pierwsze, nie będzie widać żadnych pracowników wymienionych poniżej </font></font><em><font><font>pracownicy usług</font></font></em><font><font> lub </font></font><em><font><font>udostępnionych Pracowników</font></font></em><font><font> . </font><font>Tak szybko, jak pracownik jest zarejestrowany, wykaz jest aktualizowany:</font></font></p>

<p><font><font>{{EmbedYouTube("wy4kyWFhFF4")}}</font></font></p>

<div class="note">
<p><font><font>Przed Firefox 47, pracownicy usług zostały pokazane tylko wtedy, gdy zostały one faktycznie działa.</font></font></p>
</div>

<h3 id="pracownicy_usług_Wyrejestrowywanie"><font><font>pracownicy usług Wyrejestrowywanie</font></font></h3>

<div class="geckoVersionNote">
<p><font><font>Nowy Firefox 48.</font></font></p>
</div>

<p><font><font>Uruchamianie w Firefoksie 48, zobaczysz link o nazwie „wyrejestrować” obok każdego zarejestrowanego pracownika serwisu:</font></font></p>

<p><img alt="" src="https://mdn.mozillademos.org/files/13056/unregister-sw.png" style="display: block; margin-left: auto; margin-right: auto; width: 700px;"></p>

<p><font><font>Kliknij link, aby wyrejestrować pracownika serwisu.</font></font></p>

<h3 id="Wysyłanie_zdarzeń_wypychania_do_pracowników_usług"><font><font>Wysyłanie zdarzeń wypychania do pracowników usług</font></font></h3>

<div class="note">
<p><font><font>Wysyłanie zdarzeń wypychania w about: debugowanie jest nowego w Firefoksie 47.</font></font></p>
</div>

<p><font><font>Do debugowania powiadomień Push, można ustawić punkt przerwania w </font></font><a href="/en-US/docs/Web/API/PushEvent"><font><font>wydarzeniu Push</font></font></a><font><font> słuchacza. </font><font>Jednakże, można również debugować powiadomienia push lokalnie, bez potrzeby serwera. </font><font>Wystarczy kliknąć przycisk „push”, aby wysłać zdarzenie Push pracownikowi serwisu:</font></font></p>

<p><font><font>{{EmbedYouTube ( "62SkLyA-ZnO")}}</font></font></p>

<h3 id="pracownicy_usług_nie_są_kompatybilne"><font><font>pracownicy usług nie są kompatybilne</font></font></h3>

<div>
<p><font><font>Firefox 49+ komunikat ostrzegawczy zostanie wyświetlony w sekcji Obsługa Pracowników strony pracowników, jeżeli pracownicy usług są niezgodne z bieżącej konfiguracji przeglądarki, a zatem nie mogą być używane lub pozbawione błędów.</font></font></p>

<p><img alt="" src="https://mdn.mozillademos.org/files/13613/sw-not-compatible.png" style="display: block; height: 705px; margin: 0px auto; width: 1011px;"></p>
</div>

<p><font><font>pracownicy usług mogą być niedostępne z kilku powodów:</font></font></p>

<ul>
 <li><font><font>Jeśli używasz Prywatna okno przeglądania.</font></font></li>
 <li><font><font>Jeśli preferencji Historia jest ustawiony na „Nigdy nie pamiętał historię” lub „Zawsze używaj trybu przeglądania prywatnego”.</font></font></li>
 <li><font><font>Jeśli </font></font><code>dom.serviceWorkers.enable</code><font><font>preferencji jest ustawiona na false w </font></font><code>about:config</code><font><font>.</font></font></li>
</ul>