iOS APP图标版本化

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集/大结局/合集 


相关栏目: 【 项目实操51932 】 【 工作流4

© 免责声明

相关文章