什么是sonic-ios-bridge
sonic-ios-bridge(以下简称sib),用于pc与ios通信的工具,当前版本包含以下基础功能
1、跨平台启动wda
2、app列表、安装、卸载、启动
3、设备上下线监听
4、设备详细信息
5、自动挂载开发者镜像
Github地址
只要你的ios有wda包,可以使用sib唤起之后,用appium等框架直接连接对应url,就能实现跨平台(Linux、Win、Mac)自动化,可以不依赖mac和xcode(当然打wda到ios的时候需要xcode,后续跑自动化就不需要了)
Sonic为什么考虑替换tidevice
tidevice是一个非常优秀的工具,但是这边如果单因为tidevice让用户部署python环境无疑是巨大的浪费,以往不少用户部署Agent的时候都是在python环境踩了坑。而go语言打包的可执行二进制文件可以不需要部署额外的环境运行,并且go语言天生的性能与速度都是非常优的。
引用网上一篇文章的话
Go 语言的特点表明它具备轻量级线程实现(Goroutine)、智能标准库、强大的内置安全性,且可使用最简语法进行编程。
所以,如果你自己是Sonic平台层面的用户,那么这个新技术带来的效果也许是不痛不痒,最明显收益是部署时不需要py环境。
如果你是python语言为主做iOS自动化,那么还是推荐继续使用tidevice
如果你是java或其他语言为主做iOS自动化,那么可以考虑使用sib,不要搭建py环境啦~
尝试自己造轮子
当时查找了大量usbmuxd、lockdown的文章,也有参考了tidevice的代码。用自己的方式实现了跨平台与usbmuxd的通信与iOS的lockdown通信,做出了
- 获取设备详情
- 监听设备上下线
- 设备端口转发,类似iproxy
进展还是挺顺利,接下来搞启动wda
发现宝藏
后面着手进行启动wda这最难的功能的时候,testmanager等等一系列恶心人的逻辑让我痛不欲生,启动wda几乎围绕了整个iOS协议走了一圈,偶尔逛github的时候发现原来有小伙伴用go实现过ios通信了,叫gidevice,也有伴生了cli版。但是因为没有自动挂载开发者镜像的功能,还不能直接接到sonic里面,加上某些数据基础还是要结合sonic业务来展开。
于是放弃之前自己做的轮子,直接基于gidevice的基础上,来做一层sonic的cli与辅助扩展
扩展功能如下几点:
1. 获取设备型号的中文名称,如iPhone14,5 -> iPhone 13
整理的映射表
主要从apple的wiki爬取下来的
2. 自定义输出json数据格式与格式化格式
这个主要用来结合sonic业务做的
3. 自动挂载开发者镜像
这里参考了tidevice的做法,在仓库下载对应版本号的开发者镜像并进行挂载操作
func downloadZip(url, version string) error {
if versionMap[version] != "" {
version = versionMap[version]
}
_, errT := os.Stat(fmt.Sprintf(".sib/%s.zip", version))
if errT != nil {
_, err := os.Stat(".sib")
if err != nil {
os.MkdirAll(".sib", os.ModePerm)
}
client := http.Client{
Timeout: DownLoadTimeOut,
}
res, err := client.Get(fmt.Sprintf("%s/iOSDeviceSupport/raw/master/DeviceSupport/%s.zip", url, version))
if err != nil {
return err
}
defer res.Body.Close()
r := bufio.NewReaderSize(res.Body, 32*1024)
newFile, err := os.Create(fmt.Sprintf(".sib/%s.zip", version))
w := bufio.NewWriter(newFile)
io.Copy(w, r)
abs, _ := filepath.Abs(newFile.Name())
errZip := unzip(abs, ".sib", version)
if errZip != nil {
os.Remove(newFile.Name())
return errZip
}
}
return nil
}
4. 设备离线后填充对应序列号到对应字段
离线后只能拿到deviceID,这个id是连接时候通过自增定义的,并不是设备的序列号,需要自己做处理
5. 监听时展示设备详细信息
这个属于扩展功能,搭配sonic业务使用
6. 获取app信息,包括中文名与长版本号
本来gidevice提供的applist只有app的英文名称和短版本号,需要用gidevice另一个InstallationProxyBrowse的方法做,并且筛选用户的应用
if device.Properties().SerialNumber != "" {
result, errList := device.InstallationProxyBrowse(giDevice.WithApplicationType(giDevice.ApplicationTypeUser))
if errList != nil {
return util.NewErrorPrint(util.ErrSendCommand, "appList", errList)
}
var appList entity.AppList
for _, app := range result {
a := entity.Application{}
mapstructure.Decode(app, &a)
appList.ApplicationList = append(appList.ApplicationList, a)
}
data := util.ResultData(appList)
fmt.Println(util.Format(data, isFormat, isJson))
} else {
fmt.Println("device no found")
os.Exit(0)
}
如何使用
- Sonic平台用户可以不用关心,使用起来跟以往无异,Agent层会自动调用sib,并解决了以往版本我还没修复的很多bug,理论上更稳定。
- 非直接使用平台的用户可以前往这里下载对应版本文件
sib run wda -b 你的wda包名
执行之后可以浏览器打开localhost:9100,有手机画面代表成功
包名如果没有.xctrunner会自动补全.xctrunner,默认使用第一台手机,如果想指定手机,可以
sib run wda -u 序列号 -b 你的wda包名
如果想更改端口号,可以
sib run wda -h 来查看对应参数
获取序列号可以通过
sib devices
更多用法可以通过sib -h
或者github的文档查看哦~
结语
这里还是非常感谢gidevice作者雷系泡泡,给我省去了不少造轮子的时间。
sib也将在v1.3.2-beta开始接入sonic,希望大家多多期待