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. Konfigurację możesz zdefiniować na potrzeby jednorazowego użycia lub zapisać na przyszłość. Po zapisaniu możesz wybrać konfigurację na liście Wybierz konfigurację do uruchomienia lub debugowania na pasku narzędzi. Android Studio zapisuje konfiguracje w ramach projektu.
Początkowo utworzona konfiguracja uruchamiania i debugowania
Podczas tworzenia projektu 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ę uruchomienia/debugowania (ale nie szablonu) możesz udostępnić za pomocą systemu 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 do uruchomienia lub debugowania, kliknij Uruchom > Edytuj konfiguracje. Pojawi się okno Konfiguracje uruchamiania i debugowania (patrz rys. 1).
Rysunek 1 okno Konfiguracje uruchamiania i debugowania,
Panel po lewej stronie okna grupuje zdefiniowane konfiguracje według typu szablonu, a u dołu umożliwia edycję 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 i debugowania wyświetlają się konfiguracje uruchamiania i debugowania oraz dostępne szablony konfiguracji. Nową konfigurację możesz utworzyć bezpośrednio na podstawie szablonu lub 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ć.
Jeśli utworzysz konfigurację poza oknem Uruchomienie/Debugowanie Konfiguracje, będzie 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 zmodyfikuj konfigurację.
- Kliknij Zastosuj lub OK.
Pamiętaj, aby poprawić błędy wyświetlane na dole 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 jednostkowy lokalny, 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ę wykonywania/debugowania dla elementu w projekcie:
- 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 nowe zajęcia, możesz utworzyć test i go przeprowadzić. 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ódeł. 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 Tworzenie Test zmień opcjonalnie wartości lub ustaw je i kliknij OK.
- W oknie Wybierz katalog docelowy wybierz, gdzie w projekcie ma zostać umieszczony 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ódeł 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 za pomocą zapisanej konfiguracji
Jeśli zapiszesz 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ę wykonywania lub debugowania na liście Wybierz konfigurację wykonywania 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.
- W panelu po lewej stronie wybierz konfigurację.
- W razie potrzeby zmodyfikuj konfigurację.
- Kliknij Zastosuj lub OK.
Pamiętaj, aby poprawić błędy wyświetlane na dole 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 np. chcesz utworzyć kilka konfiguracji danego typu, możesz edytować szablon, a potem przywrócić go do poprzedniego stanu.
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.
Pamiętaj, aby poprawić błędy wyświetlane na dole 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 Sortuj konfiguracje
.
- 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.
Określ operacje przed uruchomieniem
Przed zastosowaniem konfiguracji uruchomienia/debugowania możesz określić zadania do wykonania. 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ń:
- 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 listę dostępnych zadań, 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 Wybieranie konfiguracji do wykonania wybierz konfigurację do wykonania, a następnie kliknij OK. |
| Marka | Kompiluj projekt lub moduł. Jeśli konfiguracja uruchomienia/debugowania określa konkretny moduł, Android Studio wykonuje polecenie Make Module, a jeśli nie są określone żadne moduły, wykonuje polecenie Make Project. |
| Make Project | Kompiluj 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 i kliknij OK. Więcej informacji znajdziesz w Gradle. |
| Make obsługujący Gradle | Kompiluj projekt i uruchamiaj Gradle. |
| Budowniczy Gradle App Engine | Zadanie kompilatora Gradle App Engine synchronizuje projekt, a potem kompiluje moduł. |
Szablony konfiguracji
Android Studio udostępnia szablony konfiguracji, które pomogą Ci szybko rozpocząć pracę. W poniższych sekcjach opisano szablony, które można stosować do tworzenia aplikacji na Androida w Android Studio:
- Aplikacja na Androida
- Testy Androida
- App Engine DevAppServer
- Widżet, kafelek 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 tym celu możesz skorzystać z okna Konwertowanie projektu.
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 korzystaniu z tych szablonów znajdziesz w dokumentacji IntelliJ IDEA.
- Aplikacja
- Złożony
- Gradle
- Groovy
- Plik JAR aplikacji
- Java Scratch
- JUnit
- Kotlin
- Kotlin Script
- Debugowanie zdalne
- Skrypt powłoki
- TestNG
Typowe opcje konfiguracji
Opcje Nazwa, Zezwalaj na równoległe wykonywanie i Zapisz 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 pojedynczych plikach XML w folderze project_directory/.idea/runConfigurations/.
Więcej informacji znajdziesz w sekcji Format oparty 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. 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 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 adb pm
install, których chcesz użyć. Formatuj opcje w taki sam sposób jak w wierszu poleceń, ale bez ścieżki. Oto przykłady:
i
Wartość domyślna: brak opcji. |
| Opcje uruchamiania: uruchom | Wybierz opcję:
|
| Opcje uruchamiania: flagi uruchamiania | Wpisz opcje adb am
start, których chcesz użyć. Formatuj opcje tak samo jak na wierszu poleceń, ale bez intencji. Może to obejmować np. te funkcje:
Ta opcja nie jest widoczna, jeśli wybrana wartość Uruchom to Nic. 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 wyświetlaj 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: czyszczenie dziennika 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 pakiet APK się nie zmienił. | 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 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 z poprzednią opcją, która określa, czy pakiet APK ma być zainstalowany. Pozostaw domyślne wartości pól Opcje instalacji, chyba że chcesz, aby instalacja była przeprowadzana przy każdej aktualizacji. W niektórych przypadkach możesz odznaczyć tę opcję. Jeśli na przykład zmieniasz metodę wprowadzania, wymuszenie zatrzymania aplikacji spowoduje odznaczenie jej jako bieżącej klawiatury, co może nie być pożądanym działaniem. Domyślnie: wybrane |
| Przed uruchomieniem | Zobacz sekcję Defining Before Launch Operations (Defining Before Launch Operations). |
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. Aby to zrobić, użyj 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 preferuje pliki z tych katalogów w porównaniu z plikami wygenerowanymi przez wtyczkę Androida do obsługi 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 mają być wykonywane 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. Może to obejmować np. te funkcje:
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 opcje domyślne 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 zgłoszeń błędów w Android Studio. Domyślnie
Możesz zmienić domyślne ustawienie, aby uzyskać więcej informacji. Na przykład te opcje dziennika 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 więcej użytkowników, dzienniki są umieszczane w tej lokalizacji, gdzie
Informacje o używaniu LLDB do debugowania zdalnego znajdziesz w artykule Debugowanie zdalne. |
| Przed uruchomieniem | Zobacz sekcję Defining Before Launch Operations (Definiowanie operacji przed uruchomieniem). |
Karta Profilowanie
Aby włączyć niektóre funkcje w Profilu 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ódeł. Szablon testów z instrumentacją na Androida jest przeznaczony do testu z instrumentacją. Szablon Android JUnit służy do testowania jednostkowego na urządzeniu lokalnym.
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 w szablonie testu JUnit na Androida znajdziesz na stronie Konfigurowanie uruchamiania/debugowania: JUnit w IntelliJ.
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ć:
|
| Określony program do wykonywania testów (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 jest niedostępne, pojawi się okno dialogowe. 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: czyszczenie dziennika 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 się nie zmienił | 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 plik 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 odznaczyć tę opcję. Jeśli na przykład zmieniasz metodę wprowadzania, wymuszenie zatrzymania aplikacji spowoduje odznaczenie jej jako bieżącej klawiatury, co może nie być pożądanym działaniem. Domyślnie: wybrane |
| 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. Aby to zrobić, użyj 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 preferuje pliki z tych katalogów w porównaniu z plikami wygenerowanymi przez wtyczkę Androida do obsługi 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 mają być wykonywane 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. Może to obejmować np. te funkcje:
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 opcje domyślne 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 zgłoszeń błędów w Android Studio. Domyślnie
Możesz zmienić domyślne ustawienie, aby uzyskać więcej informacji. Na przykład te opcje dziennika 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 więcej użytkowników, dzienniki są umieszczane w tej lokalizacji, gdzie
Informacje o używaniu LLDB do debugowania zdalnego znajdziesz w artykule Debugowanie zdalne. |
| 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 AppEngine Server w IntelliJ IDEA to inny szablon, który nie jest dostępny w Android Studio.
| Pole | Opis |
|---|---|
| Tylko pojedyncza instancja | Wybierz tę opcję, jeśli chcesz mieć pewność, że w danym momencie jest wykonywana tylko jedna instancja konfiguracji uruchomienia lub debugowania. Nie można jednocześnie uruchamiać kilkukrotnie 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 (zalecane).
Projekt można też zsynchronizować, wybierając Plik > Synchronizuj projekt z plikami Gradle. Domyślnie: wybrane
|
| Pakiet SDK App Engine | Na komputerze lokalnym wpisz ścieżkę do pakietu Google App Engine SDK dla Javy. Aby wybrać opcję, kliknij …. |
| 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ć maszynie wirtualnej na potrzeby uruchamiania serwera DevAppServer. Podczas określania opcji:
Więcej informacji o opcjach maszyny wirtualnej 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, którego chcesz użyć na serwerze. Wartość domyślna: 8080 |
| Wyłączanie sprawdzania aktualizacji pakietu SDK App Engine | Jeśli zostanie podany, serwer deweloperski nie będzie kontaktować się z App Engine w celu sprawdzenia dostępności 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 w opcjach aplikacji na Androida. Oto opcje bardziej specyficzne dla konfiguracji uruchamiania i debugowania na Wear OS:
- W przypadku wszystkich konfiguracji Wear do uruchamiania i debugowania musisz wybrać konkretne źródło danych widżetu, kafelka lub tarczy zegarka (w zależności od szablonu), do którego ma zostać zastosowana konfiguracja. 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, spośród których możesz wybierać, są ograniczone do tych, które są udostępniane przez wybrane źródło danych komplikacji i obsługiwane przez wybrany slot. Listę typów danych widżetów znajdziesz w sekcji 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.
