Podręcznik użytkownika Anuluj

Debugowanie kodu ActionScript 3.0

Szukaj

Ostatnia aktualizacja 25 maj 2023

Informacje o debugerze kodu ActionScript 3.0

Program Animate zawiera oddzielny debuger kodu ActionScript 3.0, który działa inaczej, niż debuger kodu ActionScript 2.0. Debuger kodu ActionScript 3.0 działa tylko z plikami FLA i AS języka ActionScript 3.0. Pliki FLA muszą mieć skonfigurowane ustawienia publikowania dla wtyczki Flash Player 9. Po zainicjowaniu sesji debugowania kodu ActionScript 3.0 program Animate uruchamia samodzielną, debugującą wersję wtyczki Flash Player, w której jest odtwarzany plik SWF. Debugująca wtyczka Flash Player odtwarza plik SWF w oddzielnym oknie poza oknem aplikacji do tworzenia Animate.

Debuger kodu ActionScript 3.0 konwertuje przestrzeń roboczą programu Animate na przestrzeń roboczą debugowania, w której są wyświetlane panele używane do debugowania. Zawiera ona również panel Operacje i/lub okno Skrypt, konsolę debugowania oraz panel Zmienne. Konsola debugowania zawiera stos wywołań oraz narzędzia do wykonywania skryptów krok po kroku. W panelu Zmienne są wyświetlane bieżące zmienne razem z wartościami. Wartości te można uaktualniać.

Zasoby dodatkowe

Poniższe zasoby zawierają dodatkowe informacje na temat debugowania kodu ActionScript 3.0:

Przechodzenie do trybu debugowania

Metoda rozpoczynania sesji debugowania zależy od typu pliku. W trakcie sesji program Animate może przerwać wykonywanie kodu ActionScript. Dzieje się tak, gdy napotka punkt przerwania lub błąd.

Po rozpoczęciu sesji debugowania program Animate dodaje pewne specjalne informacje do pliku SWF eksportowanego w ramach sesji. Informacje te dotyczą numerów linii kodu, w których wykryto błędy.

Informacje te można dołączać do wszystkich plików SWF, które będą tworzone z danego piku FLA. Dzięki temu będzie istniała możliwość debugowania plików SWF bez uprzedniego inicjowania sesji debugowania. Wskutek dołączenia informacji debugowania plik SWF staje się większy.

Wybieranie domyślnego środowiska debugowania

Wybierz opcję Debugowanie > Debuguj film, a następnie wybierz jedną z następujących opcji:
- Animate
- AIR Debug Launcher (lokalnie)
- AIR Debug Launcher (na urządzeniu)
- Na urządzeniu przez USB (tylko CS5.5)
Wszystkie sesje debugowania będą się odbywały w wybranym środowisku. W dowolnej chwili można zmienić środowisko domyślne.

Uruchamianie debugowania z pliku FLA

Wybierz opcję Debuguj > Debuguj.

(Wersje CS6 i starsze) Wybierz opcję Debuguj > Debuguj film > Debuguj.

Uruchamianie debugowania z pliku ActionScript 3.0 AS

Jeśli plik z kodem ActionScript jest już otwarty w oknie Skrypt, przejdź do menu Cel u góry okna Skrypt i wybierz plik FLA, który powinien zostać użyty do skompilowania pliku z kodem. Aby plik FLA był dostępny w menu, musi być otwarty.
Wybierz opcję Debuguj > Debuguj.

(Wersje CS6 i starsze) Wybierz opcję Debuguj > Debuguj film > Debuguj.

Dodawanie informacji debugowania do wszystkich plików SWF utworzonych z pliku FLA

Gdy plik FLA jest otwarty, wybierz polecenie Plik > Ustawienia publikowania.
W oknie dialogowym Ustawienia publikowania kliknij zakładkę (CS5) lub kategorię (CS5.5).
Zaznacz opcję Pozwól debugować.

Wychodzenie z trybu debugowania

Kliknij przycisk Zakończ sesję debugowania w konsoli debugowania.

Ustawianie i usuwanie punktów przerwania

Punkty przerwania są to specjalne miejsca w kodzie ActionScript, w których program przerywa wykonywanie skryptu. Po przerwaniu wykonywania skryptu można analizować kod i wykonywać go wiersz po wierszu, oglądać różne fragmenty kodu ActionScript, wyświetlać wartości zmiennych i wyrażeń oraz edytować wartości zmiennych.

Punktów przerwania nie można wstawiać w plikach ASC (ActionScript for Communication) ani JSFL (Flash JavaScript).

Ustawianie punktu przerwania

W panelu Operacje lub w oknie Skrypt kliknij lewy margines obok wiersza kodu, gdzie chcesz wstawić punkt przerwania.

Usuwanie punktu przerwania

W panelu Operacje lub w oknie Skrypt kliknij punkt przerwania do usunięcia.

Przechodzenie między wierszami kodu

Jeśli wykonywanie kodu ActionScript zostanie przerwane w punkcie przerwania lub na skutek błędu środowiska wykonawczego, można przejść przez kod wiersz po wierszu. Można przy tym wchodzić w wywołania funkcji lub wykonywać funkcje jako pojedyncze kroki. Może też kontynuować zwykłe wykonywanie kodu.

Wykonywanie kodu linia po linii

Kliknij przycisk Wejdź w konsoli debugowania.

Pomijanie wywołania funkcji

Kliknij przycisk Pomiń w konsoli debugowania.

Wychodzenie z wywołania funkcji

Kliknij przycisk Wyjdź w konsoli debugowania.

Wznowienie normalnego wykonywania kodu

Kliknij przycisk Kontynuuj w konsoli debugowania.

Wyświetlanie i testowanie skryptów na stosie wywołań

Kiedy debuger zatrzyma wykonywanie kodu, można sprawdzić (w konsoli debugowania) stos wywołań i wyświetlić tylko te skrypty, które zawierają funkcje ze stosu. Sos wywołań jest prezentowany w postaci list zagnieżdżonych wywołań funkcji, które czekają na.

Program pozwala wyświetlić skrypty zawierające poszczególne funkcje ze stosu.

W panelu konsoli debugowania kliknij dwukrotnie nazwę skryptu w stosie wywołań.

Wyświetlanie i modyfikowanie wartości zmiennych

Do wyświetlania i modyfikowania wartości zmiennych i właściwości służy panel Zmienne.

Wyświetlanie wartości zmiennej

W panelu Zmienne wybierz typ zmiennych, które chcesz wyświetlić, w menu panelu.
- Pokaż stałe — wyświetla wartości stałe (zmienne o ustalonej wartości).
- Pokaż elementy statyczne — wyświetla zmienne należące do klas, a nie do wystąpień klas.
- Pokaż niedostępne zmienne elementu — wyświetla zmienne niedostępne dla innych klas i przestrzeni nazw. Są to między innymi zmienne chronione, prywatne lub wewnętrzne względem przestrzeni nazw.
- Pokaż dodatkowy wyświetlacz szesnastkowy — dodaje wartości szesnastkowe wszędzie tam, gdzie są wyświetlane wartości dziesiętne. Ta opcja przydaje się głównie w przypadku wartości kolorów. W przypadku wartości dziesiętnych od 0 do 9 wartości szesnastkowe nie są wyświetlane.
- Pokaż nazwy kwalifikowane — wyświetla typy zmiennych z nazwą pakietu i nazwą klasy.
Rozwijaj drzewo struktury obiektów w pliku FLA, aż do pojawienia się pożądanej zmiennej.

Edytowanie wartości zmiennej

W panelu Zmienne kliknij dwukrotnie wartość zmiennej.
Wprowadź nową wartość zmiennej i naciśnij klawisz Enter. Na kolejnych etapach przetwarzania kodu będzie używana już nowa wartość.

Sterowanie ostrzeżeniami kompilatora

Program zapewnia kontrolę nad rodzajem ostrzeżeń generowanych przez kompilator kodu ActionScript i pokazywanych w panelu Błędy kompilatora. Kiedy kompilator zgłasza błąd, wystarczy kliknąć go dwukrotnie, aby przejść do wiersza kodu powodującego wystąpienie błędu.

Wybierz polecenie Plik > Ustawienia publikowania.
Kliknij opcję Animate.
Kliknij przycisk Ustawienia ActionScript.
Zaznacz jedną z opcji obsługi błędów:
- Tryb rygorystyczny — ostrzeżenia będą zgłaszane jako błędy, co oznacza, że w przypadku wystąpienia takich błędów kompilacja zakończy się niepowodzeniem.
- Tryb ostrzeżeń — zgłaszane są dodatkowe ostrzeżenia, które pozwalają wykryć niezgodności przy aktualizowaniu kodu ActionScript 2.0 do wersji ActionScript 3.0.

Przechodzenie do błędów w kodzie

Kiedy program Animate wykryje błąd w kodzie ActionScript (zarówno w trakcie kompilacji, jak i w trakcie wykonywania kodu), zgłasza go w panelu Błędy kompilatora. Z panelu Błędy kompilatora można przejść do wiersza kodu powodującego błąd.

Kliknij dwukrotnie błąd w panelu Błędy kompilatora.

Debugowanie zdalnego pliku SWF języka ActionScript 3.0

W przypadku kodu ActionScript 3.0 zdalny plik SWF można debugować za pomocą samodzielnego debugera, debugera typu ActiveX lub specjalnej wtyczki Debug Flash Player, która znajduje się w katalogu katalog instalacyjny programu Animate/Players/Debug/. Debugowanie zdalne za pomocą debugera kodu ActionScript 3.0 ma jednak pewne ograniczenia. Debugowane pliki muszą znajdować się na tym samym komputerze co aplikacja Animate do projektowania i muszą być odtwarzane za pomocą autonomicznego odtwarzacza z debugerem, formantu ActiveX lub wtyczki.

Aby zezwolić na zdalne debugowanie pliku, należy włączyć debugowanie w ustawieniach publikowania. Opublikowany plik można także zabezpieczyć hasłem, dzięki czemu będą go mogły debugować tylko zaufane osoby.

Podobnie jak w językach JavaScript i HTML użytkownicy skryptów ActionScript mają dostęp do zmiennych klienckich. Aby zmienne te zabezpieczyć, należy wysłać je do aplikacji na serwerze i nie przechowywać ich w pliku. Autor skryptu może zabezpieczyć również inne jego elementy, np. strukturę klipów filmowych. W tym celu musi określić hasło debugowania.

Włączanie zdalnego debugowania pliku SWF i określanie hasła debugowania

W przypadku plików FLA języka ActionScript 3.0 nie można debugować kodu w skryptach klatek. Za pomocą debugera kodu ActionScript 3.0 można debugować tylko kod w zewnętrznych plikach AS.

Otwórz plik FLA.
Wybierz polecenie Plik > Ustawienia publikowania.
W oknie dialogowym Ustawienia publikowania kliknij zakładkę (CS5) lub kategorię (CS5.5), a następnie wybierz opcję Pozwól debugować.
Zamknij okno Ustawienia publikowania i wybierz jedno z następujących poleceń:
- Plik > Eksportuj > Eksportuj film
- Plik > Publikuj
Pozostaw plik SWF na komputerze lokalnym, aby wykonać debugowanie zdalne na hoście lokalnym, albo wyślij plik SWF na serwer internetowy.

Plik SWF nie zawiera żadnych informacji o punktach przerwania, w związku z czym po wysłaniu pliku na serwer zdalny nie będzie możliwości wykonywania kodu krok po kroku. W celu wykonania tego zadania należy użyć hosta lokalnego.
W programie Animate wybierz polecenie Debuguj > Rozpocznij zdalną sesję debugowania > ActionScript 3.0.

Program Animate otworzy debuger kodu ActionScript 3.0 i będzie czekać na połączenie z programem Flash Player. W ciągu 2 minut trzeba będzie uruchomić program Flash Player. Jeśli upłyną więcej niż 2 minuty, powtórz ten krok.
Otwórz plik SWF za pomocą specjalnej wtyczki debugującej do programu Flash Player, formantu ActiveX lub niezależnego odtwarzacza. Niezależny odtwarzacz debugujący znajduje się w katalogu katalog instalacyjny programu Animate/Players/Debug/. Nie należy używać pliku zapisanego na innym komputerze, ponieważ w jego wypadku debuger nie ma dostępu do informacji o punktach przerwania.

Kiedy odtwarzacz debugujący połączy się z panelem debugera kodu ActionScript 3.0 rozpocznie się sesja debugowania.

Debugowanie zdalne nie działa, jeśli dla interfejsu sieciowego środowiska AIR 3.4 wybrano ustawienie Domyślny. Zamiast tego należy wybrać opcje umożliwiające podanie nazwy interfejsu sieciowego i adresu IP komputera.

Aktywowanie debugera z lokalizacji zdalnej

Otwórz aplikację Animate (jeśli nie jest jeszcze otwarta).
Wybierz polecenie Debuguj > Rozpocznij zdalną sesję debugowania > ActionScript 3.0.
W przeglądarce lub niezależnym odtwarzaczu debugującym otwórz plik SWF opublikowany w lokalizacji zdalnej.

Jeśli okno dialogowe debugowania zdalnego nie pojawi się, kliknij prawym przyciskiem myszy (Windows) lub kliknij z naciśniętym klawiszem Control (macOS) w pliku SWF, aby wyświetlić manu kontekstowe, a następnie wybierz polecenie Debuger.
W oknie dialogowym Zdalne debugowanie wybierz opcję Host lokalny, a następnie wybierz plik do otwarcia.

W debugerze pojawi się lista wyświetlania pliku SWF. Jeśli plik SWF nie będzie odtwarzany, może to oznaczać, że debuger został wstrzymany. Wówczas należy kliknąć przycisk Kontynuuj.

Pomoc dostępna szybciej i łatwiej

Nowy użytkownik?