Android Studio 是用於 Android 開發作業的官方 IDE，包含建構 Android 應用程式所需的各項資源。
本頁將列出最新 Android Studio Narwhal 3 功能推送穩定版的新功能和改善項目。您可以透過這個連結下載，也可以在 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 3 功能推送 | 2025 年 1 月 3 日 | 4.0-8.13 |
| 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 版本低於專案的 targetSdk 或 compileSdk 所需版本，可能會導致非預期的問題。建議您使用最新的 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 功能推送時，我們就會開始執行這項規定。
Studio Labs
您可以在 Android Studio 穩定版中試用最新的 AI 實驗功能，更快將 AI 輔助功能整合至開發工作流程。詳情請參閱「Studio Labs」。
以下是 Studio Labs 目前提供的功能。
| 功能 | 說明 | 文件 |
|---|---|---|
| Compose 預覽生成 | Gemini 可以自動產生 Compose 預覽畫面，包括預覽參數的模擬資料，適用於特定可組合函式或檔案中的所有可組合函式。 | 生成 Compose 預覽 |
| 轉換使用者介面 | 直接在 Compose 預覽面板中使用自然語言更新應用程式 UI。 | 轉換 UI |
以下是 Android Studio Narwhal 3 功能推送的新功能。
可調整大小的 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 3 功能發布版本提供應用程式備份功能，可將備份檔還原至其他裝置。這項功能有助於測試應用程式在裝置間或從雲端備份還原應用程式資料時，是否會如預期運作；此外，如果您想更快速地設定測試裝置，並使用開發及偵錯應用程式所需的資料，這項功能也能派上用場。
產生備份
如要產生備份檔案，請按照下列步驟操作：
- 將應用程式的偵錯版本部署至連結裝置
- 請使用下列任一動作產生備份：
- 在「Running Device」(執行中的裝置) 視窗中，按一下工具列中的「Backup App Data」(備份應用程式資料) 動作
- 在主選單列中依序選取「Run」>「Backup App Data」
- 在「Device Explorer」>「Processes」分頁中，按一下應用程式程序，然後選取「Backup App Data」。
- 在隨即顯示的對話方塊中，執行下列操作：
- 確認要產生備份的應用程式 ID
- 選取要產生「裝置到裝置」、「雲端」或「雲端 (未加密)」備份
- 確認要儲存的備份檔名稱和位置。根據預設，備份檔會儲存至目前 Android Studio 專案的根目錄。
產生應用程式備份。
- 確認要產生備份的應用程式 ID
- Android Studio 詢問是否可以停止應用程式時，請按一下「Ok」。Android Studio 必須停止應用程式程序，才能產生備份。
您可以在「Project」>「Android」工具視窗的「Backup Files」節點下方，查看產生的備份檔案。
備份類型
您可以為應用程式產生不同類型的備份。產生備份時，請選取與要測試情境相關的備份類型：
- 裝置對裝置：產生應用程式備份，類似於裝置對裝置轉移期間建立的備份。在裝置對裝置轉移作業中，應用程式的備份資料會直接傳送至其他裝置，例如透過 USB 或 Wi-Fi。
- 雲端：產生應用程式備份，類似於儲存在使用者 Google 帳戶儲存空間的備份。使用者設定新裝置時，可以選擇從雲端備份還原。
- 雲端 (未加密)：產生應用程式備份，類似於儲存在裝置使用者 Google 帳戶儲存空間的備份，但未啟用用戶端加密功能。
注意：使用這項功能測試 Cloud、Cloud (Unencrypted) 或裝置對裝置備份時，系統不會將產生的備份檔傳送至雲端或其他裝置，與實際備份流程不同。這項功能會產生應用程式備份檔，就像要儲存至雲端或傳送至其他裝置一樣。任何備份類型產生的備份檔，都可以在「Project」>「Android」工具視窗的「Backup Files」下方找到。
還原應用程式資料
如要還原應用程式資料，請按照下列步驟操作：
- 將應用程式部署至連結的裝置。應用程式的應用程式 ID 應與要還原到裝置的備份檔案相同。
- 前往並點選下列其中一項動作：
- 在「Running Device」視窗中，按一下工具列的「Restore App Data」動作，然後從最近的記錄中選取備份檔案，或按一下「Browse」。
- 在主選單列中依序選取「Run」>「Restore App Data」。
- 在「Device Explorer」>「Processes」分頁中，對應用程式程序按一下滑鼠右鍵，然後選取「Restore App Data」。
- 在「Project」>「Android」工具視窗中，對「Backup Files」節點下的備份按一下滑鼠右鍵，然後選取「Restore App Data」。
- 視情況從近期記錄選取備份，或按一下「瀏覽」，從本機儲存空間選取要還原的備份檔案。
或者，您也可以在執行設定中加入備份檔案，這樣部署應用程式時，也會從備份檔案還原應用程式資料。如要這麼做，請按照下列步驟操作：
- 在主選單列中依序選取「Run」>「Edit Configurations」。
- 選取應用程式執行設定，然後前往「還原選項」。
在執行設定中還原選項。 - 如要從備份還原應用程式，請勾選「還原應用程式狀態」旁邊的方塊。
- 從最近的記錄選取備份檔案，或瀏覽並選取本機儲存空間中的備份檔案。
- 如果只想在全新安裝應用程式時還原應用程式資料，請勾選「Only restore on fresh apk installation」(僅在全新安裝 APK 時還原) 旁的方塊。如果您要部署到新的測試裝置，並想還原資料來協助偵錯和開發應用程式，這個選項就非常實用。
- 按一下「確定」儲存執行設定。
- 使用執行設定部署應用程式，測試將應用程式資料還原至連線裝置。
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」。
在 Gemini 中附加圖片
現在可以在提示中附加圖片檔案，並提供額外資訊。舉例來說，您可以附加 UI 模擬圖或螢幕截圖，讓 Gemini 瞭解應用程式的版面配置。因此，Gemini 可以根據提供的圖片生成 Compose 程式碼，或說明 UI 螢幕截圖的 Composables 和資料流。詳情請參閱「在查詢中附加圖片」。
Gemini 中的 @檔案脈絡資訊
現在，您可以在 Android Studio 中與 Gemini 互動時，附加專案檔案做為背景資訊。這樣一來，您就能在 Gemini 的提示中快速參照檔案。在 Gemini 對話輸入框中輸入 @，開啟檔案完成選單，然後選取要附加的檔案。你也可以按一下「內容」下拉式選單，查看 Gemini 自動附加的檔案。這樣就能進一步控管傳送給 Gemini 的脈絡資訊。詳情請參閱「在查詢中附加檔案」。
