讀唐巧的《iOS 開發進階》時學到一招:用腳本掃出專案裡從未被引用的圖片資源。書中有些小問題,GitHub 上的 issue 已提出修正建議——把程式碼存成 .sh 檔,在 Xcode 中執行這個腳本。


腳本依賴 ack 這個程式碼搜尋工具,先在終端機安裝:
brew install ack
用編輯器(Sublime、VS Code 皆可)建立一個新檔案,輸入:
#!/bin/bash
# 找出專案中所有 png 與 jpg 檔
for i in `find . -name "*.png" -o -name "*.jpg"`; do
# 去掉副檔名與 @2x / @3x 後綴,取得資源本名
file=`basename -s .jpg "$i" | xargs basename -s .png | xargs basename -s @2x | xargs basename -s @3x`
# 在整個專案中搜尋這個名稱是否被引用
result=`ack -i "$file"`
if [ -z "$result" ]; then
echo "$i"
# 確認無誤後可取消下面註解,直接刪除檔案
# rm "$i"
fi
done
相較於原書版本,這裡補上了 @3x 的處理——Retina 高解析圖片的命名後綴,漏掉它會導致所有 @3x 圖片都被誤判為未使用。
接著存檔為 deletePhoto.sh,記下存放路徑(例如 /Users/linafu/deletePhoto)。
然後在終端機為它加上執行權限:
chmod +x ./deletePhoto.sh
至此腳本就準備好了。
1. 建立一個虛擬 Target。在 Xcode 選單選擇 File → New → Target,接著選 macOS → Other → External Build System,命名為 scriptTarget。
2. 指定要執行的腳本。在專案的 target 清單中選中 scriptTarget,在 Build Tool 欄位填入腳本的完整路徑,例如 /Users/linafu/deletePhoto.sh。
3. 建立相依關係。在原本的 target 中,到 Build Phases → Target Dependencies 加入 scriptTarget。
設定完成後,每次編譯前都會先 build 這個虛擬 target,也就等於執行一次腳本。
第一次執行時,強烈建議保持 rm "$i" 處於註解狀態,先看清楚輸出的清單。原因是這個腳本只看字串有沒有出現在程式碼中,它無法分辨以下情況:
[NSString stringWithFormat:@"icon_%d", i],腳本找不到完整字串,會誤判為未使用。逐筆確認清單無誤後,再取消註解執行刪除。順序顛倒的話,刪錯的圖片往往要到使用者回報畫面空白時才會被發現。
除了 shell,也有開發者用 Python 實作同樣的功能。兩者的差別主要在於字串處理能力——Python 在正則表達式與檔案遍歷上寫起來更直觀,也能更容易地排除 Pods、Carthage 等第三方目錄。可依團隊熟悉度選擇。