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 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 目前提供的功能。

Android Studio Narwhal 3 功能推送 | 2025.1.3

以下是 Android Studio Narwhal 3 功能推送 | 2025.1.3 的新功能。

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

可調整大小的 Compose 預覽畫面

Compose 預覽畫面現在支援動態調整大小，可即時提供視覺回饋，讓您瞭解 UI 如何配合不同螢幕大小調整。

如要使用這項功能，請在工具列上變更檢視選項，在 Compose 預覽功能中進入「Focus」模式：

現在可以拖曳預覽視窗的邊緣來調整大小：

或者，您也可以使用調整大小工具列 (預覽畫面調整大小後會顯示)：

如要將新大小儲存為新的 Preview 註解，請使用右鍵選單：

動態調整大小功能可協助您建立使用者介面，在任何螢幕尺寸上都能呈現絕佳效果。

Android 檢視畫面設定，可顯示對應模組下的建構檔案

現在可以透過新設定，在 Android 檢視畫面中，於對應模組下方顯示建構檔案。處理含有多個模組的專案時，這個檢視畫面會很有幫助。如要啟用檢視畫面，請開啟 Android 檢視畫面旁的「選項」 選單。 然後依序選取「Appearance」>「Display Build Files In Module」。

Android Studio 中的 Play 政策詳解

Android Studio 現在提供更豐富的洞察資訊和指引，協助您瞭解可能影響應用程式的 Google Play 政策。這些資訊有助於您從一開始就打造更安全的應用程式，避免發生可能中斷發布流程的問題，以及日後需要花費更多時間和資源才能解決的問題。

從 Android Studio Narwhal 3 功能推送開始，您可以將 Play 政策詳解視為 Lint 檢查。這些 Lint 檢查會提供下列資訊：

• 政策總覽。
• 有助於您避免犯下常見錯誤的注意事項。
• Play 政策頁面的連結，方便您查看正式政策全文，以及更多實用資訊和資源。

這項功能旨在提供實用的預先審查指引，協助您更順利地提交應用程式。政策詳解並未涵蓋所有政策，也不代表應用程式的最終審查結果。請務必詳閱政策中心的完整政策，瞭解相關指引。我們也會積極發展及改善這項整合功能。 如有任何意見，請回報。

如要查看專案是否有任何 Play 政策深入分析資訊，請前往「Code」>「Inspect for Play Policy Insights…」深入分析資訊會列在「Problems」工具視窗中，也會以 Lint 警告的形式顯示在對應的檔案中。

使用應用程式備份與還原功能進行測試及開發

確保應用程式的 Android 備份與還原功能正常運作，是確保使用者在改用新裝置或從雲端還原後，仍會繼續使用應用程式的重要環節。不過，測試應用程式的資料備份和還原功能是否正常運作可能很困難。

Android Studio Narwhal 提供多種方式，可讓您產生應用程式備份，並還原至其他裝置。這項功能有助於測試應用程式在裝置間或從雲端備份還原應用程式資料時，是否會如預期運作；此外，如果您想更快速地設定測試裝置，並使用開發及偵錯應用程式所需的資料，這項功能也能派上用場。

產生備份

如要產生備份檔案，請按照下列步驟操作：

1. 將應用程式的偵錯版本部署至連結裝置
2. 請使用下列任一動作產生備份：
   • 在「Running Device」(執行中的裝置) 視窗中，按一下工具列中的「Backup App Data」(備份應用程式資料) 動作
   • 在主選單列中依序選取「Run」>「Backup App Data」
   • 在「Device Explorer」>「Processes」分頁中，按一下應用程式程序，然後選取「Backup App Data」。
3. 在隨即顯示的對話方塊中，執行下列操作：
   • 確認要產生備份的應用程式 ID
     • 選取要產生「裝置到裝置」、「雲端」或「雲端 (未加密)」備份
   • 確認要儲存的備份檔名稱和位置。根據預設，備份檔會儲存至目前 Android Studio 專案的根目錄。

     

4. Android Studio 詢問是否可以停止應用程式時，請按一下「Ok」。Android Studio 必須停止應用程式程序，才能產生備份。

您可以在「Project」>「Android」工具視窗的「Backup Files」節點下方，查看產生的備份檔案。

備份類型

您可以為應用程式產生不同類型的備份。產生備份時，請選取與要測試情境相關的備份類型：

• 裝置對裝置：產生應用程式備份，類似於裝置對裝置轉移期間建立的備份。在裝置對裝置轉移作業中，應用程式的備份資料會直接傳送至其他裝置，例如透過 USB 或 Wi-Fi。
• 雲端：產生應用程式備份，類似於儲存在使用者 Google 帳戶儲存空間的備份。使用者設定新裝置時，可以選擇從雲端備份還原。
• 雲端 (未加密)：產生應用程式備份，類似於儲存在裝置使用者 Google 帳戶儲存空間的備份，但未啟用用戶端加密功能。

注意：使用這項功能測試 Cloud、Cloud (Unencrypted) 或裝置對裝置備份時，系統不會將產生的備份檔傳送至雲端或其他裝置，與實際備份流程不同。這項功能會產生應用程式備份檔，就像要儲存至雲端或傳送至其他裝置一樣。任何備份類型產生的備份檔，都可以在「Project」>「Android」工具視窗的「Backup Files」下方找到。

還原應用程式資料

如要還原應用程式資料，請按照下列步驟操作：

1. 將應用程式部署至連結的裝置。應用程式的應用程式 ID 應與要還原到裝置的備份檔案相同。
2. 前往並點選下列其中一項動作：
   • 在「Running Device」視窗中，按一下工具列的「Restore App Data」動作，然後從最近的記錄中選取備份檔案，或按一下「Browse」。
   • 在主選單列中依序選取「Run」>「Restore App Data」。
   • 在「Device Explorer」>「Processes」分頁中，對應用程式程序按一下滑鼠右鍵，然後選取「Restore App Data」。
   • 在「Project」>「Android」工具視窗中，對「Backup Files」節點下的備份按一下滑鼠右鍵，然後選取「Restore App Data」。
3. 視情況從近期記錄選取備份，或按一下「瀏覽」，從本機儲存空間選取要還原的備份檔案。

或者，您也可以在執行設定中加入備份檔案，這樣部署應用程式時，也會從備份檔案還原應用程式資料。如要這麼做，請按照下列步驟操作：

1. 在主選單列中依序選取「Run」>「Edit Configurations」。
2. 選取應用程式執行設定，然後前往「還原選項」。

   

3. 如要從備份還原應用程式，請勾選「還原應用程式狀態」旁邊的方塊。
4. 從最近的記錄選取備份檔案，或瀏覽並選取本機儲存空間中的備份檔案。
5. 如果只想在全新安裝應用程式時還原應用程式資料，請勾選「Only restore on fresh apk installation」(僅在全新安裝 APK 時還原) 旁的方塊。如果您要部署到新的測試裝置，並想還原資料來協助偵錯和開發應用程式，這個選項就非常實用。
6. 按一下「確定」儲存執行設定。
7. 使用執行設定部署應用程式，測試將應用程式資料還原至連線裝置。

Proguard 檢查

Android Studio 現在會進行檢查，避免 ProGuard 規則設計不當，或規則導致 R8 無法進行最佳化。如果保留規則過於廣泛 (例如 -keep class **.*)，以及 Proguard 消費者規則設定 (例如 dontshrink 和 -dontoptimize)，Studio IDE 現在會觸發警告。如要制定合適的保留規則，允許縮減程式碼，請將規則範圍限定在特定套件，並明確指出要保留的項目。

專案層級環境的 AGENT.md 檔案

您現在可以在專案中加入 AGENT.md 檔案。這些是 Markdown 檔案，可為 Gemini 提供專案專屬的指示、程式碼樣式規則和其他指引做為脈絡。

Gemini 會自動探索並套用專案中名為 AGENT.md 的檔案中的指令。如果沒有 AGENT.md 檔案，Gemini 會改為尋找 GEMINI.md 檔案做為備用。

可停用自動同步功能的新設定

Android Studio 現在提供設定，可從預設的「自動同步」模式 (例如：專案開啟時自動執行同步) 切換為新的「手動同步」模式，並顯示提醒。預設行為仍為自動同步。如要切換為手動同步，請依序前往「File」 (macOS 上為「Android Studio」) >「Settings」>「Build, Execution, Deployment」>「Build Tools」，然後將「Project Sync mode」設為「Manual Sync with reminders」。

從 Studio Labs 畢業的功能

下列 Studio Labs 實驗功能已在 Narwhal 3 功能推送中推出穩定版：

• 在 Gemini 中附加圖片
• 在 Gemini 中使用@參照檔案內容

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。

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 版有下列新行為：

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

android {
  buildFeatures {
    shaders = true
  }
}

已移除的功能

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

• 嵌入式 Wear OS 應用程式支援
  AGP 9.0 會移除嵌入式 Wear OS 應用程式的支援，Play 不再支援這類應用程式。這包括移除 wearApp 設定和 AndroidSourceSet.wearAppConfigurationName DSL。如要瞭解如何將應用程式發布至 Wear OS，請參閱「發布至 Wear OS」一文。

已變更的 DSL

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

• 已移除 CommonExtension 的參數化。 就本身而言，這只是來源層級的重大變更，有助於避免日後發生來源層級的重大變更，但這也表示 DSL 區塊方法需要從 CommonExtension 移至 ApplicationExtension、LibraryExension、DynamicFeatureExtension 和 TestExtension。

已移除 DSL

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

• AndroidSourceSet.jni，因為該功能無法運作。

• AndroidSourceSet.wearAppConfigurationName，因為這與已移除的內嵌 Wear OS 應用程式支援有關。

• BuildType.isRenderscriptDebuggable，因為該功能無法運作。

• ComponentBuilder.enabled。已由 ComponentBuilder.enable 取代。

• Installation.installOptions(String)。這項屬性已由 Installation.installOptions 的可變動屬性取代。

• VariantBuilder.targetSdk 和 targetSdkPreview，因為這些函式庫中沒有意義。請改用 GeneratesApkBuilder.targetSdk 或 GeneratesApkBuilder.targetSdkPreview。

• 實驗性但從未穩定的 PostProcessing 區塊。

• ProductFlavor.setDimension，已由 dimension 屬性取代

• Variant.unitTest，因為這不適用於 com.android.test 外掛程式。unitTest 可用於擴充 VariantBuilder 的 HasUnitTest 子類型。

• VariantBuilder.enableUnitTest，因為這不適用於 com.android.test 外掛程式。enableUnitTest 可用於擴充 VariantBuilder 的 HasUnitTestBuilder 子類型。

• 已移除 VariantBuilder.unitTestEnabled，改用命名更一致的 enableUnitTest，適用於擴充 HasUnitTestBuilder 的 VariantBuilder 子型別。

已移除的 Gradle 屬性

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

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

android {
  buildFeatures {
    aidl = true
  }
}

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。