怎样方便的知道出 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 "{UNLOCALIZED_RESOURCES_FOLDER_PATH}"
echo "${SRCROOT}"
shell 执行结果
{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="{UNLOCALIZED_RESOURCES_FOLDER_PATH}/AppIcon60x60@2x.png"
#输入图片所在路径,find 命令找出 AppIcon60x60@2x.png 的路径
BASE_IMAGE_PATH={SRCROOT} -name "AppIcon60x60@2x.png")
#裁剪图片到 120*120
convert betaRibbon.png -resize 120x120 resizedBetaRibbon.png
#生成图片到 appIcon 实际所在路径
convert {TARGET_PATH}
运行后,返回桌面看 appIcon,已经变了。
新的 appIcon
5、在 appIcon 上显示版本号
(1)如何在 shell 中获取版本号呢?通过 PlistBuddy,它是对 plist 文件进行读取的工具,所在路径是 / usr/libexec。
CFBundleVersion:build 号
CFBundleShortVersionString:版本号,如 2.1.1
buildNumber={PROJECT_DIR}/${INFOPLIST_FILE}")
echo $buildNumber
versionNumber={PROJECT_DIR}/${INFOPLIST_FILE}")
echo $versionNumber
可以看到 shell 中打印的是一致的。
build 号
将 "hello world" 替换成 "$buildNumber",app 上的文件变成了 1。
convert buildNumber" -| composite resizedBetaRibbon.png - ${TARGET_PATH}
buildNumber
versionNumber
添加版本号,同样的替换成 $versionNumber 就可以了。
(2)在脚本中修改版本号
/usr/libexec/PlistBuddy -c "Set :CFBundleShortVersionString"2.3"""{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 {TARGET_PATH}
fi
if ["${CONFIGURATION}" == "Beta" ]; then
convert betaRibbon.png -resize 120x120 resizedBetaRibbon.png
convert {TARGET_PATH}
fi
7、改进下
在前面我们都是写死的 120120,当使用 @3x 时,图片尺寸应该是 180180。这里用 identify 来动态得出图片本身的大小。
WIDTH={BASE_IMAGE_PATH})
identify 是 ImageMagick 提供的。获取图片信息
然后 convert -resize WIDTH。
同样,也可以动态设置 pointsize,根据不同分辨率,以下以 WIDTH 为基准。
FONT_SIZE=WIDTH* .15" | bc -l)
然后将以上代码封成函数,只需传入图片名称,即可。
function generateIcon(){
#1 表示第一个参数
BASE_IMAGE_NAME = $1
BASE_IMAGE_PATH={SRCROOT} -name ${BASE_IMAGE_NAME})
...
}
调用:
generateIcon "AppIcon60x60@2x.png"
generateIcon "AppIcon60x60@3x.png"
可同时修改 @2x,@3x 的 AppIcon。
demo 地址:demo