Rozwiązywanie problemów z Androidem Studio

Ta strona zawiera wskazówki dotyczące rozwiązywania typowych problemów i problemów z konfiguracją w Android Studio.

Ekrany o dużej gęstości

Od wersji 1.5 Android Studio zapewnia obsługę wyświetlaczy o wysokiej rozdzielczości (np. monitorów HiDPI i Retina) na wszystkich platformach.

Ustawienia współczynnika skalowania

Android Studio określa współczynnik skalowania wyświetlacza w ten sposób:

Mac

W przypadku wyświetlaczy Retina elementy interfejsu są skalowane w 200%, a obrazy renderowane w wysokiej rozdzielczości. Dzięki skalowaniu nie powinno być żadnych rozmyć, nawet w przypadku konfiguracji z kilkoma monitorami. Pamiętaj, że nie obsługujemy współczynników skalowania innych niż 100% (wyświetlacze inne niż Retina) i 200% (wyświetlacze Retina).

Windows

Android Studio określa współczynnik skalowania elementów interfejsu na podstawie ustawień DPI wyświetlacza głównego. Jeśli współczynnik skalowania obrazów jest mniejszy niż 150%, obrazy o normalnej rozdzielczości są skalowane w górę. Jeśli współczynnik skalowania przekracza 150%, obrazy o wysokiej rozdzielczości są odpowiednio skalowane.

Linux

Android Studio określa współczynnik skalowania, sprawdzając opcję „Współczynnik skalowania tekstu”, a następnie wybierając ustawienie DPI systemu XWindow.

Ustawienie DPI wynoszące 96 odpowiada współczynnikowi skalowania 100% (bez skalowania), a ustawienie DPI 192 odpowiada współczynnikowi skalowania równemu 200% (rozmiar elementów interfejsu jest podwojony). Android Studio obsługuje obecnie ustawienia DPI w przedziale od 96 (skalowanie 100%) do 288 (skalowanie 300%). Jeśli Android Studio nie wykryje prawidłowej wartości DPI systemu na komputerze z systemem Linux lub Windows, możesz ustawić ją ręcznie, ustawiając właściwość hidpi w pliku idea.properties zgodnie z opisem w sekcji Dostosowywanie właściwości IDE. Pamiętaj, że ta właściwość nie ma wpływu na komputery Mac. Właściwość ta działa w ten sposób:

hidpi=true

Ustawia DPI na 192 (skalowanie 200%), ignorując ustawienia systemu.

hidpi=false

Ustawia DPI na 96 (skalowanie 100%), ignorując ustawienia systemu.

Rozmyte lub rozpikselowane elementy na wyświetlaczach o dużej gęstości

Jeśli co najmniej jeden element interfejsu Android Studio jest rozmyty lub rozpikselowany na wyświetlaczu o dużej gęstości, może występować jeden z tych problemów:

• Jeśli większość interfejsu Androida Studio wygląda dobrze, ale 1 konkretna ikona jest rozmyta lub rozpikselowana albo jeden element interfejsu używa czcionki o niewłaściwym rozmiarze, prawdopodobnie dany element nie został jeszcze w pełni zaktualizowany pod kątem obsługi HiDPI. Zgłoś błąd, klikając Pomoc > Prześlij opinię. Dołącz zrzut ekranu i jak najwięcej informacji o konfiguracji systemu.
• Jeśli używasz komputera z systemem Windows lub Linux, a wyświetlacz używa współczynnika skalowania innego niż 100% lub 200%, obraz może być nieco rozmyty ze względu na skalowanie.
• Jeśli używasz komputera z systemem Windows i zmienisz rozmiar czcionki systemu Windows w panelu sterowania, czcionka może być rozmyta lub rozpikselowana. Aby rozwiązać ten problem, wyloguj się z systemu Windows, a następnie zaloguj się ponownie.
• W przypadku konfiguracji z kilkoma monitorami z systemem Windows 8.1 lub nowszym przeniesienie okna z jednego ekranu na inny o innej rozdzielczości lub DPI może spowodować problemy z czcionkami lub obrazami (zobacz błąd 186007). Obecnie nie ma znanego obejścia.
• W starszych wersjach środowiska JRE 1.8 występowały problemy z rozmytymi czcionkami (w szczególności dla środowiska JRE 1.8.0_25-b18 amd64, patrz błąd 192316). Od wersji 2.2 Android Studio zawiera pakiet najnowszej obsługiwanej wersji JDK, w tym JDE. Aby rozwiązać ten problem, zaktualizuj Androida Studio do wersji 2.2 lub nowszej i przełącz się na pakiet JDK. Aby to zrobić, kliknij Plik > Struktura projektu > Lokalizacja pakietu SDK i zaznacz pole wyboru Użyj umieszczonego pakietu JDK.

niewłaściwy rozmiar elementów na wyświetlaczach o dużej gęstości;

Jeśli cały interfejs Androida Studio ma nieprawidłowy rozmiar na wyświetlaczu o dużej gęstości, przeczytaj sekcję Ustawienia współczynnika skalowania. Jeśli niektóre elementy interfejsu Android Studio mają niewłaściwy rozmiar na wyświetlaczu o dużej gęstości, a inne mają prawidłowy rozmiar, może występować jeden z tych problemów:

• Jeśli używasz niestandardowego schematu edytora, czcionka edytora może być za mała lub za duża w porównaniu do innych elementów interfejsu na wyświetlaczu o dużej gęstości. Aby rozwiązać ten problem, kliknij Plik > Ustawienia, a następnie Edytor > Kolory i czcionki > Czcionka i zmień rozmiar czcionki edytora. Gdy aktywny jest schemat domyślny, rozmiar czcionki edytora jest automatycznie skalowany (patrz błąd 186920).
• Jeśli niektóre elementy interfejsu Android Studio mają prawidłowy rozmiar, a inne są za małe lub za duże, może występować problem 186923. Zgłoś błąd, klikając Pomoc > Prześlij opinię. Dołącz zrzut ekranu i jak najwięcej informacji o konfiguracji systemu.

Problemy z synchronizacją projektu

Podczas próby synchronizacji projektu może pojawić się komunikat o błędzie „Odmowa połączenia z Internetem. (Odmowa uprawnień: połącz.)”. Aby rozwiązać ten problem, dodaj właściwość systemową -Djava.net.preferIPv4Stack=true do pliku gradle.properties w Android Studio w ten sposób:

1. Otwórz plik gradle.properties w Android Studio.
2. Dodaj do pliku ten wiersz:

   org.gradle.jvmargs=-Djava.net.preferIPv4Stack=true
   

   Pamiętaj, że jeśli do pliku gradle.properties zostały już dodane inne argumenty Gradle JVM, możesz dodać tę właściwość do tego samego wiersza, co pokazano w tym przykładzie:

   org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -Djava.net.preferIPv4Stack=true
   

3. Ponownie uruchom Android Studio, aby zastosować zmiany.
4. Kliknij Synchronizuj projekt z plikami Gradle, aby zsynchronizować projekt.

Problemy z aktualizowaniem IDE w systemie Windows

W systemie Windows nie można usunąć plików używanych przez proces. Gdy próbujesz użyć wbudowanego mechanizmu aktualizacji w IDE, czasami odmawia on zainstalowania aktualizacji, zwykle wyświetlając komunikat o błędzie, taki jak „Nie można usunąć pliku C:\jakaś\ścieżka\file”.

Aby obejść ten problem, otwórz menedżera zadań i spróbuj zamknąć procesy, które mogą korzystać z pliku, takie jak demony Gradle.

Problemy z minSdkVersion

Jeśli używasz przestarzałej wersji Bibliotek pomocy Androida, może pojawić się komunikat o błędzie podobny do tego:

:app:processDebugManifest app/src/main/AndroidManifest.xml:0:0 Error:
uses-sdk:minSdkVersion 19 cannot be smaller than version L declared in library app/build/intermediates/exploded-aar/com.android.support/appcompat-v7/21.0.0-rc1/AndroidManifest.xml
Suggestion: use tools:overrideLibrary="android.support.v7.appcompat" to force usage

Aby rozwiązać ten problem, zaktualizuj Bibliotekę pomocy Androida do najnowszych wersji (dostępnych w wersji testowej) za pomocą menedżera pakietów SDK. Więcej informacji o konfigurowaniu bibliotek pomocy znajdziesz w artykule o konfigurowaniu bibliotek pomocy.

Problemy z emulatorem Androida

Zobacz Rozwiązywanie problemów z emulatorem Androida.

Katalogi

Katalogi wymienione poniżej służą Android Studio do przechowywania ustawień, pamięci podręcznych, wtyczek i logów.

Katalog jest wymieniony w takim formacie:

• <informal directory name> (<IDE property>): <default path>.

Zastąp:

• AndroidStudio nazwą produktu, czyli AndroidStudio w przypadku wersji stabilnych lub AndroidStudioPreview w przypadku wersji beta i Canary.
• VERSION i podaj wersję. np. 2023.1 lub 2023.3.