(三) git pre-push hook 实践一二

本文介绍如何在iOS开发中利用xcodebuild命令执行单元测试,并通过Git pre-push hook自动运行这些测试,确保代码质量。此外,还提供了一种方法,使团队成员能够在推送代码前统一执行测试。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

  在 (一) 初探 iOS 单元测试 一文中,我们简单提到了执行xcodebuild test可以启动工程的单元测试并输出测试结果,但手动执行此类命令意义是不大的。我们需要的是,把一些测试和lint等命令写在脚本文件里,在代码提交、合并及打包等行为实际发生前,自动执行脚本,以执行的结果决定是否打断上述操作,一定程度上达到控制代码质量的目的。   在多人协作开发中,我们可以在所有成员进行某些git操作(commit push merge rebase等)前进行代码的验证(Test、Lint等),防止逻辑错误或不合规范的代码更新到远端仓库中。当然,如果团队搭建了自己的git服务器,有Mac服务器,在server端进行git hooks是最好的解决方案,本地仓库也不用进行额外配置。此外,我们也可以做一些Client Hooks,来达到同样的效果。以下内容是笔者对git pre-push hook的一些实践。

手动添加pre-push文件

前往本地仓库,按下command+shift+.查看隐藏文件,目录如下。我们可以看到.git/hooks路径下有一些.sample的文件。

删除pre-push.sample文件的后缀名,用编辑器打开,写入:

exit 1
复制代码

保存退出,仓库根目录下,执行:

git push
复制代码

可以看到push失败。下面我们在pre-push写入单元测试的命令,如果测试通过,pre-push程序正常退出,push成功;测试失败,出错并退出,push失败。写入:

workspace_name() {
  workspace_file=`find . -maxdepth 2 -name *.xcworkspace -exec basename {} \;`
  echo ${workspace_file%.xcworkspace}
}

check_result() {
if [ $? != 0 ]; then
echo "$1 failed!!"
echo "push will not execute"
echo "$?"
exit 1
else
echo "$1 passed."
echo "push will execute"
echo "$?"
fi
}

workspace=$(workspace_name)

xcodebuild -workspace Example/$workspace.xcworkspace -scheme $workspace-Example -destination 'platform=iOS Simulator,OS=11.0,name=iPhone 7' test
check_result "test"
复制代码

例子是以pod lib create ...创建的标准工作空间,从仓库根目录起以最大深度为2寻找以.xcworkspace结尾的文件名,赋给workspace变量,最后test名为worksapce.xcworkspace scheme为worksapce-Example的工程,测试失败,打印"push will not execute"exit 1;反之打印push will executeexit 0。 仓库根目录下执行:

git push
复制代码

最后输出:

现在我们已经实现了一些我们想要的效果,但如何让团队里的每个开发成员都收到pre-push hook的规范呢?

自动添加pre-push文件

我们知道,.git文件夹并不会被push到远程仓库,每个成员clone仓库,.git文件夹是会初始化的。也就是说,正常情况下,pre-push hook只对个人有效。但我们可以耍一些小手段,让每个成员仓库.git/hooks路径下都存在我们写好的pre-push文件,这样其他成员的仓库也具备了git pre-push hook功能。

if [ ! -d "$../.git/hooks/pre-push" ]; then
cp ../pre-push ../.git/hooks/pre-push
exit 0
fi
复制代码

首先,我们写好一个脚本,功能为如果.git/hooks路径下没有pre-push文件,就复制一个进去。如图中add-pre-push-hook.sh文件:

那这个脚本在什么时候被执行呢?答案是放在我们Target的Run Script下:
  注意Run Script 和 add-pre-push-hook.sh 是在.xcodeproj的路径下开始执行的。这样,每当build,就会执行add-pre-push-hook.sh检查.git/hooks文件夹下是否存在pre-push文件并尝试复制进去。下次当开发成员尝试push代码时,便无形中受到了hook!!!这一切对很多工程的基础库的维护做代码检查还是有一定实用价值的。

谢谢观看!欢迎指出文中错误!

参考文档

git-scm.com/book/en/v2/… blog.ittybittyapps.com/blog/2013/0… blog.ricardofilipe.com/post/git-ho…

推送代码到 Git 时遇到 `pre-receive hook declined` 错误通常表示远程仓库的预接收钩子(pre-receive hook)拒绝了提交。这种错误可能由多种原因引起,包括权限问题、提交内容不符合规范、分支保护设置或钩子脚本本身的限制。 ### 分析和解决方法 #### 1. 检查分支保护规则 GitLab 等平台支持分支保护功能,例如禁止强制推送(force push)或限制特定用户对某些分支的操作[^3]。如果尝试推送的分支被设置为受保护分支,则普通用户无法直接推送更改。 ```bash git config http.extraHeader "PRIVATE-TOKEN: <your_access_token>" ``` 确保你拥有推送目标分支的权限,并确认是否启用了强制推送选项。如果使用的是 `master` 或 `main` 分支,检查是否设置了只允许合并请求(Merge Request)方式提交代码[^2]。 #### 2. 查看远程仓库钩子日志 由于该错误来源于远程钩子,建议联系仓库管理员查看具体的 `pre-receive` 钩子脚本输出信息。例如,在 GitLab 中可以通过后台日志或 CI/CD 输出获取更详细的拒绝原因。常见的钩子验证逻辑包括: - 提交信息格式校验 - 文件类型或大小限制 - 提交者身份认证 - 代码签名要求 #### 3. 避免使用 `-f` 强制推送 如果推送命令中包含 `-f` 或 `--force` 参数,而远程仓库不允许强制覆盖历史记录,则会触发此错误[^3]。除非明确需要重写历史,否则应避免使用强制推送。可以先拉取最新代码并进行合并后再推送: ```bash git pull --rebase origin <branch-name> git push origin <branch-name> ``` #### 4. 使用 HTTPS 推送时的身份验证 在 Visual Studio 2022 中通过 HTTPS 协议推送时,可能会因凭据缓存失效导致认证失败,进而引发钩子拒绝的情况。尝试清除凭据管理器中的 Git 凭据并重新输入正确的用户名和 Token: - 打开 **控制面板 > 用户账户 > 凭据管理器** - 删除与 Git 相关的 Windows 凭据条目 - 重新启动 Visual Studio 并再次尝试推送操作 #### 5. 检查提交内容是否违反策略 部分组织会在 `pre-receive` 钩子中加入自定义策略,例如禁止大文件、敏感信息或特定文件扩展名上传。此时可通过以下命令检查即将推送的对象: ```bash git rev-list --objects HEAD ^origin/master ``` 确认是否存在不合规的大文件或二进制资源。如有必要,可使用 `git filter-branch` 或 `BFG Repo-Cleaner` 工具清理历史记录后再推送。 #### 6. 联系仓库管理员获取帮助 由于 `pre-receive` 钩子的具体实现不在本地控制范围内,最直接的方式是联系项目维护者或系统管理员,获取完整的钩子执行日志和相关配置说明,以便快速定位问题根源。 ---
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值