跨平台进行 iOS 自动化新选择

什么是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通信,做出了

  1. 获取设备详情
  2. 监听设备上下线
  3. 设备端口转发,类似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)
            }

如何使用

  1. Sonic平台用户可以不用关心,使用起来跟以往无异,Agent层会自动调用sib,并解决了以往版本我还没修复的很多bug,理论上更稳定。
  2. 非直接使用平台的用户可以前往这里下载对应版本文件
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,希望大家多多期待

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 215,723评论 6 498
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,003评论 3 391
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 161,512评论 0 351
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,825评论 1 290
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,874评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,841评论 1 295
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,812评论 3 416
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,582评论 0 271
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,033评论 1 308
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,309评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,450评论 1 345
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,158评论 5 341
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,789评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,409评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,609评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,440评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,357评论 2 352

推荐阅读更多精彩内容