您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

【投稿】如何在編譯時動態改變 App 圖標

編輯:iOS 開發基礎

當你完成應用程式的 beta 版本後,總會有人幫忙測試,好讓你持續完善它……運氣好還能吸引投資人青睞。但如果測試人員能用某種簡單方式一眼分辨出這是測試構建版本,會不會很有幫助呢?

這篇教學就將帶你做到這件事,並介紹一些或許鮮為人知的 Xcode 功能。

你相信嗎?在這個教學裡,你不必寫一行 Swift,也不必寫一句 Objective-C,而是要寫一些 bash shell 腳本。你將會用到 ImageMagick、終端機與 Xcode,打造一個能自動在 App 圖標上加上「debug」或「beta」標識的腳本。

這個教學需要具備一些基本的 Unix 腳本知識。你可以跟隨 shell 腳本高手學習,也可以參考《Bash 初學者指南》或《Bash 腳本進階編程指南》。

App 圖標示意。

準備工作

首先,你需要安裝 ImageMagick,這是一套非常強大的圖形處理工具套件,專為終端機操作而設計。你可以透過 Homebrew 輕鬆安裝它。如果還沒安裝 Homebrew,或不清楚它是什麼,可以到官方網站了解並安裝。

若已安裝 Homebrew,打開終端機並輸入:

brew update

這能確保你安裝的是 Homebrew 上的最新套件,同時也驗證了你確實安裝了 Homebrew。

接著用 Homebrew 安裝所需的套件:

brew install ImageMagick

你會看到一連串透過 Homebrew 安裝 ImageMagick 的過程,跟著步驟安裝即可。

接下來,你還需要安裝 Ghostscript,因為 ImageMagick 會依賴它。Ghostscript 是一套用於呈現 PDF 與 PS 檔案的軟體套件,它提供了 ImageMagick 所需的字型支援。透過以下命令安裝:

brew install ghostscript

如果中途發生錯誤,執行:

brew doctor

安裝失敗時,你會收到相應訊息,並被告知如何修復。

以上就是本教學需要安裝的所有東西。

Llama 你好

ImageMagick 有許多命令,但本教學會用到的是 convert(轉換)與 composite(組合):

  • convert:讀取一張圖片,修改後另存為新圖片;

  • composite:讀取一張圖片,在它上面覆蓋另一張圖片,再存為第三張新圖片。

本教學提供了一些簡單的圖標供你使用;當然你也可以用自己的圖標,只需相應調整檔案名稱即可。請在這裡下載圖標,並放到桌面上。

其中一個目標,是在構建版本的 App 圖標上覆蓋文字。所以我們先來看看如何用 ImageMagick 在圖標上寫入「Hello World」。打開終端機並進入存放 App 圖標的資料夾:

cd ~/Desktop/AppIconSet

接著輸入:

convert AppIcon60x60@2x.png -fill white -font Times-Bold -pointsize 18 -gravity south -annotate 0 "Hello World" test.png

我把這行命令逐一拆解,讓你明白它做了什麼:

  1. AppIcon60x60@2x.png 是輸入圖片的名稱;

  2. -fill white 把文字設為白色;

  3. -font Times-Bold 指定 ImageMagick 使用的字型;

  4. -pointsize 18 把字級設為 18;

  5. -gravity south 讓文字與圖片底部對齊;

  6. -annotate 0 "Hello World" 告訴 ImageMagick 將帶有「Hello World」文字註釋的圖片旋轉 0 度;

  7. test.png 是輸出的檔案名稱,ImageMagick 會覆蓋已存在的同名檔案。

如果終端機沒有出現任何錯誤,你就會在 AppIconSet 資料夾裡看到一個名為 test.png 的檔案,打開後你會看到類似這樣的結果:

小提示:如果你看到錯誤訊息,或腳本沒有效果,可能是你沒有安裝所需的字型。執行下面的命令,看看你能使用哪些字型。

convert -list font

如果沒有 Times 這個字型,就挑一個可用的來替代。

現在,把 beta 標志加到圖片上。在終端機輸入:

composite betaRibbon.png test.png test2.png

這會把 betaRibbon.png 疊到 test.png 上面,再將合成的圖片存為 test2.png。

打開 test2.png,等等,你看到的還是原來的 test.png,這是為什麼呢?

因為 test.png 的尺寸是 120x120,而 betaRibbon.png 是 1024x1014,所以只有 betaRibbon.png 透明的那部分疊到了 test.png 上,其餘部分都被裁掉了。

不相信嗎?試著用相同的命令,但把 betaRibbon.png 和 test.png 的位置對調。

composite test.png betaRibbon.png test2.png

你現在會看到一張在 test.png 右上角帶著 beta 的大圖片:

為了得到我們想要的結果,需要把 betaRibbon.png 的尺寸改成 120x120。在 ImageMagick 裡這非常容易,只要輸入:

convert betaRibbon.png -resize 120x120 smallBetaRibbon.png

這行命令把 betaRibbon.png 的大小改為 120x120,並存為 smallBetaRibbon.png。

現在執行:

composite smallBetaRibbon.png test.png test2.png

打開 test2.png,你會看到我們期待的結果:

以上就是本教學需要掌握的 ImageMagick 功能,但它們僅僅是 ImageMagick 的冰山一角,更多功能可前往官網查看。

Xcode

完成這些圖像處理後,是時候回到我們熟悉的平台了。

打開 Xcode,選擇 File > New > Project…,接著選 iOS > Application > Single View Application,點擊 Next。將專案命名為 Llama Trot,語言選 Swift,設備設為 Universal,最後把專案存到桌面。

你的目標是透過 Xcode 與 ImageMagick,根據所選的構建配置,在每次構建時生成合適的圖標。Xcode 能在專案構建時執行腳本,這些腳本其實就是 Unix 腳本,會在你每次運行專案時執行。

設置運行腳本

在專案中選擇 Llama Trot 的 Target,接著選 Build Phases,點擊 +,在彈出的選單中選擇 New Run Script Phase:

你會看到 Run Script Phase 被加入到專案配置中。執行腳本時,Shell 參數會自動設為 bin/sh,也就是腳本會在 bash Unix shell 中執行。

下面的方框就是讓你撰寫腳本的地方。在框中輸入:

echo "Hello World"

你的新 build phase 應該長得像這樣:

構建並運行,你會發現畫面上什麼也沒發生——這是因為腳本印出的「Hello World」被輸出到了構建日誌裡。

點擊 Report Navigator(Xcode 導航欄面板最右邊的圖標),再點擊最近一次的構建報告。當你構建專案時,這裡會列出 Xcode 為你做的所有事情,你會看到那句「Hello World」:

應用圖標

很好,你已經寫出一個能印出「Hello World」的腳本,就像你開發生涯中已經做過一百萬次的那樣。現在,是時候動手修改 App 圖標了。

從腳本中找到 App 圖標

把所有 App 圖標加入 Images.xcassets,將每個圖標拖到對應的 AppIcon 尺寸上:

同時,把 debugRibbon.png 和 betaRibbon.png 放到與 .xcodeproj 同級的目錄中:

為了使用這些圖標,你的腳本需要知道它們在哪裡。用下面的程式碼取代你先前寫的腳本:

echo "${BUILT_PRODUCTS_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}"
echo "${SRCROOT}"
  1. 第一行會印出你運行專案後的最終產品路徑,其中包含最後的圖標。

  2. 第二行會印出專案檔案所在的資料夾路徑。

這是透過使用 Xcode 的一些構建設置變量來實現的。運行專案並查看構建報告,你會看到描述專案最終產品的檔案路徑,在它下面則是專案所在的檔案路徑:

定位到第一個資料夾,查看它的位置,你會看到 App 中的所有內容,包括所有 App 圖標——這裡就是 ImageMagick 修改後圖標的存放處。在 AppIcon 上點擊右鍵並選擇 Show Package Contents,你會看到這些圖標,此時它們看起來都很正常!

現在定位到印出的第二個路徑,這就是你一般專案所在的資料夾。那麼,App 圖標在哪裡呢?前往同名為 Llama Trot 的資料夾,你會看到 Images.xcassets;打開它,你會看到另一個叫 AppIcon.appiconset 的檔案。App 圖標就在這個資料夾裡,你將透過 ImageMagick 來修改它們。假設你把專案存到桌面並命名為 Llama Trot,那麼圖標路徑就是 ~/Desktop/Llama\ Trot/Llama\ Trot/Images.xcassets/AppIcon.appiconset。

把腳本的最後一行替換成下面的程式碼,你就能得到原始圖標的完整路徑:

IFS=$'\n'
echo $(find ${SRCROOT} -name "AppIcon60x60@2x.png")
  1. 第一行設定 IFS(內部欄位分隔符)為換行符。若不這樣做,第二行就會失敗,因為檔名 Llama Trot 含有一個空格。若好奇少了第一行會發生什麼,可以刪掉試試。

  2. 第二行會在 ${SRCROOT} 資料夾中遞迴搜尋名為 AppIcon60x60@2x.png 的檔案。

運行專案,你會看到 AppIcon60x60@2x 的完整路徑被印出來:

把它們拼湊起來

最難的部分即將結束。現在是把一切組合起來、透過腳本修改 App 圖標的時候了。你會先從 AppIcon60x60@2x.png 開始,再推廣到所有圖標,這意味著你需要在 @2x 的模擬器或 iPhone 6 Plus 上測試。

結合 ImageMagick 的技法與先前的腳本,最終你會得到下面這段腳本,請確保相應地更新它:

IFS=$'\n' #1
PATH=${PATH}:/usr/local/bin #2
TARGET_PATH="${BUILT_PRODUCTS_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/AppIcon60x60@2x.png"
BASE_IMAGE_PATH=$(find ${SRCROOT} -name "AppIcon60x60@2x.png") #3
convert betaRibbon.png -resize 120x120 resizedBetaRibbon.png #4
convert ${BASE_IMAGE_PATH} -fill white -font Times-Bold -pointsize 18 -gravity south -annotate 0 "Hello World" - | composite resizedBetaRibbon.png - ${TARGET_PATH}

來分析發生了什麼:

  1. 如果省略第一行,編譯將會失敗。你的終端機有一個叫 PATH 的變量,用來存放一些預設的本地腳本路徑,這允許任何命令在指定目錄下運行而無需寫出完整路徑。Xcode 需要把同樣的 PATH 變量分享給你的終端機,這行把 /usr/local/bin(Homebrew 的安裝位置)加入 PATH 變量。

  2. 接下來兩行取得本地的 App 圖標,分別把路徑存到 TARGET_PATH 與 BASE_IMAGE_PATH 變量中。

  3. 這行把 betaRibbon.png 的尺寸改成合適的大小。

  4. 最後一行做了兩件事:先在原始 App 圖標上加上「Hello World」文字,再執行合成功能——把帶 beta 標志的圖片疊在上面,最後把合成的圖片存為 App 圖標。

小提示:App 圖標的名稱不能任意更改。最終產品中,App 圖標名稱必須像 AppIcon60x60@2x.png 這樣,Xcode 依此命名約定來決定各設備使用哪個圖標。

運行專案,在你的設備主螢幕上查看 App 圖標;如果你在模擬器中,可以按 Cmd + Shift + H 切換到主螢幕。你會看到一個修改過的圖標:

其餘的圖標

既然你已經處理好一個圖標,現在該讓腳本去處理所有圖標,好讓它們在 iPad、iPhone 6 Plus 等設備上正確顯示。

要做到這點,你就把程式碼改寫成一個函式,把圖標名稱當作參數,然後為每個圖標呼叫該函式。修改後的腳本如下:

PATH=${PATH}:/usr/local/bin
IFS=$'\n'
function generateIcon () {
 BASE_IMAGE_NAME=$1
 TARGET_PATH="${BUILT_PRODUCTS_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/${BASE_IMAGE_NAME}"
 BASE_IMAGE_PATH=$(find ${SRCROOT} -name ${BASE_IMAGE_NAME})
 WIDTH=$(identify -format %w ${BASE_IMAGE_PATH})
 convert betaRibbon.png -resize $WIDTHx$WIDTH resizedRibbon.png
 convert ${BASE_IMAGE_PATH} -fill white -font Times-Bold -pointsize 18 -gravity south -annotate 0 "Hello World" - | composite resizedRibbon.png - ${TARGET_PATH}
}
generateIcon "AppIcon60x60@2x.png"
generateIcon "AppIcon60x60@3x.png"
generateIcon "AppIcon76x76~ipad.png"
generateIcon "AppIcon76x76@2x~ipad.png"

這段程式碼把整份圖像處理邏輯封裝成一個名為 generateIcon() 的函式,並把圖標名稱作為參數傳入。腳本透過 $1 取得這個參數,並設定 BASE_IMAGE_PATH 變量,放到原本 AppIcon60x60@2x 所在的位置。

你會發現 ImageMagick 有個新功能 Identity,它能取得圖片資訊。在這裡,你想用 identify 加上 -format %w 取得的寬度,來重新調整 betaRibbon.png 的大小。

現在,選一個 iPad 或 iPhone 6 Plus 的模擬器並運行專案。之所以要這樣做,是因為字級是用像素表示的,而不同設備螢幕有不同的像素密度:

很簡單吧?但你真正想要的是讓文字高度依據整個圖標按一定比例縮放。在你先前設定 WIDTH 變量的地方,馬上加入下面這行:

FONT_SIZE=$(echo "$WIDTH * .15" | bc -l)

這行看似微妙,但它確實把 FONT_SIZE 變量設為可變寬度的五分之一。因為 Unix 算術不支援浮點運算,你必須使用 bc 程式——basic calculator 的縮寫,它能處理浮點運算。

現在,把最後一行 generateIcon() 中的 18 改成使用 FONT_SIZE 變量。最終腳本應如下:

PATH=${PATH}:/usr/local/bin
IFS=$'\n'
function generateIcon () {
 BASE_IMAGE_NAME=$1
 TARGET_PATH="${BUILT_PRODUCTS_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/${BASE_IMAGE_NAME}"
 BASE_IMAGE_PATH=$(find ${SRCROOT} -name ${BASE_IMAGE_NAME})
 WIDTH=$(identify -format %w ${BASE_IMAGE_PATH})
 FONT_SIZE=$(echo "$WIDTH * .15" | bc -l)
 convert betaRibbon.png -resize $WIDTHx$WIDTH resizedRibbon.png
 convert ${BASE_IMAGE_PATH} -fill white -font Times-Bold -pointsize ${FONT_SIZE} -gravity south -annotate 0 "Hello World" - | composite resizedRibbon.png - ${TARGET_PATH}
}
generateIcon "AppIcon60x60@2x.png"
generateIcon "AppIcon60x60@3x.png"
generateIcon "AppIcon76x76~ipad.png"
generateIcon "AppIcon76x76@2x~ipad.png"

在不同設備上運行專案,你會發現效果好多啦。

構建號

把圖標上的「Hello World」換成構建號其實很容易。版本的構建號可以在 Info.plist 中的 CFBundleVersion 找到。那麼,要怎麼把它放進腳本呢?好消息是,你的 Mac 有個程式能幫你搞定,它叫 PlistBuddy,位於 /usr/libexec/。

在腳本最上面加入這行:

buildNumber=$(/usr/libexec/PlistBuddy -c "Print CFBundleVersion" "${PROJECT_DIR}/${INFOPLIST_FILE}")

這行透過 PlistBuddy 取得構建號。現在很簡單地把「Hello World」換成 $buildNumber:

convert ${BASE_IMAGE_PATH} -fill white -font Times-Bold -pointsize ${FONT_SIZE} -gravity south -annotate 0 "$buildNumber" - | composite resizedRibbon.png - ${TARGET_PATH}

在 General 中把構建號改為 2015:

現在運行,你會看到一個帶著構建號的圖標:

構建配置

太酷了!整個流程即將完成,你已經能在專案每次運行時,為 App 圖標加上 beta 標志與構建號。

但你顯然不想永遠帶著 beta 標志和構建號,那該怎麼辦?在 Xcode 中進入專案配置,你會看到兩個預設設置:Debug 與 Release。點擊 +,選擇 Duplicate Release,並命名為 Beta。

這樣一來,Debug 配置是調試版本,Beta 配置是測試版本,Release 配置則是正式發布版本。

現在你需要把這些配置放進腳本,並透過 CONFIGURATION 來判斷。在腳本中加入一個 if 來選擇當前配置,更新後的腳本如下:

IFS=$'\n'
buildNumber=$(/usr/libexec/PlistBuddy -c "Print CFBundleVersion" "${PROJECT_DIR}/${INFOPLIST_FILE}")
versionNumber=$(/usr/libexec/PlistBuddy -c "Print CFBundleShortVersionString" "${PROJECT_DIR}/${INFOPLIST_FILE}")
PATH=${PATH}:/usr/local/bin
function generateIcon () {
 BASE_IMAGE_NAME=$1
 TARGET_PATH="${BUILT_PRODUCTS_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/${BASE_IMAGE_NAME}"
 BASE_IMAGE_PATH=$(find ${SRCROOT} -name ${BASE_IMAGE_NAME})
 WIDTH=$(identify -format %w ${BASE_IMAGE_PATH})
 FONT_SIZE=$(echo "$WIDTH * .15" | bc -l)
 if [ "${CONFIGURATION}" == "Debug" ]; then
 convert debugRibbon.png -resize ${WIDTH}x${WIDTH} resizedRibbon.png
 convert ${BASE_IMAGE_PATH} -fill white -font Times-Bold -pointsize ${FONT_SIZE} -gravity south -annotate 0 "$buildNumber" - | composite resizedRibbon.png - ${TARGET_PATH}
 fi
 if [ "${CONFIGURATION}" == "Beta" ]; then
 convert betaRibbon.png -resize ${WIDTH}x${WIDTH} resizedRibbon.png
 convert ${BASE_IMAGE_PATH} -fill white -font Times-Bold -pointsize ${FONT_SIZE} -gravity south -annotate 0 "$buildNumber" - | composite resizedRibbon.png - ${TARGET_PATH}
 fi
}
generateIcon "AppIcon60x60@2x.png"
generateIcon "AppIcon60x60@3x.png"
generateIcon "AppIcon76x76~ipad.png"
generateIcon "AppIcon76x76@2x~ipad.png"

透過選擇 Product > Scheme > Edit Scheme…,選 Info,再依你的需求選擇 Run、Archive、Profile 等,即可切換構建配置。

就是這樣!帶著構建號與標志的 App 圖標大功告成!

Beta 版本:

Debug 版本:

  • 原文:How To Change Your App Icon at Build Time

  • 作者:Neil Dwyer

  • 翻譯:zmp1123(簡書)

  • 微信號:iOS開發者

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved