此文章来源于项目官方公众号：“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
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