排解 Android Studio 問題

本頁列出 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 支援功能的更新。請按一下「說明」>「錯誤」來回報錯誤提供意見。除了附上螢幕截圖外，也請盡可能提供更多有關系統設定的資訊。
  • 如果您使用 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 以上版本，並藉由按一下滑鼠，切換至隨附的 JDK 檔案 >專案架構 >SDK 位置，然後勾選「使用」 嵌入的 JDK 核取方塊。

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

如果在高密度螢幕上整個 Android Studio UI 的大小有誤， 請參閱「縮放比例係數設定」。如果 在高密度螢幕上 Android Studio UI 的大小有誤 畫面的大小正確，您可能會遇到下列其中一項問題：

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

專案同步問題

嘗試同步處理專案時，您可能會收到下列錯誤 訊息：「連線至網際網路遭拒。('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 JVM 引數加入 gradle.properties 檔案，您可以將這個屬性加到 ，如以下範例所示： 
    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 支援資料庫版本 (非預先發布版)。進一步瞭解設定 以及 Pod 資訊主頁 支援資料庫設定。

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 表示穩定版，AndroidStudioPreview 代表 Beta 版和 Canary 版。
  • VERSION 代表版本。例如 2023.1 或 2023.3。