Gdy uruchamiasz, debugujesz lub testujesz kod, Android Studio używa konfiguracji uruchamiania/debugowania, aby określić sposób wykonania tej operacji. Do uruchomienia lub debugowania aplikacji zwykle wystarcza początkowa konfiguracja. Możesz jednak modyfikować i tworzyć nowe konfiguracje oraz modyfikować szablony konfiguracji 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ą szczegóły, takie jak instalacja, uruchamianie i testowanie 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ę uruchamiania/debugowania na pasku narzędzi. Android Studio zapisuje konfiguracje w ramach projektu.
Początkowo utworzona konfiguracja uruchamiania/debugowania
Gdy tworzysz nowy projekt, Android Studio tworzy konfigurację uruchamiania/debugowania 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 zalecamy nie usuwać początkowo utworzonej konfiguracji.
Zakres projektu i kontrola wersji
Konfiguracje uruchamiania i debugowanie oraz zmiany w szablonach mają zastosowanie tylko do 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 nazw i udostępniania.
Otwórz okno Konfiguracje uruchamiania/debugowania
Aby otworzyć okno Konfiguracje uruchamiania/debugowania, wybierz Uruchom > Edytuj konfiguracje. Pojawi się okno Konfiguracje uruchamiania/debugowania, tak jak na ilustracji 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. Aby zobaczyć ukryte elementy, zmień rozmiar okna.
W tym oknie możesz:
- Utwórz nowe konfiguracje uruchamiania i debugowania.
- Edytuj konfiguracje uruchamiania i debugowania.
- Edytuj szablony konfiguracji.
- Konfiguracje sortowania i grupowania.
Utwórz nową konfigurację uruchamiania/debugowania
Nowe konfiguracje uruchamiania/debugowania możesz zdefiniować w oknie Uruchom/debugowanie, 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 rozpocząć bezpośrednio z szablonu lub z kopii innej konfiguracji. Następnie możesz w razie potrzeby zmienić wartości pól.
Możesz też kliknąć prawym przyciskiem myszy element w oknie Projekt, aby automatycznie utworzyć na jego potrzeby konfigurację. Jeśli na przykład chcesz uruchomić konkretne działanie, możesz kliknąć prawym przyciskiem myszy plik Java aktywności i wybrać Uruchom. W zależności od elementu Android Studio tworzy konfigurację przy użyciu szablonu konfiguracji Aplikacja na Androida, Testy instrumentalne Androida lub JUnit.
W edytorze kodu możesz łatwo utworzyć konfigurację testu i uruchomienia/debugowania klasy lub metody, a potem ją wykonać.
Gdy utworzysz konfigurację poza oknem Uruchom/debugowanie, będzie ona tymczasowa, chyba że ją zapiszesz. Domyślnie w projekcie może być maksymalnie 5 konfiguracji tymczasowych, zanim Android Studio rozpocznie ich usuwanie. Aby zmienić to ustawienie domyślne, otwórz ustawienia Android Studio i zmień Ustawienia zaawansowane > Uruchom/debugowanie > Tymczasowy limit konfiguracji. Więcej informacji o konfiguracjach tymczasowych znajdziesz w artykule Tworzenie i zapisywanie tymczasowych konfiguracji uruchamiania/debugowania.
Rozpoczynanie konfiguracji na podstawie szablonu
Aby zdefiniować konfigurację uruchamiania/debugowania na podstawie szablonu, wykonaj te czynności:
- Otwórz okno Uruchamianie/debugowanie.
- Kliknij Add New Configuration (Dodaj nową konfigurację)
.
- Wybierz szablon konfiguracji.
- Wpisz nazwę w polu Nazwa.
- W razie potrzeby zmodyfikuj konfigurację.
- Kliknij Zastosuj lub OK.
Pamiętaj, by poprawić błędy wyświetlane na dole okna.
Rozpoczynanie konfiguracji od kopii
Aby zdefiniować konfigurację uruchamiania/debugowania, zaczynając od kopii innej konfiguracji, wykonaj te czynności:
- Otwórz okno Uruchamianie/debugowanie.
- Wybierz istniejącą konfigurację uruchamiania/debugowania w panelu po lewej stronie.
- Kliknij Kopiuj konfigurację
.
- Wpisz nazwę w polu Nazwa.
- W razie potrzeby zmodyfikuj konfigurację.
- Kliknij Zastosuj lub OK.
Popraw wszystkie błędy wyświetlone u dołu okna.
zdefiniować konfigurację elementu w projekcie,
Android Studio może utworzyć konfigurację uruchamiania/debugowania niektórych elementów wyświetlanych w oknie Projekt. Konfiguracja jest oparta na takim szablonie:
- Plik Java z aktywnością: szablon aplikacji na Androida.
- Pakiet: szablon Android Instrumented Tests lub Android JUnit, w zależności od zestawu źródłowego. Jeśli wybierzesz test instrumentalny, zostanie użyty szablon Testy instrumentalne na Androida. Jeśli wybierzesz test jednostki lokalnej, zostanie użyty szablon Android JUnit. W przypadku testu jednostki lokalnej możesz opcjonalnie uruchomić kod z zasięgiem kodu. Więcej informacji znajdziesz w sekcji Pokrycie kodu.
Aby utworzyć konfigurację uruchamiania/debugowania elementu w projekcie, wykonaj te czynności:
- Otwórz projekt w widoku Androida lub projektu.
- W oknie Projekt kliknij prawym przyciskiem myszy element możliwy do przetestowania i wybierz Uruchom filename lub Debuguj filename. Android Studio tworzy tymczasową konfigurację uruchamiania/debugowania i uruchamia aplikację.
- Na pasku narzędzi otwórz listę Wybierz konfigurację uruchamiania/debugowania.
- Wybierz Save Configuration (Zapisz konfigurację) wśród opcji obok konfiguracji, którą chcesz zapisać.
Rysunek 2. Zapisywanie konfiguracji
Uwaga: jeśli klikniesz prawym przyciskiem myszy i uruchomisz lub zdebugujesz ten sam element (ale nie aktywność), Android Studio utworzy nową konfigurację.
Zdefiniuj konfigurację testową dla klasy lub metody
Android Studio umożliwia zdefiniowanie konfiguracji uruchomienia testowego 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 przeprowadzić testy w pozostałej części projektu, by mieć pewność, że nowy kod nie spowoduje uszkodzenia niczego w innym miejscu.
Android Studio używa szablonu Android Instrumented Tests lub Android JUnit, w zależności od zestawu źródłowego. W przypadku testu jednostkowego lokalnego możesz opcjonalnie uruchomić pokrycie kodu.
Aby utworzyć konfigurację uruchamiania/debugowania klasy lub metody w kodzie Java, wykonaj te czynności:
- Otwórz projekt w widoku Androida lub projektu.
- Otwórz plik Java w edytorze kodu.
- Wybierz klasę lub metodę w kodzie, a następnie naciśnij Control+Shift+T (Command+Shift+T).
- W wyświetlonym menu wybierz 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. 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 testu.
- Aby uruchomić 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 listę Wybierz konfigurację uruchamiania/debugowania.
- Wybierz Zapisz konfigurację obok konfiguracji, którą chcesz zapisać.
Rysunek 3. Zapisywanie konfiguracji
Uruchamianie lub debugowanie aplikacji przy użyciu zapisanej konfiguracji
Jeśli masz zapisaną konfigurację uruchamiania/debugowania, możesz wybrać ją przed uruchomieniem lub debugowaniem aplikacji.
Aby użyć zapisanej konfiguracji uruchamiania/debugowania, wykonaj te czynności:
- Wybierz konfigurację uruchamiania/debugowania z listy Wybierz konfigurację uruchamiania/debugowania na pasku narzędzi.
- Kliknij Uruchom > Uruchom lub Uruchom > Debuguj.
Lista znajduje się po lewej stronie pozycji Uruchom
i Debugowanie
, np. 
.
Możesz też kliknąć Uruchom lub Debuguj
.
Edytowanie konfiguracji uruchamiania/debugowania
Aby edytować konfigurację uruchamiania/debugowania:
- Otwórz okno Uruchamianie/debugowanie.
- Wybierz konfigurację w panelu po lewej stronie.
- W razie potrzeby zmodyfikuj konfigurację.
- Kliknij Zastosuj lub OK.
Popraw wszystkie błędy wyświetlone u dołu okna.
Edytowanie szablonu konfiguracji uruchamiania/debugowania
Możesz edytować szablony konfiguracji udostępniane w Android Studio, aby dostosować je do swojego procesu programowania. Zmodyfikowanie szablonu nie ma wpływu na istniejące konfiguracje, które z niego korzystają. 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 będą wykorzystywały podobne elementy do szablonu. Możesz skopiować konfigurację i edytować kopię, aby utworzyć nowe konfiguracje.
Aby edytować szablon, wykonaj te czynności:
- Otwórz okno Uruchamianie/debugowanie.
- 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 uruchamiania/debugowania możesz uporządkować konfiguracje, aby móc je szybko znaleźć. Możesz sortować elementy w folderze alfabetycznie i tworzyć nowe foldery dla konfiguracji grup.
Aby posortować konfiguracje alfabetycznie, wykonaj te czynności:
- Otwórz okno Uruchamianie/debugowanie.
- 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 Uruchamianie/debugowanie.
- Wybierz folder zawierający konfiguracje.
- Kliknij Utwórz nowy folder
.
- Wpisz nazwę w polu Nazwa folderu.
- Kliknij Zastosuj, aby zapisać nazwę.
Zdefiniuj działania przed opublikowaniem
Możesz określić zadania do wykonania przed zastosowaniem konfiguracji uruchamiania/debugowania. Zadania są wykonywane w kolejności, w jakiej są widoczne na liście.
Uwaga: określanie zadań przed uruchomieniem jest funkcją zaawansowaną. Zamiast korzystać z tej funkcji zalecamy umieszczenie wszystkich algorytmów przygotowawczych jako zadania w pliku build.gradle, tak aby były one wykonywane podczas kompilacji z poziomu wiersza poleceń.
Aby utworzyć listę zadań, wykonaj te czynności:
- U dołu okna Konfiguracja 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 posortować zadania, 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 przed ich zastosowaniem.
Ta opcja jest domyślnie odznaczona.
- Wybierz Okno aktywnego narzędzia, jeśli chcesz, aby okno narzędzia Uruchom lub Debugowanie 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
.
- W wyświetlonym oknie zmodyfikuj ustawienia zadania i kliknij OK.
W tabeli poniżej znajdziesz dostępne zadania, które możesz dodać.
| Zadanie | Opis |
|---|---|
| Uruchom narzędzie zewnętrzne | Uruchom aplikację zewnętrzną w stosunku do Android Studio. W oknie Narzędzia zewnętrzne wybierz co najmniej jedną 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 Utwórz narzędzia. Więcej informacji znajdziesz w sekcjach Konfigurowanie narzędzi innych firm i Narzędzia zewnętrzne. |
| Uruchom inną konfigurację | Wykonaj jedną z istniejących konfiguracji uruchamiania/debugowania. W oknie Wybierz konfigurację do wykonania wybierz konfigurację do wykonania, a następnie kliknij OK. |
| Twórz | 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. |
| Utwórz projekt | Skompiluj projekt. Android Studio wykonuje polecenie Utwórz projekt. |
| Twórz, bez sprawdzania błędów | Ta opcja jest taka sama jak w polu Make, ale Android Studio wykonuje konfigurację uruchamiania/debugowania niezależnie od wyniku kompilacji. |
| Artefakty kompilacji | Nieobsługiwane w Android Studio. |
| Uruchom zadanie Gradle | uruchomić zadanie Gradle. W wyświetlonym oknie określ szczegóły i kliknij OK. Więcej informacji znajdziesz na stronie Gradle. |
| Marka zgodna z Gradle | skompilować projekt i uruchomić Gradle; |
| Kreator 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 ułatwiają szybkie rozpoczęcie pracy. W sekcjach poniżej opisujemy szablony, które mają zastosowanie w programowaniu na Androida w Android Studio:
- Aplikacja na Androida
- Testy Androida
- Serwer DevApp Engine w App Engine
- Widżety, kafelki i tarcza zegarka z Wear OS
Uwaga: Android Studio w wersji 2.1.x lub starszej zawierał szablon aplikacji natywnej, którego nie ma w nowszych wersjach. Jeśli masz w projekcie szablon aplikacji natywnej, podczas wczytywania projektu Android Studio konwertuje go na aplikację na Androida. Okno Konwertuj projekt przeprowadzi Cię przez cały proces.
Nieobsługiwane szablony
Poniższe nieobsługiwane szablony pochodzą z IntelliJ IDEA i nie są przeznaczone wyłącznie do programowania na Androida w Android Studio. Więcej informacji o korzystaniu z tych szablonów znajdziesz, klikając linki do dokumentacji IntelliJ IDEA.
- Aplikacja
- Złożone
- Gradle
- Groovy
- Aplikacja JAR
- Java Scratch
- JUnit
- Kotlin
- Skrypt Kotlin
- 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 nich znajdziesz w artykule Ustawienia wspólne.
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
Aplikacje i aktywności na Androida możesz uruchamiać oraz debugować 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 również zawiera opcje instalacji.
| Pole | Opis |
|---|---|
| Moduł | Wybierz moduł, do którego chcesz zastosować tę konfigurację. |
| Opcje instalacji: wdróż | Wybierz opcję:
|
| Opcje instalacji: wdróż jako aplikację błyskawiczną | Jeśli Twoja aplikacja obsługuje aplikacje błyskawiczne (czyli dodasz obsługę aplikacji błyskawicznych podczas tworzenia nowego projektu lub utworzysz co najmniej 1 moduł funkcji z obsługą 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 pola 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 następnie użyć ś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 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ć. Sformatuj opcje w taki sam sposób jak w wierszu poleceń, ale bez intencji. Na przykład:
Ta opcja jest niewidoczna, jeśli dla opcji Uruchom wybierzesz wartość Nic. Domyślnie: brak opcji. |
| Opcje celu wdrożenia: cel | Wybierz opcję:
|
Opcje celu wdrożenia: używaj tego samego urządzenia przy kolejnych premierach |
Domyślnie ta opcja jest odznaczona i przy każdym uruchomieniu aplikacji wyświetla 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 aplikacja jest uruchamiana na wybranym urządzeniu bez wyświetlania okna Wybierz wdrożenie. Aby uruchomić aplikację na innym urządzeniu, odznacz opcję Używaj tego samego urządzenia w kolejnych wersjach lub zatrzymaj aplikację, klikając Uruchom > Zatrzymaj app
lub Zatrzymaj  ,
a następnie uruchom ją ponownie. Pojawi się okno Wybierz wdrożenie, w którym możesz wybrać urządzenie.
|
| Przed uruchomieniem | Patrz sekcja Definiowanie operacji przed opublikowaniem. |
Karta Różne
Na karcie Inne możesz określić opcje logcat, instalacji, uruchamiania i wdrażania. Karta Ogólne też zawiera opcje instalacji.
| Pole | Opis |
|---|---|
| Logcat: automatycznie pokazuj logcat | Jeśli wybierzesz tę opcję, przy każdym wdrożeniu i uruchomieniu aplikacji przy użyciu tej konfiguracji będzie się otwierać okno Logcat. Domyślne: wybrane. |
| 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. | Gdy ta opcja jest zaznaczona, Android Studio nie wdraża ponownie pakietu APK, jeśli wykryje, że pozostaje on bez zmian. Jeśli chcesz, aby Android Studio wymuszał instalację pakietu APK, nawet jeśli zawartość się nie zmieniła, odznacz tę opcję. Domyślnie: wybrano |
| Opcje instalacji: wymuś zatrzymanie uruchomionej aplikacji przed uruchomieniem | 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 zatrzymania aplikacji. Ta opcja działa z poprzednią opcją, która określa, czy trzeba zainstalować plik APK. W obu polach Opcje instalacji pozostaw wartości domyślne, chyba że chcesz za każdym razem wymuszać instalację. W niektórych przypadkach możesz usunąć zaznaczenie tej opcji. Jeśli na przykład piszesz silnik metody wprowadzania (IME), wymuszanie zatrzymania aplikacji spowoduje odznaczenie jej jako bieżącej klawiatury, czego możesz nie chcieć używać. Domyślnie: wybrano |
| Przed uruchomieniem | Patrz Definiowanie operacji przed uruchomieniem. |
Karta Debuger
Określ opcje debugowania na karcie Debuger.
W przypadku kodu w języku 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 działania.
W przypadku projektów C i C++ na karcie Debuger możesz dodać katalogi symboli oraz polecenia uruchamiania i publikowania LLDB. Użyj do tego 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ół listy.
Więcej informacji o debugowaniu w Android Studio znajdziesz w artykule Debugowanie aplikacji.
| Pole | Opis |
|---|---|
| Typ debugowania | Wybierz jedną z tych opcji:
Zalecamy korzystanie z opcji Wykrywaj automatycznie, ponieważ wybiera ona właściwy typ debugowania dla projektu. |
| Katalogi symboli | Jeśli chcesz dodać pliki symboli, by udostępnić debugerowi informacje w języku C lub C++ wygenerowane poza Android Studio, możesz dodać tu jeden lub więcej katalogów. Android Studio używa plików w tych katalogach zamiast plików wygenerowanych przez wtyczkę Android do Gradle. Debuger przeszukuje katalogi po kolei, aż znajdzie to, czego potrzebuje. Rekurencyjnie przeszukuje 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 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 znajdowaniem plików potrzebnych do debugowania. Jeśli na przykład masz katalog, który zawiera podkatalogi różnych interfejsów binarnych Androida (ABI), możesz dodać katalog dla konkretnego interfejsu ABI lub wszystkich interfejsów 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 startowe LLDB | Dodaj polecenia LLDB, które chcesz wykonać, zanim debuger dołączy do procesu. Możesz na przykład określić ustawienia środowiska w sposób pokazany w tym poleceniu:
LLDB wykonuje polecenia w kolejności od góry do dołu. |
| Polecenia dołączenia po publikacji w LLDB | Dodaj polecenia LLDB, które chcesz wykonać zaraz po tym, jak debuger uruchomi się w procesie. Na przykład:
LLDB wykonuje polecenia w kolejności od góry do dołu. |
| Katalog roboczy hosta | Podaj katalog roboczy LLDB. |
| Logowanie: kanały docelowe | Określ opcje logu LLDB. Android Studio ustawia opcje domyślne na podstawie doświadczeń zespołu – nie działa zbyt wolno, ale zawiera informacje potrzebne do rozwiązania problemów. Dziennik jest często potrzebny w przypadku raportów o błędach w Android Studio. Wartość domyślna to
Możesz ją zmienić, aby zebrać 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ń logu, wpisz polecenie
Android Studio umieszcza dzienniki urządzenia w tym miejscu (
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 | Patrz sekcja Definiowanie operacji przed opublikowaniem. |
Karta Profilowanie
Opcja Włącz profilowanie zaawansowane musi być zaznaczona, aby włączyć określone funkcje narzędzia do profilowania Androida, gdy na urządzeniu działa Android 7.1 lub starszy.
Testy Androida
Szablon testowy, którego należy użyć, zależy od zbioru źródłowego. Szablon Testy instrumentalne na Androida jest przeznaczony do testów instrumentalnych. Szablon JUnit na Androida dotyczy testu jednostkowego lokalnego.
Uwaga: jeśli używasz Laboratorium Firebase do testowania na różnych urządzeniach, możesz za pomocą szablonu Android JUnit zdefiniować testy zinstruowane. Więcej informacji znajdziesz w artykule Przeprowadzanie testów w Laboratorium Firebase.
Poniższe opisy kart opisują karty i pola szablonu testu instrumentowanego w Androidzie. 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ę testową, uruchomienie narzędzia, powłokę adb i opcje wdrożenia.
| Pole | Opis |
|---|---|
| Moduł | Wybierz moduł, do którego chcesz zastosować tę konfigurację. |
| Testowanie | W tym obszarze określ lokalizację testów, które chcesz przeprowadzić:
|
| Uruchamianie odpowiedniego narzędzia (opcjonalnie) | Wpisz lokalizację programu uruchamiającego instrumenty i kliknij Więcej, aby otworzyć okno. Plik build.gradle określa lokalizację mechanizmu uruchamiania narzędzi i zastępuje ją. Wartością domyślną jest zwykle klasa AndroidJUnitRunner z AndroidX Test.
|
| Opcje dodatkowe | Wpisz opcje narzędzia adb Wartość domyślna: brak opcji. |
| Opcje celu wdrożenia: cel | Wybierz opcję:
|
| Opcje celu wdrożenia: używaj tego samego urządzenia przy kolejnych premierach | Jeśli w przyszłości chcesz automatycznie używać urządzenia wybranego w oknie Wybierz cel wdrożenia, wybierz tę opcję. Jeśli urządzenie nie jest dostępne, pojawi się okno. Domyślnie: odznaczone |
| Przed uruchomieniem | Patrz sekcja Definiowanie operacji przed opublikowaniem. |
Karta Różne
Karta Inne zawiera opcje instalacji narzędzia 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 | Gdy ta opcja jest zaznaczona, Android Studio nie wdraża ponownie pakietu APK, jeśli wykryje, że pozostaje on bez zmian. Jeśli chcesz, by Android Studio wymuszał instalację pakietu APK, nawet jeśli nie został on zmieniony, odznacz tę opcję. Domyślnie: wybrano |
| Opcje instalacji: wymuś zatrzymanie uruchomionej aplikacji przed uruchomieniem | 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 zatrzymania aplikacji. Ta opcja działa w połączeniu z poprzednią opcją, która określa, czy trzeba zainstalować plik APK. W obu polach Opcje instalacji pozostaw wartości domyślne, chyba że chcesz za każdym razem wymuszać instalację. W niektórych przypadkach możesz usunąć zaznaczenie tej opcji. Jeśli na przykład piszesz silnik metody wprowadzania (IME), wymuszanie zatrzymania aplikacji spowoduje odznaczenie jej jako bieżącej klawiatury, czego możesz nie chcieć używać. Domyślnie: wybrano |
| Przed uruchomieniem | Patrz sekcja Definiowanie operacji przed opublikowaniem. |
Karta Debuger
Określ opcje debugowania na karcie Debuger.
W przypadku kodu w języku 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 działania.
W przypadku projektów C i C++ na karcie Debuger możesz dodać katalogi symboli oraz polecenia uruchamiania i publikowania LLDB. Użyj do tego 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ół listy.
Więcej informacji o debugowaniu w Android Studio znajdziesz w artykule Debugowanie aplikacji.
| Pole | Opis |
|---|---|
| Typ debugowania | Wybierz jedną z tych opcji:
Zalecamy korzystanie z opcji Wykrywaj automatycznie, ponieważ wybiera ona właściwy typ debugowania dla projektu. |
| Katalogi symboli | Jeśli chcesz dodać pliki symboli, by udostępnić debugerowi informacje w języku C lub C++ wygenerowane poza Android Studio, możesz dodać tu jeden lub więcej katalogów. Android Studio używa plików w tych katalogach zamiast plików wygenerowanych przez wtyczkę Android do Gradle. Debuger przeszukuje katalogi po kolei, aż znajdzie to, czego potrzebuje. Rekurencyjnie przeszukuje 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 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 znajdowaniem plików potrzebnych do debugowania. Jeśli na przykład masz katalog, który zawiera podkatalogi różnych interfejsów binarnych Androida (ABI), możesz dodać katalog dla konkretnego interfejsu ABI lub wszystkich interfejsów 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 startowe LLDB | Dodaj polecenia LLDB, które chcesz wykonać, zanim debuger dołączy do procesu. Możesz na przykład określić ustawienia środowiska w sposób pokazany w tym poleceniu:
LLDB wykonuje polecenia w kolejności od góry do dołu. |
| Polecenia dołączenia po publikacji w LLDB | Dodaj polecenia LLDB, które chcesz wykonać zaraz po tym, jak debuger uruchomi się w procesie. Na przykład:
LLDB wykonuje polecenia w kolejności od góry do dołu. |
| Katalog roboczy hosta | Podaj katalog roboczy LLDB. |
| Logowanie: kanały docelowe | Określ opcje logu LLDB. Android Studio ustawia opcje domyślne na podstawie doświadczeń zespołu – nie działa zbyt wolno, ale zawiera informacje potrzebne do rozwiązania problemów. Dziennik jest często potrzebny w przypadku raportów o błędach w Android Studio. Wartość domyślna to
Możesz ją zmienić, aby zebrać 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ń logu, wpisz polecenie
Android Studio umieszcza dzienniki urządzenia w tym miejscu (
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 | Patrz sekcja Definiowanie operacji przed opublikowaniem. |
Serwer aplikacji deweloperskich w App Engine
Ta konfiguracja uruchamiania/debugowania ma zastosowanie do Google Cloud Platform. Więcej informacji znajdziesz w artykule na temat
uruchamiania, testowania i wdrażania 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 IntellJ 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 wykonywane jest tylko jedno wystąpienie konfiguracji uruchamiania/debugowania. Nie można stosować jednocześnie wielu uruchomień tej samej konfiguracji. Domyślnie: wybrano |
| Moduł | Wybierz moduł, do którego chcesz zastosować tę konfigurację. |
| Synchronizuj z konfiguracją build.gradle | Jeśli dodasz moduł App Engine i zsynchronizujesz go z plikiem build.gradle, pola konfiguracji App Engine DevAppServer zostaną wypełnione za Ciebie (zalecane).
Wybranie opcji Plik > Synchronizuj projekt z plikami Gradle spowoduje też synchronizację projektu. Domyślnie: wybrano
|
| 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, którą wdrażasz na lokalnym serwerze programistycznym. Kliknij ..., aby wybrać go w oknie. |
| Argi maszyn wirtualnych | 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. Domyślnie: brak opcji |
| Adres serwera | Wpisz adres hosta dla serwera. Być może trzeba będzie podać adres, by uzyskać dostęp do serwera programistycznego z innego komputera w sieci. Adres 0.0.0.0 zapewnia dostęp zarówno do lokalnego hosta, jak i do nazwy hosta. Domyślnie: localhost |
| Port serwera | Wpisz numer portu serwera. Domyślnie: 8080 |
| Wyłącz sprawdzanie dostępności aktualizacji pakietu SDK App Engine | W takim przypadku serwer programistyczny nie kontaktuje się z App Engine, by sprawdzić dostępność nowej wersji pakietu SDK. Domyślnie serwer podczas uruchamiania sprawdza dostępność nowej wersji i wyświetla komunikat, jeśli jest dostępna nowa wersja. |
| Przed uruchomieniem | Patrz sekcja Definiowanie operacji przed opublikowaniem. |
Konfiguracje uruchamiania i debugowania na Wear OS
Szablony komplikacji, kafelków i tarczy zegarka na 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, które są bardziej szczegółowe w przypadku konfiguracji uruchamiania/debugowania na Wear OS:
- W przypadku wszystkich konfiguracji uruchamiania/debugowania 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 kodzie.
- W przypadku konfiguracji uruchamiania/debugowania komplikacji na Wear OS musisz wybrać przedział, w którym chcesz umieścić dane widżetu dostarczone przez źródło danych widżetu. Możesz umieścić go u góry, po prawej, u dołu, lewej lub w tle tarczy zegarka.
- W przypadku konfiguracji uruchamiania/debugowania kompilacji na Wear OS musisz też wybrać typ danych widżetu dostarczanych przez źródło danych widżetu. Dostępne typy są ograniczone do tych dostarczanych przez wybrane źródło danych widżetu oraz obsługiwane przez wybrany przedział. Listę typów danych widżetów znajdziesz w artykule Typy i pola.
Możesz też uruchomić te powierzchnie za pomocą ikony rynien, która znajduje się obok deklaracji powierzchni, jak pokazano na ilustracji poniżej.
