基于tidevice实现iOS app主动化使用详解

目次
1、IOS主动化工具概述
2、tidevice工具的原理和使用
2.1、tidevice的原理
2.2、tidevice实现的功能
2.3、tidevice的安装
2.4、tidevice的使用
2.4.1、设备管理
1、检察已连接的设备的列表
2、检测设备连接状态
3、等候设备连接，只要有就连接就结束监听
4、等候指定设备连接
5、实时获取设备操作日志
6、获取设备信息
7、检察设备电源信息
8、系统信息
9、关机
10、重启设备
11、截屏生存在当前目次
12、截屏生存在指定目次
13、设备文件管理
14、应用文件管理
2.4.2、应用管理
1、安装应用
2、卸载应用
3、启动应用
4、关闭应用
5、检察已安装应用列表
2.4.4、fps 数据采集

背景：没有Mac OS设备，需要使用Windows完成iOS app主动化测试，这个过程是如何完成的呢，又是借助什么工具呢。
使用WDA框架完成iOS主动化测试见文章：使用wda框架实现IOS主动化测试详解-CSDN博客
1、IOS主动化工具概述

• 首先需要知道在iOS设备上是谁在执行发送已往的指令，它就是XCUITest，下面介绍它的由来和作用：
  
  
  
  • XCTest和XCUITest是 iOS 开发中常用的两个测试框架，它们之间存在一定的区别和接洽。
    
  • XCTest：是苹果官方提供的测试框架，可以在 Objective-C 和 Swift 语言中使用。它提供了许多功能强大的测试工具，包罗单位测试、性能测试、UI 测试等。使用 XCTest 可以帮助开发者快速编写和运行各种类型的测试用例，并得到具体的测试报告。
    
  • XCUITest：是 XCTest 框架的扩展，是苹果官方提供的用于 iOS 应用步伐 UI 测试的框架。它支持 Objective-C 和 Swift 语言，并提供了一组 API，用于操作 iOS 应用步伐的用户界面元素。使用 XCUITest 可以模拟用户对应用步伐的操作，如点击按钮、输入文本、滑动屏幕等，并验证应用步伐的举动是否符合预期。
    
  
  

• 从上面可知XCUITest只是一个在iOS设备上执行指令的工具，它并不具备通讯能力，以是也就不能和类似appium和wda这些框架进行交互；以是我们还需要一个用于和外部通讯的工具，它就是WebDriverAgent，它的作用如下：
  
  
  
  • WebDriverAgent（简称WDA）是一个开源的工具，由 Facebook 提供，用于在 iOS 设备上进行主动化测试。它是基于 WebDriver 协议的实现，通过与客户端的交互来控制 iOS 设备上的应用步伐。
    
  • WebDriverAgent 的重要功能是提供一个接口，使客户端可以发送各种命令和哀求，操作 iOS 设备上的应用步伐。这些命令和哀求可以包罗点击按钮、输入文本、滑动屏幕、获取元素信息等等。客户端可以使用各种编程语言、测试框架或测试工具与 WebDriverAgent 进行通讯，以实现主动化测试。
    
  • WebDriverAgent 使用 XCTest 框架来运行测试，并且需要通过 Xcode 进行构建和安装到 iOS 设备上。它通过与设备上的 WebDriverAgentRunner 应用步伐进行通讯来执行测试。WebDriverAgentRunner 是一个特别的应用步伐，用于启动和管理 WebDriverAgent，以及与客户端进行通讯。
    
  • WebDriverAgent 功能强大且灵活，可以支持各种类型的主动化测试，如 UI 测试、性能测试、功能测试等。它也提供了丰富的 API，用于与 iOS 应用步伐进行交互和验证应用步伐的举动。
    
  
  
• WebDriverAgent是基于XCTest框架的，以是需要使用xcodebuild来启动WebDriverAgent，可以很容易的运行在Mac电脑上；可是我们现在没有Mac电脑，那么需要如何才气在Windows或是Linux上执行IOS主动化测试呢，于是tidevice就出现了，它是由阿里开源的可以实现在Windows和Linux上也能执行IOS的主动化测试。
  

2、tidevice工具的原理和使用

• 要使用tidevice完成iOS的主动化测试，首先需要确保手机上已经安装有WebDriverAgent，并且知道bundleId，安装WebDriverAgent教程推荐：https://tester-joe.blog.csdn.net/article/details/133134348
  

2.1、tidevice的原理

• tidevice 的底层原理重要基于libimobiledevice库和usbmux通讯协议。libimobiledevice是一个用于与iOS设备进行通讯的开源库，而usbmux通讯协议则实现了Mac/Windows/Linux与iOS设备服务间的通讯。通过模拟xcodebuild与手机进行通讯，tidevice向手机发送特定的指令，启动WDA，从而实现了在Linux和Windows上运行iOS主动化的功能。
  

2.2、tidevice实现的功能

• 获取设备信息
  
• 应用安装、卸载、启动、克制、检察应用信息、已安装应用列表
  
• 设备截图、获取设备日志
  
• 启动 WebDriverAgent （跨平台：Mac、Windows、Linux）
  
• 性能数据采集
  

2.3、tidevice的安装

• Python环境：Python 3.6+
  
• tidevice 安装
  
  
  
  • 方式一：
    
  
  

   pip install -U "tidevice[openssl]" （推荐）
  

• 方式二
  

   pip install -U tidevice （缺少设备配对功能）
  

• 检察是否安装乐成
  

   tidevice -v
  

2.4、tidevice的使用

2.4.1、设备管理

1、检察已连接的设备的列表

• cmd
  

   tidevice list
  

• python
  

1. from tidevice import Usbmux
2. print(Usbmux().device_list())

复制代码

2、检测设备连接状态

说明：该功能是实时获取，已连接设备、断开设备的状态，以是运行该命令/步伐 会挂起阻塞后面的流程，如果不想阻塞后面历程，使用subprocess模块开启子历程完成监测。

• cmd
  

   tidevice watch
  

• python
  
  
  
  • watch_device()函数返回的是一个生成器对象，以是需要使用循环的方式获取数据，获取的数据是字典类型，以是可以根据字段MessageType的值判断设备的连接情况。
    
  
  

1. from tidevice import Usbmux
2. for data in Usbmux().watch_device():
3.     print(data)

复制代码

3、等候设备连接，只要有就连接就结束监听

• cmd
  
  
  
  • 如果已经存在设备连接，检测到后主动结束该命令；如果没有设备连接直到等到有设备连接，再结束该命令
    
  
  

   tidevice wait-for-device
  4、等候指定设备连接

• cmd:
  
  
  
  • 等候指定设备连接，如果指定设备有连接，则结束该命令，否则不停挂起等候指定设备连接
    
  • 留意：tidevice -u $UDID watch 改命令并不具备上面功能，作用还是监测设备的连接情况
    
  
  

   tidevice -u $UDID wait-for-device
  5、实时获取设备操作日志

• cmd
  
  
  
  • 该命令会实时打印设备的操作日志，类似 adb logcat 的作用
    
  
  

   tidevice -u $UDID syslog
  

• Python
  

1. from tidevice import Device
2. device = Device("$UDID")
3. # 开启 com.apple.syslog_relay服务 它的作用是用于记录系统日志
4. socket_proxy = device.start_service("com.apple.syslog_relay")
5. while True:
6.     print(socket_proxy.get_socket().recv(1024).decode('utf-8'))

复制代码

6、获取设备信息

• cmd
  
  
  
  • 获取设备型号、设备名、系统版本、手机号、序列号、时区、蓝牙地址、Wifi地址等
    
  
  

   tidevice info
  

• Python
  

1. from tidevice import Device
2. print(Device("$UDID").device_info())

复制代码

7、检察设备电源信息

• cmd
  

   tidevice info --domain com.apple.mobile.battery --json
  

• Python
  

1. from tidevice import Device
2. import json
3. domain_info = Device("$UDID").device_info("com.apple.mobile.battery")
4. print(json.dumps(domain_info))

复制代码

8、系统信息

• cmd
  

   tidevice sysinfo
  

• Python
  

1. from tidevice import Device
2. Device("$UDID").instruments.system_info()

复制代码

9、关机

• cmd
  

   tidevice shutdown
  

• Python
  

1. from tidevice import Device
2. Device("$UDID").shutdown()

复制代码

10、重启设备

• cmd
  

   tidevice reboot
  

• Python
  

1. from tidevice import Device
2. Device("$UDID").reboot()

复制代码

11、截屏生存在当前目次

• cmd
  

   tidevice screenshot
  

• Python
  

2. from tidevice import Device
3. filename = "screenshot.jpg"
4. Device("$UDID").screenshot().convert("RGB").save(filename)

复制代码

12、截屏生存在指定目次

• cmd
  

   tidevice screenshot /xxx/xxx/screenshot.png
  

• Python
  

1. from tidevice import Device
2. file_path = "/xxx/xxx/screenshot.png"
3. Device("udid").screenshot().convert("PNG").save(file_path)

复制代码

13、设备文件管理

• cmd
  

   tidevice -u $UDID fsync
  
  以下是一些常见的文件同步操作及其对应的命令和参数示例：
列出指定路径下的文件: tidevice fsync ls /path/to/directory
删除文件: tidevice fsync rm /path/to/file
检察文件内容: tidevice fsync cat /path/to/file
将文件从设备上拉取到当地: tidevice fsync pull /path/to/device/file /path/to/local/destination
将文件推送到设备上: tidevice fsync push /path/to/local/file /path/to/device/destination
检察文件或目次的具体信息: tidevice fsync stat /path/to/file_or_directory
列出指定路径下的文件和目次树: tidevice fsync tree /path/to/directory
  

• Python
  

1. from tidevice import Device
2. # 示例：获取目录"/"下的文件信息
3. print(Device("$UDID").sync.listdir_info("/"))

复制代码

14、应用文件管理

• cmd
  

   tidevice -u $UDID fsync -B bundle_id
  
  该命令需要提供两个参数：command 和 arguments。
command：指定要执行的文件同步操作，如 ls、rm、cat 等。
arguments：根据所选的文件同步操作，提供相应的参数。
  
  以下是一些常见的文件同步操作及其对应的命令和参数示例：
列出指定路径下的文件: tidevice fsync -B com.king.Money ls /path/to/directory
删除文件: tidevice fsync -B com.king.Money rm /path/to/file
检察文件内容: tidevice fsync -B com.king.Money cat /path/to/file
将文件从设备上拉取到当地: tidevice fsync -B com.king.Money pull /path/to/device/file /path/to/local/destination
将文件推送到设备上: tidevice fsync -B com.king.Money push /path/to/local/file /path/to/device/destination
检察文件或目次的具体信息: tidevice fsync -B com.king.Money stat /path/to/file_or_directory
列出指定路径下的文件和目次树: tidevice fsync -B com.king.Money tree /path/to/directory
  

• Python
  

1. from tidevice import Device
2. # 示例：获取目录"/"下的文件信息
3. print(Device("$UDID").app_sync(bundle_id).listdir_info("/"))

复制代码

2.4.2、应用管理

1、安装应用

• cmd
  
  
  
  • file_or_url：表示当地的.ipa文件地址路径或.ipa包的下载路径
    
  • 使用url安装的底层原理：先在当地生成一个暂时空的.ipa文件，路径为： C:\Users\Admin\AppData\Local\Temp\tmp42jr_gnw\_tmp.ipa ；然后哀求下载链接，一边下载一边把下载的内容写入到_tmp.ipa文件中，最后使用_tmp.ipa安装。
    
  
  

   tidevice --udid $UDID install file_or_url
  或
  tidevice -u $UDID install file_or_url
  

• Python
  

1. from tidevice import Device
2. device = Device("$UDID")
3. device.app_install(file_or_url)

复制代码

2、卸载应用

• cmd
  
  
  
  • bundle_id：类比于Android的包名
    
  
  

   tidevice --udid $UDID uninstall bundle_id
  

• Python
  

1. from tidevice import Device
2. device = Device("$UDID")
3. device.app_uninstall(bundle_id)

复制代码

3、启动应用

• cmd
  
  
  
  • 留意：该命令执行每次都是冷启动，也就是如果应用是打开的会先把应用kill掉，然后再启动。
    
  
  

   tidevice --udid $UDID launch bundle_id
  

• Python
  1. from tidevice import Device
  2. # 注意此方式是强制的冷启动，如果应用已打开则先kill旧进程，然后再启动
  3. pid = Device("$UDID").app_start(bundle_id)

  复制代码
  
  
• 
  
  
  
  • 如果想实现：
    
  • 已启动且最上层应用，则保持稳固；
    
  • 已启动且退到背景，把应用拉起；
    
  • 如果未启动，冷启动
    
  
  
• 则需要改变源码中app_launch()函数下的KillExisting变量，将其改为False，但是请留意，设置KillExisting为False，调用60次以上，instruments服务将瓦解，原因是：多次启动相同的应用步伐实例并且不终止旧的历程会导致系统资源耗尽或冲突。这可能会导致 "instruments" 服务无法正常运行，并最终瓦解。
  

4、关闭应用

• cmd
  
  
  
  • pid_or_name：表示历程ID或包名（bundle_id）
    
  
  

   tidevice --udid &UDID kill pid_or_name
  

• Python
  

1. from tidevice import Device
2. Device("$UDID").app_stop(pid_or_name)

复制代码

5、检察已安装应用列表

• cmd
  

   # 检察指定设备的应用列表
tidevice --udid &UDID applist
# 只有一个设备连接的情况，可直接检察
tidevice applist
  

• Python
  

1. from tidevice import Device
2. device = Device("$UDID")
3. # 结果包含设备上全部的应用信息；包括用户应用（'Type': 'User'）,系统应用（'Type': 'System'），插件（'Type': 'PluginKit'）
4. apps = device.connect_instruments().app_list()

复制代码

6、获取指定应用详情应用信息

• cmd
  
  
  
  • 可以获取：具体信息，如版本、构建版本、安装日期、所需最低操作系统版本等
    
  
  

   tidevice appinfo bundle_id
  

• Python
  

1. from tidevice import Device
2. device = Device("$UDID")
3. app_info = device.installation.lookup(bundle_id)
4. print(app_info)

复制代码

2.4.3、执行主动化测试

1、启动WebDriverAgent服务

• cmd
  
  
  
  • WebDriverAgent_bundle_id：表示WebDriverAgent的bundle_id
    
  
  

   tidevice wdaproxy -B WebDriverAgent_bundle_id --port 8100
  
  # 指定设备启动WebDriverAgent tidevice -u &UDID wdaproxy -B WebDriverAgent_bundle_id --port 8100
  

• 命令详解：
  
  
  
  • tidevice -u &UDID：连接到指定 UDID 的 iOS 设备。UDID 是设备的唯一标识
    
  • wdaproxy -B WebDriverAgent_bundle_id：启动 WebDriverAgent，并将其绑定到指定的 WebDriverAgent_bundle_id。WebDriverAgent 是一个答应远程控制 iOS 设备的工具，它需要一个唯一的标识符来与设备进行通讯。
    
  • --port 8100：指定将 WebDriverAgent 署理到当地的 8100 端口。这样，你可以通过访问当地的 8100 端口来控制设备上的 WebDriverAgent。
    
  
  
• 启动后通过访问http://127.0.0.1:8100/status，检测WebDriverAgent服务是否乐成启动。
  

2.4.4、fps 数据采集

• cmd
  

   tidevice dumpfps
  

• Python
  

1. from tidevice import Device
2. device = Device("$UDID")
3. for data in device.connect_instruments().iter_opengl_data():
4.     print(data)

复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。