Narzędzie pulpitu Konsola umożliwia przechwytywanie danych wynikowych konsoli (tych samych, które są widoczne w programie Qt Creator) z aplikacji AppStudio za pomocą narzędzia pulpitu. Podobnie jak w przypadku konsoli programu Qt Creator, narzędzia Konsola można używać z aplikacją działającą na tym samym komputerze. Może ono również odbierać dane wynikowe z innego urządzenia w tej samej sieci. Jest to idealne rozwiązanie do przechwytywania danych wynikowych konsoli z urządzenia z systemem iOS lub Android i wyświetlania ich na komputerze.
W przypadku uruchomienia aplikacji AppStudio na urządzeniu z systemem Android i jej awarii można pobrać wygenerowane systemowe pliki dziennika w celu przeprowadzenia diagnostyki i rozwiązania problemów. Wymaga to użycia narzędzi SDK systemu Android. Więcej informacji zawiera artykuł bazy wiedzy How to export a crash log (logcat) from an Android device (Jak wyeksportować dziennik awarii (logcat) z urządzenia z systemem Android).
Włączanie narzędzia Konsola
Po uruchomieniu aplikacji ArcGIS AppStudio w wersji 1.2 lub nowszej przycisk Konsola pojawia się na pasku narzędzi u góry aplikacji. Służy on do otwierania narzędzia Konsola.
Notatka:
Aby uzyskać dostęp do tego narzędzia, nie trzeba się logować.
Pomijając szczegóły dotyczące komputera hosta, ta strona jest na razie pusta, ponieważ przed wyświetleniem w konsoli informacji wynikowych należy skierować do niej aplikację. Operację tę można wykonać tylko w aplikacji AppStudio z włączonym rejestrowaniem.
Włączanie rejestrowania w aplikacji AppStudio Player
W przypadku opracowywanych aplikacji lub aplikacji korporacyjnych aplikacja AppStudio Player ma wbudowaną kompatybilność z konsolą. Aby włączyć rejestrowanie w odtwarzaczu, otwórz menu boczne i wybierz opcję Połącz się z konsolą zdalną. Następnie należy wybrać jedną z trzech różnych metod łączenia się z urządzeniem.
- Opcja Skanuj kod QR jest przydatna podczas uruchamiania aplikacji w aplikacji AppStudio Player na urządzeniach mobilnych. Przed zeskanowaniem kodu wybierz adres IP w narzędziu Konsola. Ponieważ system z uruchomioną konsolą AppStudio może mieć przypisane wiele adresów IP, kod QR zostanie wygenerowany dla adresu wybranego z listy rozwijanej i wyświetlony obok. Po kliknięciu tego kodu QR zostanie wyświetlona większa wersja, która jest przydatna, gdy urządzenie nie może zeskanować mniejszego kodu. Zeskanuj wygenerowany kod QR w każdym rozmiarze, aby nawiązać połączenie.
- Opcja Połącz za pośrednictwem sieci umożliwia wybranie obecnie działającej konsoli AppStudio w sieci w celu nawiązania połączenia.
- Opcja Wpisz adres IP powoduje otwarcie nowej strony, na której można ręcznie wpisać adres IP i port, na przykład: syslog://10.112.25.174:514. Aby połączyć się z konsolą, naciśnij przycisk Dalej.
Po zastosowaniu każdej z tych metod wszystkie działania wykonywane w aplikacji AppStudio Player będą wysyłać komunikaty do konsoli na wybranym komputerze.
Rejestrowanie komunikatów w narzędziu Konsola
Po nawiązaniu przez aplikację AppStudio Player połączenia z narzędziem Konsola pole Lokalizacje rejestrowania danych wynikowych zostaje automatycznie zapełnione szczegółami dotyczącymi podłączonego urządzenia.
Konsola na wybranym komputerze natychmiast wyświetli informacje diagnostyczne pochodzące zarówno z aplikacji AppStudio Player, jak i z aplikacji w niej działającej. Komunikaty pochodzące z odtwarzacza można odróżnić od informacji pochodzących z innej aplikacji dzięki informacjom wyświetlanym w kolumnie Aplikacja. Konsola będzie odbierać informacje, dopóki rejestrowanie nie zostanie wyłączone w aplikacji AppStudio Player lub w konsoli nie zostanie kliknięta opcja Zatrzymaj.
Rejestrowanie w innych konsolach w trybie online
Narzędzie Konsola korzysta z protokołu syslog, który jest powszechnie obsługiwaną i kompatybilną metodą rejestrowania informacji w sieci lub w trybie online. Oznacza to, że możliwości rejestrowania aplikacji AppStudio Player i aplikacji obsługujących konsolę mogą być używane do wysyłania komunikatów do innych konsol obsługujących protokół syslog, na przykład Loggly.
W tym celu ręcznie wpisz adres URL lub IP lokalizacji z obsługą protokołu syslog w polu tekstowym Lokalizacja rejestrowania danych wynikowych. Może być również konieczne podanie informacji o identyfikatorze użytkownika. Wpisz je w polu tekstowym Dane użytkownika. Aby dowiedzieć się więcej na temat informacji o identyfikatorze użytkownika oraz konsoli Loggly, zapoznaj się z tematem Dokumentacja konsoli Loggly.
Zapisywanie zarejestrowanych komunikatów konsoli w pliku
Narzędzie Konsola pozwala również eksportować odebrane komunikaty do pliku dziennika, do którego można się później odwołać lub który można wysłać do innych osób. W tym celu kliknij przycisk Zapisz w konsoli podczas rejestrowania lub po jego zakończeniu. Zostanie wyświetlone okno dialogowe, w którym można wybrać nazwę i miejsce docelowe pliku oraz zapisać wyniki jako plik .log.
Dodawanie funkcji kompatybilności z konsolą do aplikacji
Do własnej aplikacji możesz dodać możliwość wyprowadzania komunikatów konsoli. W wersji minimalnej następujący wiersz kodu umożliwi aplikacji wyprowadzanie komunikatów konsoli do zewnętrznego pliku dziennika w domyślnej lokalizacji urządzenia.
AppFramework.logging.enabled = true;
Notatka:
Aby zapewnić, że plik ten będzie mógł zostać utworzony, gdy aplikacja będzie uruchamiana na urządzeniu z systemem Android, w opcji Ustawienia na karcie Funkcje zaznacz opcję Pamięć zewnętrzna.
Więcej szczegółowych przykładów implementacji rejestrowania zawiera szablon korporacyjny aplikacji AppStudio Player dostarczany z aplikacją AppStudio.