排解 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」,然後勾選「Use embedded 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 疑難排解頁面。