一、背景
在我们平时开发过程中,需要频繁的给测试人员打包测试,一般的流程都是:
Xcode打包 --> 导出ipa文件 --> 上传蒲公英/fir.im --> 通知测试人员
一套流程下来得15分钟左右,而且需要频繁操作,相当麻烦。所以趁最近比较闲,就想着写个脚本,只需要运行脚本就能完成上述所有流程。
当然了,也有非常成熟的自动化构建方案:Jenkins + fastlane,网上资料很多,本篇文章不做介绍。
二、需求分析
其实前面三步都很简单,特别是第一二步,都是Xcode自带的命令。上传也只需要去对应的官网看看文档也能找到相应的方法,比较复杂的是最后一步,如何通过脚本通知测试人员。最简单的方法就是通过钉钉web hook机器人,但是我们一般办公时都是使用QQ或微信,如果能直接通过脚本给QQ或微信发消息就好了。在之前web版QQ还未停用时,网上也有很多方案能实现需求,现在都不能用了。此问题也困扰了我好几天,直到有一天看到
Mac微信助手,就在想他是怎么实现自动回复消息的呢?这是一个开源框架,相信有一定基础的iOS开发者应该都能看懂,本篇文章也主要是分享并记录自己学习的过程并作抛砖引玉的作用。
三、实现
1.Xcode打包并导出ipa
# 清除缓存
xcodebuild clean -workspace TongueCheck.xcworkspace -scheme $schemeName -configuration $configType
# 打包
xcodebuild archive -workspace TongueCheck.xcworkspace -scheme $schemeName -configuration $configType -archivePath $archivePath
echo "🚀 正在导出ipa"
xcodebuild -exportArchive -archivePath $archivePath -exportPath $exportPath -exportOptionsPlist $optionsPath
其中
- schemeName 是工程的名字
- configType 是Debug或者Release,当然还可以是自定义环境
- archivePath 是编译文件生成的路径
- exportPath 是导出ipa的路径
- optionsPath 是配置文件plist的路径,可以手动用Xcode打包并导出一次,会自动生成ExportOptions.plist文件
2. 上传fir.im
需安装工具 https://github.com/FIRHQ/fir-cli/blob/master/doc/install.md
fir login $apiToken
#发布应用到fim
echo "🚀 正在上传fir.im"
addr=`fir publish "$exportPath/xxx.ipa" -c "$changeLog" --skip-update-icon | sed -n -E 's;^.*s*Published succeed: ([^ ]+)\s*.*$;\1;p'`
if [ -z "$addr" ] ; then
echo "💣 fir publish之后获取不到链接。重试。。"
exit 0
fi
echo "✅ 安装包地址:$addr"
其中
- apiToken 登录fir.im网页版就能查询到
- changeLog 是更新日志
3. 通知QQ或微信
QQ和微信都有相应的开源库 下面我只介绍微信的,QQ的原理其实是一样的。
我们把工程下载下来,会发现Run Script里面有一段脚本
#!/bin/bash
app_name="WeChat"
framework_name="WeChatExtension"
app_bundle_path="/Applications/${app_name}.app/Contents/MacOS"
app_executable_path="${app_bundle_path}/${app_name}"
app_executable_backup_path="${app_executable_path}_backup"
framework_path="${app_bundle_path}/${framework_name}.framework"
# 备份WeChat原始可执行文件
if [ ! -f "$app_executable_backup_path" ]
then
cp "$app_executable_path" "$app_executable_backup_path"
fi
cp -r "${BUILT_PRODUCTS_DIR}/${framework_name}.framework" ${app_bundle_path}
./"Rely"/insert_dylib --all-yes "${framework_path}/${framework_name}" "$app_executable_backup_path" "$app_executable_path"
阅读之后会发现,原理其实就是把工程编译之后生成的framework,通过insert_dylib注入到Mac程序中,并替换掉原来的程序,同时也将原来的进行了备份,方便卸载。
我们在main.mm中可以看到下面这一段代码
static void __attribute__((constructor)) initialize(void) {
NSLog(@"++++++++ WeChatExtension loaded ++++++++");
if (@available(macOS 10.14, *)) {
[NSObject hookTheme];
}
[NSObject hookWeChat];
[NSObject hookMMChatsTableCellView];
[NSObject hookMMStickerMessageCellView];
}
看到这里,相信大家都能知道插件的原理了吧,就是对原函数进行hook。至于如何知道原库中的类名以及方法名就不在本篇文章中介绍了,网上也有很多逆向相关的文章。
WeChat+hook.m是hook消息发送与接收的文件,现在我们可以调用hook之后的方法进行消息发送了,那么如何用脚本调用方法呢?其实作者已经提供了相应的方法,但是我在看文档时并未看到相关介绍,原因未知。其实方法也很简单,就是监听本地端口,在收到请求后解析参数,调用方法即可。具体代码在YMWebServerManager.m 文件中。
当然了,我们也可以自己实现一些需要,进行二次开发。
self.webServer addHandlerForMethod:@"POST" path:@"/wechat-plugin/send-message"
可以看到原插件中已经存在我们需要的功能了,端口是52700,我们的脚本发送消息就很简单了
curl http://localhost:52700/wechat-plugin/send-message -X POST -d 'userId=xxx&content=测试注意啦!《XXX》iOS端有如下更新:
'$changeLog'
下载地址:'$addr''
其中
- userId 对方微信id 并不是微信号,获取方式我还不太清楚,我是通过断点来看的... 相对而言QQ的userId对应的就是QQ号或者群号,多了一个type参数,具体可以看开源框架
- content 是发送的消息,目前只支持文本,不过已经能满足我们的需求了
总结
至此我们的需求也就可以实现了,我们只需要运行脚本耐心等待,就能实现之前的一系列操作了。当然了如果涉及到多人开发,在打包之前还应加上拉取代码等操作,相信也很简单。
如果有问题可以留言或者加我QQ进行交流。
免责声明
- 使用插件有风险,使用需谨慎。
- 本文只作学习与交流作用,不可用于商业和个人其他意图。若使用不当,请使用者自行承担。
- 如果您发现本文有侵犯您的知识产权,请与我取得联系,我会及时修改或删除。huqigu@163.com