Android Studio Narwhal 功能推送 | 2025.1.2

Android Studio 是用於 Android 開發作業的官方 IDE,包含建構 Android 應用程式所需的各項資源。

本頁將針對 Android Studio Narwhal 功能推送穩定版的最新版本,列出其中的最新功能和改善項目。您可以透過這個連結下載,也可以在 Android Studio 中更新,方法是依序點選「Help」>「Check for updates」(在 macOS 上為「Android Studio」>「Check for updates」)。

這是 Android Studio 的穩定版。請注意,修補程式可能包含新的次要功能和錯誤修正。如要瞭解 Android Studio 版本命名方式,請參閱「Android Studio 版本名稱」。

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

如要查看舊版 Android Studio 的版本資訊,請參閱「過往版本」。

如要搶先體驗即將推出的功能和改善項目,請參閱「Android Studio 預先發布版」。

如果使用 Android Studio 時遇到問題,請參閱已知問題疑難排解頁面。

Android Gradle 外掛程式與 Android Studio 相容性

Android Studio 建構系統以 Gradle 為基礎,Android Gradle 外掛程式 (AGP) 則加入了建構 Android 應用程式專用的功能。下表列出各個 Android Studio 版本所需的 AGP 版本。

Android Studio 版本 所需的 AGP 版本
Narwhal 功能推送 | 2025.1.2 4.0-8.12
Narwhal | 2025.1.1 3.2-8.11
Meerkat 功能推送 | 2024.3.2 3.2-8.10
Meerkat | 2024.3.1 3.2-8.9
Ladybug 功能推送 | 2024 年 2 月 2 日 3.2-8.8
Ladybug | 2024.2.1 3.2-8.7
Koala 功能推送 | 2024.1.2 3.2-8.6
Koala | 2024.1.1 3.2-8.5
Jellyfish | 2023.3.1 3.2-8.4
Iguana | 2023.2.1 3.2-8.3
Hedgehog | 2023.1.1 3.2-8.2
Giraffe | 2022.3.1 3.2-8.1
Flamingo | 2022.2.1 3.2-8.0

較舊版本

Android Studio 版本 所需的 AGP 版本
Electric Eel | 2022.1.1 3.2-7.4
Dolphin | 2021.3.1 3.2-7.3
Chipmunk | 2021.2.1 3.2-7.2
Bumblebee | 2021.1.1 3.2-7.1
Arctic Fox | 2020.3.1 3.1-7.0

如要瞭解 Android Gradle 外掛程式的新功能,請參閱 Android Gradle 外掛程式版本資訊

支援 Android API 級別的最低工具版本

Android Studio 和 AGP 有支援特定 API 級別的最低版本。如果您使用的 Android Studio 或 AGP 版本低於專案的 targetSdkcompileSdk 所需版本,可能會導致非預期的問題。建議您使用最新的 Android Studio 和 AGP 預先發布版,處理針對 Android 作業系統預先發布版的專案。您可以一併安裝 Android Studio 的預先發布版和穩定版

Android Studio 和 AGP 的最低版本如下:

API 級別 Android Studio 最低版本 AGP 最低版本
36.0 Meerkat | 2024.3.1 Patch 1 8.9.1
35 Koala 功能推送 | 2024.2.1 8.6.0
34 Hedgehog | 2023.1.1 8.1.1
33 Flamingo | 2022.2.1 7.2

Android Studio 和 Cloud 服務的相容性

Android Studio 內含服務整合功能,可協助您和團隊在開發、發布及維護 Android 應用程式時,加快進度。包括 Android Studio 中的 Gemini、Play Vitals 和 Firebase Crashlytics 等雲端服務。雲端服務僅適用於 Android Studio 的最新穩定版、最近三個主要版本,以及與這些版本相關的修補程式。如果版本超出相容性範圍,服務整合功能就會停用,您必須更新 Android Studio。

目前與雲端服務相容的 Android Studio 版本

Android Studio Meerkat Feature Drop 穩定版發布後,所有版本的 Studio 都與 Cloud 服務相容。Android Studio Narwhal 功能推送時,我們就會開始執行這項規定。

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

Android Studio 的 Gemini 代理程式模式

Android Studio 的 Gemini 代理程式模式是全新 AI 功能,可處理複雜的多階段開發工作,這類工作無法透過與 Gemini 對話完成。如要使用代理程式模式,請按一下側欄中的「Gemini」,然後選取「代理程式」分頁標籤。您可以描述複雜目標,例如產生單元測試或修正錯誤,代理程式會制定涵蓋專案中多個檔案的執行計畫。代理程式會建議編輯內容,並反覆修正錯誤,直到達成目標為止。您可以查看、接受或拒絕建議的變更,並要求服務專員根據您的意見反覆修改。

Gemini 中的規則

您可以在 提示庫中,透過 Gemini 的規則定義偏好的程式碼樣式或輸出格式。你也可以提及偏好的技術堆疊和語言。設定一次後,這些偏好設定就會自動套用至所有後續傳送給 Gemini 的提示。規則可協助 AI 瞭解專案標準和偏好設定,提供更準確且量身打造的程式碼輔助功能。舉例來說,你可以建立「一律以 Kotlin 簡要回覆」這類規則。

如要設定規則,請依序前往「Android Studio」>「Settings」>「Tools」>「Gemini」>「Prompt Library」>「Rules」,然後在編輯器中編輯文字。使用下拉式選單在 IDE 層級或專案層級儲存規則:

  • IDE 層級的規則僅供您個人使用,且可套用至多個專案。
  • 專案層級規則可供同一專案的團隊成員共用。 如要與團隊共用提示,請將 .idea 資料夾新增至版本控管系統。

內嵌 XR 模擬器

XR 模擬器現在預設會以嵌入狀態啟動。您現在可以直接在 Android Studio 中部署應用程式、瀏覽 3D 空間,以及使用版面配置檢查器。

XR 模擬器現在預設會以嵌入狀態啟動。
直接在 Android Studio 中使用 XR 模擬器。

XR 專案範本

Android Narwhal 功能推送推出專為 Jetpack XR 設計的新專案範本。這項功能提供範本程式碼,可做為堅實的基礎,讓您立即開始開發沉浸式體驗。

XR 內嵌版面配置檢查器

內嵌版面配置檢查器現在支援 XR 應用程式,可讓您在 XR 環境中檢查及最佳化 UI 版面配置。深入瞭解應用程式的元件結構,並找出潛在的版面配置問題,打造更精緻且效能更佳的體驗。

支援 16 KB 頁面大小

Android Studio Narwhal 功能推送版本新增了對轉換至 16 KB 分頁大小的改良支援。為協助您順利完成這項轉換,Android Studio 現在會在建構與 16 KB 裝置不相容的 APK 或 Android App Bundle 時,主動顯示警告訊息。您也可以使用 APK 分析工具,找出與 16 KB 裝置不相容的程式庫。如要在這個新環境中測試應用程式,Android Studio 也提供專用的 16 KB 模擬器目標,以及現有的 4 KB 映像檔。

使用 Gemini 轉換 UI

現在您可以在 Compose 預覽環境中,直接在預覽畫面使用自然語言轉換 UI 程式碼。如要使用這項功能,請在「撰寫」預覽畫面中按一下滑鼠右鍵,然後選取「使用 Gemini 轉換 UI」。然後輸入自然語言要求,例如「將這些按鈕置中對齊」,引導 Gemini 調整版面配置或樣式,或在預覽畫面中選取特定 UI 元素,提供更清楚的脈絡。Gemini 會直接編輯 Compose UI 程式碼,您可以查看並核准,加快 UI 開發工作流程。

內容選單中的「使用 Gemini 轉換 UI」
存取「使用 Gemini 轉換 UI」選單
「使用 Gemini 轉換 UI」模式對話方塊
對 Compose 預覽套用自然語言轉換

Compose 預覽導覽功能改善

最新導覽功能改善了 Compose 預覽互動的效率。按一下預覽名稱即可跳至預覽定義,或按一下個別元件跳至定義該元件的函式。當滑鼠游標懸停在預覽畫面時,懸停狀態會立即提供視覺回饋。改良的鍵盤方向鍵瀏覽功能可輕鬆在多個預覽畫面之間移動,加快 UI 疊代和調整速度。

Compose 預覽挑選器

Compose 預覽選擇器現已推出。如要試用,請按一下撰寫程式碼中的任何 @Preview 註解。

版面配置檢查器中的子項重組

版面配置檢查器支援子項重組計數。現在即使重組的 composable 在元件樹狀結構中摺疊於父項下方,您也能看到重組次數。如果發現子項重組次數增加,可以開啟樹狀結構,找出發生重組的位置。

版面配置檢查器支援子項重組計數
版面配置檢查器支援子項重組計數。

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

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

透過 Android 裝置串流功能使用合作夥伴裝置實驗室

合作夥伴裝置實驗室是由 Google OEM 合作夥伴 (例如 Samsung、小米、OPPO、OnePlus、vivo 等) 營運的裝置實驗室,可擴充 Android 裝置串流服務提供的裝置選擇。這項服務目前為 Beta 版,適用於最新 Android Studio Canary 版。詳情請參閱「連線至合作夥伴裝置實驗室」。



預設為 K2 模式

Android Studio 現在預設使用 K2 Kotlin 編譯器。這個新一代編譯器可大幅提升 IDE 和建構作業的效能。啟用 K2 後,我們將為未來的 Kotlin 程式設計語言功能鋪路,並在 Kotlin 中提供更快速、更穩健的開發體驗。