Rozwiązywanie problemów z Androidem Studio

Na tej stronie znajdziesz wskazówki dotyczące rozwiązywania typowych problemów i problemów z konfiguracją w Android Studio.

Wyświetlacze o wysokiej gęstości pikseli

Od wersji 1.5 Android Studio obsługuje wyświetlacze o wysokiej gęstości pikseli (np. monitory HiDPI i Retina) na wszystkich platformach.

Ustawienia współczynnika skalowania

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

Mac
Na wyświetlaczach Retina elementy interfejsu są skalowane o 200%, a obrazy są renderowane w wysokiej rozdzielczości. Nie powinno być rozmycia spowodowanego skalowaniem, nawet w konfiguracjach z wieloma monitorami. Pamiętaj, że nie ma obsługi współczynników skalowania innych niż 100% (w przypadku wyświetlaczy innych niż Retina) i 200% (w przypadku wyświetlaczy Retina).
Windows
Android Studio używa ustawień DPI wyświetlacza głównego do określania współczynnika skalowania elementów interfejsu. W przypadku obrazów, jeśli współczynnik skalowania jest mniejszy niż 150%, obrazy o normalnej rozdzielczości są powiększane. Jeśli współczynnik skalowania jest większy niż 150%, obrazy w wysokiej rozdzielczości są odpowiednio skalowane.
Linux
Android Studio określa współczynnik skalowania, sprawdzając „Współczynnik skalowania tekstu”, a następnie ustawienie DPI systemu XWindow.
Ustawienie DPI na poziomie 96 odpowiada współczynnikowi skalowania 100% (bez skalowania), a ustawienie DPI na poziomie 192 odpowiada współczynnikowi skalowania 200% (rozmiar elementów interfejsu jest podwojony). Android Studio obsługuje obecnie ustawienia DPI w zakresie od 96 dpi (skalowanie 100%) do 288 dpi (skalowanie 300%). Jeśli Android Studio nie wykryje prawidłowego DPI systemu na komputerze z systemem Linux lub Windows, możesz ustawić go ręcznie, ustawiając właściwość hidpi w pliku idea.properties zgodnie z opisem w artykule Dostosowywanie właściwości IDE. Ta właściwość nie ma wpływu na komputery Mac. Ta właściwość 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.

Nieostre lub rozpikselowane elementy na wyświetlaczach o wysokiej gęstości pikseli

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

  • Jeśli większość interfejsu Android Studio wygląda dobrze, ale jedna z ikon jest rozmyta lub rozpikselowana albo jeden z elementów interfejsu używa czcionki o nieprawidłowym rozmiarze, prawdopodobnie ten element nie został jeszcze w pełni zaktualizowany pod kątem obsługi ekranów HiDPI. Aby zgłosić błąd, kliknij 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 ma współczynnik skalowania inny niż 100% lub 200%, obrazy mogą być nieco rozmyte z powodu skalowania.
  • Jeśli używasz komputera z systemem Windows i zmienisz rozmiar czcionki 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 wieloma monitorami z systemem Windows 8.1 lub nowszym, gdy przenosisz okno z jednego monitora na drugi o innej rozdzielczości lub DPI, mogą wystąpić problemy z czcionkami lub obrazami (zobacz błąd 186007). Obecnie nie ma znanego sposobu obejścia tego problemu.
  • Starsze wersje JRE 1.8 miały problem z rozmazanymi czcionkami (w szczególności JRE 1.8.0_25-b18 amd64, patrz błąd 192316). Od wersji 2.2 Android Studio zawiera dołączoną wersję najnowszego obsługiwanego pakietu JDK, który zawiera JDE. Aby rozwiązać ten problem, zaktualizuj Androida Studio do wersji 2.2 lub nowszej i zacznij używać dołączonego pakietu JDK. W tym celu kliknij File > Project Structure > SDK Location (Plik > Struktura projektu > Lokalizacja pakietu SDK) i zaznacz pole wyboru Use embedded JDK (Użyj wbudowanego pakietu JDK).

Elementy o nieprawidłowym rozmiarze na wyświetlaczach o wysokiej gęstości pikseli

Jeśli cały interfejs Android Studio ma nieprawidłowy rozmiar na wyświetlaczu o wysokiej gęstości pikseli, zapoznaj się z sekcją Ustawienia współczynnika skalowania. Jeśli niektóre elementy interfejsu Android Studio mają nieprawidłowy rozmiar na wyświetlaczu o wysokiej rozdzielczości, ale inne są wyświetlane prawidłowo, może to oznaczać jeden z tych problemów:

  • Jeśli używasz niestandardowego schematu edytora, czcionka edytora może być zbyt mała lub zbyt duża w porównaniu z pozostałymi elementami interfejsu na wyświetlaczu o wysokiej gęstości pikseli. Aby rozwiązać ten problem, kliknij Plik > Ustawienia, a potem kliknij Edytor > Kolory i czcionki > Czcionka i zmień rozmiar czcionki edytora. Pamiętaj, że gdy aktywny jest domyślny schemat, rozmiar czcionki edytora jest automatycznie skalowany (zobacz błąd 186920).
  • Jeśli niektóre elementy interfejsu Androida Studio mają odpowiedni rozmiar, ale inne są za małe lub za duże, może to być problem 186923. Aby zgłosić błąd, kliknij Pomoc > Prześlij opinię. Dołącz zrzut ekranu i podaj jak najwięcej informacji o konfiguracji systemu.

Problemy z synchronizacją projektów

Podczas próby synchronizacji projektu może pojawić się ten komunikat o błędzie: „Odmowa połączenia z internetem. („Odmowa uprawnień: połączenie”). 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 tego pliku ten wiersz: 
    org.gradle.jvmargs=-Djava.net.preferIPv4Stack=true
    Jeśli w pliku gradle.properties masz już inne argumenty JVM Gradle, możesz dodać tę właściwość w tym samym wierszu, jak pokazano w tym przykładzie: 
    org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -Djava.net.preferIPv4Stack=true
  3. Aby zmiany zaczęły obowiązywać, ponownie uruchom Android Studio.
  4. Aby zsynchronizować projekt, kliknij Sync Project with Gradle Files (Synchronizuj projekt z plikami Gradle).

Problemy z aktualizacją IDE w systemie Windows

W systemie Windows nie można usuwać 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, np. „Nie można usunąć C:\some\path\file”.

Aby to obejść, otwórz Menedżera zadań i spróbuj zakończyć procesy, które mogą używać pliku, np. demony Gradle.

Problemy z parametrem minSdkVersion

Jeśli używasz starszej wersji bibliotek pomocy Androida, może pojawić się taki komunikat o błędzie:

: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, użyj menedżera pakietów SDK, aby zaktualizować biblioteki pomocy Androida do najnowszych wersji (nie wersji podglądowych). Więcej informacji o konfigurowaniu bibliotek pomocy znajdziesz w artykule Konfigurowanie bibliotek pomocy.

Problemy z emulatorem Androida

Zobacz Rozwiązywanie problemów z emulatorem Androida.

Katalogi

Android Studio używa tych katalogów do przechowywania ustawień, pamięci podręcznej, wtyczek i logów.

Windows

  • Konfiguracja (idea.config.path): %APPDATA%\Google\AndroidStudioVERSION
  • Wtyczki (idea.plugins.path): %APPDATA%\Google\AndroidStudioVERSION\plugins
  • System (idea.system.path): %LOCALAPPDATA%\Google\AndroidStudioVERSION
  • Dzienniki (idea.log.path): %LOCALAPPDATA%\Google\AndroidStudioVERSION\log
  • %APPDATA% przykład: C:\Users\YourUserName\AppData\Roaming
  • %LOCALAPPDATA% przykład: C:\Users\YourUserName\AppData\Local

macOS

  • Konfiguracja (idea.config.path): ~/Library/Application Support/Google/AndroidStudioVERSION
  • Wtyczki (idea.plugins.path): ~/Library/Application Support/Google/AndroidStudioVERSION/plugins
  • System (idea.system.path): ~/Library/Caches/Google/AndroidStudioVERSION
  • Dzienniki (idea.log.path): ~/Library/Logs/Google/AndroidStudioVERSION

Linux

  • Konfiguracja (idea.config.path): ~/.config/Google/AndroidStudioVERSION
  • Wtyczki (idea.plugins.path): ~/.local/share/Google/AndroidStudioVERSION
  • System (idea.system.path): ~/.cache/Google/AndroidStudioVERSION
  • Dzienniki (idea.log.path): ~/.cache/Google/AndroidStudioVERSION/log

Każdy katalog jest wymieniony w tym formacie:

Zastąp:

  • AndroidStudio z nazwą produktu, która w przypadku wersji stabilnych to AndroidStudio, a w przypadku wersji RC i Canary – AndroidStudioPreview.
  • VERSION z wersją. Na przykład: 2023.1 lub 2023.3.