排解 Android Studio 問題

本頁列出 Android Studio 中常見問題和設定問題的疑難排解指引。

高密度螢幕

自第 1.5 版起,Android Studio 在所有平台上支援 HiDPI 和 Retina 等高密度螢幕。

縮放比例係數設定

Android Studio 判定螢幕縮放比例係數的方式如下:

Mac
在 Retina 螢幕上,UI 元素的縮放比例係數為 200%,而且圖片會以高解析度顯示。即使在採用多螢幕設定的情況下,圖像應該也不會因為縮放而模糊不清。請注意,系統並不支援 100% (適用於非 Retina 螢幕) 和 200% (適用於 Retina 螢幕) 以外的縮放比例係數。
Windows
Android Studio 會以主要螢幕的每英寸像素數 (DPI) 設定為依據,判定 UI 元素的縮放比例係數。對圖片而言,如果縮放比例係數小於 150%,一般解析度的圖片就會放大。若縮放比例係數大於 150%,系統則會適當縮放高解析度圖片。
Linux
Android Studio 會依序檢視「文字縮放比例係數」和 XWindow 系統 DPI 設定,判定縮放比例係數。
DPI 設定值 96 對應至 100% 的縮放比例係數 (無縮放),而 DPI 設定值 192 則對應至 200% 的縮放比例係數 (UI 元素放大一倍)。Android Studio 目前支援的 DPI 設定值介於 96 (縮放比例係數為 100%) 和 288 (縮放比例係數為 300%)。如果 Android Studio 未在 Linux 或 Windows 電腦上偵測到正確的系統 DPI,您可以按照「自訂 IDE 屬性」一節的說明指定 idea.properties 檔案中的 hidpi 屬性,藉此手動設定 DPI。請注意,這個屬性不會對 Mac 電腦造成任何影響。此屬性的運作方式如下:
hidpi=true
將 DPI 設為 192 (縮放比例係數為 200%),忽略系統設定。
hidpi=false
將 DPI 設為 96 (縮放比例係數為 100%),忽略系統設定。

高密度螢幕上的元素出現模糊不清或像素化的狀況

若 Android Studio UI 的一或多個元素在高密度螢幕上出現模糊不清或像素化的狀況,表示可能發生下列其中一項問題:

  • 如果 Android Studio 的大部分 UI 看起來都沒問題,但某個特定圖示出現模糊不清或像素化的狀況,或者某個特定 UI 元素使用大小錯誤的字型,那麼該元素可能尚未完成 HiDPI 支援功能的更新。請依序按一下「Help」>「Submit Feedback」回報錯誤。除了附上螢幕截圖外,也請盡可能提供更多有關系統設定的資訊。
  • 如果您使用 Windows 或 Linux 電腦,而且螢幕採用 100% 或 200% 以外的縮放比例係數,那麼圖片可能會因為縮放而稍微模糊。
  • 如果您使用 Windows 電腦,而且在控制台中變更了 Windows 字型大小,那麼字型可能會出現模糊不清或像素化的狀況。如要解決這個問題,請先登出 Windows 再重新登入。
  • 如果在搭載 Windows 8.1 以上版本的電腦中採用多螢幕設定,當您將視窗從某個螢幕移至另一個解析度或 DPI 不同的螢幕時,字型或圖片可能會發生問題 (詳情請參閱錯誤 186007 的說明)。這個問題目前沒有已知的解決方法。
  • 較舊的 JRE 第 1.8 版有字型模糊不清的問題 (尤其是 JRE 1.8.0_25-b18 amd64,詳情請參閱錯誤 192316 的說明)。自第 2.2 版起,Android Studio 加入最新支援的套裝 JDK 版本,其中包含 JDE。如要解決這個問題,請將 Android Studio 更新至 2.2 以上版本,接著依序按一下「File」>「Project Structure」>「SDK Location」,然後勾選「UseEmbedded JDK」核取方塊,即可改用隨附的 JDK。

高密度螢幕上的元素大小有誤

如果在高密度螢幕上整個 Android Studio UI 的大小有誤,請參閱「縮放比例係數設定」。若高密度螢幕上 Android Studio UI 的部分元素大小有誤,但其他元素的大小正確,表示可能發生下列其中一項問題:

  • 如果您採用自訂編輯器配置,高密度螢幕上的編輯器字型與其餘 UI 元素相較之下,可能會顯得太小或太大。如要修正這個問題,請依序選取「File」>「Settings」,然後依序點選「Editor」>「Colors and Fonts」>「Font」,並變更編輯器字型大小。請注意,當預設配置為啟用狀態時,系統會自動縮放編輯器字型大小 (詳情請參閱錯誤 186920 的說明)。
  • 如果 Android Studio 的部分 UI 元素大小正確,但其他元素看起來太小或太大,表示可能發生錯誤 186923。請依序按一下「Help」>「Submit Feedback」回報錯誤。除了附上螢幕截圖外,也請盡可能提供更多有關系統設定的資訊。

專案同步問題

嘗試同步處理專案時,您可能會收到以下錯誤訊息:「Connection to the Internet denied. ('Permission denied: connect')」。如要解決導致這則訊息出現的問題,請按照下列步驟操作,在 Android Studio 中將系統屬性 -Djava.net.preferIPv4Stack=true 新增至 gradle.properties 檔案:

  1. 在 Android Studio 中開啟 gradle.properties 檔案。
  2. 在檔案中加入下列程式碼:
    org.gradle.jvmargs=-Djava.net.preferIPv4Stack=true
    
    請注意,如果您已在 gradle.properties 檔案中添加其他 Gradle JVM 引數,可以直接在同一行新增這個屬性,如以下範例所示:
    org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -Djava.net.preferIPv4Stack=true
    
  3. 重新啟動 Android Studio,讓您所做的變更生效。
  4. 按一下「Sync Project with Gradle Files」圖示 ,同步處理專案。

在 Windows 系統中更新 IDE 時發生問題

在 Windows 系統中,您無法刪除處理程序正在使用的檔案。當您嘗試使用 IDE 內建的更新機制時,IDE 有時會拒絕安裝更新,在此情況下通常會顯示「Can't delete C:\some\path\file」這類錯誤訊息。

如要解決這個問題,請開啟工作管理員,並嘗試終止可能正在使用該檔案的處理程序,例如 Gradle Daemon。

minSdkVersion 問題

若您使用過時的 Android 支援資料庫版本,可能會收到如下的錯誤訊息:

: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

如要解決這個問題,請使用 SDK Manager 更新至最新的 Android 支援資料庫版本 (非預先發布版)。如需更多有關設定支援資料庫的資訊,可參閱「支援資料庫設定」。

Android Emulator 問題

請參閱 Android Emulator 疑難排解頁面。

目錄

Android Studio 會使用下列目錄儲存設定、快取、外掛程式和記錄。

Windows

  • 設定 (idea.config.path):%APPDATA%\Google\AndroidStudioVERSION
  • 外掛程式 (idea.plugins.path):%APPDATA%\Google\AndroidStudioVERSION\plugins
  • 系統 (idea.system.path):%LOCALAPPDATA%\Google\AndroidStudioVERSION
  • 記錄 (idea.log.path):%LOCALAPPDATA%\Google\AndroidStudioVERSION\log
  • %APPDATA% 範例:C:\Users\YourUserName\AppData\Roaming
  • %LOCALAPPDATA% 範例:C:\Users\YourUserName\AppData\Local

macOS

  • 設定 (idea.config.path):~/Library/Application Support/Google/AndroidStudioVERSION
  • 外掛程式 (idea.plugins.path):~/Library/Application Support/Google/AndroidStudioVERSION/plugins
  • 系統 (idea.system.path):~/Library/Caches/Google/AndroidStudioVERSION
  • 記錄 (idea.log.path):~/Library/Logs/Google/AndroidStudioVERSION

Linux

  • 設定 (idea.config.path):~/.config/Google/AndroidStudioVERSION
  • 外掛程式 (idea.plugins.path):~/.local/share/Google/AndroidStudioVERSION
  • 系統 (idea.system.path):~/.cache/Google/AndroidStudioVERSION
  • 記錄 (idea.log.path):~/.cache/Google/AndroidStudioVERSION/log

每個目錄都會以下列格式列出:

取代:

  • 替換為 AndroidStudio,產品名稱為 AndroidStudio,在穩定版上為 AndroidStudio,在 Beta 版和 Canary 版中則為 AndroidStudioPreview
  • 包含版本的 VERSION。例如 2023.12023.3