Android 自適應圖示被裁切：檢查前景、安全區與資源引用
區分 Android 圖示裁切、白邊和舊資源問題，調整前景安全區，檢查匯出 XML，並在啟動器中驗證結果。
Android 自適應圖示被裁切，通常需要縮小前景或準備更乾淨的獨立圖層。直接縮小完整方形圖片，可能仍把原背景留在符號後面，並沒有解決相同的問題。先判斷哪部分被裁掉，再分別檢查前景與背景。
本指南使用 Android 圖示製作器。你可以先試原創模板，也可以使用有權修改的素材。替換專案資源之前保留主檔案。
插圖：原創產生的概念示意，不是介面截圖、客戶結果或平台驗收紀錄。
先區分裁切型別
在不止一種遮罩中觀察。如果圓角矩形里正常、圓形裡丟失四角，主要符號可能太靠近邊緣。如果符號已經很小，卻仍帶著白色方框，前景可能包含不透明背景。如果整個圖示像舊版本，先檢查專案引用和啟動器快取，而不是立即重畫。
這三類問題的處理不同。縮放可以把核心符號向裡收，但不能去掉已經存在於照片或扁平 Logo 中的白色畫素。匯出新檔案也不會改變仍指向舊資源名稱的專案。
實際縮放對比
2026 年 10 月 2 日，在瀏覽器的圓形構圖預覽中，對同一 Stack 範本分別設定 125% 和 50% 縮放。125% 時，深色來源方塊超出虛線標示的 66 dp 參考區，四角被圓形遮罩裁掉；50% 時，整個方塊都落在參考區內。兩張截圖中的 AG 字母都可見。這展示的是不透明來源圖片的縮放，並非去背，也不代表所有啟動器的效果。
將關鍵內容放進安全區
Android 官方指南把前景與背景放在 108 × 108 dp 畫布上，中央 66 × 66 dp 是支援遮罩下的安全區。外圍留給系統呈現，不適合擺放必須完整顯示的文字或細節。
開啟安全區預覽，逐步縮小前景，直到主要符號舒適地位於中央，再切換遮罩。不要為了避免所有邊緣問題，把圖形縮得過小；應在小尺寸下仍然辨認得出。
可用應用圖示製作器裡的 Stack 原創模板做可復現練習：開啟 Android 自適應輸出，對比兩種前景縮放值。這是設計示例，不是轉化率研究。記錄選定設定，後續才能復現同一輸出。
獨立檢查背景
背景應填滿圖層。透明前景可以疊在純色或單獨背景圖上。觀察系統裁切合成圖後，是否出現空角、意外白邊或對比度變化。
如果源圖已經在符號後放了實心方塊，應回到可編輯設計中分離前景。PNG 製作器能保留已有透明通道並調整畫布，但把不透明 JPEG 轉成 PNG 不會自動移除背景。
檢查 XML 實際引用的檔案
下載後先解包，不要直接把 ZIP 放進專案。當前自適應輸出的密度目錄包含前景、背景和傳統 PNG；Android 8.0 資源定義位於 res/mipmap-anydpi-v26。
確認 ic_launcher.xml 每個引用都能找到對應檔案。典型定義如下：
<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
<background android:drawable="@mipmap/ic_launcher_background" />
<foreground android:drawable="@mipmap/ic_launcher_foreground" />
</adaptive-icon>專案可以使用不同資源名稱，但檔案和 XML 必須一起保持一致。再檢查 application 的 android:icon。如果它指向另一個名稱，修改 ic_launcher 不會更新實際圖示。
已檢查資源整合的 Android 專案
2026 年 10 月 1 日，一個獨立測試應用程式匯入目前匯出的 Android/res 目錄，使用 Gradle 9.5.0、Android Gradle Plugin 9.3.1、JDK 21.0.10 與 compile SDK 36.1 完成 assembleDebug。最低 API 為 23，目標 API 為 36。產生的 APK 包含啟動 Activity 程式碼、DEX、資源表，以及自適應和傳統圖示資源，偵錯簽章也已驗證。
設定你的 Android SDK，並在附帶專案目錄中執行以下命令。首次建置可能下載公開的建置相依套件。
./gradlew --no-daemon :app:assembleDebug這確認了專案編譯與資源引用，不代表特定啟動器中安裝圖示的裁切或顯示效果。請在目標裝置上另行檢查。
構建並檢查啟動器
將確定的資源複製到應用模組，構建並檢查安裝後的圖示。使用支援的模擬器或裝置，條件允許時再觀察第二種遮罩。瀏覽器預覽能發現構圖問題，但不能復現所有啟動器的渲染和快取。
仍顯示舊圖示時，確認新構建已安裝，manifest 的引用也指向修改後的資源。重新安裝可丟棄資料的測試應用，有助於區分快取和檔案問題；不要為排錯隨意移除含有重要資料的應用。
模擬器安裝實例
2026 年 10 月 2 日，匯出資源已安裝至隔離的 Android API 36 模擬器。應用成功啟動，應用程式抽屜顯示 XY 圖示。這驗證了該啟動器與建置；其他遮罩和裝置仍須分別檢查。
常見問題
為什麼縮小後白邊仍然存在？
白邊可能就是源圖的一部分，縮放會連它一起縮小。應使用真正透明的前景，或從可編輯設計中分離圖層。
傳統圖示和自適應圖示可以同時存在嗎？
可以。輸出包含傳統 PNG 和按系統版本區分的自適應 XML。仍需檢查實際資源引用，並測試支援的 Android 版本。
輸出覆蓋所有主題圖示功能嗎？
當前匯出提供彩色前景與背景。若需要單色或主題圖示，請按最新 Android 指南準備並測試，不要假設彩色 ZIP 自動包含全部主題功能。
再次匯出前
讓關鍵符號留在安全區，背景填滿圖層，重建前核對 XML 引用。用 Android 圖示製作器處理裁切，用尺寸指南查平臺數值。
更多文章
通訊
保持更新
將最新的應用設計技巧和圖標趨勢發送到您的收件箱。