Nine-Patch 是 Android 專用的 PNG 延伸格式,**檔名以 .9.png 結尾**。在圖片四周各加 1 像素邊框,用**純黑線 (#000000, 不透明)** 標記:
編譯打包時 (aapt2),黑線被移除,資訊寫入 PNG chunk,執行期由 NinePatchDrawable 解析自動拉伸。
+-----------------+ ← 上邊框:水平拉伸區 (黑線像素) | 1 | 2 | 3 | 4 | ← 內容區 (不拉伸) |---+---+---+---| | 5 | 6 | 7 | 8 | ← 中間區:雙向拉伸 (黑線區域) |---+---+---+---| | 9 |10 |11 |12 | ← 內容區 |---+---+---+---| |13 |14 |15 |16 | ← 內容區 +-----------------+ ← 下邊框:水平拉伸區 ←左 → →右邊框:垂直拉伸區
java 在 PATH。$ANDROID_SDK/tools/draw9patch.bat (Windows) 或 draw9patch (Linux/Mac)。xxx.9.png。

#000000、不透明度 100%、硬度 100%。xxx.9.png。⚠️ **缺點**:無即時預覽,易畫錯;必須確保邊緣無半透明像素,否則編譯報錯。
透明背景 + 邊框黑線同樣有效,四角透明區不拉伸,保持圓角完美。

部分舊裝置螢幕 16-bit 色深 (RGB565),漸層圖會出現明顯色帶。.9.png 經 aapt2 優化後,系統會在拉伸時進行**抖動 (Dithering)**,大幅減輕色帶現象。

drawable-nodpi 或 drawable),自動適配所有密度,APK 體積大幅縮減。<Button
android:background="@drawable/btn_bg_9"
android:text="九宮格按鈕"
android:padding="12dp" />
// 或 Java/Kotlin
view.setBackgroundResource(R.drawable.btn_bg_9);
| 錯誤現象 | 原因 | 解決 |
|---|---|---|
編譯報錯 ERROR: 9-patch image ... malformed | 黑線不連續、非純黑、邊框寬度不為 1px、四角有黑點 | 用 draw9patch 修正,確保邊框乾淨 |
| 運行時圖片不拉伸 / 變形 | 拉伸區標記錯誤、內容區過小導致文字溢出 | 調整右/下邊框黑線範圍擴大內容區 |
| APK 解壓後 .9.png 黑線消失 | **正常現象**:aapt2 編譯時已剝離黑線並寫入 chunk | 無需處理,運行時自動識別 |
| VectorDrawable (XML) 可替代? | 簡單幾何形狀 (圓角矩形、圓形) 用 Vector 更佳,無邊框煩惱、無限縮放 | 複雜漸層/紋理仍需 .9.png |
.9.png 是 Android 適配多螢幕、減小安裝包、解決漸層色帶的利器。掌握 draw9patch 工具、理解九宮格分割原理、注意黑線繪製規範,能輕鬆製作高質感可拉伸 UI 素材。現代開發中,優先考慮 VectorDrawable / ShapeDrawable / Material Components,複雜圖文混排背景再用 .9.png。