Airtest:各平台的剪切板功能汇总

此文章来源于项目官方公众号:“AirtestProject”
版权声明:允许转载,但转载必须保留原链接;请勿用作商业或者非法用途

1. 前言

一直以来,大家都还挺关注 Airtest是否有剪切板功能 的。从Airtest1.3.1版本起,我们新增了Android、iOS设备的剪切板功能,自此,3大平台的剪切板功能就齐全啦。

正好趁这个机会,我们给各大平台的剪切板功能做个合集,方便同学们查阅使用~

2. Android设备的剪切板功能

Android设备的剪切板功能包含设置剪切板内容、获取剪切板内容、剪切板粘贴:

# -*- encoding=utf8 -*-
__author__ = "AirtestProject"

from airtest.core.api import *
auto_setup(__file__)

text_1 = "test_clipboard"
set_clipboard(text_1) # 设置剪切板内容

get_text = get_clipboard() # 获得剪切板内容
print(get_text)  # -> test_clipboard

# 剪切板粘贴接口
paste()  # => text(get_clipboard())

3. iOS设备的剪切板功能

iOS的剪切板功能和Android是大同小异的;对于本地iOS设备,特别是本地机器上只安装了一个WDA的,我们无需在使用剪切板功能时指定WDA的bundle ID:

但是 对于远程iOS设备,我们必须指定定WDA的bundle ID

# 远程iOS设备

text_1 = "test_clipboard"
bundle_id = "com.2303xxxxxxxxx.WebDriverAgentRunner.xctrunner"

set_clipboard(text_1,bundle_id) # 设置剪切板内容

get_text = get_clipboard(bundle_id) # 获得剪切板内容
print(get_text)  # -> test_clipboard

# 剪切板粘贴接口
paste(bundle_id)  # => text(get_clipboard())

否则会出现如下的报错:

Traceback (most recent call last):
  File "airtest\cli\runner.py", line 75, in runTest
  File "site-packages\six.py", line 703, in reraise
  File "airtest\cli\runner.py", line 72, in runTest
  File "D:\demo\untitled.air\untitled.py", line 9, in <module>
    set_clipboard(text_1) # 设置剪切板内容
  File "airtest\utils\logwraper.py", line 131, in wrapper
  File "airtest\core\api.py", line 698, in set_clipboard
  File "E:\AirtestIDE-win-1.2.16\AirtestIDE\airtest\core\ios\ios.py", line 47, in wrapper
    return func(self, *args, **kwargs)
  File "E:\AirtestIDE-win-1.2.16\AirtestIDE\airtest\core\ios\ios.py", line 956, in set_clipboard
    e.g. set_clipboard('content', 'wda_bundle_id').")
RuntimeError: Remote device need to set running wda bundle id parameter,                                     e.g. set_clipboard('content', 'wda_bundle_id').

----------------------------------------------------------------------
Ran 1 test in 2.169s

FAILED (errors=1)
[Finished]

1)小tips:关于如何获取WDA的bundle ID

我们可以使用Airtest1.3.0新增的iOS接口来查询:

# -*- encoding=utf8 -*-
__author__ = "AirtestProject"

from airtest.core.api import *
import airtest
auto_setup(__file__)

dev = device()

#列出并打印用户安装的APP
print("---------以下是用户安装的APP的信息-----------")
user_app = dev.list_app("user")
print(user_app)

此时,我们安装在手机上的WDA信息也会被打印出来,不过 该方式只能适用于本地的iOS设备

4. Windows平台的剪切板功能

对于Windows应用,Airtest虽然没有封装专门的剪切板功能,但其实我们都知道,Windows平台的复制粘贴就是键盘操作 “Ctrl+C”、“Ctrl+V”,并且Airtest封装有 keyevent 接口,支持我们执行键盘操作:

# -*- encoding=utf8 -*-
__author__ = "AirtestProject"

from airtest.core.api import *
auto_setup(__file__)

text("11111111")

# 模拟按键Ctrl+A,实现全选文本
keyevent("^a")

# 模拟按键Ctrl+C,实现复制文本
keyevent("^c")

# 回车换行
keyevent("{ENTER}")

# 模拟按键Ctrl+V,实现复制文本
keyevent("^v")

(其实,pywin32 的模块里面也有一些现成的关于Windows剪切板功能的接口,感兴趣的同学可以自行网上查阅资料~)

5. 小结

至此,3大平台的剪切板功能就介绍到这里啦,后续同学们还想看怎样的教程,欢迎给我们留言/投稿!


AirtestIDE下载:airtest.netease.com/
Airtest 教程官网:airtest.doc.io.netease.com/
搭建企业私有云服务:airlab.163.com/b2b

官方答疑 Q 群:117973773

posted @ 2023-11-17 10:28  AirtestProject  阅读(252)  评论(0编辑  收藏  举报