iOS 在系统设置中展示Git Commit, App版本等信息

Xcode编译时支持运行脚本,众所周知的CocoaPods就是这种方式比对工程中依赖库和本地库的SHA1值提示你运行pod install的。

本篇文章目的

在设备设置中,App权限下面展示自定义内容,如类似下图圈住区域内容

iOS 在系统设置中展示Git Commit, App版本等信息_第1张图片
效果图

步骤

1.在项目中添加Settings.bundle文件

iOS 在系统设置中展示Git Commit, App版本等信息_第2张图片
Settings.bundle

2.修改Settings.bundle的Root.plist列表
以设置App版本号,Git的分支以及Git的commit为例。

iOS 在系统设置中展示Git Commit, App版本等信息_第3张图片
Screen Shot 2017-03-12 at 02.20.08.png

3.编辑脚本,设置Settings.bundle的值

  1. App版本:从项目Info.Plist中CFBundleShortVersionString键值获取;
  2. git分支:git rev-parse --abbrev-ref HEAD指令可以获取;
  3. 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

  1. 如果没有Run Script就在该区域左上角+来增加;
  2. 将步骤3的脚本复制粘贴即可。
  3. 安装App后在设置中找到App,迎接你的成果。

注意事项

  1. Apple坑,Settings.bundle里显示Preference Items键值,但实际中是以PreferenceSpecifiers键值,类似DefaultValue没有空格;
    获取键值方法:在Root.plist中右键,勾选"Show Raw Keys/Values"一项,即可看到实际的键值名称.
  1. 脚本的路径或者键值有空格时不能简单“a b”,而是a\ b;
  2. Settings.bundlePreference Items的第一个TypeGroup,这样有层次;
  3. Preference Items可以嵌套,也可以设置UISwitch,UITextFiled等;
  4. 安装前如果有打开系统设置中,那么可能安装后看不到更新,杀掉设置重新进来即可,莫慌~
  5. 如果使用了commit做为记录内容,那么在git中没有办法git ignore来隐藏变化,因为每个人编译时都会生成commit值,解决方法时用PlistBuddy脚本动态生成Root.plist文件。

你可能感兴趣的:(iOS 在系统设置中展示Git Commit, App版本等信息)