在跨平台專案中,常需要把 iOS 的圖形資源轉移到 Android 專案使用。然而,兩邊的命名規則不同,若直接複製,容易出現 Android 無法編譯或資源無法辨識的問題。
iOS 圖檔常見 @2x.png、@3x.png 等寫法,而 Android 資源名稱通常只能使用小寫字母、數字與底線,且不能以數字開頭,也不能使用保留字。因此,批次重新命名是必要步驟。
最簡單的方式是把 @2x.png 這類後綴移除,只保留 .png。若同一張圖存在多個倍率版本,可依照專案需求選擇保留 @2x 或 @3x,並手動調整對應的資料夾。
可在資源目錄建立一個 rename.sh 腳本,利用 find 找出所有 @2x.png 檔案,再透過 mv 批次改名。腳本內容可參考:
#!/bin/sh
find . -name "*@2x.png" -type f | while read file
do
mv "$file" "${file%@2x.*}.png"
done
建立後,將腳本複製到資源目錄,執行 chmod +x rename.sh 加上執行權限,再執行 ./rename.sh 即可。
改名後仍要確認檔案名稱是否全為小寫、是否以數字開頭、是否與 Android 保留字衝突。若大量檔案需要處理,可再寫一個檢查腳本,列出不符合規則的名稱,方便人工修正。
透過批次腳本處理資源命名,可以大幅減少手動修改的時間,也能降低跨平台搬移時的錯誤率。