2.4 常见API使用介绍

这个小节主要会来介绍下Appium常见的API使用。上面几节课已经介绍了一些API了如点击，通过定位方式定位到控件后调用click方法就可以对控件进行点击，还有获取控件的文本，一样是定位到控件后调用getText方法就可以获取控件的文本。

接着我们来介绍下一些输入框操作的API，如输入、清空。可以通过测试代码切换到开源中国的登录页面，可通过点击底部“我的”tab页，然后点击登录按钮可切换到登录界面，如下所示：

这时候如果要操作用户名输入框需要先定位到输入框这个控件，可通过uiautomatorviewer查看这个控件的属性，可以看到这个控件是有id的，因此可以通过id来定位到该控件，然后通过sendKeys和clear方法方法来进行文本输入和清空，具体测试代码如下：

package appium.chapter2;

import io.appium.java_client.AppiumDriver;
import io.appium.java_client.android.AndroidDriver;
import org.openqa.selenium.By;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.remote.DesiredCapabilities;
import org.testng.annotations.AfterMethod;
import org.testng.annotations.BeforeMethod;
import org.testng.annotations.Test;

import java.io.File;
import java.net.URL;

public class EditText {

    private AppiumDriver<WebElement> driver;

    @BeforeMethod
    public void setUp() throws Exception {
        //构造被测试应用的路径
        File app = new File(System.getProperty("user.dir"), "AUT/osc.apk");
        //实例化DesiredCapabilities
        DesiredCapabilities capabilities = new DesiredCapabilities();
        //deviceName的值可以任意指定
        capabilities.setCapability("deviceName","My Device");
        //设置被测应用的绝对路径
        capabilities.setCapability("app", app.getAbsolutePath());
        capabilities.setCapability("appPackage","net.oschina.app");
        //设置启动类的信息，这个信息可以通过aapt dump bading apkname来获得
        capabilities.setCapability("appActivity", ".AppStart");
        //初始化AppiumDriver
        driver = new AndroidDriver<WebElement>(new URL("http://127.0.0.1:4723/wd/hub"), capabilities);
    }

    @Test
    public void testName() throws Exception {
        Thread.sleep(3000);
        //点击底部"我的"tab页
        driver.findElement(By.id("net.oschina.app:id/nav_item_me")).click();
        //点击我的登录按钮
        driver.findElement(By.id("net.oschina.app:id/iv_portrait")).click();
        //通过ID定位到输入框控件
        WebElement name = driver.findElement(By.id("net.oschina.app:id/et_username"));
        //输入文本
        name.sendKeys("277860602@qq.com");
        Thread.sleep(3000);
        //清空输入框
        name.clear();
    }

    @AfterMethod
    public void tearDown() throws Exception {
        driver.quit();
    }
}

执行下脚本可以发现往用户名输入信息，接着又清空输入框的信息。

这时候可以将用户名里的邮箱改成任意的中文，可以执行下脚本看下中文能不能被成功输入。可以发现中文是没办法被成功输入的，要输入中文还需要在setUp里添加一个capability信息，如下：

      capabilities.setCapability("unicodeKeyboard",true);

完整代码如下：

package appium.chapter2;

import io.appium.java_client.AppiumDriver;
import io.appium.java_client.android.AndroidDriver;
import org.openqa.selenium.By;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.remote.DesiredCapabilities;
import org.testng.annotations.AfterMethod;
import org.testng.annotations.BeforeMethod;
import org.testng.annotations.Test;

import java.io.File;
import java.net.URL;

public class EditText {

    private AppiumDriver<WebElement> driver;

    @BeforeMethod
    public void setUp() throws Exception {
        //构造被测试应用的路径
        File app = new File(System.getProperty("user.dir"), "AUT/osc.apk");
        //实例化DesiredCapabilities
        DesiredCapabilities capabilities = new DesiredCapabilities();
        //deviceName的值可以任意指定
        capabilities.setCapability("deviceName","My Device");
        //设置被测应用的绝对路径
        capabilities.setCapability("app", app.getAbsolutePath());
        capabilities.setCapability("appPackage","net.oschina.app");
        //设置启动类的信息，这个信息可以通过aapt dump bading apkname来获得
        capabilities.setCapability("appActivity", ".AppStart");
        //通过添加如下设置来支持中文输入
        capabilities.setCapability("unicodeKeyboard",true);
        //初始化AppiumDriver
        driver = new AndroidDriver<WebElement>(new URL("http://127.0.0.1:4723/wd/hub"), capabilities);
    }

    @Test
    public void testName() throws Exception {
        Thread.sleep(3000);
        //点击底部"我的"tab页
        driver.findElement(By.id("net.oschina.app:id/nav_item_me")).click();
        //点击我的登录按钮
        driver.findElement(By.id("net.oschina.app:id/iv_portrait")).click();
        //通过ID定位到输入框控件
        WebElement name = driver.findElement(By.id("net.oschina.app:id/et_username"));
        //输入文本
        name.sendKeys("世界你好！");
        Thread.sleep(3000);
        //清空输入框
        name.clear();
    }

    @AfterMethod
    public void tearDown() throws Exception {
        driver.quit();
    }
}

执行下上面的脚本可以发现中文被成功输入了，这里要注意下添加了unicodeKeyboard会往手机或者模拟器安装一个输入法，然后将设置的输入法设置为这个新安装的输入法，如果你手动要往输入框输入的话会发现输入不了，需要去手机输入法里更改下默认的输入法为其他的输入法。