排解 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 檔案：

在 Android Studio 中開啟 gradle.properties 檔案。
在檔案中新增下方這行文字：
```
org.gradle.jvmargs=-Djava.net.preferIPv4Stack=true
```
請注意，如果您已在 gradle.properties 檔案中添加其他 Gradle JVM 引數，可以直接在同一行新增這項屬性，如下列範例所示：
```
org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -Djava.net.preferIPv4Stack=true
```
重新啟動 Android Studio，讓您所做的變更生效。
按一下「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 疑難排解頁面。