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:
Konfiguracje uruchamiania i debugowania
Konfiguracje uruchamiania i debugowania określają takie szczegóły, jak opcje instalacji, uruchamiania i testowania aplikacji. Możesz zdefiniować konfigurację na potrzeby jednorazowego użycia lub zapisać ją 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/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ę uruchomienia/debugowania (ale nie szablonu) możesz udostępnić za pomocą systemu kontroli wersji. Więcej informacji o udostępnianiu konfiguracji znajdziesz w artykule Nazywanie i udostępnianie opcji konfiguracji.
Otwórz okno Konfiguracje uruchamiania/debugowania
Aby otworzyć okno Konfiguracje wykonywania 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. U dołu możesz edytować szablony 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
- Sortuj 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 tymczasowych konfiguracji. Więcej informacji o tym, jak tworzyć i zapisywać tymczasowe konfiguracje, 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 zmień 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ę uruchomienia lub debugowania.
- Kliknij Kopiuj konfigurację
.
- Wpisz nazwę w polu Nazwa.
- W razie potrzeby zmień 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, w którym miejscu w projekcie chcesz, aby Android Studio umieścił 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 przy użyciu 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ę uruchomienia lub debugowania z listy 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.
- 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ć kopię, aby utworzyć nowe konfiguracje.
Aby edytować szablon:
- Otwórz okno Konfiguracje uruchamiania/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/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 zmieniać kolejność zadań, przeciągaj je lub wybierz zadanie i kliknij W górę
oraz W dół
, aby przesuwać je w górę lub w dół na liście. - Jeśli chcesz wyświetlić ustawienia konfiguracji przed ich zastosowaniem, wybierz Pokaż tę stronę.
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 potem 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 dotychczasowych konfiguracji uruchamiania i debugowania. W oknie Wybieranie konfiguracji do wykonania wybierz konfigurację do wykonania, a następnie kliknij OK. |
| Zrób | Kompiluj projekt lub moduł. Jeśli konfiguracja uruchomienia/debugowania określa konkretny moduł, Android Studio wykonuje polecenie MakeModule, a jeśli nie są określone żadne moduły, wykonuje polecenie MakeProject. |
| Make Project | Kompiluj projekt. Android Studio wykonuje polecenie Make Project. |
| Make, no error check | Ta opcja jest taka sama jak Utwórz, z tym wyjątkiem, że Android Studio wykonuje konfigurację uruchamiania/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ł 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. Przykład:
Ta opcja nie jest widoczna, jeśli wybrana wartość Uruchomienia 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 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 przymusowo za każdym razem. W niektórych przypadkach możesz odznaczyć tę opcję. Jeśli na przykład przekształcasz 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
Określ opcje debugowania na karcie Debugger.
W przypadku kodu C i C++ Android Studio używa debugera LLDB. Oprócz standardowego interfejsu Android Studio okno debuggera zawiera kartę LLDB, która umożliwia wpisywanie poleceń 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. 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 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. Przykład:
LLDB wykonuje polecenia w kolejności od góry do dołu. |
| Katalog roboczy hosta | Określ katalog roboczy LLDB. |
| Logowanie: kanały docelowe | Określ opcje dziennika LLDB. Android Studio ustawia opcje domyślne na podstawie doświadczeń zespołu, dzięki czemu nie jest zbyt wolne, ale zawiera potrzebne informacje 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 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 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ódeł. Szablon testów z instrumentacją na Androida jest przeznaczony do testu z instrumentacją. Szablon Android JUnit służy do lokalnego testowania jednostkowego.
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 działania/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 zazwyczaj 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 wymusić instalację za każdym razem. W niektórych przypadkach możesz odznaczyć tę opcję. Jeśli na przykład przekształcasz 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
Określ opcje debugowania na karcie Debugger.
W przypadku kodu C i C++ Android Studio używa debugera LLDB. Oprócz standardowego interfejsu Android Studio okno debuggera zawiera kartę 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 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. Przykład:
LLDB wykonuje polecenia w kolejności od góry do dołu. |
| Katalog roboczy hosta | Określ katalog roboczy LLDB. |
| Logowanie: kanały docelowe | Określ opcje dziennika LLDB. Android Studio ustawia opcje domyślne na podstawie doświadczeń zespołu, dzięki czemu nie jest zbyt wolne, ale zawiera potrzebne informacje 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 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 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 pozwala na jednoczesne uruchamianie wielu 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 zezwala na dostęp zarówno do localhost, jak i 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 aplikacji na Androida. Oto opcje bardziej szczegółowe dotyczące 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 kompilacji/debugowania na potrzeby widżetu na Wear OS musisz wybrać miejsce, w którym chcesz umieścić dane widżetu pochodzące ze źródła danych 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 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 poziomej ikony, która znajduje się obok deklaracji powierzchni, jak pokazano na poniższym obrazie. Jeśli wystąpi błąd, np. „Błąd podczas ustawiania kafelka”, sprawdź, czy powierzchnia jest prawidłowo skonfigurowana, w tym oznaczona w pliku manifestu.
