## 简单的元素Swipe
### Android的UIAutomator2
默认的UIAutomator2只返回在屏幕上可以看到的元素。如果可见视图和不可见视图分隔了某个容器,那么此容器中一部分内容将无法(被UIAutomator2)识别到。
![simple-element-swipe.png](https://img.kancloud.cn/da/2b/da2b08757c398030a5f0f82c8b04889c_116x248.png)
```java
/**
* Performs swipe inside an element
*
* @param el the element to swipe
* @param dir the direction of swipe
* @version java-client: 7.3.0
**/
public void swipeElementAndroid(MobileElement el, Direction dir) {
System.out.println("swipeElementAndroid(): dir: '" + dir + "'"); // always log your actions
// Animation default time:
// - Android: 300 ms
// - iOS: 200 ms
// final value depends on your app and could be greater
final int ANIMATION_TIME = 200; // ms
final int PRESS_TIME = 200; // ms
int edgeBorder;
PointOption pointOptionStart, pointOptionEnd;
// init screen variables
Rectangle rect = el.getRect();
// sometimes it is needed to configure edgeBorders
// you can also improve borders to have vertical/horizontal
// or left/right/up/down border variables
edgeBorder = 0;
switch (dir) {
case DOWN: // from up to down
pointOptionStart = PointOption.point(rect.x + rect.width / 2,
rect.y + edgeBorder);
pointOptionEnd = PointOption.point(rect.x + rect.width / 2,
rect.y + rect.height - edgeBorder);
break;
case UP: // from down to up
pointOptionStart = PointOption.point(rect.x + rect.width / 2,
rect.y + rect.height - edgeBorder);
pointOptionEnd = PointOption.point(rect.x + rect.width / 2,
rect.y + edgeBorder);
break;
case LEFT: // from right to left
pointOptionStart = PointOption.point(rect.x + rect.width - edgeBorder,
rect.y + rect.height / 2);
pointOptionEnd = PointOption.point(rect.x + edgeBorder,
rect.y + rect.height / 2);
break;
case RIGHT: // from left to right
pointOptionStart = PointOption.point(rect.x + edgeBorder,
rect.y + rect.height / 2);
pointOptionEnd = PointOption.point(rect.x + rect.width - edgeBorder,
rect.y + rect.height / 2);
break;
default:
throw new IllegalArgumentException("swipeElementAndroid(): dir: '" + dir + "' NOT supported");
}
// execute swipe using TouchAction
try {
new TouchAction(driver)
.press(pointOptionStart)
// a bit more reliable when we add small wait
.waitAction(WaitOptions.waitOptions(Duration.ofMillis(PRESS_TIME)))
.moveTo(pointOptionEnd)
.release().perform();
} catch (Exception e) {
System.err.println("swipeElementAndroid(): TouchAction FAILED\n" + e.getMessage());
return;
}
// always allow swipe action to complete
try {
Thread.sleep(ANIMATION_TIME);
} catch (InterruptedException e) {
// ignore
}
}
```
### iOS的XCUITest
XCUITest可以显示屏幕外的元素。强烈建议使用屏幕滑动(screen swipe)或'mobile:scroll' / 'mobile:swipe' 方法。如果你需要或更倾向于使用元素相关的方法,需要考虑以下内容:
1. 检查确保起始点和结束点都在屏幕区域之内。
2. 滚动视图通常是背景元素。页面/页脚或其他元素覆盖在滚动视图之上,限制了滚动性。尝试配置正确的边界以保证滚动性。如果不同屏幕上的边界有差异,应该通过swipe方法的参数进行配置化处理。
```java
/**
* Performs swipe inside an element
*
* @param el the element to swipe
* @param dir the direction of swipe
* @version java-client: 7.3.0
**/
public void swipeElementIOS(MobileElement el, Direction dir) {
System.out.println("swipeElementIOS(): dir: '" + dir + "'"); // always log your actions
// Animation default time:
// - Android: 300 ms
// - iOS: 200 ms
// final value depends on your app and could be greater
final int ANIMATION_TIME = 200; // ms
final int PRESS_TIME = 500; // ms
// init screen variables
Dimension dims = driver.manage().window().getSize();
Rectangle rect = el.getRect();
// check element overlaps screen
if (rect.x >= dims.width || rect.x + rect.width <= 0
|| rect.y >= dims.height || rect.y + rect.height <= 0) {
throw new IllegalArgumentException("swipeElementIOS(): Element outside screen");
}
// init borders per your app screen
// or make them configurable with function variables
int leftBorder, rightBorder, upBorder, downBorder;
leftBorder = 0;
rightBorder = 0;
upBorder = 0;
downBorder = 0;
// find rect that overlap screen
if (rect.x < 0) {
rect.width = rect.width + rect.x;
rect.x = 0;
}
if (rect.y < 0) {
rect.height = rect.height + rect.y;
rect.y = 0;
}
if (rect.width > dims.width)
rect.width = dims.width;
if (rect.height > dims.height)
rect.height = dims.height;
PointOption pointOptionStart, pointOptionEnd;
switch (dir) {
case DOWN: // from up to down
pointOptionStart = PointOption.point(rect.x + rect.width / 2,
rect.y + upBorder);
pointOptionEnd = PointOption.point(rect.x + rect.width / 2,
rect.y + rect.height - downBorder);
break;
case UP: // from down to up
pointOptionStart = PointOption.point(rect.x + rect.width / 2,
rect.y + rect.height - downBorder);
pointOptionEnd = PointOption.point(rect.x + rect.width / 2,
rect.y + upBorder);
break;
case LEFT: // from right to left
pointOptionStart = PointOption.point(rect.x + rect.width - rightBorder,
rect.y + rect.height / 2);
pointOptionEnd = PointOption.point(rect.x + leftBorder,
rect.y + rect.height / 2);
break;
case RIGHT: // from left to right
pointOptionStart = PointOption.point(rect.x + leftBorder,
rect.y + rect.height / 2);
pointOptionEnd = PointOption.point(rect.x + rect.width - rightBorder,
rect.y + rect.height / 2);
break;
default:
throw new IllegalArgumentException("swipeElementIOS(): dir: '" + dir + "' NOT supported");
}
// execute swipe using TouchAction
try {
new TouchAction(driver)
.press(pointOptionStart)
// a bit more reliable when we add small wait
.waitAction(WaitOptions.waitOptions(Duration.ofMillis(PRESS_TIME)))
.moveTo(pointOptionEnd)
.release().perform();
} catch (Exception e) {
System.err.println("swipeElementIOS(): TouchAction FAILED\n" + e.getMessage());
return;
}
// always allow swipe action to complete
try {
Thread.sleep(ANIMATION_TIME);
} catch (InterruptedException e) {
// ignore
}
}
```
- 关于TesterHome和MTSC
- 关于Appium
- 简介
- Appium 客户端
- 入门指南
- 已支持的平台
- API 文档
- Appium驱动
- XCUITest (iOS)
- XCUITest Real Devices (iOS)
- UIAutomation (iOS)
- UIAutomation Safari Launcher (iOS)
- UIAutomator (Android)
- UIAutomator2 (Android)
- Espresso (Android)
- Windows
- Mac
- Appium命令
- Status
- Execute Mobile Command
- Session
- Create
- End
- Get Session Capabilities
- Go Back
- Screenshot
- Source
- Timeouts
- Timeouts
- Implicit Wait
- Async Script
- Orientation
- Get Orientation
- Set Orientation
- Geolocation
- Get Geolocation
- Set Geolocation
- Logs
- Get Log Types
- Get Logs
- Events
- Log event
- Get events
- Settings
- Update Settings
- Get Device Settings
- Settings
- Update Settings
- Get Device Settings
- Execute Driver Script
- Device
- Activity
- Start Activity
- Current Activity
- Current Package
- App
- Install App
- Is App Installed
- Launch App
- Background App
- Close App
- Reset App
- Remove App
- Activate App
- Terminate App
- Get App State
- Get App Strings
- End Test Coverage
- Clipboard
- Get Clipboard
- Set Clipboard
- Emulator
- Power AC
- Power Capacity
- Files
- Push File
- Pull File
- Pull Folder
- Interactions
- Shake
- Lock
- Unlock
- Is Locked
- Rotate
- Keys
- Press keycode
- Long press keycode
- Hide Keyboard
- Is Keyboard Shown
- Network
- Toggle Airplane Mode
- Toggle Data
- Toggle WiFi
- Toggle Location Services
- Send SMS
- GSM Call
- GSM Signal
- GSM Voice
- Network Speed
- Performance Data
- Get Performance Data
- Performance Data Types
- Screen Recording
- Start Screen Recording
- Stop Screen Recording
- Simulator
- Perform Touch ID
- Toggle Touch ID Enrollment
- System
- Open Notifications
- System Bars
- System Time
- Display density
- Authentication
- Finger Print
- Element
- Find Element
- Find Elements
- Actions
- Click
- Send Keys
- Clear
- Attributes
- Text
- Name
- Attribute
- Selected
- Enabled
- Displayed
- Location
- Size
- Rect
- CSS Property
- Location in View
- Other
- Submit
- Active Element
- Equals Element
- Context
- Get Context
- Get All Contexts
- Set Context
- Interactions
- Mouse
- Move To
- Click
- Double Click
- Button Down
- Button Up
- Touch
- Single Tap
- Double Tap
- Move
- Touch Down
- Touch Up
- Long Press
- Scroll
- Flick
- Multi Touch Perform
- Touch Perform
- W3C Actions
- Web
- Window
- Set Window
- Close Window
- Get Handle
- Get Handles
- Get Title
- Get Window Size
- Set Window Size
- Get Window Position
- Set Window Position
- Maximize Window
- Navigation
- Go to URL
- Get URL
- Back
- Forward
- Refresh
- Storage
- Get All Cookies
- Set Cookie
- Delete Cookie
- Delete All Cookies
- Frame
- Switch to Frame
- Switch to Parent Frame
- Execute Async
- Execute
- 编写 & 运行Appium脚本
- Running Tests
- Desired Capabilities
- The --default-capabilities flag
- Finding Elements
- Touch Actions
- CLI Arguments
- Server Security
- Web/Web Views
- Mobile Web Testing
- Automating Hybrid Apps
- Using ios-webkit-debug-proxy
- Using Chromedriver
- Image Comparison
- iOS
- Low-Level Insights on iOS Input Events
- XCUITest Mobile Gestures
- XCUITest Mobile App Management
- iOS Pasteboard Guide
- iOS Predicate Guide
- iOS Touch ID Guide
- iOS Install Certificate
- tvOS support
- Pushing/Pulling files
- Audio Capture
- Android
- Low-Level Insights on Android Input Events
- UiSelector Guide
- Espresso Datamatcher Guide
- Android Code Coverage Guide
- Activities Startup Troubleshooting Guide
- How To Execute Shell Commands On The Remote Device
- Android Device Screen Streaming
- How To Emulate IME Actions Generation
- How To Test Android App Bundle
- Other
- Reset Strategies
- Network Connection Guide
- Using Unicode with Appium
- Troubleshooting
- Tutorial
- Swipe Tutorial
- Screen
- Element
- Partial screen
- Simple
- Multiple scroll views
- Add scroll layout
- Tricks and Tips
- Screen
- Element
- Element search
- Fast
- Slow
- Guide
- 进阶概念
- 定位图像中的元素
- 使用定位元素的插件
- 迁移到 XCUITest
- 在 Appium 中使用 Selenium Grid
- Appium Logs Filtering
- 跨域 iframes
- 使用自定义 WDA 服务器
- 使用不同版本的 Xcode 运行
- The Event Timings API
- 并行测试的设置
- The Settings API
- Memory Collection
- 向Appium项目做贡献
- 从源代码运行 Appium
- 开发者概述
- 标准开发命令
- Appium 风格指南
- 如何编写文档
- Appium 包结构
- 鸣谢