Gdy uruchamiasz, debugujesz lub testujesz kod, Android Studio używa konfiguracji uruchamiania/debugowania, by określić sposób wykonywania tej operacji. Zwykle do uruchamiania lub debugowania aplikacji wystarcza początkowa konfiguracja. Możesz jednak zmieniać i tworzyć nowe konfiguracje, a także modyfikować szablony, aby dostosować je do swojego procesu programowania, jak opisano na tej stronie.
Więcej informacji znajdziesz w tej dokumentacji IntelliJ:
Informacje o konfiguracjach uruchamiania/debugowania
Konfiguracje uruchamiania i debugowania określają szczegóły, takie jak instalacja, uruchamianie i testowanie aplikacji. Możesz zdefiniować konfigurację do jednorazowego użycia lub zapisać ją na przyszłość. Po zapisaniu możesz ją wybrać na liście Wybierz konfigurację uruchamiania/debugowania na pasku narzędzi. Android Studio zapisuje konfiguracje w ramach projektu.
Początkowo utworzona konfiguracja uruchamiania/debugowania
Gdy tworzysz projekt po raz pierwszy, Android Studio tworzy konfigurację uruchamiania/debugowania dla głównego działania na podstawie szablonu aplikacji na Androida. Aby uruchomić lub debugować projekt, musisz zawsze mieć zdefiniowaną co najmniej 1 konfigurację uruchamiania/debugowania. Z tego powodu odradzamy usuwanie konfiguracji utworzonej na początku.
Zakres projektu i kontrola wersji
Konfiguracje uruchamiania i debugowania oraz zmiany w szablonach mają zastosowanie tylko do bieżącego projektu. W systemie kontroli wersji możesz udostępnić konfigurację uruchamiania/debugowania (ale nie szablon). Więcej informacji na temat udostępniania konfiguracji znajdziesz w sekcji Nazwa i udostępnianie opcji konfiguracji.
Otwórz okno konfiguracji uruchamiania/debugowania
Aby otworzyć okno konfiguracji uruchamiania/debugowania, wybierz Uruchom > Edytuj konfiguracje. Pojawi się okno Konfiguracje uruchamiania/debugowania, tak jak pokazano na rysunku 1.
W lewym panelu okna zobaczysz zdefiniowane konfiguracje według typu szablonu. U dołu możesz edytować szablony konfiguracji. Możesz edytować wybraną konfigurację w panelu po prawej stronie. Zmień rozmiar okna, aby zobaczyć wszystkie ukryte elementy.
W tym oknie możesz:
- Utwórz nowe konfiguracje uruchamiania/debugowania.
- Edytuj konfiguracje uruchamiania/debugowania.
- Edytowanie szablonów konfiguracji
- Sortowanie i grupowanie konfiguracji.
Utwórz nową konfigurację uruchamiania/debugowania
Nowe konfiguracje uruchamiania i debugowania możesz zdefiniować w oknie Uruchamianie/debugowanie konfiguracji, oknie Projekt lub edytorze kodu. Nowa konfiguracja musi być oparta na szablonie konfiguracji.
W oknie konfiguracji uruchamiania/debugowania wyświetlane są konfiguracje uruchamiania/debugowania oraz dostępne szablony konfiguracji. Nową konfigurację możesz rozpocząć bezpośrednio z szablonu lub od kopii innej konfiguracji. Następnie możesz zmienić wartości pól według potrzeb.
Możesz też kliknąć prawym przyciskiem myszy element w oknie Projekt, aby automatycznie utworzyć dla niego konfigurację. Jeśli na przykład chcesz uruchomić konkretne działanie, możesz kliknąć prawym przyciskiem myszy plik aktywności i wybrać Uruchom. W zależności od produktu Android Studio tworzy konfigurację na podstawie szablonu konfiguracji aplikacji na Androida, testów instrumentowanych na Androida lub JUnit.
W edytorze kodu możesz łatwo utworzyć konfigurację do testów i uruchamiania/debugowania dla klasy lub metody, a następnie ją wykonać.
Konfiguracja utworzona poza oknem Uruchamianie/debugowanie ma charakter tymczasowy, chyba że ją zapiszesz. Domyślnie możesz mieć w projekcie maksymalnie 5 konfiguracji tymczasowych, zanim Android Studio zacznie je usuwać. Aby zmienić to ustawienie domyślne, otwórz ustawienia Android Studio i zmień Ustawienia zaawansowane > Uruchom/debugowanie > Limit konfiguracji tymczasowych. Więcej informacji o konfiguracjach tymczasowych znajdziesz w artykule Tworzenie i zapisywanie konfiguracji tymczasowego uruchamiania/debugowania.
Rozpoczynanie konfiguracji na podstawie szablonu
Aby zdefiniować konfigurację uruchamiania/debugowania na podstawie szablonu:
- Otwórz okno Run/Debug Configurations (Konfiguracje uruchamiania/debugowania).
- Kliknij Add New Configuration (Dodaj nową konfigurację) .
- Wybierz szablon konfiguracji.
- Wpisz nazwę w polu Nazwa.
- W razie potrzeby zmodyfikuj konfigurację.
- Kliknij Zastosuj lub OK.
Popraw wszystkie błędy, które wyświetlają się na dole okna.
Rozpoczynanie konfiguracji od kopii
Aby zdefiniować konfigurację uruchamiania/debugowania, rozpoczynając od kopii innej konfiguracji, wykonaj te czynności:
- Otwórz okno Run/Debug Configurations (Konfiguracje uruchamiania/debugowania).
- W lewym panelu wybierz istniejącą konfigurację uruchamiania/debugowania.
- Kliknij Kopiuj konfigurację .
- Wpisz nazwę w polu Nazwa.
- W razie potrzeby zmodyfikuj konfigurację.
- Kliknij Zastosuj lub OK.
Popraw wszystkie błędy wyświetlane u dołu okna.
Zdefiniuj konfigurację elementu w projekcie.
Android Studio może utworzyć konfigurację uruchamiania/debugowania dla niektórych elementów wyświetlanych w oknie Projekt. Konfiguracja opiera się na szablonie konfiguracji w następujący sposób:
- Plik Java aktywności: szablon aplikacji na Androida.
- Pakiet: testy instrumentalne na Androida lub szablon Android JUnit w zależności od zestawu źródeł. Jeśli wybierzesz test instruktażowy, użyjemy szablonu testów z instrumentacją na Androida. Jeśli wybierzesz test jednostki lokalnej, zostanie użyty szablon JUnit Androida. W przypadku testu jednostki lokalnej możesz opcjonalnie uruchomić go z pokryciem kodu. Więcej informacji znajdziesz w sekcji Zasięg kodu.
Aby utworzyć konfigurację uruchamiania/debugowania dla elementu w projekcie, wykonaj te czynności:
- Otwórz projekt w widoku Androida lub projektu.
- W oknie Projekt kliknij prawym przyciskiem myszy element, który można przetestować, i wybierz Uruchom filename lub Debuguj filename. Android Studio utworzy tymczasową konfigurację uruchamiania/debugowania i uruchamia aplikację.
- Otwórz listę Wybierz konfigurację uruchamiania/debugowania na pasku narzędzi.
- Wybierz Save Configuration (Zapisz konfigurację) spośród opcji obok konfiguracji, którą chcesz zapisać.
Uwaga: jeśli klikniesz prawym przyciskiem myszy i uruchomisz lub zdebugujesz ten sam element (ale nie działanie), Android Studio utworzy nową konfigurację.
określić konfigurację testową dla klasy lub metody,
Android Studio pozwala zdefiniować i wykonać konfigurację uruchomienia testowego dla klasy lub metody. Jeśli na przykład utworzysz nową klasę, możesz utworzyć i przeprowadzić jej test. Jeśli testy zakończą się powodzeniem, możesz uruchomić testy pozostałej części projektu, aby sprawdzić, czy nowy kod nie narusza niczego w innych miejscach.
Android Studio używa szablonu Android Instrumented Tests lub Android JUnit, w zależności od zestawu źródłowego. W przypadku testu jednostki lokalnej możesz opcjonalnie uruchomić go z pokryciem kodu.
Aby utworzyć konfigurację uruchamiania/debugowania dla klasy lub metody w kodzie Java, wykonaj te czynności:
- Otwórz projekt w widoku Androida lub projektu.
- W edytorze kodu otwórz plik Java.
- Wybierz klasę lub metodę w kodzie, a następnie naciśnij Control+Shift+T (Command+Shift+T).
- W wyświetlonym menu wybierz Create New Test (Utwórz nowy test).
- W oknie Utwórz test opcjonalnie zmień lub ustaw wartości i kliknij OK.
- W oknie Choose Target Directory (Wybierz katalog docelowy) wskaż w projekcie miejsce, w którym Android Studio ma przeprowadzić test. Możesz określić lokalizację według struktury katalogów lub wybierając sąsiednią klasę.
- Kliknij OK.
Nowy test pojawi się w oknie Projekt w odpowiednim zbiorze źródłowym.
- Aby przeprowadzić test, wykonaj jedną z tych czynności:
- W oknie Projekt kliknij test prawym przyciskiem myszy i wybierz Uruchom lub Debuguj.
- W edytorze kodu kliknij prawym przyciskiem definicję klasy lub nazwę metody w pliku testowym i wybierz Uruchom lub Debuguj, aby przetestować wszystkie metody klasy.
- Otwórz listę Wybierz konfigurację uruchamiania/debugowania na pasku narzędzi.
- Wybierz Save Configuration (Zapisz konfigurację) spośród opcji obok konfiguracji, którą chcesz zapisać.
Uruchamianie lub debugowanie aplikacji przy użyciu zapisanej konfiguracji
Jeśli masz zapisaną konfigurację uruchamiania/debugowania, możesz ją wybrać przed uruchomieniem lub debugowaniem aplikacji.
Aby użyć zapisanej konfiguracji uruchamiania/debugowania, wykonaj te czynności:
- Wybierz konfigurację do uruchamiania/debugowania z listy Wybierz konfigurację uruchamiania/debugowania na pasku narzędzi.
- Wybierz Uruchom > Uruchom lub Uruchom > Debuguj.
Lista znajduje się po lewej stronie opcji Uruchom i Debuguj , np. .
Możesz też kliknąć Uruchom lub Debuguj .
Edytuj konfigurację uruchamiania/debugowania
Aby edytować konfigurację uruchamiania/debugowania, wykonaj te czynności:
- Otwórz okno Run/Debug Configurations (Konfiguracje uruchamiania/debugowania).
- W panelu po lewej stronie wybierz konfigurację.
- W razie potrzeby zmodyfikuj konfigurację.
- Kliknij Zastosuj lub OK.
Popraw wszystkie błędy wyświetlane u dołu okna.
Edytuj szablon konfiguracji uruchamiania/debugowania
Szablony konfiguracji dostarczane przez Android Studio możesz edytować, aby dostosować je do swojego procesu programowania. Gdy edytujesz szablon, nie ma to wpływu na istniejące konfiguracje, które z niego korzystają. Jeśli np. musisz utworzyć kilka konfiguracji określonego typu, możesz edytować szablon, a potem wrócić do niego z powrotem.
Nie możesz tworzyć nowych szablonów, ale możesz tworzyć konfiguracje, aby używać funkcji podobnych do szablonów. Możesz skopiować konfigurację i zmodyfikować kopię, aby utworzyć nowe konfiguracje.
Aby edytować szablon:
- Otwórz okno Run/Debug Configurations (Konfiguracje uruchamiania/debugowania).
- Kliknij Edytuj szablony konfiguracji...
- Wybierz szablon konfiguracji.
- W razie potrzeby zmodyfikuj konfigurację.
- Kliknij Zastosuj lub OK.
Popraw wszystkie błędy wyświetlane u dołu okna.
Sortowanie i grupowanie
W oknie Konfiguracje uruchamiania/debugowania możesz uporządkować konfiguracje, by szybko je znaleźć. Możesz sortować elementy w folderze alfabetycznie i tworzyć nowe foldery, aby grupować konfiguracje.
Aby posortować konfiguracje alfabetycznie, wykonaj te czynności:
- Otwórz okno Run/Debug Configurations (Konfiguracje uruchamiania/debugowania).
- Wybierz folder zawierający konfiguracje.
- Kliknij Konfiguracje sortowania .
- Kliknij OK, aby zamknąć okno.
Aby pogrupować konfiguracje w folderach, wykonaj te czynności:
- Otwórz okno Run/Debug Configurations (Konfiguracje uruchamiania/debugowania).
- Wybierz folder zawierający konfiguracje.
- Kliknij Utwórz nowy folder .
- Wpisz nazwę w polu Nazwa folderu.
- Aby zapisać nazwę, kliknij Zastosuj.
Definiowanie działań przed wprowadzeniem na rynek
Możesz określić zadania do wykonania przed zastosowaniem konfiguracji uruchamiania/debugowania. Zadania są wykonywane w kolejności, w jakiej znajdują się na liście.
Uwaga: określanie zadań przed uruchomieniem kampanii jest funkcją zaawansowaną. Zamiast korzystać z tej funkcji zalecamy umieszczanie wszystkich logiki przygotowań jako zadań w pliku build.gradle
, aby były one wykonywane przy kompilowaniu z poziomu wiersza poleceń.
Aby utworzyć listę zadań, wykonaj te czynności:
- Na dole okna Konfiguracje uruchamiania/debugowania w sekcji Przed uruchomieniem (konieczne może być przewinięcie strony w dół) kliknij Dodaj i wybierz typ zadania. Jeśli otworzy się okno, wypełnij pola i kliknij OK.
- W razie potrzeby dodaj więcej zadań.
- Aby zmienić kolejność zadań, przeciągnij je lub wybierz zadanie i kliknij w górę lub w dół , aby przenieść je w górę lub w dół listy.
- Wybierz Pokaż tę stronę, jeśli chcesz wyświetlić ustawienia konfiguracji uruchamiania/debugowania, zanim je zastosujesz.
Domyślnie ta opcja jest odznaczona.
- Wybierz Okno aktywnego narzędzia, jeśli chcesz, aby okno narzędzia Uruchom lub Debuguj było aktywowane podczas uruchamiania lub debugowania aplikacji.
Ta opcja jest domyślnie wybrana.
Aby usunąć zadanie z listy, wykonaj te czynności:
- Wybierz zadanie.
- Kliknij Usuń .
Aby edytować zadanie, wykonaj te czynności:
- Wybierz zadanie.
- Kliknij Edytuj .
- Edytuj ustawienia zadania w otwartym oknie dialogowym, a następnie kliknij OK.
Tabela poniżej zawiera listę dostępnych zadań, które możesz dodać.
Zadanie | Opis |
---|---|
Uruchom narzędzie zewnętrzne | Uruchomienie aplikacji spoza Android Studio. W oknie External Tools (Narzędzia zewnętrzne) wybierz co najmniej jedną aplikację, którą chcesz uruchomić, a następnie kliknij OK. Jeśli aplikacji nie zdefiniowano w Android Studio, dodaj jej definicję w oknie Utwórz narzędzia. Więcej informacji znajdziesz w sekcjach Konfigurowanie narzędzi innych firm i Narzędzia zewnętrzne. |
Uruchom kolejną konfigurację | Wykonaj jedną z istniejących konfiguracji uruchamiania/debugowania. W oknie Wybierz konfigurację do wykonania wybierz konfigurację do wykonania i kliknij OK. |
Twórz | Skompiluj projekt lub moduł. Android Studio wykonuje polecenie MakeModule, jeśli konfiguracja uruchamiania/debugowania określa konkretny moduł, lub wykonuje polecenie Make Project, jeśli nie określono żadnych modułów. |
Utwórz projekt | Skompilować projekt. Android Studio wykonuje polecenie Create Project. |
Wykonywanie, bez sprawdzania błędów | Ta opcja jest taka sama jak w funkcji Make, z tym wyjątkiem, że Android Studio wykonuje konfigurację uruchamiania/debugowania niezależnie od wyniku kompilacji. |
Artefakty kompilacji | Nieobsługiwane w Android Studio. |
Uruchom zadanie Gradle | Uruchom zadanie Gradle. W oknie, które się otworzy, określ szczegóły i kliknij OK. Więcej informacji znajdziesz w sekcji Gradle. |
Tworzenie zależne od Gradle | Skompiluj projekt i uruchom Gradle. |
Kreator Gradle w App Engine | Zadanie montera Gradle w App Engine synchronizuje projekt, a następnie kompilowa moduł. |
Szablony konfiguracji
Android Studio udostępnia szablony konfiguracji, które ułatwiają szybkie rozpoczęcie pracy. W sekcjach poniżej opisano szablony przeznaczone do tworzenia aplikacji na Androida za pomocą Android Studio:
- Aplikacja na Androida
- Testy Androida
- App Engine DevAppServer
- Widżet na Wear OS, kafelek i tarcza zegarka
Uwaga: Android Studio w wersji 2.1.x i starszych miał szablon aplikacji natywnej, którego nie ma w nowszych wersjach. Jeśli masz w projekcie szablon aplikacji natywnej, Android Studio podczas jego wczytywania przekształci go w aplikację na Androida. Okno Konwertuj projekt przeprowadzi Cię przez cały proces.
Nieobsługiwane szablony
Podane niżej nieobsługiwane szablony pochodzą z platformy IntelliJ IDEA i nie są związane z programowaniem Androida w Android Studio. Informacje o korzystaniu z tych szablonów znajdziesz w dokumentacji IntelliJ IDEA.
- Aplikacja
- Kombinacja
- Gradle
- Groovy
- Aplikacja JAR
- Jawa – Scratch
- JUnit
- Kotlin
- Skrypt Kotlin
- Debugowanie zdalne
- Skrypt powłoki
- TestNG
Typowe opcje konfiguracji
Opcje Nazwa, Zezwalaj na uruchamianie równoległe i Zapisz jako plik projektu są wspólne dla wielu szablonów konfiguracji. Więcej informacji na ten temat znajdziesz w artykule Ustawienia wspólne.
Android Studio przechowuje udostępnianą konfigurację uruchamiania/debugowania w poszczególnych plikach XML w folderze project_directory/.idea/runConfigurations/
.
Więcej informacji znajdziesz w sekcji o formacie na podstawie katalogu w dokumentacji projektów IntelliJ.
Aplikacja na Androida
Możesz uruchamiać lub debugować aplikacje i aktywności na Androida na urządzeniach wirtualnych lub sprzętowych, korzystając z konfiguracji opartych na tym szablonie.
Karta Ogólne
Na karcie Ogólne możesz określić opcje instalacji, uruchamiania i wdrażania. Karta Inne zawiera też opcje instalacji.
Zaawansowana | Opis |
---|---|
Moduł | Wybierz moduł, do którego chcesz zastosować tę konfigurację. |
Opcje instalacji: wdrożenie | Wybierz opcję:
|
Opcje instalacji: wdrażanie jako aplikacji błyskawicznej | Jeśli Twoja aplikacja obsługuje aplikacje błyskawiczne, czyli dodajesz obsługę aplikacji błyskawicznych podczas tworzenia nowego projektu lub tworzysz co najmniej 1 moduł funkcji z obsługą wersji błyskawicznej, możesz wdrożyć te moduły, zaznaczając pole Wdróż jako aplikację błyskawiczną. |
Opcje instalacji: funkcje do wdrożenia |
Jeśli aplikacja zawiera moduły funkcji, zaznacz pole obok każdej funkcji, którą chcesz uwzględnić podczas wdrażania aplikacji. Ta opcja jest widoczna tylko wtedy, gdy aplikacja zawiera moduły funkcji.
Uwaga: jeśli chcesz przetestować pobieranie i instalowanie modułów funkcji na żądanie, musisz to zrobić po opublikowaniu pakietu aplikacji, a potem przy użyciu ścieżki testu wewnętrznego Konsoli Play. Więcej informacji znajdziesz w artykule Przesyłanie pakietu aplikacji do Konsoli Play. |
Opcje instalacji: zainstaluj flagi | Wpisz opcje adb pm
install , których chcesz użyć. Sformatuj opcje w taki sam sposób jak w wierszu poleceń, ale bez ścieżki. Oto przykłady:
i
Domyślnie: brak opcji. |
Opcje uruchamiania: Uruchom | Wybierz opcję:
|
Opcje uruchamiania: flagi uruchamiania | Wpisz opcje adb am
start , których chcesz użyć. Sformatuj opcje w taki sam sposób jak w wierszu poleceń, ale bez intencji. Na przykład:
Ta opcja nie pojawi się, jeśli dla opcji Uruchom wybierzesz wartość Brak. Domyślnie: brak opcji. |
Opcje miejsca docelowego wdrożenia: cel | Wybierz opcję:
|
Opcje celu wdrożenia: używaj tego samego urządzenia przy kolejnych uruchomieniach |
Domyślnie ta opcja jest odznaczona. Przy każdym uruchomieniu aplikacji pojawia się okno Wybierz wdrożenie, w którym możesz wybrać urządzenie. Gdy wybierzesz tę opcję i uruchomisz aplikację, pojawi się okno Wybierz wdrożenie, w którym możesz wybrać urządzenie. Następnie przy każdym uruchomieniu aplikacji będzie się ona uruchamiać na wybranym urządzeniu bez wyświetlania okna Wybierz wdrożenie. Aby uruchomić aplikację na innym urządzeniu, odznacz pole Użyj tego samego urządzenia przy kolejnych wersjach lub zatrzymaj aplikację, klikając Uruchom > Zatrzymaj app lub Zatrzymaj , a potem uruchom ją ponownie. Pojawi się okno Wybierz wdrożenie, w którym możesz wybrać urządzenie. |
Przed wdrożeniem | Zapoznaj się z sekcją Definiowanie operacji przed uruchomieniem. |
Karta Inne
Na karcie Inne możesz określić opcje logcat, instalacji, uruchamiania i wdrażania. Karta Ogólne zawiera też opcje instalacji.
Zaawansowana | Opis |
---|---|
Logcat: pokazuj automatycznie logcat | Gdy wybierzesz tę opcję, za każdym razem, gdy wdrożysz i uruchomisz aplikację korzystającą z tej konfiguracji, będzie się otwierać okno Logcat. Domyślnie: wybrano. |
Logcat: wyczyść dziennik przed uruchomieniem | Wybierz tę opcję, jeśli chcesz, aby przed uruchomieniem aplikacji Android Studio usuwał z pliku dziennika dane z poprzednich sesji. Domyślnie: niezaznaczone. |
Opcje instalacji: pomiń instalację, jeśli plik APK nie został zmieniony. | Gdy wybierzesz tę opcję, Android Studio nie będzie ponownie wdrażać pakietu APK, jeśli wykryje, że nie uległ on zmianie. Jeśli chcesz, aby Android Studio wymuszał instalację pliku APK, nawet jeśli nie uległ on zmianie, odznacz tę opcję. Domyślnie: wybrane |
Opcje instalacji: przed uruchomieniem działania wymuszaj zatrzymanie aplikacji | Jeśli wybierzesz tę opcję, gdy Android Studio wykryje, że nie trzeba ponownie instalować pakietu APK, ponieważ ten plik APK nie został zmieniony, wymusi zatrzymanie aplikacji, tak aby uruchamiała się od domyślnego działania programu uruchamiającego. Jeśli ta opcja nie jest zaznaczona, Android Studio nie wymusza zatrzymania aplikacji. Ta opcja działa z poprzednią opcją, która określała, czy pakiet APK jest zainstalowany czy nie. W obu polach Opcje instalacji pozostaw wartości domyślne, chyba że chcesz za każdym razem wymuszać instalację. W niektórych przypadkach warto usunąć zaznaczenie tej opcji. Jeśli na przykład piszesz mechanizm metody wprowadzania (IME), wymuszenie zatrzymania aplikacji odznacza ją jako obecną klawiaturę, co może być niepożądane. Domyślnie: wybrane |
Przed wdrożeniem | Patrz Definiowanie operacji przed uruchomieniem. |
Karta Debuger
Opcje debugowania możesz określić na karcie Debuger.
W przypadku kodów C i C++ Android Studio używa debugera LLDB. Oprócz zwykłego interfejsu Android Studio okno debugera zawiera kartę LLDB, na której możesz wpisywać polecenia LLDB podczas debugowania. Możesz wpisywać te same polecenia, których Android Studio używa do wyświetlania informacji w interfejsie debugera, a także wykonywać dodatkowe operacje.
W przypadku projektów w językach C i C++ na karcie Debugger możesz dodawać katalogi symboli, a także uruchamianie LLDB i wysyłanie poleceń. Aby to zrobić, użyj przycisków podobnych do tych:
- Dodaj – dodaj katalog lub polecenie.
- Usuń – Wybierz katalog lub polecenie, a następnie kliknij ten przycisk, aby usunąć element.
- W górę – Wybierz katalog lub polecenie, a następnie kliknij ten przycisk, aby przenieść element w górę listy.
- W dół – wybierz katalog lub polecenie, a następnie kliknij ten przycisk, aby przenieść element w dół na liście.
Więcej informacji o debugowaniu w Android Studio znajdziesz w artykule Debugowanie aplikacji.
Zaawansowana | Opis |
---|---|
Typ debugowania | Wybierz jedną z tych opcji:
Opcja Wykryj automatycznie jest zalecana, ponieważ pozwala wybrać właściwy typ debugowania dla Twojego projektu. |
Katalogi symboli | Jeśli chcesz dodać pliki symboli, by przekazać debugerowi informacje w języku C lub C++ wygenerowane poza Android Studio, możesz tutaj dodać jeden lub więcej katalogów. Android Studio preferuje używanie dowolnych plików z tych katalogów, a nie plików generowanych za pomocą wtyczki Android do obsługi Gradle. Debuger przeszukuje katalogi kolejno od góry do dołu, aż znajdzie potrzebne informacje. Przeszukuje rekurencyjnie pliki w katalogu. Aby zoptymalizować listę i zaoszczędzić czas, umieść najczęściej używane katalogi na jej początku. Jeśli określisz katalog wysoko w drzewie, przeszukanie wszystkich podkatalogów może potrwać dłużej. Jeśli dodasz określony katalog, wyszukiwanie zajmie mniej czasu. Musisz znaleźć równowagę między szybkością działania a znajdowaniem plików potrzebnych do debugowania. Jeśli na przykład masz katalog zawierający podkatalogi różnych interfejsów binarnych Androida (ABI), możesz dodać katalog dla określonego interfejsu ABI lub wszystkich interfejsów ABI. Chociaż przeszukiwanie katalogu najwyższego poziomu może potrwać dłużej, jest bardziej niezawodne, jeśli zdecydujesz się debugować na innym urządzeniu. Pamiętaj, że nie musisz dodawać katalogów zawierających pliki symboli Gradle, ponieważ debuger używa ich automatycznie. |
Polecenia startowe LLDB | Dodaj polecenia LLDB, które chcesz wykonać, zanim debuger dołączy do procesu. Możesz na przykład zdefiniować ustawienia środowiska zgodnie z tym poleceniem:
LLDB wykonuje polecenia w kolejności od góry do dołu. |
Polecenia LLDB po dołączeniu | Dodaj polecenia LLDB, które chcesz wykonać zaraz po podłączeniu debugera do procesu. Na przykład:
LLDB wykonuje polecenia w kolejności od góry do dołu. |
Katalog roboczy hosta | Określ katalog roboczy LLDB. |
Logowanie: kanały docelowe | Określ opcje logu LLDB. Android Studio ustawia opcje domyślne na podstawie doświadczenia zespołu, więc nie działa zbyt wolno, ale zawiera informacje potrzebne do rozwiązywania problemów. Dziennik jest często używany w przypadku raportów o błędach w Android Studio. Domyślne ustawienie to
Aby zebrać więcej informacji, możesz zmienić ustawienie domyślne. Na przykład te opcje logu zbierają informacje o konkretnym lldb process
platform:gdb-remote packets
Aby zobaczyć pełną listę poleceń logu, wpisz polecenie
Android Studio umieszcza dzienniki urządzenia w tym miejscu, gdzie
Jeśli wielu użytkowników ma dostęp do urządzenia, logi są umieszczane w tej lokalizacji, gdzie
Informacje o używaniu LLDB do debugowania zdalnego znajdziesz w artykule Zdalne debugowanie. |
Przed wdrożeniem | Zapoznaj się z sekcją Definiowanie operacji przed uruchomieniem. |
Karta Profilowanie
Jeśli masz urządzenie z Androidem 7.1 lub starszym, musisz zaznaczyć opcję Włącz zaawansowane profilowanie, aby włączyć określone funkcje programu profilującego Androida.
Testy Androida
Szablon testowy, którego należy użyć, zależy od zbioru źródłowego. Szablon testów z instrumentacją na Androidzie służy do testów instruktażowych. Szablon JUnit Androida służy do testowania jednostek lokalnych.
Uwaga: jeśli używasz Laboratorium Firebase do testowania na różnych urządzeniach, możesz zdefiniować testy za pomocą szablonu JUnit na Androida. Więcej informacji znajdziesz w artykule Przeprowadzanie testów w Laboratorium Firebase.
Poniższe opisy kart zawierają informacje o kartach i polach szablonu testu z instrumentacją na Androidzie. Informacje o kartach i polach szablonu testowego Androida JUnit znajdziesz na stronie IntelliJ Run/Debug Configuration: JUnit (Konfiguracja uruchamiania/debugowania: JUnit).
Karta Ogólne
Na karcie Ogólne możesz określić lokalizację testową, aplikację uruchamiającą instrument, powłokę adb i opcje wdrażania.
Zaawansowana | Opis |
---|---|
Moduł | Wybierz moduł, do którego chcesz zastosować tę konfigurację. |
Testowanie | W tym obszarze określ lokalizację testów, które chcesz przeprowadzić:
|
Uruchomienie konkretnej instrumentacji (opcjonalnie) | Wpisz lokalizację bieguna instrumentu. Kliknij Więcej, aby otworzyć okno. Plik build.gradle określa lokalizację mechanizmu uruchamiania narzędzi. Ta wartość ją zastępuje. Wartość domyślna to zwykle klasa AndroidJUnitRunner z narzędzia AndroidX Test.
|
Opcje dodatkowe | Wpisz opcje adb Wartość domyślna: brak opcji |
Opcje miejsca docelowego wdrożenia: cel | Wybierz opcję:
|
Opcje celu wdrożenia: używaj tego samego urządzenia przy kolejnych uruchomieniach | Wybierz tę opcję, jeśli w przyszłości chcesz automatycznie używać urządzenia wybranego w oknie Wybierz cel wdrożenia. Jeśli urządzenie będzie niedostępne, pojawi się okno dialogowe. Domyślnie: odznaczone |
Przed wdrożeniem | Zapoznaj się z sekcją Definiowanie operacji przed uruchomieniem. |
Karta Inne
Karta Miscellaneous (Różne) zawiera opcje logcat oraz opcje instalacji.
Zaawansowana | Opis |
---|---|
Logcat: wyczyść dziennik przed uruchomieniem | Wybierz tę opcję, jeśli chcesz, aby przed uruchomieniem aplikacji Android Studio usuwał z pliku dziennika dane z poprzednich sesji. Domyślnie: niezaznaczone. |
Opcje instalacji: Pomiń instalację, jeśli plik APK nie został zmieniony | Gdy wybierzesz tę opcję, Android Studio nie będzie ponownie wdrażać pakietu APK, jeśli wykryje, że nie uległ on zmianie. Jeśli chcesz, by Android Studio wymuszał instalację pliku APK, nawet jeśli nie uległ on zmianie, odznacz tę opcję. Domyślnie: wybrane |
Opcje instalacji: przed uruchomieniem działania wymuszaj zatrzymanie aplikacji | Jeśli wybierzesz tę opcję, gdy Android Studio wykryje, że nie trzeba ponownie instalować pakietu APK, ponieważ ten plik APK nie został zmieniony, wymusi zatrzymanie aplikacji, tak aby uruchamiała się od domyślnego działania programu uruchamiającego. Jeśli ta opcja nie jest zaznaczona, Android Studio nie wymusza zatrzymania aplikacji. Działa ona w połączeniu z poprzednią opcją, która określa, czy pakiet APK jest zainstalowany. W obu polach Opcje instalacji pozostaw wartości domyślne, chyba że chcesz za każdym razem wymuszać instalację. W niektórych przypadkach warto usunąć zaznaczenie tej opcji. Jeśli na przykład piszesz mechanizm metody wprowadzania (IME), wymuszenie zatrzymania aplikacji odznacza ją jako obecną klawiaturę, co może być niepożądane. Domyślnie: wybrane |
Przed wdrożeniem | Zapoznaj się z sekcją Definiowanie operacji przed uruchomieniem. |
Karta Debuger
Opcje debugowania możesz określić na karcie Debuger.
W przypadku kodów C i C++ Android Studio używa debugera LLDB. Oprócz zwykłego interfejsu Android Studio okno debugera zawiera kartę LLDB, na której możesz wpisywać polecenia LLDB podczas debugowania. Możesz wpisywać te same polecenia, których Android Studio używa do wyświetlania informacji w interfejsie debugera, a także wykonywać dodatkowe operacje.
W przypadku projektów w językach C i C++ na karcie Debugger możesz dodawać katalogi symboli, a także uruchamianie LLDB i wysyłanie poleceń. Aby to zrobić, użyj przycisków podobnych do tych:
- Dodaj – dodaj katalog lub polecenie.
- Usuń – Wybierz katalog lub polecenie, a następnie kliknij ten przycisk, aby usunąć element.
- W górę – Wybierz katalog lub polecenie, a następnie kliknij ten przycisk, aby przenieść element w górę listy.
- W dół – wybierz katalog lub polecenie, a następnie kliknij ten przycisk, aby przenieść element w dół na liście.
Więcej informacji o debugowaniu w Android Studio znajdziesz w artykule Debugowanie aplikacji.
Zaawansowana | Opis |
---|---|
Typ debugowania | Wybierz jedną z tych opcji:
Opcja Wykryj automatycznie jest zalecana, ponieważ pozwala wybrać właściwy typ debugowania dla Twojego projektu. |
Katalogi symboli | Jeśli chcesz dodać pliki symboli, by przekazać debugerowi informacje w języku C lub C++ wygenerowane poza Android Studio, możesz tutaj dodać jeden lub więcej katalogów. Android Studio preferuje używanie dowolnych plików z tych katalogów, a nie plików generowanych za pomocą wtyczki Android do obsługi Gradle. Debuger przeszukuje katalogi kolejno od góry do dołu, aż znajdzie potrzebne informacje. Przeszukuje rekurencyjnie pliki w katalogu. Aby zoptymalizować listę i zaoszczędzić czas, umieść najczęściej używane katalogi na jej początku. Jeśli określisz katalog wysoko w drzewie, przeszukanie wszystkich podkatalogów może potrwać dłużej. Jeśli dodasz określony katalog, wyszukiwanie zajmie mniej czasu. Musisz znaleźć równowagę między szybkością działania a znajdowaniem plików potrzebnych do debugowania. Jeśli na przykład masz katalog zawierający podkatalogi różnych interfejsów binarnych Androida (ABI), możesz dodać katalog dla określonego interfejsu ABI lub wszystkich interfejsów ABI. Chociaż przeszukiwanie katalogu najwyższego poziomu może potrwać dłużej, jest bardziej niezawodne, jeśli zdecydujesz się debugować na innym urządzeniu. Pamiętaj, że nie musisz dodawać katalogów zawierających pliki symboli Gradle, ponieważ debuger używa ich automatycznie. |
Polecenia startowe LLDB | Dodaj polecenia LLDB, które chcesz wykonać, zanim debuger dołączy do procesu. Możesz na przykład zdefiniować ustawienia środowiska zgodnie z tym poleceniem:
LLDB wykonuje polecenia w kolejności od góry do dołu. |
Polecenia LLDB po dołączeniu | Dodaj polecenia LLDB, które chcesz wykonać zaraz po podłączeniu debugera do procesu. Na przykład:
LLDB wykonuje polecenia w kolejności od góry do dołu. |
Katalog roboczy hosta | Określ katalog roboczy LLDB. |
Logowanie: kanały docelowe | Określ opcje logu LLDB. Android Studio ustawia opcje domyślne na podstawie doświadczenia zespołu, więc nie działa zbyt wolno, ale zawiera informacje potrzebne do rozwiązywania problemów. Dziennik jest często używany w przypadku raportów o błędach w Android Studio. Domyślne ustawienie to
Aby zebrać więcej informacji, możesz zmienić ustawienie domyślne. Na przykład te opcje logu zbierają informacje o konkretnym lldb process
platform:gdb-remote packets
Aby zobaczyć pełną listę poleceń logu, wpisz polecenie
Android Studio umieszcza dzienniki urządzenia w tym miejscu, gdzie
Jeśli wielu użytkowników ma dostęp do urządzenia, logi są umieszczane w tej lokalizacji, gdzie
Informacje o używaniu LLDB do debugowania zdalnego znajdziesz w artykule Zdalne debugowanie. |
Przed wdrożeniem | Zapoznaj się z sekcją Definiowanie operacji przed uruchomieniem. |
Serwer aplikacji DevApp Engine na platformie App Engine
Ta konfiguracja do uruchomienia/debugowania dotyczy Google Cloud Platform. Więcej informacji znajdziesz w artykule o
uruchamianiu, testowaniu i wdrażaniu backendu. Gdy wykonasz te czynności i zsynchronizujesz projekt z plikiem build.gradle
, Android Studio utworzy dla Ciebie konfigurację App Engine DevAppServer.
Pamiętaj, że szablon App Engine Server IntellJ IDEA to inny szablon, który nie jest dostępny w Android Studio.
Zaawansowana | Opis |
---|---|
Tylko jedna instancja | Wybierz tę opcję, jeśli chcesz mieć pewność, że obecnie wykonywana jest tylko jedna instancja konfiguracji uruchamiania/debugowania. Nie umożliwia jednoczesnego uruchomienia wielu uruchomień tej samej konfiguracji. Domyślnie: wybrane |
Moduł | Wybierz moduł, do którego chcesz zastosować tę konfigurację. |
Synchronizuj z konfiguracją build.gradle | Jeśli dodasz moduł App Engine i przeprowadzisz synchronizację z plikiem build.gradle , pola konfiguracji App Engine DevAppServer zostaną wypełnione za Ciebie (zalecane).
Wybranie Plik > Synchronizuj projekt z plikami Gradle powoduje też synchronizację projektu. Domyślnie: wybrane
|
Pakiet SDK App Engine | Wpisz ścieżkę do pakietu SDK Google App Engine dla Javy na komputerze lokalnym. Kliknij ..., aby wybrać go w oknie. |
Ścieżka wojenna | Wpisz ścieżkę do katalogu WAR (Web Application Archive) aplikacji wdrażanej na lokalnym serwerze programistycznym. Kliknij ..., aby wybrać go w oknie. |
Argi maszyny wirtualnej | Określ opcje wiersza poleceń, które chcesz przekazać do maszyny wirtualnej w celu uruchomienia serwera DevAppServer. Określając opcje:
Więcej informacji o opcjach maszyn wirtualnych znajdziesz w dokumentacji wersji J2SE, np. Domyślnie: brak opcji |
Adres serwera | Wpisz adres hosta, który ma być używany na serwerze. Dostęp do serwera programistycznego z innego komputera w sieci może być potrzebny. Adres 0.0.0.0 zapewnia dostęp zarówno do hosta lokalnego, jak i z nazwy hosta. Domyślnie: localhost |
Port serwera | Wpisz numer portu, który ma być używany przez serwer. Domyślnie: 8080 |
Wyłącz sprawdzanie dostępności aktualizacji pakietu App Engine SDK | Jeśli zostanie podany, serwer programistyczny nie skontaktuje się z App Engine, by sprawdzić dostępność nowej wersji pakietu SDK. Domyślnie serwer sprawdza dostępność nowej wersji podczas uruchamiania i drukuje komunikat, jeśli jest dostępna nowa wersja. |
Przed wdrożeniem | Zapoznaj się z sekcją Definiowanie operacji przed uruchomieniem. |
Konfiguracje uruchamiania/debugowania na Wear OS
Szablony widżetu, kafelka i tarczy zegarka na Wear OS umożliwiają uruchamianie lub debugowanie aplikacji na Wear OS na urządzeniach wirtualnych i sprzętowych. Większość opcji konfiguracji szablonów jest taka sama jak w przypadku opcji aplikacji na Androida. Oto opcje bardziej specyficzne dla konfiguracji uruchamiania/debugowania na Wear OS:
- W przypadku wszystkich konfiguracji uruchamiania lub debugowania na Wear musisz wybrać konkretne źródło danych widżetu, kafelek lub tarczę zegarka (w zależności od szablonu), do której chcesz zastosować konfigurację. Zwykle każdy z tych elementów odpowiada klasie w kodzie.
- W przypadku konfiguracji uruchamiania/debugowania widżetu Wear OS musisz wybrać przedział, w którym chcesz umieścić dane widżetu pochodzące ze źródła danych widżetu. Możesz umieścić go w górnej, w prawej, u dołu, po lewej stronie lub w tle tarczy zegarka.
- W przypadku konfiguracji uruchamiania/debugowania widżetu Wear OS musisz też wybrać Typ danych widżetu pochodzących ze źródła danych widżetu. Dostępne typy są ograniczone do tych zapewnianych przez wybrane źródło danych widżetu oraz obsługiwane przez wybrany przedział. Listę typów bardziej szczegółowych danych znajdziesz w sekcji Typy i pola.
Te powierzchnie możesz też uruchamiać, korzystając z ikony rynien, która znajduje się obok deklaracji powierzchni, jak widać na ilustracji poniżej.