Podczas uruchamiania, debugowania lub testowania kodu Android Studio korzysta z konfiguracji uruchamiania/debugowania, aby określić sposób wykonania danej operacji. Zwykle pierwotnie utworzona konfiguracja wystarcza do uruchamiania i debugowania aplikacji. Możesz jednak modyfikować i tworzyć nowe konfiguracje oraz modyfikować szablony konfiguracji, aby dostosować je do swojego procesu programowania zgodnie z opisem na tej stronie.
Więcej informacji znajdziesz w tej dokumentacji IntelliJ:
Informacje o konfiguracjach uruchamiania i debugowania
Konfiguracje uruchamiania i debugowania określają takie szczegóły, jak opcje instalacji, uruchamiania i testowania aplikacji. Możesz zdefiniować konfigurację do jednorazowego użytku lub zapisać ją do użycia w przyszłości. Po zapisaniu konfiguracji możesz wybrać ją z listy Wybierz konfigurację uruchomienia/debugowania na pasku narzędzi. Android Studio zapisuje konfiguracje w ramach projektu.
Początkowo utworzona konfiguracja uruchamiania i debugowania
Gdy tworzysz projekt po raz pierwszy, Android Studio tworzy konfigurację uruchamiania i debugowania dla głównej czynności na podstawie szablonu aplikacji na Androida. Aby uruchomić projekt lub debugować go, musisz zdefiniować co najmniej 1 konfigurację uruchamiania lub debugowania. Z tego powodu zalecamy, aby nie usuwać początkowo utworzonej konfiguracji.
Zakres projektu i kontrola wersji
Konfiguracje wykonywania i debugowania oraz zmiany szablonów dotyczą tylko bieżącego projektu. Konfigurację uruchamiania/debugowania (ale nie szablon) możesz udostępnić w systemie kontroli wersji. Więcej informacji o udostępnianiu konfiguracji znajdziesz w artykule Opcje konfiguracji: nazwa i udostępnianie.
Otwórz okno Konfiguracje uruchamiania/debugowania
Aby otworzyć okno Konfiguracje uruchamiania/debugowania, wybierz Uruchom > Edytuj konfiguracje. Pojawi się okno Konfiguracje uruchamiania i debugowania (patrz rys. 1).
Rysunek 1 Okno Konfiguracje uruchamiania/debugowania
Lewy panel okna pozwala grupować zdefiniowane konfiguracje według typu szablonu, a u dołu umożliwia edytowanie szablonów konfiguracji. Wybraną konfigurację możesz edytować w panelu po prawej stronie. Zmień rozmiar okna, aby zobaczyć ukryte elementy.
W tym oknie możesz:
- Utwórz nowe konfiguracje uruchamiania i debugowania.
- Edytowanie konfiguracji uruchamiania i debugowania
- Edytowanie szablonów konfiguracji
- Sortowanie i grupowanie konfiguracji.
Tworzenie nowej konfiguracji uruchamiania i debugowania
Nowe konfiguracje uruchamiania i debugowania możesz definiować w oknie Konfiguracje uruchamiania i debugowania, w oknie Projekt lub w edytorze kodu. Nowa konfiguracja musi być oparta na szablonie konfiguracji.
W oknie Konfiguracje uruchamiania/debugowania wyświetlane są konfiguracje uruchamiania i debugowania oraz dostępne szablony konfiguracji. Nową konfigurację możesz utworzyć bezpośrednio z szablonu lub z kopii innej konfiguracji. W razie potrzeby możesz zmienić wartości pól.
Możesz też kliknąć prawym przyciskiem myszy element w oknie Projekt, aby automatycznie utworzyć konfigurację dla tego elementu. Jeśli na przykład chcesz uruchomić określone działanie, kliknij prawym przyciskiem myszy plik Java aktywności i wybierz Uruchom. W zależności od elementu Android Studio używa szablonu konfiguracji aplikacji na Androida, testów z użyciem instrumentacji Androida lub JUnit.
W Edytorze kodu możesz łatwo utworzyć konfigurację testu i uruchomienia/debugowania klasy lub metody, a następnie ją uruchomić.
Gdy utworzysz konfigurację poza oknem Uruchom/debugowanie, jest ona tymczasowa, chyba że ją zapiszesz. Domyślnie w projekcie może być maksymalnie 5 tymczasowych konfiguracji, zanim Android Studio zacznie je usuwać. Aby zmienić tę wartość domyślną, otwórz ustawienia Android Studio i zmodyfikuj ustawienie Ustawienia zaawansowane > Uruchom/Debuguj > Limit konfiguracji tymczasowych. Więcej informacji o tym, jak tworzyć i zapisywać tymczasowe konfiguracje uruchomienia lub debugowania, znajdziesz w artykule Tworzenie i zapisywanie tymczasowych konfiguracji uruchomienia lub debugowania.
Rozpoczynanie konfiguracji na podstawie szablonu
Aby zdefiniować konfigurację uruchamiania lub debugowania na podstawie szablonu, wykonaj te czynności:
- Otwórz okno Konfiguracje uruchamiania i debugowania.
- Kliknij Dodaj nową konfigurację
.
- Wybierz szablon konfiguracji.
- Wpisz nazwę w polu Nazwa.
- W razie potrzeby zmodyfikuj konfigurację.
- Kliknij Zastosuj lub OK.
Pamiętaj, aby poprawić błędy wyświetlane na dole okna.
Rozpoczynanie konfiguracji na podstawie kopii
Aby zdefiniować konfigurację uruchamiania lub debugowania na podstawie kopii innej konfiguracji, wykonaj te czynności:
- Otwórz okno Konfiguracje uruchamiania i debugowania.
- W panelu po lewej stronie wybierz istniejącą konfigurację uruchamiania lub debugowania.
- Kliknij Kopiuj konfigurację
.
- Wpisz nazwę w polu Nazwa.
- W razie potrzeby zmień konfigurację.
- Kliknij Zastosuj lub OK.
Popraw wszystkie błędy wyświetlone u dołu okna.
Definiowanie konfiguracji elementu w projekcie
Android Studio może utworzyć konfigurację uruchamiania/debugowania niektórych elementów wyświetlanych w oknie Projekt. Konfiguracja jest oparta na szablonie konfiguracji w ten sposób:
- Plik Java Activity: szablon Aplikacja na Androida.
- Pakiet: szablon Android Instrumented Tests lub Android JUnit, w zależności od zbioru źródeł. Jeśli wybierzesz test z użyciem instrumentacji, zostanie użyty szablon testów z użyciem instrumentacji na Androida. Jeśli wybierzesz test jednostki lokalnej, zostanie użyty szablon Android JUnit. Test jednostkowy lokalny możesz opcjonalnie uruchomić z pokryciem kodu. Więcej informacji znajdziesz w artykule Zakres kodu.
Aby utworzyć konfigurację uruchamiania/debugowania elementu w projekcie, wykonaj te czynności:
- Otwórz projekt w widoku Android lub Projekt.
- W oknie Projekt kliknij prawym przyciskiem myszy element, który chcesz przetestować, i wybierz Uruchomfilename lub Debugowaniefilename. Android Studio utworzy tymczasową konfigurację uruchamiania/debugowania i uruchomi aplikację.
- Na pasku narzędzi otwórz menu Wybierz konfigurację uruchomienia lub debugowania.
- Wybierz Zapisz konfigurację z opcji obok konfiguracji, którą chcesz zapisać.
Rysunek 2. Zapisywanie konfiguracji
Uwaga: jeśli klikniesz prawym przyciskiem myszy i uruchomisz lub debugujesz ten sam element (ale nie aktywność), Android Studio utworzy nową konfigurację.
Definiowanie konfiguracji testu klasy lub metody
Android Studio umożliwia zdefiniowanie konfiguracji testu dla klasy lub metody, a następnie jej wykonanie. Jeśli na przykład utworzysz nową klasę, możesz utworzyć i przeprowadzić jej test. Jeśli test się powiedzie, możesz uruchomić testy w pozostałych częściach projektu, aby upewnić się, że nowy kod nie powoduje błędów gdzieś indziej.
Android Studio używa szablonu Android Instrumented Tests lub Android JUnit, w zależności od zestawu źródłowego. Test jednostkowy na komputerze możesz opcjonalnie uruchomić z zabezpieczeniem kodu.
Aby utworzyć konfigurację uruchamiania/debugowania klasy lub metody w kodzie Java, wykonaj te czynności:
- Otwórz projekt w widoku Android lub Projekt.
- Otwórz plik Java w Edytorze kodu.
- W kodzie wybierz klasę lub metodę, a następnie naciśnij Ctrl + Shift + T (Command + Shift + T).
- W menu, które się pojawi, kliknij Utwórz nowy test.
- W oknie Utwórz test opcjonalnie zmień lub ustaw wartości i kliknij OK.
- W oknie Wybierz katalog docelowy wskaż miejsce w projekcie, w którym Android Studio ma przeprowadzić test. Lokalizację możesz określić za pomocą struktury katalogu lub wybierając sąsiadującą klasę.
- Kliknij OK.
Nowy test pojawi się w oknie Projekt w odpowiednim zbiorze źródłowym testu.
- 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 myszy definicję klasy lub nazwę metody w pliku testowym i wybierz Uruchom lub Debuguj, aby przetestować wszystkie metody w klasie.
- Na pasku narzędzi otwórz menu Wybierz konfigurację uruchomienia lub debugowania.
- Wybierz Zapisz konfigurację z opcji obok konfiguracji, którą chcesz zapisać.
Rysunek 3. Zapisywanie konfiguracji
Uruchamianie i debugowanie aplikacji przy użyciu zapisanej konfiguracji
Jeśli masz zapisaną konfigurację uruchamiania lub debugowania, możesz ją wybrać przed uruchomieniem lub debugowaniem aplikacji.
Aby użyć zapisanej konfiguracji uruchomienia/debugowania:
- Na pasku narzędzi wybierz konfigurację uruchomienia lub debugowania na liście Wybierz konfigurację uruchomienia lub debugowania.
- Kliknij Uruchom > Uruchom lub Uruchom > Debugowanie.
Lista rozwijana znajduje się po lewej stronie przycisków Uruchom
i Debuguj
, na przykład 
.
Możesz też kliknąć Uruchom lub Debuguj
.
Edytowanie konfiguracji uruchamiania i debugowania
Aby edytować konfigurację uruchomienia/debugowania:
- Otwórz okno Konfiguracje uruchamiania i debugowania.
- Wybierz konfigurację w panelu po lewej stronie.
- W razie potrzeby zmień konfigurację.
- Kliknij Zastosuj lub OK.
Popraw wszystkie błędy wyświetlone u dołu okna.
Edytowanie szablonu konfiguracji uruchamiania i debugowania
Możesz edytować szablony konfiguracji udostępniane przez Android Studio, aby dostosować je do swojego procesu tworzenia. Edytowanie szablonu nie ma wpływu na istniejące konfiguracje, które go używają. Jeśli na przykład musisz utworzyć kilka konfiguracji określonego typu, możesz edytować szablon, a następnie zmienić go z powrotem.
Nie możesz tworzyć nowych szablonów, ale możesz tworzyć konfiguracje, które możesz używać podobnie jak szablony. Możesz skopiować konfigurację i zmodyfikować jej kopię, aby utworzyć nowe konfiguracje.
Aby edytować szablon:
- Otwórz okno Konfiguracje uruchamiania i debugowania.
- Kliknij Edytuj szablony konfiguracji….
- Wybierz szablon konfiguracji.
- W razie potrzeby zmodyfikuj konfigurację.
- Kliknij Zastosuj lub OK.
Popraw wszystkie błędy wyświetlone u dołu okna.
Sortowanie i grupowanie konfiguracji
W oknie Konfiguracje uruchomienia/debugowania możesz uporządkować konfiguracje, aby móc je szybko znaleźć. Możesz sortować elementy w folderze alfabetycznie i tworzyć nowe foldery, aby grupować konfiguracje.
Aby posortować konfiguracje alfabetycznie:
- Otwórz okno Konfiguracje uruchamiania i debugowania.
- Wybierz folder zawierający konfiguracje.
- Kliknij Konfiguracje sortowania
.
- Kliknij OK, aby zamknąć okno.
Aby zgrupować konfiguracje w folderach:
- Otwórz okno Konfiguracje uruchamiania i debugowania.
- Wybierz folder zawierający konfiguracje.
- Kliknij Utwórz nowy folder
.
- Wpisz nazwę w polu Nazwa folderu.
- Aby zapisać nazwę, kliknij Zastosuj.
Definiowanie operacji przed uruchomieniem
Możesz określić zadania do wykonania przed zastosowaniem konfiguracji uruchamiania/debugowania. Zadania są wykonywane w kolejności, w jakiej występują na liście.
Uwaga: definiowanie zadań przed opublikowaniem to funkcja zaawansowana. Zamiast
korzystać z tej funkcji, zalecamy umieszczanie logiki przygotowania w plikach build.gradle, aby były one wykonywane podczas kompilacji z poziomu wiersza poleceń.
Aby utworzyć listę zadań, wykonaj te czynności:
- U dołu okna Konfiguracje uruchamiania/debugowania w sekcji Przed uruchomieniem (może być konieczne przewinięcie 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 ustawić kolejność zadań, przeciągnij je lub wybierz zadanie i kliknij W górę
i W dół
, aby przesunąć je w górę lub w dół na liście. - Wybierz Pokaż tę stronę, jeśli chcesz wyświetlić ustawienia konfiguracji przed ich zastosowaniem.
Ta opcja jest domyślnie odznaczona.
- Wybierz Aktywne okno narzędzia, jeśli chcesz, aby podczas uruchamiania lub debugowania aplikacji było aktywne okno Uruchom lub Debugowanie.
Ta opcja jest domyślnie wybrana.
Aby usunąć zadanie z listy:
- Wybierz zadanie.
- Kliknij Usuń
.
Aby edytować zadanie:
- Wybierz zadanie.
- Kliknij Edytuj
.
- W wyświetlonym oknie edytuj ustawienia zadania, a następnie kliknij OK.
W tabeli poniżej znajdziesz dostępne zadania, które możesz dodać.
| Zadanie | Opis |
|---|---|
| Uruchamianie narzędzia zewnętrznego | Uruchamianie aplikacji zewnętrznej w Android Studio. W oknie Narzędzia zewnętrzne wybierz co najmniej 1 aplikację, którą chcesz uruchomić, a następnie kliknij OK. Jeśli aplikacja nie jest jeszcze zdefiniowana w Android Studio, dodaj jej definicję w oknie Tworzenie narzędzi. Więcej informacji znajdziesz w artykułach Konfigurowanie narzędzi i Narzędzia zewnętrzne. |
| Uruchamianie innej konfiguracji | Wykonaj jedną z dostępnych konfiguracji uruchamiania i debugowania. W oknie Wybierz konfigurację do wykonania wybierz konfigurację do wykonania, a następnie kliknij OK. |
| Marka | Skompiluj projekt lub moduł. Android Studio wykonuje polecenie Wykonaj moduł, jeśli konfiguracja uruchamiania/debugowania określa konkretny moduł, lub wykonuje polecenie Utwórz projekt, jeśli nie określono żadnych modułów. |
| Make Project | Skompiluj projekt. Android Studio wykonuje polecenie Make projektu. |
| Make, no error check | Ta opcja jest taka sama jak Make, z tym że Android Studio wykonuje konfigurację uruchomienia/debugowania niezależnie od wyniku kompilacji. |
| Tworzenie artefaktów | Nieobsługiwane w Android Studio. |
| Uruchamianie zadania Gradle | Uruchomić zadanie Gradle. W otwartym oknie podaj szczegóły, a potem kliknij OK. Więcej informacji znajdziesz w Gradle. |
| Make obsługujący Gradle | Kompiluj projekt i uruchamiaj Gradle. |
| Budowniczy Gradle App Engine | Zadanie kreatora Gradle w App Engine synchronizuje projekt, a następnie kompiluje moduł. |
Szablony konfiguracji
Android Studio udostępnia szablony konfiguracji, które pomogą Ci szybko rozpocząć pracę. W sekcjach poniżej opisujemy szablony, które mają zastosowanie w programowaniu na Androida w Android Studio:
- Aplikacja na Androida
- Testy Androida
- App Engine DevAppServer
- Kafelek, widżet i tarcza zegarka w Wear OS
Uwaga: w Android Studio 2.1.x i starszych wersjach był dostępny szablon aplikacji natywnej, którego nie ma w nowszych wersjach. Jeśli w projekcie masz szablon aplikacji natywnej, Android Studio przekształci go w aplikację na Androida, gdy go wczytasz. W oknie Konwertowanie projektu znajdziesz instrukcje dotyczące tego procesu.
Nieobsługiwane szablony
Te nieobsługiwane szablony pochodzą z IntelliJ IDEA i nie są przeznaczone do tworzenia aplikacji na Androida w Android Studio. Informacje o używaniu tych szablonów znajdziesz w dokumentacji IntelliJ IDEA.
- Aplikacja
- Złożony
- Gradle
- Groovy
- Aplikacja JAR
- Java Scratch
- JUnit
- Kotlin
- Kotlin Script
- Debugowanie zdalne
- Skrypt powłoki
- TestNG
Typowe opcje konfiguracji
Opcje Nazwa, Zezwalaj na uruchamianie równoległe i Przechowuj jako plik projektu są wspólne dla wielu szablonów konfiguracji. Więcej informacji o tych ustawieniach znajdziesz w artykule Najczęstsze ustawienia.
Android Studio przechowuje udostępnioną konfigurację uruchamiania/debugowania w poszczególnych plikach XML w folderze project_directory/.idea/runConfigurations/.
Więcej informacji znajdziesz w opisie formatu opartego na katalogu w dokumentacji projektów IntelliJ.
Aplikacja na Androida
Możesz uruchamiać i debugować aplikacje i czynności 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 Różne zawiera też opcje instalacji.
| Pole | Opis |
|---|---|
| Moduł | Wybierz moduł, do którego chcesz zastosować tę konfigurację. |
| Opcje instalacji: wdróż | Wybierz opcję:
|
| Opcje instalacji: wdrożenie jako aplikacja błyskawiczna | Jeśli Twoja aplikacja obsługuje aplikacje błyskawiczne, czyli dodasz obsługę aplikacji błyskawicznych podczas tworzenia nowego projektu lub utworzysz co najmniej jeden moduł funkcji z obsługą aplikacji błyskawicznych, możesz wdrożyć te moduły, zaznaczając pole Wdróż jako aplikację błyskawiczną. |
| Opcje instalacji: funkcje do wdrożenia |
Jeśli Twoja aplikacja zawiera moduły funkcji, zaznacz pole obok każdej funkcji, którą chcesz uwzględnić podczas wdrażania aplikacji. Tę opcję zobaczysz tylko wtedy, gdy aplikacja zawiera moduły funkcji.
Uwaga: jeśli chcesz przetestować pobieranie i instalowanie modułów funkcji na żądanie, musisz najpierw opublikować pakiet aplikacji, a potem użyć wewnętrznej ścieżki testów w Konsoli Play. Więcej informacji znajdziesz w artykule Prześlij pakiet aplikacji do Konsoli Play. |
| Opcje instalacji: flagi instalacji | Wpisz opcje narzędzia 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 narzędzia adb am
start, których chcesz użyć. Formatuj opcje tak samo jak na wierszu poleceń, ale bez intencji. Na przykład:
Ta opcja jest niewidoczna, jeśli dla opcji Uruchom wybierzesz wartość Brak. Wartość domyślna: brak opcji. |
| Opcje celu wdrożenia: cel | Wybierz opcję:
|
Opcje docelowe wdrożenia: użyj tego samego urządzenia w przyszłości |
Domyślnie ta opcja jest odznaczona, więc za każdym razem, gdy uruchamiasz aplikację, pojawia się okno Wybierz wdrożenie, w którym możesz wybrać urządzenie. Po wybraniu tej opcji i uruchomieniu aplikacji pojawi się okno Wybierz wdrożenie, w którym możesz wybrać urządzenie. Następnie za każdym razem, gdy uruchamiasz aplikację, uruchamia się ona na wybranym urządzeniu bez wyświetlania okna dialogowego Wybierz wdrożenie. Aby uruchomić aplikację na innym urządzeniu, odznacz opcję Użyj tego samego urządzenia w przyszłości lub zatrzymaj aplikację, wybierając Uruchom > Zatrzymaj app lub Zatrzymaj  , a następnie uruchom ją ponownie. Wyświetli się okno Wybierz wdrożenie, w którym możesz wybrać urządzenie.
|
| Przed uruchomieniem | Zobacz sekcję Defining Before Launch Operations (Definiowanie operacji przed uruchomieniem). |
Karta Inne
Na karcie Różne możesz określić opcje logcat, instalacji, uruchamiania i wdrażania. Na karcie Ogólne znajdują się też opcje instalacji.
| Pole | Opis |
|---|---|
| Logcat: automatycznie pokazuj logcat | Gdy ta opcja jest zaznaczona, po każdym prawidłowym wdrożeniu i uruchomieniu aplikacji za pomocą tej konfiguracji otwiera się okno Logcat. Domyślnie: zaznaczone. |
| Logcat: wyczyść dziennik przed uruchomieniem | Wybierz tę opcję, jeśli chcesz, aby Android Studio przed uruchomieniem aplikacji usuwało dane z poprzednich sesji z pliku dziennika. Domyślnie: nie zaznaczone. |
| Opcje instalacji: pomiń instalację, jeśli plik APK nie został zmieniony. | Gdy ta opcja jest zaznaczona, Android Studio nie ponownie wdraża pliku APK, jeśli wykryje, że nie został on zmieniony. Jeśli chcesz, aby Android Studio wymuszało instalację pliku APK, nawet jeśli nie został zmieniony, odznacz tę opcję. Domyślnie: wybrane |
| Opcje instalacji: wymuś zatrzymanie uruchomionej aplikacji przed uruchomieniem aktywności | Jeśli ta opcja zostanie zaznaczona, a Android Studio wykryje, że nie trzeba ponownie instalować pakietu APK, bo ten pakiet się nie zmienił, wymusza 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 zamykania aplikacji. Ta opcja działa z poprzednią opcją, która określa, czy pakiet APK ma być zainstalowany. Pozostaw domyślne wartości obu pól Opcje instalacji, chyba że chcesz, aby instalacja była przeprowadzana przy każdej aktualizacji. W niektórych przypadkach możesz usunąć zaznaczenie tej opcji. Jeśli na przykład piszesz silnik metody wprowadzania (IME), wymuszenie zatrzymania aplikacji spowoduje odznaczenie jej jako bieżącej klawiatury, czego możesz nie chcieć używać. Domyślnie: wybrano |
| Przed uruchomieniem | Zobacz sekcję Defining Before Launch Operations (Definiowanie operacji przed uruchomieniem). |
Karta Debuger
Na karcie Debugger określ opcje debugowania.
W przypadku kodu C i C++ Android Studio używa debugera LLDB. Oprócz standardowego interfejsu Android Studio w oknie debugera znajduje się karta LLDB, która umożliwia wpisywanie poleceń LLDB podczas debugowania. Możesz wpisywać te same polecenia, których Android Studio używa do wyświetlania informacji w interfejsie debugera, oraz wykonywać dodatkowe operacje.
W przypadku projektów C i C++ możesz dodawać katalogi symboli, a także polecenia uruchamiania i dołączania LLDB na karcie Debugger. Użyj do tego przycisków podobnych do tych:
- Dodaj
– dodaj katalog lub polecenie.
- Usuń
– wybierz katalog lub polecenie, a potem kliknij ten przycisk, aby usunąć element.
- W górę – wybierz katalog lub polecenie, a następnie kliknij ten przycisk, aby przesunąć element wyżej na liście.
- W dół
– wybierz katalog lub polecenie, a potem kliknij ten przycisk, aby przesunąć element w dół listy.
Więcej informacji o debugowaniu w Android Studio znajdziesz w artykule Debugowanie aplikacji.
| Pole | Opis |
|---|---|
| Typ debugowania | Wybierz jedną z tych opcji:
Zalecamy wybranie opcji Wykrywaj automatycznie, ponieważ wybiera ona odpowiedni typ debugowania dla projektu. |
| Katalogi symboli | Jeśli chcesz dodać pliki symboli, aby udostępnić debugerowi informacje wygenerowane poza Android Studio, możesz dodać tutaj co najmniej 1 katalog. Android Studio używa plików w tych katalogach zamiast plików wygenerowanych przez wtyczkę Android do Gradle. Debuger przeszukuje katalogi od góry do dołu, aż znajdzie to, czego potrzebuje. Przeszukuje rekurencyjnie pliki w katalogu. Aby zoptymalizować listę i zaoszczędzić czas, umieść najczęściej używane katalogi na początku listy. Jeśli określisz katalog znajdujący się wysoko w drzewie, przeszukiwanie wszystkich podkatalogów może potrwać dłużej. Jeśli dodasz bardzo konkretny katalog, wyszukiwanie będzie trwało krócej. Musisz znaleźć równowagę między szybkością a wyszukiwaniem plików potrzebnych do debugowania. Jeśli na przykład masz katalog zawierający podkatalogi dla różnych interfejsów binarnych Androida (ABI), możesz dodać katalog dla konkretnego ABI lub dla wszystkich ABI. Chociaż przeszukiwanie katalogu najwyższego poziomu może trwać dłużej, jest bardziej niezawodne, jeśli zdecydujesz się na debugowanie na innym urządzeniu. Pamiętaj, że nie musisz dodawać katalogów zawierających pliki symboli Gradle, ponieważ debuger używa ich automatycznie. |
| Polecenia uruchamiania LLDB | Dodaj polecenia LLDB, które chcesz wykonać przed przyłączeniem debugera do procesu. Możesz na przykład zdefiniować ustawienia środowiska, jak w tym poleceniu:
LLDB wykonuje polecenia od góry do dołu. |
| Polecenia LLDB po załączeniu | Dodaj polecenia LLDB, które chcesz wykonać bezpośrednio po dołączeniu debugera do procesu. Na przykład:
LLDB wykonuje polecenia od góry do dołu. |
| Katalog roboczy hosta | Określ katalog roboczy LLDB. |
| Logowanie: kanały docelowe | Określ opcje dziennika LLDB. Android Studio ustawia domyślne opcje na podstawie doświadczeń zespołu, dzięki czemu nie jest zbyt wolne, ale zawiera informacje potrzebne do rozwiązywania problemów. Logi są często wymagane w przypadku raportów o błędach w Android Studio. Domyślnie
Możesz zmienić domyślne ustawienie, aby uzyskać więcej informacji. Na przykład te opcje logów zbierają informacje o konkretnym lldb process
platform:gdb-remote packets
Aby wyświetlić pełną listę poleceń logowania, w oknie powłoki LLDB w Android Studio wpisz polecenie
Android Studio umieszcza dzienniki urządzenia w tym miejscu, gdzie
Jeśli z urządzenia korzysta wielu użytkowników, logi są zapisywane w tej lokalizacji, gdzie
Informacje o używaniu LLDB do debugowania zdalnego znajdziesz w artykule Debugowanie zdalne. |
| Przed uruchomieniem | Patrz sekcja Definiowanie operacji przed opublikowaniem. |
Karta Profilowanie
Aby włączyć niektóre funkcje w Profilomacie Androida, gdy na urządzeniu jest zainstalowany Android 7.1 lub starszy, musisz zaznaczyć opcję Włącz zaawansowane profilowanie.
Testy Androida
Szablon testowy, którego należy użyć, zależy od zbioru źródłowego. Szablon testów z instrumentacją na Androida jest przeznaczony do testu z instrumentacją. Szablon JUnit na Androida dotyczy testu jednostkowego lokalnego.
Uwaga: jeśli używasz Laboratorium Firebase do testowania na różnych urządzeniach, możesz zdefiniować testy z instrumentacją za pomocą szablonu Android JUnit. Więcej informacji znajdziesz w artykule Przeprowadzanie testów za pomocą Laboratorium Firebase.
Poniższe opisy kart obejmują karty i pola w szablonie testu z wykorzystaniem instrumentacji na Androida. Informacje o kartach i polach szablonu testowego Android JUnit znajdziesz na stronie IntelliJ Run/Debug Configuration: JUnit.
Karta Ogólne
Na karcie Ogólne możesz określić lokalizację testu, narzędzie do testowania, powłokę adb i opcje wdrożenia.
| Pole | Opis |
|---|---|
| Moduł | Wybierz moduł, do którego chcesz zastosować tę konfigurację. |
| Test | W tym obszarze określ lokalizację testów, które chcesz przeprowadzić:
|
| Uruchamianie konkretnego narzędzia (opcjonalnie) | Wpisz lokalizację runnera pomiarów; kliknij Więcej, aby użyć okna dialogowego. Plik build.gradle określa lokalizację narzędzia do testowania; ta wartość zastępuje go. Domyślnie jest to zwykle klasa AndroidJUnitRunner z poziomu AndroidX Test.
|
| Opcje dodatkowe | Wpisz opcje adb Domyślnie: brak opcji |
| Opcje celu wdrożenia: cel | Wybierz opcję:
|
| Opcje docelowe wdrożenia: użyj tego samego urządzenia w przyszłości | Jeśli chcesz, aby w przyszłości automatycznie używane było urządzenie wybrane w oknie Wybieranie celu wdrożenia, wybierz tę opcję. Jeśli urządzenie nie jest dostępne, pojawi się okno. Domyślnie: odznaczone |
| Przed uruchomieniem | Zobacz sekcję Defining Before Launch Operations (Definiowanie operacji przed uruchomieniem). |
Karta Inne
Karta Różne zawiera opcje logcat i instalacji.
| Pole | Opis |
|---|---|
| Logcat: wyczyść dziennik przed uruchomieniem | Wybierz tę opcję, jeśli chcesz, aby Android Studio usuwał z pliku dziennika dane z poprzednich sesji przed uruchomieniem aplikacji. Domyślnie: niezaznaczone. |
| Opcje instalacji: pomiń instalację, jeśli plik APK nie został zmieniony | Jeśli ta opcja jest zaznaczona, Android Studio nie ponownie wdraża pliku APK, jeśli wykryje, że nie został on zmieniony. Jeśli chcesz, aby Android Studio wymuszało instalację pliku APK, nawet jeśli nie został zmieniony, odznacz tę opcję. Domyślnie: wybrane |
| Opcje instalacji: wymuś zatrzymanie uruchomionej aplikacji przed uruchomieniem aktywności | Jeśli ta opcja jest zaznaczona, gdy Android Studio wykryje, że nie musi ponownie instalować pliku APK, ponieważ nie został on zmieniony, wymusi zatrzymanie aplikacji, aby uruchomiła się ona z domyślnej aktywności programu uruchamiającego. Jeśli ta opcja nie jest zaznaczona, Android Studio nie wymusza zamykania aplikacji. Ta opcja działa w połączeniu z poprzednią opcją, która określa, czy trzeba zainstalować plik APK. Pozostaw domyślne wartości obu pól Opcje instalacji, chyba że chcesz, aby instalacja była przeprowadzana przy każdej aktualizacji. W niektórych przypadkach możesz usunąć zaznaczenie tej opcji. Jeśli na przykład piszesz silnik metody wprowadzania (IME), wymuszenie zatrzymania aplikacji spowoduje odznaczenie jej jako bieżącej klawiatury, czego możesz nie chcieć używać. Domyślnie: wybrano |
| Przed uruchomieniem | Zobacz sekcję Defining Before Launch Operations (Definiowanie operacji przed uruchomieniem). |
Karta Debuger
Na karcie Debugger określ opcje debugowania.
W przypadku kodu C i C++ Android Studio używa debugera LLDB. Oprócz zwykłego interfejsu Androida Studio okno debugowania zawiera kartę LLDB, na której możesz wpisywać polecenia LLDB podczas debugowania. Możesz wpisywać te same polecenia, których używa Android Studio do wyświetlania informacji w interfejsie debugera, oraz wykonywać dodatkowe operacje.
W przypadku projektów C i C++ możesz dodawać katalogi symboli, a także polecenia uruchamiania i dołączania LLDB na karcie Debugger. Użyj do tego przycisków podobnych do tych:
- Dodaj
– dodaj katalog lub polecenie.
- Usuń
– wybierz katalog lub polecenie, a potem kliknij ten przycisk, aby usunąć element.
- W górę – wybierz katalog lub polecenie, a następnie kliknij ten przycisk, aby przesunąć element wyżej na liście.
- W dół
– wybierz katalog lub polecenie, a potem kliknij ten przycisk, aby przesunąć element w dół listy.
Więcej informacji o debugowaniu w Android Studio znajdziesz w artykule Debugowanie aplikacji.
| Pole | Opis |
|---|---|
| Typ debugowania | Wybierz jedną z tych opcji:
Zalecamy wybranie opcji Wykrywaj automatycznie, ponieważ wybiera ona odpowiedni typ debugowania dla projektu. |
| Katalogi symboli | Jeśli chcesz dodać pliki symboli, aby udostępnić debugerowi informacje wygenerowane poza Android Studio, możesz dodać tutaj co najmniej 1 katalog. Android Studio używa plików w tych katalogach zamiast plików wygenerowanych przez wtyczkę Android do Gradle. Debuger przeszukuje katalogi od góry do dołu, aż znajdzie to, czego potrzebuje. 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 znajdujący się wysoko w drzewie, przeszukiwanie wszystkich podkatalogów może potrwać dłużej. Jeśli dodasz bardzo konkretny katalog, wyszukiwanie zajmie mniej czasu. Musisz znaleźć odpowiednią równowagę między szybkością a znajdowaniem plików potrzebnych do debugowania. Jeśli na przykład masz katalog zawierający podkatalogi dla różnych interfejsów binarnych Androida (ABI), możesz dodać katalog dla konkretnego ABI lub dla wszystkich ABI. Chociaż wyszukiwanie w katalogu na wyższym poziomie może zająć więcej czasu, jest też 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 uruchamiania LLDB | Dodaj polecenia LLDB, które chcesz wykonać przed przyłączeniem debugera do procesu. Możesz na przykład zdefiniować ustawienia środowiska, jak w tym poleceniu:
LLDB wykonuje polecenia od góry do dołu. |
| Polecenia LLDB po załączeniu | Dodaj polecenia LLDB, które chcesz wykonać bezpośrednio po dołączeniu debugera do procesu. Na przykład:
LLDB wykonuje polecenia od góry do dołu. |
| Katalog roboczy hosta | Określ katalog roboczy LLDB. |
| Logowanie: kanały docelowe | Określ opcje dziennika LLDB. Android Studio ustawia domyślne opcje na podstawie doświadczeń zespołu, dzięki czemu nie jest zbyt wolne, ale zawiera informacje potrzebne do rozwiązywania problemów. Logi są często wymagane w przypadku raportów o błędach w Android Studio. Domyślnie
Możesz zmienić domyślne ustawienie, aby uzyskać więcej informacji. Na przykład te opcje logów zbierają informacje o konkretnym lldb process
platform:gdb-remote packets
Aby wyświetlić pełną listę poleceń logowania, w oknie powłoki LLDB w Android Studio wpisz polecenie
Android Studio umieszcza dzienniki urządzenia w tym miejscu, gdzie
Jeśli z urządzenia korzysta wielu użytkowników, logi są zapisywane w tej lokalizacji, gdzie
Informacje o używaniu LLDB do zdalnego debugowania znajdziesz w artykule Zdalne debugowanie. |
| Przed uruchomieniem | Zobacz sekcję Defining Before Launch Operations (Definiowanie operacji przed uruchomieniem). |
App Engine DevAppServer
Ta konfiguracja uruchamiania i debugowania dotyczy Google Cloud Platform. Więcej informacji znajdziesz w artykule
uruchamianie, testowanie i wdrażanie 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 w IntelliJ IDEA to inny szablon, który nie jest dostępny w Android Studio.
| Pole | Opis |
|---|---|
| Tylko jedna instancja | Wybierz tę opcję, jeśli chcesz mieć pewność, że w danym momencie jest wykonywana tylko jedna instancja konfiguracji uruchomienia lub debugowania. Nie pozwala na jednoczesne uruchamianie tej samej konfiguracji. Domyślnie: wybrane |
| Moduł | Wybierz moduł, do którego chcesz zastosować tę konfigurację. |
| Synchronizacja z konfiguracją build.gradle | Jeśli dodasz moduł App Engine i zsynchronizujesz go z plikiem build.gradle, pola konfiguracji serwera App Engine DevApp zostaną wypełnione automatycznie (zalecane).
Wybranie opcji Plik > Synchronizuj projekt z plikami Gradle spowoduje 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. |
| War Path | Wpisz ścieżkę do katalogu archiwum aplikacji internetowej (WAR) aplikacji, którą wdrażasz na lokalnym serwerze programistycznym. Kliknij …, aby wybrać go w oknie. |
| Parametry maszyny wirtualnej | Określ opcje wiersza poleceń, które chcesz przekazać do maszyny wirtualnej przy uruchamianiu DevAppServer. Podczas określania opcji:
Więcej informacji o opcjach maszyn wirtualnych znajdziesz w dokumentacji wersji J2SE, np. Wartość domyślna: brak opcji |
| Adres serwera | Wpisz adres hosta, który ma być używany na serwerze. Może być konieczne podanie adresu, aby uzyskać dostęp do serwera programisty z innego komputera w sieci. Adres 0.0.0.0 umożliwia dostęp zarówno do localhost, jak i do nazwy hosta. Wartość domyślna: localhost |
| Port serwera | Wpisz numer portu serwera. Wartość domyślna: 8080 |
| Wyłącz sprawdzanie dostępności aktualizacji pakietu SDK App Engine | W takim przypadku serwer programisty nie kontaktuje się z App Engine, by sprawdzić dostępność nowej wersji pakietu SDK. Domyślnie serwer sprawdza, czy jest dostępna nowa wersja, i wyświetla odpowiedni komunikat. |
| Przed uruchomieniem | Zobacz sekcję Defining Before Launch Operations (Definiowanie operacji przed uruchomieniem). |
Konfiguracje uruchamiania i debugowania na Wear OS
Szablony widżetów, widżetów tarczy zegarka i widżetów tarczy zegarka Wear OS umożliwiają uruchamianie i debugowanie aplikacji na Wear OS na urządzeniach wirtualnych lub sprzętowych. Większość opcji konfiguracji szablonu jest taka sama jak opcji aplikacji na Androida. Oto opcje bardziej szczegółowe w przypadku konfiguracji uruchamiania i debugowania na Wear OS:
- W przypadku wszystkich konfiguracji uruchamiania i 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ę. Ogólnie każdy z tych elementów odpowiada klasie w Twoim kodzie.
- W przypadku konfiguracji elementu widżetu na potrzeby uruchamiania lub debugowania na Wear OS musisz wybrać miejsce, w którym chcesz umieścić dane elementu widżetu pochodzące ze źródła danych elementu widżetu. Możesz umieścić go na górze, po prawej stronie, na dole, po lewej stronie lub na tle tarczy zegarka.
- W przypadku konfiguracji elementu widżetu na potrzeby uruchamiania lub debugowania na urządzeniu z Wear OS musisz też wybrać Typ danych elementu widżetu, który jest udostępniany przez źródło danych elementu widżetu. Typy, które możesz wybrać, są ograniczone do tych, które są udostępniane przez wybrane źródło danych i obsługiwane przez wybrany slot. Listę typów danych widżetów znajdziesz w artykule Typy i pola.
Możesz też uruchomić te powierzchnie z ikony ścieżki, która znajduje się obok deklaracji powierzchni, jak pokazano na poniższym obrazie.
