設定 Android Studio

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

Android Studio 提供精靈和範本,可讓您驗證自己的系統需求 (例如 Java Development Kit (JDK) 和可用的 RAM) 並調整預設設定,例如最佳化預設 Android 虛擬裝置 (AVD) 和更新的系統映像檔。本文說明您可能會想使用哪些其他設定來自訂 Android Studio 的使用方式。

Android Studio 提供使用「Help」選單的兩個設定檔存取權:

  • studio.vmoptions:自訂 Studio Java 虛擬機器 (JVM) 的選項,例如堆積大小和快取大小。請注意,在 Linux 電腦上,此檔案的名稱可能會以 studio64.vmoptions 為 Android 版本,視您的 Android Studio 版本而定。
  • idea.properties:自訂 Android Studio 屬性,例如外掛程式資料夾路徑或支援的檔案大小上限。

如需模擬器和裝置設定和使用方式的特定說明文件,請參閱下列主題:

尋找設定檔

這兩個設定檔都會儲存在 Android Studio 的設定檔資料夾中。資料夾的名稱取決於 Studio 版本。以下是 Android Studio 4.1 以上版本的位置:

Windows

語法:%APPDATA%\Google\<product><version>

範例:C:\Users\YourUserName\AppData\Roaming\Google\AndroidStudio4.1

macOS

語法:~/Library/Application Support/Google/<product><version>

範例:~/Library/Application Support/Google/AndroidStudio4.1

Linux

語法:~/.config/Google/<product><version>

範例:~/.config/Google/AndroidStudio4.1

針對 Android Studio 4.0 以下版本,設定檔位於下列位置:

  • Windows:%USERPROFILE%\.CONFIGURATION_FOLDER
  • macOS:~/Library/Preferences/CONFIGURATION_FOLDER
  • Linux:~/.CONFIGURATION_FOLDER

您也可以使用以下環境變數,指向其他位置的特定覆寫檔案:

  • STUDIO_VM_OPTIONS:設定 .vmoptions 檔案的名稱和位置
  • STUDIO_PROPERTIES:設定 .properties 檔案的名稱和位置
  • STUDIO_JDK:設定要用於執行 Studio 的 JDK

自訂 VM 選項

studio.vmoptions 檔案可讓您自訂 Android Studio 的 JVM 選項。如要提升 Studio 的效能,最常見的調整選項是堆積大小上限,但您也可以使用 studio.vmoptions 檔案來覆寫其他預設設定,例如初始堆積大小、快取大小和 Java 垃圾收集開關。

如要建立新的 studio.vmoptions 檔案或開啟現有的檔案,請按照下列步驟操作:

  1. 依序點選「Help」 >「Edit Custom VM Options」。如果您從未編輯 Android Studio 的 VM 選項,IDE 會提示您建立新的 studio.vmoptions 檔案。按一下「Yes」建立檔案。
  2. studio.vmoptions 檔案會在 Android Studio 的編輯器中開啟。編輯檔案以新增您的自訂 VM 選項。如需可自訂 JVM 選項的完整清單,請參閱 Oracle 的「Java HotSpot VM 選項頁面」。

您建立的 studio.vmoptions 檔案會新增至預設的 studio.vmoptions 檔案,位於 Android Studio 安裝資料夾中的 bin/ 目錄。

請注意,請勿直接編輯 Android Studio 程式資料夾中的 studio.vmoptions 檔案。雖然您可以存取檔案來查看 Studio 的預設 VM 選項,但只編輯自己的 studio.vmoptions 檔案可確保 Android Studio 不會覆寫重要的預設設定。因此,在 studio.vmoptions 檔案中,請覆寫您重視的屬性,並允許 Android Studio 繼續使用未變更任何屬性的預設值。

堆積大小上限

根據預設,Android Studio 的堆積大小上限為 1280 MB。如果您處理的是大型專案,或系統有大量 RAM,則您可以提高 Android Studio 程序 (例如核心 IDE、Gradle Daemon) 的堆積大小上限,藉此提升效能,以及 Kotlin Daemon。

Android Studio 會自動檢查可能的堆積大小最佳化,並會在偵測到效能有改善時通知您。

記憶體設定,可讓您為 Android Studio 程序設定 RAM 數量上限。

圖 1. 關於建議記憶體設定的通知。

如果使用的 64 位元系統至少具備 5 GB 的 RAM,您也可以手動調整專案的堆積大小。步驟如下:

  1. 在選單列中,依序按一下「File」>「Settings」(macOS 則為「Android Studio」>「Preferences」)。
  2. 依序按一下「Appearance & Behavior」>「System Settings」>「Memory Settings」

    記憶體設定,可讓您為 Android Studio 程序設定 RAM 數量上限。

  3. 根據需求量調整堆積大小。

  4. 按一下「Apply」

    如果您變更了 IDE 的堆積大小,就必須先重新啟動 Android Studio,才能套用新的記憶體設定。

匯出及匯入 IDE 設定

您可以匯出 Settings.jar 檔案,其中包含專案偏好的所有 IDE 設定或部分子集。接著,您可以將 JAR 檔案匯入其他專案,並/或提供 JAR 檔案供同事匯入自己的專案。

詳情請參閱 IntelliJ IDEA 的「匯出與匯入設定」。

自訂 IDE 屬性

idea.properties 檔案可讓您自訂 Android Studio 的 IDE 屬性,例如使用者已安裝外掛程式的路徑,以及 IDE 支援的檔案大小上限。idea.properties 檔案會與 IDE 的預設屬性合併,因此只能指定覆寫屬性。

如要建立新的 idea.properties 檔案或開啟現有的檔案,請按照下列步驟操作:

  1. 依序按一下「Help」>「Edit Custom Properties」。如果您從未編輯 IDE 屬性,Android Studio 會提示您建立新的 idea.properties 檔案。按一下「Yes」建立檔案。
  2. idea.properties 檔案會在 Android Studio 的編輯器中開啟。編輯檔案以新增自訂 IDE 屬性。

以下 idea.properties 檔案包含一般自訂的 IDE 屬性。如需完整的屬性清單,請參閱「IntelliJ IDEA 的 idea.properties 檔案」。

#---------------------------------------------------------------------
# Uncomment this option if you want to customize path to user installed plugins folder. Make sure
# you're using forward slashes.
#---------------------------------------------------------------------
# idea.plugins.path=${idea.config.path}/plugins
#---------------------------------------------------------------------
# Maximum file size (kilobytes) IDE should provide code assistance for.
# The larger file is the slower its editor works and higher overall system memory requirements are
# if code assistance is enabled. Remove this property or set to very large number if you need
# code assistance for any files available regardless their size.
#---------------------------------------------------------------------
idea.max.intellisense.filesize=2500
#---------------------------------------------------------------------
# This option controls console cyclic buffer: keeps the console output size not higher than the
# specified buffer size (Kb). Older lines are deleted. In order to disable cycle buffer use
# idea.cycle.buffer.size=disabled
#---------------------------------------------------------------------
idea.cycle.buffer.size=1024
#---------------------------------------------------------------------
# Configure if a special launcher should be used when running processes from within IDE.
# Using Launcher enables "soft exit" and "thread dump" features
#---------------------------------------------------------------------
idea.no.launcher=false
#---------------------------------------------------------------------
# To avoid too long classpath
#---------------------------------------------------------------------
idea.dynamic.classpath=false
#---------------------------------------------------------------------
# There are two possible values of idea.popup.weight property: "heavy" and "medium".
# If you have WM configured as "Focus follows mouse with Auto Raise" then you have to
# set this property to "medium". It prevents problems with popup menus on some
# configurations.
#---------------------------------------------------------------------
idea.popup.weight=heavy
#---------------------------------------------------------------------
# Use default anti-aliasing in system, i.e. override value of
# "Settings|Editor|Appearance|Use anti-aliased font" option. May be useful when using Windows
# Remote Desktop Connection for instance.
#---------------------------------------------------------------------
idea.use.default.antialiasing.in.editor=false
#---------------------------------------------------------------------
# Disabling this property may lead to visual glitches like blinking and fail to repaint
# on certain display adapter cards.
#---------------------------------------------------------------------
sun.java2d.noddraw=true
#---------------------------------------------------------------------
# Removing this property may lead to editor performance degradation under Windows.
#---------------------------------------------------------------------
sun.java2d.d3d=false
#---------------------------------------------------------------------
# Workaround for slow scrolling in JDK6
#---------------------------------------------------------------------
swing.bufferPerWindow=false
#---------------------------------------------------------------------
# Removing this property may lead to editor performance degradation under X Window.
#---------------------------------------------------------------------
sun.java2d.pmoffscreen=false
#---------------------------------------------------------------------
# Workaround to avoid long hangs while accessing clipboard under Mac OS X.
#---------------------------------------------------------------------
# ide.mac.useNativeClipboard=True
#---------------------------------------------------------------------
# Maximum size (kilobytes) IDEA will load for showing past file contents -
# in Show Diff or when calculating Digest Diff
#---------------------------------------------------------------------
# idea.max.vcs.loaded.size.kb=20480

為低記憶體機器設定 IDE

如果您執行機器所使用的 Android 規格低於建議規格 (請參閱「系統需求」),就能自訂 IDE 來改善機器的效能,如下所示:

  • 縮減 Android Studio 可用的堆積大小上限:將 Android Studio 的堆積大小上限縮減至 512 MB。如要進一步瞭解如何變更堆積大小,請參閱「堆積大小上限」。
  • 更新 Gradle 和 Android 外掛程式的 Android 外掛程式:將 Gradle 更新至最新版本,並將 Gradle 適用的 Android 外掛程式更新為最新版本,以便充分運用效能的最新改善項目。如要進一步瞭解如何更新 Gradle 和 Gradle 的 Android 外掛程式,請參閱「Gradle 版本資訊的 Android 外掛程式」。
  • 啟用節電模式:啟用節電模式會關閉多項記憶體和耗電量高背景作業,包括醒目顯示錯誤和即時檢查、自動彈出式視窗程式碼完成作業,以及自動漸進式背景編譯。如要開啟省電模式,請依序點選「File」>「Power Save Mode」
  • 停用不需要的 Lint 檢查:如要變更 Android Studio 在您的程式碼中執行的 Lint 檢查功能,請執行下列步驟:

    1. 依序點選「File」>「Settings」(在 macOS 中為「Android Studio」>「Preferences」),即可開啟「Settings」對話方塊。
    2. 展開左側窗格中的「Editor」區段,然後按一下「Inspections」
    3. 視需要在您的專案中勾選或取消勾選核取方塊。
    4. 按一下「Apply」或「OK」儲存變更。
  • 在實體裝置上偵錯:在模擬裝置上偵錯時,系統會耗用更多記憶體,而不是針對實體裝置偵錯。因此,您可以對實體裝置進行偵錯,藉此提升 Android Studio 的整體效能。

  • 只納入必要的 Google Play 服務做為依附元件:將 Google Play 服務新增為專案的依附元件時,會增加所需的記憶體量。您只需要包含必要的依附元件,即可提升記憶體用量和效能。詳情請參閱「將 Google Play 服務新增至專案」。

  • 縮減 Gradle 可用的堆積大小上限:Gradle 的預設堆積大小上限為 1,536 MB。覆寫 gradle.properties 檔案中的 org.gradle.jvmargs 屬性即可降低值,如下所示:

    # Make sure to gradually decrease this value and note
    # changes in performance. Allocating too little memory may
    # also decrease performance.
    org.gradle.jvmargs = -Xmx1536m
    
  • 不啟用平行編譯:Android Studio 現在可以同時編譯獨立模組,但記憶體不足系統則不建議您開啟這項功能。如要檢查此設定,請按照下列步驟操作:

    1. 依序點選「File」>「Settings」 (在 macOS 中為「Android Studio」>「Preferences」),即可開啟「Settings」對話方塊。
    2. 展開左側窗格中的「Build, Execution, Deployment」,然後按一下「Compiler」
    3. 確認未勾選「Compile independent modules in parallel」選項。
    4. 如果您變更了設定,請按一下「Apply」或「OK」使變更生效。

設定 JDK 版本

最新的 OpenJDK 副本會隨附 Android Studio 2.2 以上版本,這也是我們建議您用於 Android 專案的 JDK 版本。如要使用隨附的 JDK,請執行下列步驟:

  1. 在 Android Studio 中開啟專案,然後依序按一下「File」>「Settings」...>「Build, Execution, Deployment」>「Build Tools」>「Gradle」(Mac 上為「Android Studio」>「Preferences」...>「Build, Execution, Deployment」>「Build Tools」>「Gradle」)。
  2. 「Gradle JDK」下方,選擇「Embedded JDK」選項。
  3. 按一下「OK」

根據預設,用於編譯專案的 Java 語言版本會沿用專案的 compileSdkVersion (因為 Android 版本支援不同版本的 Java)。如有需要,您可以在 build.gradle 檔案中加入下列 compileOptions 區塊,藉此覆寫這個預設 Java 版本:

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION\_1\_6
        targetCompatibility JavaVersion.VERSION\_1\_6
    }
}

如要進一步瞭解定義 compileSdkVersion 的地方,請參閱「模組層級建構檔案」。

配置 Proxy 設定

Proxy 是 HTTP 用戶端與網路伺服器之間的中介連線點,可為網際網路連線增添安全性和隱私權。

如要支援在防火牆後方執行 Android Studio,請調整 Android Studio IDE 的 Proxy 設定。使用 Android Studio IDE HTTP Proxy 設定頁面來設定 Android Studio 的 HTTP Proxy 設定。

透過指令列或未安裝 Android Studio 的機器 (例如持續整合伺服器) 執行 Gradle 的 Android 外掛程式時,請在 Gradle 建構檔案中設定 Proxy 設定。

設定 Android Studio Proxy

Android Studio 支援 HTTP Proxy 設定,因此你可以在防火牆或安全網路後方執行 Android Studio。如何在 Android Studio 中設定 HTTP Proxy:

  1. 在選單列中,依序按一下「File」>「Settings」 (macOS 則為「Android Studio」>「Preferences」)。
  2. 在左側窗格中,依序按一下「Appearance & Behavior」>「System Settings」>「HTTP Proxy」。畫面上會顯示 HTTP Proxy 頁面。
  3. 選取「Auto-detect proxy settings」使用 Proxy 設定的自動 Proxy 設定網址,或是選取「Manual proxy configuration」,自行輸入各項設定。如需這些設定的詳細說明,請參閱「HTTP Proxy」。
  4. 按一下「Apply」或「OK」使變更生效。

Gradle HTTP Proxy 設定的 Android 外掛程式

透過指令列或未安裝 Android Studio 的機器執行 Android 外掛程式時,請在 Gradle 建構檔案中設定 Gradle Proxy 設定的 Android 外掛程式。

如果是應用程式專屬的 HTTP Proxy 設定,請針對每個應用程式模組,在 build.gradle 檔案中設置 Proxy 設定。

plugins {
  id 'com.android.application'
}

android {
    ...

    defaultConfig {
        ...
        systemProp.http.proxyHost=proxy.company.com
        systemProp.http.proxyPort=443
        systemProp.http.proxyUser=userid
        systemProp.http.proxyPassword=password
        systemProp.http.auth.ntlm.domain=domain
    }
    ...
}

對於專案層級的 HTTP Proxy 設定,請在 gradle/gradle.properties 檔案中進行 Proxy 設定。

# Project-wide Gradle settings.
...

systemProp.http.proxyHost=proxy.company.com
systemProp.http.proxyPort=443
systemProp.http.proxyUser=username
systemProp.http.proxyPassword=password
systemProp.http.auth.ntlm.domain=domain

systemProp.https.proxyHost=proxy.company.com
systemProp.https.proxyPort=443
systemProp.https.proxyUser=username
systemProp.https.proxyPassword=password
systemProp.https.auth.ntlm.domain=domain

...

如需有關利用 Gradle 屬性進行 Proxy 設定的資訊,請參閱「Gradle 使用手冊」。

在 Windows 裝置上最佳化 Android Studio 效能

Windows 上的 Android Studio 效能可能會受到多種因素影響。本節說明如何最佳化 Android Studio 設定,以便在 Windows 上獲得最佳效能。

將防毒軟體對建構速度的影響降至最低

某些防毒軟體可能會干擾 Android Studio 建構程序,導致建構作業的運作速度明顯變慢。在 Android Studio 中執行建構作業時,Gradle 會編譯應用程式的資源和原始碼,然後將編譯後的資源封裝在 APK 或 AAB 中。在這個過程中,系統會在您的電腦上建立許多檔案。如果防毒軟體已啟用即時掃描功能,防毒功能便可在建立檔案的同時,在防毒軟體執行掃描作業時暫停該檔案。

為了避免這個問題,您可以將防毒軟體從即時掃描範圍中排除。

以下清單列出您應從即時掃描中排除各個 Android Studio 目錄的預設位置:

Gradle 快取
%USERPROFILE%\.gradle
Android Studio 專案
%USERPROFILE%\AndroidStudioProjects
Android SDK
%USERPROFILE%\AppData\Local\Android\SDK

Android Studio 系統檔案

語法:%LOCALAPPDATA%\Google\<product><version>

範例:C:\Users\YourUserName\AppData\Local\Google\AndroidStudio4.1

自訂受群組原則控管環境的目錄位置

如果群組原則限制了您從電腦即時掃描中排除的目錄,您可以將 Android Studio 目錄移至集中式群組原則排除的其中一個位置。

下列清單說明如何自訂各個 Android Studio 目錄的位置,其中 C:\WorkFolder 是群組原則已排除的目錄:

Gradle 快取
定義GRADLE_USER_HOME環境變量指向C:\WorkFolder\.gradle
Android Studio 專案
C:\WorkFolder 的適當子目錄中移動或建立專案目錄。例如:C:\WorkFolder\AndroidStudioProjects
Android SDK

請按照下列步驟操作:

  1. 在 Android Studio 中開啟「Settings」 對話方塊 (macOS 為「Preferences」),然後按一下「Appearance & Behavior」>「System Settings」>「Android SDK」

  2. 將「Android SDK Location」的值變更為 C:\WorkFolder\AndroidSDK

    為避免再次下載 SDK,請務必將現有的 SDK 目錄 (預設為 %USERPROFILE%\AppData\Local\Android\SDK) 複製到新位置。

Android Studio 系統檔案

請按照下列步驟操作:

  1. 在 Android Studio 中,依序按一下「Help」>「Edit Custom Properties」

    如果您尚未建立 idea.properties 檔案,Android Studio 會提示您建立。

  2. idea.properties 檔案中新增下列程式碼:

    idea.system.path=c:/workfolder/studio/caches/trunk-system