Android Studio 預先發布版的新功能

本頁列出 Android Studio 預先發布版本的新功能。預先發布版可搶先體驗 Android Studio 的最新功能和改善項目。您可以下載這些預覽版本。如果使用 Android Studio 預先發布版時遇到任何問題，請通知我們。錯誤報告有助於改善 Android Studio。

Canary 版本包含積極開發中的尖端功能，且僅經過輕微測試。您可以使用 Canary 版本進行開發，但請注意，系統可能會新增或變更功能。候選版本 (RC) 是 Android Studio 的下一個版本，幾乎已準備好發布穩定版。下個版本的 功能集已穩定。如要瞭解 Android Studio 版本命名方式，請參閱「Android Studio 版本名稱」。

如需 Android Studio 預先發布版本的最新消息，包括各預先發布版本所含的重要修正內容清單，請參閱 Android Studio 網誌中的「版本更新」。

目前版本的 Android Studio

下表列出目前 Android Studio 的版本和對應的管道。

版本 頻道
Android Studio Narwhal 3 功能推送 | 2025.1.3 穩定
Android Gradle 外掛程式 8.13.0 版 穩定
Android Studio Narwhal 4 功能推送 | 2025.1.4 Canary 版

與 Android Gradle 外掛程式預先發布版本的相容性

每個 Android Studio 預先發布版都會隨附相應的 Android Gradle 外掛程式 (AGP) 版本。Studio 預先發布版應可搭配任何相容的 AGP 穩定版。不過，如果您使用 AGP 預先發布版，就必須使用對應的 Studio 預先發布版 (例如 Android Studio Chipmunk Canary 7 和 AGP 7.2.0-alpha07)。嘗試使用不同版本 (例如 Android Studio Chipmunk Beta 1 和 AGP 7.2.0-alpha07) 會導致同步處理失敗，並提示您更新至對應的 AGP 版本。

如要查看 Android Gradle 外掛程式 API 淘汰及移除項目的詳細記錄，請參閱「Android Gradle 外掛程式 API 更新」。

Studio Labs

您可以在 Android Studio 穩定版中試用最新的 AI 實驗功能，更快將 AI 輔助功能整合至開發工作流程。詳情請參閱「Studio Labs」。

以下是 Studio Labs 目前提供的功能。

功能 說明 文件
Compose 預覽生成 Gemini 可以自動產生 Compose 預覽畫面，包括預覽參數的模擬資料，適用於特定可組合函式或檔案中的所有可組合函式。 生成 Compose 預覽
轉換使用者介面 直接在 Compose 預覽面板中使用自然語言更新應用程式 UI。 轉換 UI

Android Studio Narwhal 4 功能推送 | 2025.1.4

以下是 Android Studio Narwhal 4 功能推送 | 2025.1.4 的新功能。

如要查看這個版本的 Android Studio 修復了哪些問題，請參閱已解決的問題。

Android Studio 學習歷程

Android Studio 的 Journeys 可讓您使用自然語言描述每個測試 (稱為「歷程」) 的步驟和斷言，輕鬆編寫及維護端對端測試。Gemini 具備視覺和推理能力，可將以自然語言撰寫的步驟轉換為 Gemini 在應用程式中執行的動作，讓您輕鬆編寫及瞭解歷程。此外，您也可以編寫及說明更複雜的判斷結果，Gemini 會根據裝置上顯示的內容進行評估，判斷流程是否通過測試。

此外，由於 Gemini 會推論要執行哪些動作才能達成目標，因此即使應用程式的版面配置或行為有細微變化，路徑也不容易受到影響，在不同版本的應用程式和不同裝置設定上執行測試時，發生不穩定測試的情況也會減少。

直接在 Android Studio 中針對任何本機或遠端 Android 裝置編寫及執行歷程。IDE 提供全新的編輯器體驗，可製作歷程，並提供豐富的結果，協助您更瞭解 Gemini 的推理過程，以及歷程的執行方式。

備份與同步

您現在可以使用 Google 或 JetBrains 帳戶，將 Android Studio 設定備份到雲端儲存空間。這有助於同步處理設定，例如鍵盤對應、程式碼編輯器設定、系統設定等。如要開始使用，請執行下列任一操作：

  • 在 Android Studio 中開啟專案後，請按一下 IDE 右上角的顯示圖片，然後按一下「Sign in」(登入)，登入 Google 帳戶。

    1. 按照顯示的對話方塊中的提示操作，並務必勾選方塊，授權 Android Studio 存取 Google 帳戶儲存空間。
    2. 按照提示授權 Android Studio。

  • 依序前往「設定」>「備份與同步處理」。

    1. 選取「Google」，即可使用 Google 帳戶儲存空間，在不同 Android Studio 安裝版本之間同步應用程式資料。或者，您也可以使用 JetBrains 帳戶，在 IntelliJ 和 Android Studio 安裝項目之間同步處理應用程式資料。
    2. 按照提示授權 Android Studio 存取偏好帳戶的儲存空間後，請返回 Android Studio。
    3. 在「設定」>「備份與同步」頁面，你可以查看要同步到帳戶的應用程式資料類別。
    4. 如要停用「備份與同步處理」，請取消勾選啟用這項功能的方塊。

如果選取的裝置已同步處理資料，Android Studio 會提供選項，讓您從遠端儲存空間下載設定 (這是預設選項)，或是上傳本機設定並覆寫同步處理至遠端儲存空間的設定。

修正當機問題的建議

在 Android Studio Meerkat Feature Drop 中，我們推出了 Gemini 洞察功能，可針對「App Quality Insights」工具視窗中回報的當機問題提供洞察資訊。現在，Android Studio 可以使用 Gemini 分析當機資料和原始碼，並建議可能的修正方式。在「應用程式品質洞察」工具視窗中選取當機問題後，請前往「洞察」分頁，並在 Gemini 產生當機洞察後，按一下「建議修正方式」。接著，Gemini 會生成建議的程式碼變更，您可以在編輯器差異分頁中查看並接受。

新增設定，可透過「專案」檢視畫面開啟新專案

現在有新的設定，可讓新專案預設在「專案」檢視畫面中開啟。 如要啟用這項設定，請依序前往「File」(檔案) (macOS 上為「Android Studio」) >「Settings」(設定) >「Advanced Settings」(進階設定) >「Project View」(專案檢視畫面)，然後選取「Set Project view as the default」(將專案檢視畫面設為預設)。

Compose 預覽螢幕截圖測試工具

使用 Compose 預覽螢幕截圖測試工具，測試 Compose UI 並防止迴歸。這項新工具可協助您產生 HTML 報表，以視覺化方式偵測應用程式 UI 的任何變更。詳情請參閱「Compose 預覽畫面 螢幕截圖測試」。

內嵌版面配置檢查器元件樹狀結構強化功能

內嵌版面配置檢查器經過幾項重大改良後，現在與元件樹狀結構互動時更加直覺且有效率。這些更新旨在簡化工作流程，並提供更清楚的 Compose UI 結構洞察資料。

  1. 水平捲動：您現在可以在元件樹狀結構中水平捲動，更輕鬆地瀏覽及檢查寬度較大或深度巢狀的版面配置，同時不會失去脈絡。
  2. 選取時自動捲動：選取元件樹狀結構中的項目時，系統現在會自動水平和垂直捲動檢視畫面，將所選項目帶入焦點。這樣可確保您感興趣的元素一律置中顯示。
  3. 改良關係視覺化：我們改良元件樹狀結構中的支援線，提供更明確的視覺提示，協助瞭解節點關係。虛線現在會清楚指出父項和子項節點之間的呼叫堆疊關係，協助您更有效地追蹤程式輔助連結。實線仍代表樹狀結構中的所有其他標準父項/子項關係。

這些強化功能旨在提供更流暢、更有效率的偵錯體驗，讓您快速瞭解及調整 UI。

內嵌版面配置檢查器中的元件樹狀結構現在支援水平捲動，以及選取時自動捲動。
內嵌版面配置檢查器元件樹狀結構強化功能

使用本機 LLM

Android Studio Narwhal 4 功能推送版本可讓您選擇為 IDE 的 AI 功能提供支援的 LLM。

Android Studio Gemini 對話視窗，顯示模型挑選器，其中包含 Gemini 和本機 LLM 的選項。
Android Studio 中的模型挑選器。

LLM 必須位於本機電腦上，如果您網路連線有限、使用 AI 模型受到限制，或是只想試用開放原始碼研究模型，這項功能就非常實用。

本機 LLM 可做為 Android Studio 內建 LLM 支援的替代方案。不過，Gemini 版 Android Studio 通常能提供最佳的 Android 開發體驗，因為 Gemini 經過 Android 調整，且支援 Android Studio 的所有功能。您可以使用 Gemini 執行各種 Android 開發工作，包括免付費的預設模型，或是透過付費 Gemini API 金鑰存取的模型。

如要支援本機 LLM，您必須在本機電腦上安裝 LLM 供應商 (例如 LM Studio 或 Ollama)，並選擇相容的模型。

Android SDK 升級工具現在支援 Android 16 / API 36

Android SDK 升級工具已新增從 Android 15 / API 35 遷移至 Android 16 / API 36 的功能。如需遷移作業的相關說明，請依序前往「Tools」>「Android SDK Upgrade Assistant」。

Android Gradle 外掛程式 9.0 版

Android Gradle 外掛程式 9.0 是 AGP 的新主要版本，並帶來 API 和行為變更。

如要更新至 Android Gradle 外掛程式 9.0.0-alpha02，請在 Android Studio Narwhal 4 Feature Drop | 2025.1.4 中使用 Android Gradle 外掛程式升級工具。

升級專案時，AGP 升級小幫手會盡可能保留現有行為，讓您將專案升級為使用 AGP 9.0，即使您尚未準備好採用 AGP 9.0 的所有新預設值，也能順利升級。

相容性

Android Gradle 外掛程式 9.0.0-alpha02 支援的最高 Android API 級別為 API 級別 36。

Android Gradle 外掛程式 9.0.0-alpha02 需要 Gradle 9.0.0。

行為變更

Android Gradle 外掛程式 9.0 版有下列新行為：

行為 建議
Android Gradle 外掛程式 9.0 預設使用 NDK 版本 r28c。 建議明確指定要使用的 NDK 版本。
Android Gradle 外掛程式 9.0 預設會要求程式庫的消費者使用相同或更高版本的編譯 SDK。 使用程式庫時，請使用相同或更高版本的編譯 SDK。 如果無法這麼做，或想讓發布的程式庫消費者有更多時間切換，請明確設定 AarMetadata.minCompileSdk。

AGP 9.0 包含下列 Gradle 屬性預設值的更新。升級時，您可以選擇保留 AGP 8.13 行為：

資源 函式 從 AGP 8.13 變更為 AGP 9.0 建議
android.uniquePackageNames 強制規定每個程式庫都必須有不同的套件名稱。 false → true 為專案中的所有程式庫指定不重複的套件名稱。 如果無法這樣做，您可以在遷移期間停用這個標記。
android.dependency.useConstraints 控管設定之間的依附元件限制。
AGP 9.0 的預設值為 false，只會在應用程式裝置測試 (AndroidTest) 中使用限制。 將此值設為 true，即可還原為 8.13 版的行為。 		true → false 除非必要，否則請勿在所有位置使用依附元件限制。 接受這個標記的新預設值，也會在專案匯入程序中啟用最佳化功能，減少含有許多 Android 程式庫子專案的建構作業匯入時間。
aandroid.enableAppCompileTimeRClass 在應用程式中針對非最終 R 類別編譯程式碼，使應用程式編譯與程式庫編譯保持一致。
這項功能可提升增量成效，並為日後資源處理流程的成效最佳化作業奠定基礎。 		false → true 許多專案只要採用新行為即可，不必變更來源。 如果 R 類別欄位用於需要常數的任何位置 (例如 switch 案例)，請重構為使用鏈結的 if 陳述式。
android.sdk.defaultTargetSdkToCompileSdkIfUnset 將編譯 SDK 版本做為應用程式和測試中目標 SDK 版本的預設值。
在此變更前，目標 SDK 版本預設為最低 SDK 版本。 		false → true 為應用程式和測試明確指定目標 SDK 版本。
android.onlyEnableUnitTestForTheTestedBuildType 只會為受測建構類型建立單元測試元件。
在預設專案中，這會產生單一偵錯單元測試， 而先前的行為是針對偵錯或發布執行單元測試。 		false → true 如果專案不需要針對偵錯和發布版本執行測試，則無需變更。
android.proguard.failOnMissingFiles 如果 AGP DSL 中指定的任何保留檔案不存在於磁碟上，就會導致建構失敗並顯示錯誤。在這項異動之前，如果檔案名稱有錯字，系統會直接忽略檔案。 false → true 移除所有無效的 ProGuard 檔案宣告
android.r8.optimizedResourceShrinking 一併考量類別和 Android 資源，讓 R8 保留較少的 Android 資源。 false → true 如果專案的保留規則已完成，則無須變更。
android.r8.strictFullModeForKeepRules 允許 R8 保留較少的項目，方法是在保留類別時，不要隱含保留預設建構函式。也就是說，-keep class A 不再表示 -keep class A { <init>(); }
。		 false → true 如果專案的保留規則已完成，則無須變更。

在專案的保留規則中，將 -keep class A 替換為 -keep class A { <init>(); }，以便在需要保留預設建構函式的情況下使用。
android.defaults.buildfeatures.shaders 在所有子專案中啟用著色器編譯 true → false 如要只在含有待編譯著色器的子專案中啟用著色器編譯功能，請在這些專案的 Gradle 建構檔案中設定下列項目：
android {
  buildFeatures {
    shaders = true
  }
}

已移除的功能

Android Gradle 外掛程式 9.0 版移除了下列功能：

已變更的 DSL

Android Gradle 外掛程式 9.0 版的 DSL 破壞性變更如下：

已移除 DSL

Android Gradle 外掛程式 9.0 移除的項目：

已移除的 Gradle 屬性

最初新增下列 Gradle 屬性，是為了全域停用預設啟用的功能。

自 AGP 8.0 以下版本起，這些功能預設為停用。只在會使用這些功能的子專案中啟用，以提高建構效率。

資源 函式 取代
android.defaults.buildfeatures.aidl 在所有子專案中啟用 AIDL 編譯 只在有 AIDL 來源的子專案中啟用 AIDL 編譯，方法是在這些專案的 Gradle 建構檔案中設定下列屬性：
android {
  buildFeatures {
    aidl = true
  }
}
 在每個包含 AIDL 來源的子專案 Gradle 建構檔案中
android.defaults.buildfeatures.renderscript 在所有子專案中啟用 RenderScript 編譯 如要只在有 renderscript 來源的子專案中啟用 renderscript 編譯，請在這些專案的 Gradle 建構檔案中設定下列屬性：
android {
  buildFeatures {
    renderScript = true
  }
}

已移除的 API

Android Gradle 外掛程式 9.0 移除的項目：

  • 已淘汰並停用的 BaseExtension.registerTransform API，僅用於允許針對最新 AGP 版本進行編譯，同時以在 AGP 4.2 以下版本執行為目標。

強制執行的 Gradle 屬性

如果您設定下列 Gradle 屬性，AGP 9.0 會擲回錯誤。

如果專案使用這些屬性，Android Gradle 外掛程式升級小幫手就不會將專案升級至 AGP 9.0。

資源 函式
android.r8.integratedResourceShrinking 資源縮減功能現在一律會做為 R8 的一部分執行，先前的實作方式已移除。