Appium的安装和使用

最新推荐文章于 2024-02-22 16:10:09 发布

weixin_30760895

最新推荐文章于 2024-02-22 16:10:09 发布

阅读量92

点赞数

文章标签： java 测试 ui

原文链接：http://www.cnblogs.com/wangyinghao/p/10161004.html

版权

Appium

基于 WebDrive 协议的一个自动化测试框架，可以对 Android、iOS 以及混合开发的移动端应用进行自动化测试。
优势：可以使用 Python 、Ruby 、 Java 、 JavaScript、Php 、 C# 等语言进行开发。
劣势：Appium 在 Android 官方的自动化框架 UiAutomator 和 iOS 官方的 UiAutomation 上进行的封装，所以效率上没有直接使用官方的框架好。
目前已经有了 GUI 版本，环境配置更加方便和快速。
官网

安装

最新 GUI 版本下载

使用

配置

app 信息

Package： com.xxx.xxx
Launch Activity： com.xxx.xxx.ui.activity.WelcomeActivity
Device Name:4d003d169c0c4037，可以通过 adb devices 命令查询到
PlatformVersion:测试设备的 Android 版本号

脚本的编写（以 Java 为例，其他语言的 Api 类似）

定位

常用 Api 通过各种属性定位
在 Android 测试中，一般使用 findElementsById() 或者 findElementById() 方法就够了，假如需要定位的控件没有 id的话，可以让开发人员帮忙添加上。
T findElementById(String id)
T findElementByName(String using)
T findElementByClassName(String using)
T findElementByXPath(String using)
List
List
List
List

示例

driver.findElement(By.xpath(".//*[@text='Add Contact']"))
driver.findElementById("com.xxx.xxx:id/login_btn");
driver.findElement(By.id("com.xxx.xxx:id/login_btn"));
driver.findElementsById("com.xxx.xxx:id/login_btn").get(0)

点击

void click()

EditText 等控件输入文本

void sendKeys(CharSequence... keysToSend)

滑动

swipe(int startx, int starty, int endx, int endy, int duration)
- startx:开始坐标 x
- starty:开始坐标 y
- endx:结束坐标 x
- endy:结束坐标 y
- duration:滑动持续时间
向左滑动，手机分辨率为1080P,即1920×1080，坐标可以写成从（900，500）滑动到（400，500）。（该写法为 Android 中的 sp ,针对兼容性问题，目前在 Android 使用的是 dp ，所以这里用 sp 的话，会在不同分辨率的机子上出现问题，因此针对不同的设备，在脚本运行前需要进行代码的检查和校验）
Android 坐标系
- Android 坐标系是以 x 轴的正方向和 y 轴的下方向为坐标系，即数学中的第四象限

截图

缩放

缩：
- void pinch(WebElement el)
  - webElement:一般通过 findViewBy... 方法可以获取到 WebElement 的子类
- void pinch(int x, int y)
  - （x,y）：坐标
放：
- void zoom(WebElement webElement)：缩放每个控件
  - webElement:一般通过 findViewBy... 方法可以获取到 WebElement 的子类
- void zoom(int x, int y)：通过（x,y）坐标缩放
  - （x,y）：坐标

隐藏键盘

void hideKeyboard()

获取和设置横竖屏

ScreenOrientation getOrientation()：获取手机横竖屏信息
- 返回值是一个枚举类型，通过 value() 方法可以得到手机屏幕的横竖屏信息。
- landscape：横屏
- portrait：竖屏
void rotate(ScreenOrientation orientation)：设置手机横竖屏
- orientation：枚举类型
  - ScreenOrientation.LANDSCAPE
  - ScreenOrientation.PORTRAIT

等待时间

Thread.sleep(1000)：当前线程睡眠时间

在一定时间内等待某个元素的出现

      WebDriverWait wait = new WebDriverWait(driver, 10);
      wait.until(new ExpectedCondition<WebElement>() {
          @Override
          public WebElement apply(WebDriver d) { return d.findElement(By.id("com.xxx.xxx:id/backlog_list_layout")); } });

等待某个元素的出现

  private void waitForVisible(WebDriver driver, final By by, int waitTime) { WebDriverWait wait = new WebDriverWait(driver, waitTime); for (int i = 0; i < waitTime; i++) { try { driver.findElement(by); break; } catch (Exception e) { driver.manage().timeouts().implicitlyWait(1, TimeUnit.SECONDS); } } wait.until(ExpectedConditions.visibilityOfElementLocated(by)); }

判断某个元素是否显示在屏幕上

boolean isDisplayed()

断言

断言，在 org.junit.Assert 包里，判断是否与预期结果一致。
void assertNull(Object object)
void assertNotNull(Object object)
void assertEquals(Object expected, Object actual)

应用工具类Api

app 是否安装：boolean isAppInstalled(String bundleId)：
- bundleId：应用的包名
- 返回值：返回一个布尔值，true 表示已安装了该应用
安装 apk:void installApp(String appPath)：
- appPath：apk路径
移出指定包名的app:void removeApp(String bundleId)
- bundleId：应用的包名
运行app:void launchApp()
关闭app:void closeApp()
app放到后台：void runAppInBackground(int seconds)
- seconds：后台放置时间
执行命令：Response execute(String command)
- command：命令
- 返回值是一个 Resonse，可以解析 Response 来判断是否执行成功。

代码示例

Java

package com.saucelabs.appium;

import io.appium.java_client.AppiumDriver;
import io.appium.java_client.android.AndroidDriver;
import org.junit.After;
import org.junit.Before; import org.junit.Test; import org.openqa.selenium.By; import org.openqa.selenium.WebElement; import org.openqa.selenium.remote.DesiredCapabilities; import java.io.File; import java.net.URL; import java.util.List; import static org.junit.Assert.assertEquals; public class AndroidTest { private AppiumDriver<WebElement> driver; @Before public void setUp() throws Exception { File classpathRoot = new File(System.getProperty("user.dir")); File appDir = new File(classpathRoot, "../../../apps/ApiDemos/bin"); File app = new File(appDir, "ApiDemos-debug.apk"); DesiredCapabilities capabilities = new DesiredCapabilities(); capabilities.setCapability("deviceName","Android Emulator"); capabilities.setCapability("platformVersion", "4.4"); capabilities.setCapability("app", app.getAbsolutePath()); capabilities.setCapability("appPackage", "io.appium.android.apis"); capabilities.setCapability("appActivity", ".ApiDemos"); driver = new AndroidDriver<>(new URL("http://127.0.0.1:4723/wd/hub"), capabilities); } @After public void tearDown() throws Exception { driver.quit(); } @Test public void apiDemo(){ WebElement el = driver.findElement(By.xpath(".//*[@text='Animation']")); assertEquals("Animation", el.getText()); el = driver.findElementByClassName("android.widget.TextView"); assertEquals("API Demos", el.getText()); el = driver.findElement(By.xpath(".//*[@text='App']")); el.click(); List<WebElement> els = driver.findElementsByClassName("android.widget.TextView"); assertEquals("Activity", els.get(2).getText()); } }

Python

import os
from time import sleep

import unittest

from appium import webdriver

# Returns abs path relative to this file and not cwd
PATH = lambda p: os.path.abspath(
    os.path.join(os.path.dirname(__file__), p)
)

class SimpleAndroidTests(unittest.TestCase): def setUp(self): desired_caps = {} desired_caps['platformName'] = 'Android' desired_caps['platformVersion'] = '4.2' desired_caps['deviceName'] = 'Android Emulator' desired_caps['app'] = PATH( '../../../sample-code/apps/ApiDemos/bin/ApiDemos-debug.apk' ) self.driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps) def tearDown(self): # end the session self.driver.quit() def test_find_elements(self): el = self.driver.find_element_by_accessibility_id('Graphics') el.click() el = self.driver.find_element_by_accessibility_id('Arcs') self.assertIsNotNone(el) self.driver.back() el = self.driver.find_element_by_accessibility_id("App") self.assertIsNotNone(el) els = self.driver.find_elements_by_android_uiautomator("new UiSelector().clickable(true)") self.assertGreaterEqual(12, len(els)) self.driver.find_element_by_android_uiautomator('text("API Demos")') def test_simple_actions(self): el = self.driver.find_element_by_accessibility_id('Graphics') el.click() el = self.driver.find_element_by_accessibility_id('Arcs') el.click() self.driver.find_element_by_android_uiautomator('new UiSelector().text("Graphics/Arcs")') if __name__ == '__main__': suite = unittest.TestLoader().loadTestsFromTestCase(SimpleAndroidTests) unittest.TextTestRunner(verbosity=2).run(suite)

GitHub示例代码

app 示例代码

测试环境下，app 登录，进入待办1000次，并截图

import io.appium.java_client.AppiumDriver;
import io.appium.java_client.android.AndroidDriver;
import io.appium.java_client.android.AndroidElement;
import org.apache.commons.io.FileUtils;
import org.junit.After; import org.junit.Assert; import org.junit.Before; import org.junit.Test; import org.openqa.selenium.By; import org.openqa.selenium.OutputType; import org.openqa.selenium.WebDriver; import org.openqa.selenium.WebElement; import org.openqa.selenium.remote.DesiredCapabilities; import org.openqa.selenium.remote.SessionId; import org.openqa.selenium.support.ui.ExpectedCondition; import org.openqa.selenium.support.ui.ExpectedConditions; import org.openqa.selenium.support.ui.WebDriverWait; import java.io.File; import java.io.IOException; import java.net.URL; import java.text.SimpleDateFormat; import java.util.Date; import java.util.List; import java.util.concurrent.TimeUnit; public class RuixinTest { private AppiumDriver<AndroidElement> driver; @Before public void setUp() throws Exception { // set up appium File classpathRoot = new File(System.getProperty("user.dir")); File appDir = new File(classpathRoot, "apps"); File app = new File(appDir, "ruixin.apk"); DesiredCapabilities capabilities = new DesiredCapabilities(); capabilities.setCapability("deviceName", "4d003d169c0c4037"); capabilities.setCapability("platformVersion", "5.0.1"); capabilities.setCapability("app", app.getAbsolutePath()); capabilities.setCapability("appPackage", "com.xxx.xxx"); capabilities.setCapability("appActivity", ".ui.activity.WelcomeActivity"); driver = new AndroidDriver<>(new URL("http://127.0.0.1:4723/wd/hub"), capabilities); } @After public void tearDown() throws Exception { driver.removeApp("com.xxx.xxx"); SessionId sessionId = driver.getSessionId(); sessionId = null; driver.quit(); } @Test public void appLogin() { waitForVisible(driver, By.id("com.xxx.xxx:id/login_btn"), 10); if (driver.findElementsById("com.xxx.xxx:id/login_btn").get(0).isDisplayed()) { AndroidElement userName = driver.findElementsById("com.xxx.xxx:id/login_username_edit_text").get(0); userName.sendKeys("lijingbo02"); AndroidElement password = driver.findElementsById("com.xxx.xxx:id/login_password_edit_text").get(0); password.click(); driver.hideKeyboard(); //判断登录框是否输入了 Assert.assertEquals("lijingbo02@cnpc.com.cn", userName.getText()); //等待2秒 driver.manage().timeouts().implicitlyWait(2, TimeUnit.SECONDS); password.click(); password.sendKeys("1"); //隐藏弹出的键盘 driver.hideKeyboard(); //判断输入的密码不为空 Assert.assertNotNull(password.getText()); //点击登录按钮 driver.findElementsById("com.xxx.xxx:id/login_btn").get(0).click(); //登录等待 driver.manage().timeouts().implicitlyWait(5, TimeUnit.SECONDS); task(); } } private void task() { AndroidElement androidElement = driver.findElementsById("com.xxx.xxx:id/main_tab_apps").get(0); driver.zoom(androidElement); waitForVisible(driver, By.id("com.xxx.xxx:id/main_tab_msgs"), 10); //跳转到应用页面 driver.findElementsById("com.xxx.xxx:id/main_tab_apps").get(0).click(); //等待5秒 driver.manage().timeouts().implicitlyWait(5, TimeUnit.SECONDS); //判断GridView是否显示 if (driver.findElementsById("com.xxx.xxx:id/application_grid_view").get(0).isDisplayed()) { System.out.println("待办开始时间：" + getCurrentTime()); for (int i = 0; i < 1000; i++) { AndroidElement daibanElement = driver.findElementsById("com.xxx.xxx:id/item_content_linear").get(0); daibanElement.click(); driver.manage().timeouts().implicitlyWait(2, TimeUnit.SECONDS); taskLogin(i); } System.out.println("待办结束时间：" + getCurrentTime()); } } boolean isFirst = true; //待办登录 // @Test public void taskLogin(int time) { driver.manage().timeouts().implicitlyWait(3, TimeUnit.SECONDS); if (isFirst) { AndroidElement userName = driver.findElementsById("com.xxx.xxx:id/login_username_edit_text").get(0); userName.sendKeys("yangjianfeng1"); driver.hideKeyboard(); Assert.assertEquals("yangjianfeng1", userName.getText()); //等待1秒 driver.manage().timeouts().implicitlyWait(1, TimeUnit.SECONDS); AndroidElement password = driver.findElementById("com.xxx.xxx:id/login_password_edit_text"); if (password.getText().trim().equals("")) { System.out.println("password为null"); password.click(); password.sendKeys("1"); //隐藏弹出的键盘 driver.hideKeyboard(); } isFirst = false; } driver.manage().timeouts().implicitlyWait(1, TimeUnit.SECONDS); //点击登录按钮 driver.findElementsById("com.xxx.xxx:id/login_btn").get(0).click(); System.out.println("第 " + time + " 次登录"); backTask(time); } //截图 public void getScreen(int time) { String fileRoute = "/testing/screen/"; String picname = fileRoute + String.valueOf(time) + ".png"; File screen = driver.getScreenshotAs(OutputType.FILE); System.out.println(picname); File screenFile = new File(picname); try { FileUtils.copyFile(screen, screenFile); System.out.println("第 " + time + " 截图"); } catch (IOException e) { e.printStackTrace(); } } //从待办列表返回 public void backTask(int time) { driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS); List<AndroidElement> elementsById = driver.findElementsById("com.xxx.xxx:id/backlog_list_layout"); getScreen(time); if (null != elementsById && elementsById.size() > 0) { AndroidElement backButton = elementsById.get(0); if (backButton.isDisplayed()) { backButton.click(); } //长时间操作，可能会出现无法获取到backButton的情况，做判断，list是否为null或者size为0； } else if (null == elementsById || elementsById.size() == 0) { //等待10秒，直到能找到backButton元素 getScreen(-1); WebDriverWait wait = new WebDriverWait(driver, 10); wait.until(new ExpectedCondition<WebElement>() { @Override public WebElement apply(WebDriver d) { return d.findElement(By.id("com.xxx.xxx:id/backlog_list_layout")); } }); driver.findElementsById("com.xxx.xxx:id/backlog_list_layout").get(0).click(); } } private String getCurrentTime() { SimpleDateFormat df = new SimpleDateFormat("yyyy-MM-dd:HH-mm-ss"); return df.format(new Date()); } private void waitForVisible(WebDriver driver, final By by, int waitTime) { WebDriverWait wait = new WebDriverWait(driver, waitTime); for (int i = 0; i < waitTime; i++) { try { driver.findElement(by); break; } catch (Exception e) { driver.manage().timeouts().implicitlyWait(1, TimeUnit.SECONDS); } } wait.until(ExpectedConditions.visibilityOfElementLocated(by)); } }

转载于:https://www.cnblogs.com/wangyinghao/p/10161004.html

weixin_30760895

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
Appium的安装和使用

Appium基于 WebDrive 协议的一个自动化测试框架，可以对 Android、iOS 以及混合开发的移动端应用进行自动化测试。优势：可以使用 Python 、Ruby 、 Java 、 JavaScript、Php 、 C# 等语言进行开发。劣势：Appium 在 Android 官方的自动化框架 UiAutomator 和 iOS 官方的 UiAutomation 上进行...
复制链接

扫一扫