设备配置-腾讯WeTest

Android设备配置

如您需要接入注册Android设备，请提前进行设备的相关配置，已确保后续接入顺利。

开发者模式

重要：设备接入前须开启开发者模式，并打开USB调试选项，可以参考Android启用开发者选项和USB调试。

相关手机配置

这里列出了部分厂商特殊机型的设置，请根据自己的手机型号查看是否有对应选项需要打开。
　
小米

开启允许模拟点击位置、USB安装、USB调试(安全设置) 等选项
禁用启用MIUI优化、应用权限监控” 和 USB安装管理等选项
关掉高风险提示设置
打开允许模拟点击位置设置
取消安全键盘设置

1.请在“开发者选项”中将“允许模拟点击位置”、“USB安装”、“USB调试(安全设置)”等选项打开，部分选项的开启可能需要登录MIUI账号（需要插入SIM卡），若没有正确打开这些选项，可能会导致小米手机无法连接的问题。
　

　
如果尝试打开图示2个选项，但是打开后提示被临时限制而无法打开，可以试下退出当前小米账号，重新插入另一张有效sim卡，然后登录当前sim卡号码注册的小米账号，一般就能再次打开了。
　
2.另外，部分型号的小米还需要禁用掉下述设置才可以正常连接：
开发者选项底部的 “启用MIUI优化” 需要禁用掉：

3.手机管家-应用管理-权限-右上角的设置- “应用权限监控” 和 “USB安装管理” ，这俩个设置也需要禁用：

4.开发者选项中，关掉“高风险提示”。
5.如果出现点击手机屏幕会报错、无法点击手机屏幕的问题，请确认小米设置中的允许模拟点击位置选项已经打开。
6.部分小米手机在连接失败时，报错 Failure [INSTALL_FAILED_USER_RESTRICTED: Install canceled by user] ，是因为在Airtest试图向手机中安装apk但是被手机自动拦截了。除了上述开发者选项中需要注意开启允许通过USB安装应用之外，还可以查看手机设置-》授权管理-》USB安装管理-》去掉USB安装应用的相关限制。

部分小米手机无法成功安装WeTestIME输入法，在初始化测试时报以下错误：

在系统设置的语言和输入法中，取消安全键盘的选中状态：

三星

屏幕分辨率调到最大 WQHD。
取消权限监控。
1.显示-屏幕分辨率调到最大：
如下图所示，部分手机设备（如部分型号三星手机）在打开云真机界面后，显示出的手机画面不能撑满整个屏幕，请在“设置”-“显示”中将“屏幕分辨率”调至 “WQHD”。
　

　
2.在开发者选项中，打开未知来源、取消权限监控。
　
华为
取消安全输入、或者关闭安全键盘。
取消监控ADB安装应用、锁屏。
打开仅充电模式下允许调试、自动配置权限、保持唤醒。
屏幕分辨率调到最高 WQHD+。
勾选pocoservice的允许自启动和允许后台活动。

1.输入法设置中，取消安全输入。
2.开发者选项->监控ADB安装应用取消，打开仅充电模式下允许调试。
3.权限监控->设置->自动配置权限。
4.部分华为型号的手机，可能出现点击位置与实际位置不符的情况（mate20pro, mate7等），需要在设置->显示->屏幕分辨率中，将分辨率设置为最高即可。
　

　
5.如果华为手机出现poco在启动后十几秒内自动断开的话，可以检查一下手机管家的版本号是否大于8.0，如果是的话，就在手机管家->启动管理里面，找到pocoservice，勾选允许自启动和允许后台活动。

vivo

取消安全输入 ,设置WeTestIME为默认输入法。
打开安全权限、usb模拟点击。
关闭安全键盘或者安全输入、防止恶意截屏录屏。
打开不锁定屏幕。
1.取消安全输入，如果遇到Poco初始化失败、text接口无法调用的问题，可以在输入法设置中将WeTestIME输入法设置为默认　
2.部分机型需要在开发者选项中打开安全权限，否则可能在初始化poco的时候看到以下报错：

3.如果vivo 输密码的时候出现黑屏，可以在尝试把安全性设置里的安全键盘关闭掉再重试。如果没找到安全键盘的设置，可以找一下vivo的设置->安全与隐私-> 防止恶意截屏录屏，然后把防止恶意截屏录屏关掉就好了。
4.如果有usb模拟点击选项的话,一定要点开,否则运行脚本可能会报错：
　

5.如果出现vivo手机长时间连接会出现自动关闭开发者选项的问题，可以在开发者选项里选择不锁定屏幕来解决。
　
OPPO
打开禁止权限监控、不使用锁屏、充电不休眠。
输入法安装失败可选择手动安装，并且设置WeTestIME为默认输入法。
打开 pocoservice的允许完全后台行为、允许应用自启动。
USB连接模式选文件模式。
关闭 USB验证应用、安全键盘、防止恶意截屏录屏。
1.开发者选项的最底部，勾选禁止监控权限。
部分Android低版本（6.0以下）权限监控修改路径：设置->手机管家->权限监控。
　

2.OPPO部分机型在每次安装APK时都需要输入密码
3.如OPPO出现10分钟断连的情况,不要插拔手机,直接在屏幕上方下拉的选项里再次打开 USB调试 ,一般就不会再断开了。
4.在电池-后台高耗电-> PocoService 开启，这样能有效避免poco不断重启的问题，并且OPPO部分机型还要在pocoservice的应用中开启允许完全后台行为和允许应用自启动设置。

5.如输入密码时出现黑屏，请注意关闭安全键盘、防止恶意截屏录屏等设置

魅族
1.魅族手机部分型号无法直接通过ADB进行连接，需要关闭USB安装管理，操作路径监控手机管家->权限管家->USB安装管理。
　

　
LG
LG手机需要选择充电模式才能正确打开USB调试，识别序列号：
　

　
另外还需要在开发者选项中勾选允许模仿位置：
　

一加

pocoservice和WeTestIME的电池优化选择不优化
　
一加手机在使用poco的时候，会出现重复安装的问题，报错如下：
　

　
此时需要将pocoservice.apk的电池优化关掉，改成“不优化”：
　

　
Pixel及自带GMS包的手机
android - installation app blocked by play protect - Stack Overflow

此弹框报错属于GMS的app自动检测，可以通过以下路径关闭：Play Store->Play Protect->Settings Icon->Scan Device for security threats。
这个检测一般会暴露app的配置问题（截图中问题应该是gradle中配置的targetsdk太低引起的），这个报错其实是合理的，特别是如果应用需要在海外的设备要上架Google play的话，可以暴露应用自身的问题。

IOS设备配置

如您需要接入注册iOS设备，请提前进行设备的相关配置，已确保后续接入顺利。注意：windows系统连接苹果设备，需提前安装itunes。

1.设备信任

(1)关闭设备锁屏密码，后续步骤会需要输入密码。
(2)通过USB连接设备后，如提示“信任”弹框，需要点击允许。注意：设备 iOS 版本≥16.0需要手动在设置->安全与隐私->Developer中打开开发者开关（开启后会提示手机重启）。如果找不到开发者选项，见FAQ。
　

　
如果没有出现该开关，重新插拔手机，并接入desktop，desktop会自动重启手机，重启完成可以使用了。

2.UDT组件安装

接入设备的iOS系统版本≥15.0，需要打开设置->通用->VPN与设备管理->企业签名APP->scrcpy点击信任。
　

　
正常运行后，手机会提示“Automation Running字样”，如下：
　　

　
注：如果后续不想接入desktop，可以通过点击桌面“scrcpy”及“WedDriverA”入口，然后上化手机进入近期APP任务页面，手动关闭，“Automation Running字样”会提示消失。
　

　
接入设备的iOS系统版本<15.0，投屏功能会受到系统限制，需要将投屏组件应用重签名。具体指引如下：