在编译时修改AppIcon

838 阅读2分钟

怎样方便的知道出 app 当前的版本信息,版本号,是 beta/debug/release 呢?之前最直接的方式是在 app 某一页面,显示这些信息,需要的时候去查看。现在出了一个利器,在 AppIcon 上直接就可以看出这些信息,一目了然。见图。

主要思路

使用_ImageMagick_来生成新的 appIcon,并替换生成的 app 包里面的资源。这样就达到了修改 appIcon 的目的。主要用到 shell 脚本来实现。

在 app 生成目录中,选中 app,右键显示包内容,AppIcon 就在这里。只要替换了它们就达到目的了。

包内容

动手实现

1、首先安装 ImageMagick

使用 homebrew 来安装。在命令行中输入:brew install ImageMagick。

如果还未安装 homebrew,要先用如下命令安装 homebrew

ruby -e "$(curl -fsSL raw.githubusercontent.com/Homebrew/in…)"

然后再执行 brew install ImageMagick。

此外还需要安装 Ghostscript,因为 ImageMagick 是依赖于它的,提供了字体支持。

brew install ghostscript

Ghostscript is a software suite designed for rendering PDF and PS files. You need it because it provides the font support for ImageMagick.

2、牛刀小试

下面来介绍下 ImageMagick 的几个命令。可以下载 sampleIcon 来试试。

convert:修改图片。

composite:合成图片。

例子:

convert AppIcon60x60@2x.png -fill white -font Helvetica-Narrow -pointsize 18 -gravity south -annotate 0 "hello world" test.png

AppIcon60x60@2x.png 输入的图片

-fill white 设置文本颜色,red,black,orange 等等。

-font Helvetica-Narrow 设置字体(支持的字体可以通过 convert -list font 来查看)

-pointsize 18 设置字体大小

-gravity south 设置文字对齐方向,south 表示底部对齐,west 表示靠左对齐

-annotate 0 旋转的角度,若设置成 90°,文字将顺时针旋转 90°。

"hello world"  表示要绘制的文字。

test.png 表示生成的新图片,若已存在同名的,会覆盖原文件。

convert betaRibbon.png -resize 120x120 smallBetaRibbon.png

resize 进行裁剪。

composite smallBetaRibbon.png test.png test2.png

合成图片

3、在 Xcode 中添加 shell 脚本

在 build phase 中添加 script

先来个简单的:echo "hello world"

hello world

编译,查看脚本运行结果。可以看到输出了 hello world。

运行结果

4、新建工程

sampleIcon 导入到 Imageassets 的 AppIcon 中。同时将 sampleIcon 中的 beta.png,debug.png 文件拖入到工程根目录。如图:

导入 debug 和 beta 图片

在 shell 脚本中添加

echo "BUILTPRODUCTSDIR/{BUILT_PRODUCTS_DIR}/{UNLOCALIZED_RESOURCES_FOLDER_PATH}"

echo "${SRCROOT}"

shell 执行结果

BUILTPRODUCTSDIR/{BUILT_PRODUCTS_DIR}/{UNLOCALIZED_RESOURCES_FOLDER_PATH} 表示生成的 app 所在目录。

${SRCROOT} 表示工程根目录

打开 Finder 到 app 目录,右键包内容,可以看到 appIcon。

app 所在目录 包内容

修改脚本,替换成如下(替换 6p 的 AppIcon 需要对 @3x.png 进行操作)

#添加 / usr/local/bin 到环境变量

PATH=${PATH}:/usr/local/bin

#appIcon 所在路径 TARGET_PATH="BUILTPRODUCTSDIR/{BUILT_PRODUCTS_DIR}/{UNLOCALIZED_RESOURCES_FOLDER_PATH}/AppIcon60x60@2x.png"

#输入图片所在路径,find 命令找出 AppIcon60x60@2x.png 的路径

BASE_IMAGE_PATH=(find(find {SRCROOT} -name "AppIcon60x60@2x.png")

#裁剪图片到 120*120

convert betaRibbon.png -resize 120x120 resizedBetaRibbon.png

#生成图片到 appIcon 实际所在路径

convert BASEIMAGEPATHfillwhitefontTimesBoldpointsize18gravitysouthannotate0"HelloWorld"compositeresizedBetaRibbon.png{BASE_IMAGE_PATH} -fill white -font Times-Bold -pointsize 18 -gravity south -annotate 0 "Hello World" -| composite resizedBetaRibbon.png - {TARGET_PATH}

运行后,返回桌面看 appIcon,已经变了。

新的 appIcon

5、在 appIcon 上显示版本号

(1)如何在 shell 中获取版本号呢?通过 PlistBuddy,它是对 plist 文件进行读取的工具,所在路径是 / usr/libexec。

CFBundleVersion:build 号

CFBundleShortVersionString:版本号,如 2.1.1

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

echo $buildNumber

versionNumber=(/usr/libexec/PlistBuddyc"PrintCFBundleShortVersionString""(/usr/libexec/PlistBuddy -c "Print CFBundleShortVersionString" "{PROJECT_DIR}/${INFOPLIST_FILE}")

echo $versionNumber

可以看到 shell 中打印的是一致的。

build 号

将 "hello world" 替换成 "$buildNumber",app 上的文件变成了 1。

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

buildNumber versionNumber

添加版本号,同样的替换成 $versionNumber 就可以了。

(2)在脚本中修改版本号

/usr/libexec/PlistBuddy -c "Set :CFBundleShortVersionString"2.3"""PROJECTDIR/{PROJECT_DIR}/{INFOPLIST_FILE}"

6、添加 configuration,默认有 debug,release。现在我们添加一个 beta

添加 beta

在脚本中添加 config 的判断,beta 版本使用 beta 图片,debug 使用 debug 图片,release 不做操作。Edit scheme 中的 config,重新运行,发现 AppIcon 发生了改变。

if ["${CONFIGURATION}" == "Debug" ]; then

convert debugRibbon.png -resize 120x120 resizedDebugRibbon.png

convert BASEIMAGEPATHfillwhitefontTimesBoldpointsize18gravitysouthannotate0"HelloWorld"compositeresizedDebugRibbon.png{BASE_IMAGE_PATH} -fill white -font Times-Bold -pointsize 18 -gravity south -annotate 0 "Hello World" -| composite resizedDebugRibbon.png - {TARGET_PATH}

fi

if ["${CONFIGURATION}" == "Beta" ]; then

convert betaRibbon.png -resize 120x120 resizedBetaRibbon.png

convert BASEIMAGEPATHfillwhitefontTimesBoldpointsize18gravitysouthannotate0"HelloWorld"compositeresizedBetaRibbon.png{BASE_IMAGE_PATH} -fill white -font Times-Bold -pointsize 18 -gravity south -annotate 0 "Hello World" -| composite resizedBetaRibbon.png - {TARGET_PATH}

fi

7、改进下

在前面我们都是写死的 120120,当使用 @3x 时,图片尺寸应该是 180180。这里用 identify 来动态得出图片本身的大小。

WIDTH=(identifyformat(identify -format %w {BASE_IMAGE_PATH})

identify 是 ImageMagick 提供的。获取图片信息

然后 convert -resize WIDTHxWIDTHxWIDTH。

同样,也可以动态设置 pointsize,根据不同分辨率,以下以 WIDTH 为基准。

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

然后将以上代码封成函数,只需传入图片名称,即可。

function generateIcon(){

#0表示shell本身文件名,0 表示 shell 本身文件名,1 表示第一个参数

BASE_IMAGE_NAME = $1

BASE_IMAGE_PATH=(find(find {SRCROOT} -name ${BASE_IMAGE_NAME})

...

}

调用:

generateIcon "AppIcon60x60@2x.png"

generateIcon "AppIcon60x60@3x.png"

可同时修改 @2x,@3x 的 AppIcon。

demo 地址:demo

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