iOS APP图标版本化

作者 | huqigu
来源 | 简书,点击阅读原文查看作者更多文章
一、需求背景
在我们的项目开发过程中,需要频繁打包给测试人员去测试,有时候我们都不知道测试机上安装的版本是否是最新的,这样会造成很多不必要的麻烦和成本。因此我们需要将buildNumber以水印的方式打在APPIcon上,可以很直观的知道当前是哪一个版本。
二、需求分析
1、如何动态更新图标
Xcode在build过程中可以执行Script脚本,我们可以利用Script在程序运行之前做很多我们想做的事情。
2、如何打水印
ImageMagick 免费的图片处理插件,同时支持多种语言。
github https://github.com/ImageMagick/ImageMagick
官网 http://www.imagemagick.org/
三、实现
1、ImageMagick安装
有两种安装方式,具体可以看这里 ,推荐大家使用第一种,因为我在测试第二种安装的时候碰到了很多坑,需要自己安装依赖,不然很多方法使用不了。
安装
brew install imagemagick
检查是否安装成功
identify -version
2、Xcode项目配置
2.1 AppIcon配置
这里我使用的是唔哩头条的icon,并新建一个AppIcon-Debug 用于存放Debug的图标,后面我们打水印生成的图标会存放到这里。

设置Debug模式下图标为刚才新建的图标组

2.2 脚本配置
我们在项目路径下新建一个脚本文件并执行
$ touch JCIconVersion.sh
$ vim JCIconVersion.sh
$ ./JCIconVersion.sh
-bash: ./JCIconVersion.sh: Permission denied
需要赋予可执行权限
$ chmod +x JCIconVersion.sh
再次执行
$ ./JCIconVersion.sh
hellow world
脚本创建完了并赋予了可执行权限,我们现在将他配置到Xcode中。
先将他添加到项目中,然后在Build Phases中添加Run Script。
注意填写正确的脚本路径

然后我们build一下项目


在这里能看到我们每次Build状态,以及脚本运行情况。
下面就进入脚本代码的编写。
3、Shell脚本编写
3.1 检查是否安装了ImageMagick
#######################################################
# 1、检查是否安装了ImageMagick
#######################################################
echo ": Checking installed ImageMagick"
convertPath=`which convert`
if [[ ! -f ${convertPath} || -z ${convertPath} ]]; then
convertValidation=true;
else
convertValidation=false;
fi
# 未安装 提示并退出
if [ "$convertValidation" == true ]; then
echo ": you need to install ImageMagick first, you can use brew to simplify process:\n brew install imagemagick"
exit 0;
else
echo "✅: Begin convert"
fi
由于我们打水印使用的是convert命令,所以检查convert是否安装就行。
3.2 获取需要的字段
######################################################
# 2. 全局字段
######################################################
# Assets中的appIcon文件名
APPICON_NAME="AppIcon"
# Assets中Debug环境的appIcon文件名
DEBUG_APPICON_NAME="${APPICON_NAME}-Debug"
# 获取app版本号
APP_VERSION=$(/usr/libexec/PlistBuddy -c 'Print CFBundleShortVersionString' "${INFOPLIST_FILE}")
# 获取build号
APP_BUILD_NUM=$(/usr/libexec/PlistBuddy -c 'Print CFBundleVersion' "${INFOPLIST_FILE}")
# Icon上显示的文字内容, 你可以在这里修改标题格式
CAPTION="$APP_VERSION\n($APP_BUILD_NUM)"
3.3 复制AppIcon到AppIcon-Debug
######################################################
# 3. 复制AppIcon到AppIcon-Debug
######################################################
echo " Begin copy icon files"
# appicon路径
APPICON_SET_PATH=`find $SRCROOT -name "${APPICON_NAME}.appiconset"`
echo " APPICON_SET_PATH=$APPICON_SET_PATH"
if [ "$APPICON_SET_PATH" = "" ]; then
exitWithMessage " Get APPICON_SET_PATH failed." 0
fi
# appicon_debug路径
ASSET_PATH=`echo $(dirname ${APPICON_SET_PATH})`
DEBUG_APPICON_SET_PATH="${ASSET_PATH}/${DEBUG_APPICON_NAME}.appiconset"
echo " DEBUG_APPICON_SET_PATH=$DEBUG_APPICON_SET_PATH"
if [ "$DEBUG_APPICON_SET_PATH" = "" ]; then
exitWithMessage " Get DEBUG_APPICON_SET_PATH failed." 0
fi
# 删除appicon_debug里的文件
rm -rf $DEBUG_APPICON_SET_PATH
if [ $? != 0 ];then
exitWithMessage " Remove ${DEBUG_APPICON_SET_PATH} failed." 0
fi
# 复制appicon到appicon_debug
cp -rf $APPICON_SET_PATH $DEBUG_APPICON_SET_PATH
if [ $? != 0 ];then
exitWithMessage " Copy ${APPICON_NAME} to ${DEBUG_APPICON_NAME} failed." 0
fi
echo "✅ Finish copy icon files."
3.4 添加水印
# # 处理icon
# # Processing icon
function processIcon() {
BASE_IMAGE_PATH=$1
echo "BASE_IMAGE_PATH=$BASE_IMAGE_PATH"
BASE_FLODER_PATH=`dirname $BASE_IMAGE_PATH`
cd "$BASE_FLODER_PATH"
# 获取图片宽度
WIDTH=$(identify -format %w ${BASE_IMAGE_PATH})
echo "width $WIDTH"
FONT_SIZE=$(echo "$WIDTH * .15" | bc -l)
echo "font size $FONT_SIZE"
convert ${BASE_IMAGE_PATH} -font Arial -pointsize ${FONT_SIZE} \
-draw "gravity south \
fill white text 0,12 '$APP_VERSION($APP_BUILD_NUM)'" \
${BASE_IMAGE_PATH}
}
3.5 处理AppIcon-Debug
#######################################################
# 4. 处理AppIcon-Debug
#######################################################
find "$DEBUG_APPICON_SET_PATH" -type f -name "*.png" -print0 |
while IFS= read -r -d '' file; do
echo " ${file}"
processIcon "${file}"
done
echo "✅ Finish all process"
总结

效果如上图,水印效果还不太完善,imagemagick里面还有很多强大的api,能实现更加炫酷的效果,感兴趣的同学可以看看 这里 https://imagemagick.org/Usage/annotating/#wmark_text,有时间我也会完善一下。
最后附上Demo下载地址:Demo下载 https://github.com/huqigu/AppIconVersion/tree/master
☞ 苹果发布新的 Swift Server 框架:Swift Cluster Membership,这次的目标是集群
☞ Sketch vs. Figma:为什么 Figma 会赢?我们又能从中学到什么?
☞ 苹果正式更新应用审核流程,以后可以对审核指南提建议了
☞ Arm64e 符号翻译与 PAC 问题
☞ DartNative 内存自动管理
就差您点一下了
相关文章:
2026年住院医师规培结业考试题库(App端)
揭秘软件咨询界的“黄埔军校”
苹果手机真不能少了这种实用的iOS软件
超1000W下载,浏览外网必备的神仙插件
鸿子铭:360浏览器插件的安装方法
古装微短剧必看榜单!4部不得不看的穿越、穿书、重生保命指南,不但保命还很甜!不看血亏!
2017 精选音乐 iOS App
WPS软件VBA宏插件,安装即可使用,有需自取
资讯丨APP卸载一年多仍扣费2500余元!官方:可以退300多
AE PR插件合集
推荐VScode十大实用插件
1月9日热门短剧上线推荐!
ps批量替换装饰画、ps卧龙修图插件批量替换图片
残友软件:管理咨询+贴身服务+配套软件-赋能PCB企业建立稳健运营管理体系
特斯拉开始遵守开源软件许可条款 发布部分软件源代码
短剧《爱在等风不等你》1-74集完整版(大结局/后续/全集)
DeepTech发布全新硬科技商业资讯APP,跟上!
超好看!热门短剧丨大结局《重生:拒绝当*狗,女神校花急了》全集在线看
iOS|成人|专用app,已上架!低调用!!!
四部高质量短剧,质感、剧情、人设、演技全在线,二刷三刷都过瘾!
手机*新选择这款App全网最强没有之一
熬夜必追短剧《妈妈,我不要再爱你了》完整版1-62集/大结局/合集
AppCan新增的9个超实用插件 (内含示例代码)
资讯丨朱海舟正式加入一加,担任软件产品经理
软件·插件·神器,全部免费下载!
短剧《妈咪别逃了!你和傅总是一对》完整版
AI杀疯了?Blender免费AI渲染器插件来了,可把简单模型变成各种风格图像!
超好看!热门短剧丨大结局《离婚当天,戏精青梅缠上我》全集在线看
CDR各种开挂插件一键安装��
别再被“源码”忽悠了!软件开发的坑,你踩过吗?
短剧完整版《问灵》1-93集(后续 /合集/大结局)
10月28日高质量短剧推荐!
【含文档+PPT+源码】基于spring boot的固定资产管理系统
【WordPress开源免费插件1】自定义软件PPT模板资源下载插件
最大密码管理软件LastPass遭攻击,源代码和专有技术数据失窃
资料汇总|FPGA软件安装包、书籍、源码、技术文档…(2025.05.15更新)
iOS 11.3上的这个细节 让你更新APP更方便
软件资讯 拯救赖床者 这款软件就是这么神奇
设计师修图必备21款插件合集(支持Win+Mac)
精选软件 | 第五期 / 电脑上超实用的聚合搜索/插件.
【12.28周日21:00】获得免费插件之后 | 浅灰 鸭腩儿 奥莉
智桂通app咋下载安装?超详细教程来啦,手把手教你轻松上手!
精彩短剧《千金谋》1-98集(合集/完整版)
赶紧自查!这些App被通报
超好看!热门短剧丨大结局《心声喧嚣真爱静谧》全集在线看
很好的热门短剧《欲吻桑枝》1-74(完整版/后续/大结局)没删减版
爱不释手,短 中 长三线控盘副图指标源码!
CAD免费插件—贱人工具
三部精品短剧齐开机
热门短剧《城南的花开了,你还走吗》完整版1-82集/大结局/合集