Xcode编译时支持运行脚本,众所周知的
CocoaPods
就是这种方式比对工程中依赖库和本地库的SHA1值提示你运行pod install
的。
本篇文章目的
在设备设置中,App权限下面展示自定义内容,如类似下图圈住区域内容
步骤
1.在项目中添加Settings.bundle文件
2.修改Settings.bundle的Root.plist列表
以设置App版本号,Git的分支以及Git的commit为例。
3.编辑脚本,设置Settings.bundle的值
- App版本:从项目Info.Plist中
CFBundleShortVersionString
键值获取; - git分支:
git rev-parse --abbrev-ref HEAD
指令可以获取; - git commit:
git rev-parse --short HEAD
指令获取;
#获取Bundle Version
version=$(/usr/libexec/PlistBuddy -c "Print CFBundleShortVersionString" "${PROJECT_DIR}/${INFOPLIST_FILE}")
/usr/libexec/PlistBuddy -c "Set :PreferenceSpecifiers:1:DefaultValue ${version}" "${PROJECT_DIR}/${PROJECT_NAME}/Settings.bundle/Root.plist"
#获取Git当前分支
branch=`git rev-parse --abbrev-ref HEAD | awk '{print $1}'`
/usr/libexec/PlistBuddy -c "Set :PreferenceSpecifiers:2:DefaultValue ${branch}" "${PROJECT_DIR}/${PROJECT_NAME}/Settings.bundle/Root.plist"
#获取Git当前Commit SHA1值
commit=`git rev-parse --short HEAD | awk '{print $1}'`
/usr/libexec/PlistBuddy -c "Set :PreferenceSpecifiers:3:DefaultValue ${commit}" "${PROJECT_DIR}/${PROJECT_NAME}/Settings.bundle/Root.plist"
4.项目中配置脚本
路径:Target -> 项目名字 -> Build Phases
- 如果没有
Run Script
就在该区域左上角+
来增加; - 将步骤3的脚本复制粘贴即可。
- 安装App后在设置中找到App,迎接你的成果。
注意事项
- Apple坑,
Settings.bundle
里显示Preference Items
键值,但实际中是以PreferenceSpecifiers
键值,类似DefaultValue
没有空格;
获取键值方法:在Root.plist中右键,勾选"Show Raw Keys/Values"一项,即可看到实际的键值名称.
- 脚本的路径或者键值有空格时不能简单
“a b”
,而是a\ b
; -
Settings.bundle
的Preference Items
的第一个Type
为Group
,这样有层次; -
Preference Items
可以嵌套,也可以设置UISwitch,UITextFiled
等; - 安装前如果有打开系统设置中,那么可能安装后看不到更新,杀掉设置重新进来即可,莫慌~
- 如果使用了
commit
做为记录内容,那么在git
中没有办法git ignore来隐藏变化,因为每个人编译时都会生成commit值,解决方法时用PlistBuddy
脚本动态生成Root.plist
文件。