appium driver 方法总结

小鱼儿 2022-06-13 06:11 256阅读 0赞

<table> 
 <thead> 
  <tr> 
   <th>关键字</th> 
   <th align="center">描述</th> 
   <th align="right">实例</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>automationName</td> 
   <td align="center">你想使用的自动化测试引擎</td> 
   <td align="right">Appium (默认) 或 Selendroid</td> 
  </tr> 
  <tr> 
   <td>platformName</td> 
   <td align="center">你要测试的手机操作系统</td> 
   <td align="right">iOS, Android, 或 FirefoxOS</td> 
  </tr> 
  <tr> 
   <td>platformVersion</td> 
   <td align="center">手机操作系统版本</td> 
   <td align="right">例如： 7.1, 4.4</td> 
  </tr> 
  <tr> 
   <td>deviceName</td> 
   <td align="center">使用的手机类型或模拟器类型</td> 
   <td align="right">iPhone Simulator, iPad Simulator, iPhone Retina 4-inch, Android Emulator, Galaxy S4, 等。在 iOS 上，这个关键字的值必须是使用 instruments -s devices得到的可使用的设备名称之一。在 Android 上，这个关键字目前不起作用。</td> 
  </tr> 
  <tr> 
   <td>app</td> 
   <td align="center">.ipa or .apk文件所在的本地绝对路径或者远程路径,也可以是一个包括两者之一的.zip。 Appium会先尝试安装路径对应的应用在适当的真机或模拟器上。针对Android系统，如果你指定app-package和app-activity(具体见下面)的话，那么就可以不指定app。 会与browserName 冲突</td> 
   <td align="right">比如/abs/path/to/my.apk或<a href="http://myapp.com/app.ipa" rel="nofollow">http://myapp.com/app.ipa</a></td> 
  </tr> 
  <tr> 
   <td>browserName</td> 
   <td align="center">需要进行自动化测试的手机 web 浏览器名称。如果是对应用进行自动化测试，这个关键字的值应为空。</td> 
   <td align="right">iOS 系统上可以用 ‘Safari’ ，Android 系统上可以用 ‘Chrome’, ‘Chromium’, 或 ‘Browser’。</td> 
  </tr> 
  <tr> 
   <td>newCommandTimeout</td> 
   <td align="center">设置命令超时时间，单位：秒。达到超时时间仍未接收到新的命令时 Appium 会假设客户端退出然后自动结束会话。</td> 
   <td align="right">比如 60</td> 
  </tr> 
  <tr> 
   <td>autoLaunch</td> 
   <td align="center">Appium是否需要自动安装和启动应用。</td> 
   <td align="right">默认值true true, false</td> 
  </tr> 
  <tr> 
   <td>language</td> 
   <td align="center">(Sim/Emu-only) 设定模拟器 ( simulator / emulator ) 的语言。</td> 
   <td align="right">如： fr</td> 
  </tr> 
  <tr> 
   <td>locale</td> 
   <td align="center">(Sim/Emu-only) 设定模拟器 ( simulator / emulator ) 的区域设置。</td> 
   <td align="right">如： fr_CA</td> 
  </tr> 
  <tr> 
   <td>udid</td> 
   <td align="center">连接的物理设备的唯一设备标识</td> 
   <td align="right">如： 1ae203187fc012g</td> 
  </tr> 
  <tr> 
   <td>orientation</td> 
   <td align="center">(Sim/Emu-only) 在一个设定的方向模式中开始测试 LANDSCAPE (横向) 或 PORTRAIT (纵向)</td> 
   <td align="right"></td> 
  </tr> 
  <tr> 
   <td>autoWebview</td> 
   <td align="center">直接转换到 WebView 上下文。</td> 
   <td align="right">默认值 false、 true, false</td> 
  </tr> 
  <tr> 
   <td>noReset</td> 
   <td align="center">不要在会话前重置应用状态。</td> 
   <td align="right">默认值false。 true, false</td> 
  </tr> 
  <tr> 
   <td>fullReset</td> 
   <td align="center">(iOS) 删除整个模拟器目录。</td> 
   <td align="right">(Android) 通过卸载——而不是清空数据——来重置应用状态。在 Android 上，这也会在会话结束后自动清除被测应用。默认值 false true, false</td> 
  </tr> 
  <tr> 
   <td>appActivity</td> 
   <td align="center">你要从你的应用包中启动的 Android Activity 名称。</td> 
   <td align="right">它通常需要在前面添加 . (如：使用.MainActivity 而不是 MainActivity) MainActivity, .Settings</td> 
  </tr> 
  <tr> 
   <td>appPackage</td> 
   <td align="center">你想运行的Android应用的包名</td> 
   <td align="right">比如com.example.android.myApp, com.android.settings</td> 
  </tr> 
 </tbody> 
</table>

|||

**屏幕滑动-swipe**  
Swipe的方法包括五个参数起始点的坐标，终点的坐标，以及移动的时长  
Driver.swipe（x,y,a,b,l）  
一般可以通过屏幕的相对位置去获得。

driver.manage().window().getSize().获得当前机的长宽
    width=driver.manage().window().getSize().width;
    height= driver.manage().window().getSize().height;
    上滑1/4
    Driver.swipe(w/2, h/3*2, w/2, h/3*1, 0)
    上滑1/2
    driver.swipe(w/2, h/3*1, w/2, h/3*2, 0);
    左滑1/2
    driver.swipe(w/4*3, h/2, w/4*1, h/2, 0);
    右滑1/2
    driver.swipe(w/4*1, h/2, w/4*3, h/2, 0);

屏幕点击 tap  
模拟手指多指点击，最多可支持5指,使用手机设置中开发人员选项中，显示指针，可快速定位

Driver.Tap([876,1560],[1550,1780],3000)

1，启动Android 设备：  
//启动

//   set up appium  
    //   File classpathRoot = new File(System.getProperty("user.dir")); 
    //   File appDir = new File(classpathRoot, "apps"); 
    //   File app = new File(appDir, "ContactManager.apk"); 
       DesiredCapabilities capabilities = new DesiredCapabilities(); 
           capabilities.setCapability("device","Android");
    //       capabilities.setCapability(CapabilityType.BROWSER_NAME, "");
           capabilities.setCapability("deviceName", "xiaomi-mi_3-02214788");//小米
    //       capabilities.setCapability("deviceName", "52c7c049");//三星
    //       capabilities.setCapability("deviceName", "614ad249");//红米
           capabilities.setCapability("platformVersion", "4.4.4"); 
           capabilities.setCapability("platformName", "Android"); 
    //       capabilities.setCapability("app", app.getAbsolutePath());
           capabilities.setCapability("appPackage", "com.tencent.mm"); 
           capabilities.setCapability("appActivity", "com.tencent.mm.ui.LauncherUI"); 
           capabilities.setCapability("unicodeKeyboard", "True"); 
           capabilities.setCapability("resetKeyboard", "True"); 
           driver = new AndroidDriver(new URL("http://127.0.0.1:4723/wd/hub"), capabilities);

启动IOS设备：

DesiredCapabilities capabilities = new DesiredCapabilities();
    //capabilities.setCapability(CapabilityType.BROWSER_NAME, "ios");
    capabilities.setCapability(CapabilityType.VERSION, "8.1");
    capabilities.setCapability(CapabilityType.PLATFORM, "Mac");
    //capabilities.setCapability("device", "iPhone Simulator");
    //capabilities.setCapability("app", "safai");
    capabilities.setCapability("deviceName", "pohoto");
         capabilities.setCapability("platformName", "ios");
    driver = new RemoteWebDriver(new URL("http://0.0.0.0:4723/wd/hub"), capabilities);
    
    注：Appium内还需要配置一些东西，UDID/BundleID/Force Driver
    
    ________________________________________
    寻找元素超时时间：
    driver.manage().timeouts().implicitlyWait(10,TimeUnit.SECONDS);
    ________________________________________
    打印整个页面的元素：System.out.print(driver.getPageSource());
    ________________________________________
    获取当前时间并截图，命名：
    public static String getScreen(){
    String fileRoute="//liyu/testing/test/";
    SimpleDateFormat df = new SimpleDateFormat("yyyy-MM-dd-HH-mm");
    String picname=fileRoute+df.format(new Date()).toString()+".png";
    //picname=picname.replaceAll(":", "-");
    //picname=picname.replaceAll(" ", "-");
           File screen = driver.getScreenshotAs(OutputType.FILE);
           System.out.println(picname);
           File screenFile = new File(picname);
           try {
               FileUtils.copyFile(screen, screenFile); 
               String time=df.format(new Date()).toString();
               System.out.println("当前时间"+time);
               return time;
           } catch (IOException e) {
               e.printStackTrace();
           }
    return null;
    
    }
    ________________________________________
    发送邮件：HTML/TXT（要把图片放到IIS路径拼接url）
    
    
    public void mail() {
    String value2="微信**系统: 本次**时间："+getScreen();
    String Value="<img src=\"http://172.17.6.134:88/test/"+getScreen()+".png\">";
    System.out.print(Value);
    String smtpHost ="172.17.1.23";
    String from = "liyu@yiguo.com";
    String to = "liyu@yiguo.com";
    String subject = value2; //subject javamail自动转码
    StringBuffer theMessage = new StringBuffer();
    theMessage.append("<h2><font color=red>**截图乳腺：</font></h2>");
    theMessage.append("<hr>");
    theMessage.append(Value);
    try {
    Mail.sendMessage(smtpHost, from, to, subject, theMessage.toString());
    }
    catch (javax.mail.MessagingException exc) {
    exc.printStackTrace();
    }
    catch (java.io.UnsupportedEncodingException exc) {
    exc.printStackTrace();
    }
    }
    public static void sendMessage(String smtpHost,String from, String to, String subject, String messageText)throws MessagingException,java.io.UnsupportedEncodingException
    {
    // Step : Configure the mail session
    System.out.println("Configuring mail session for: " + smtpHost);
    java.util.Properties props = new java.util.Properties();
    props.setProperty("mail.smtp.auth", "true");//指定是否需要SMTP验证
    props.setProperty("mail.smtp.host", smtpHost);//指定SMTP服务器
    props.put("mail.transport.protocol", "smtp");
    Session mailSession = Session.getDefaultInstance(props);
    mailSession.setDebug(true);//是否在控制台显示debug信息
    // Step : Construct the message
    System.out.println("Constructing message - from=" + from + " to=" + to);
    InternetAddress fromAddress = new InternetAddress(from);
    InternetAddress toAddress = new InternetAddress(to);
    MimeMessage testMessage = new MimeMessage(mailSession);
    testMessage.setFrom(fromAddress);
    testMessage.addRecipient(javax.mail.Message.RecipientType.TO, toAddress);
    testMessage.setSentDate(new java.util.Date());
    testMessage.setSubject(MimeUtility.encodeText(subject,"gb2312","B"));
    testMessage.setContent(messageText, "text/html;charset=gb2312");
    System.out.println("Message constructed");
    // Step : Now send the message
    Transport transport = mailSession.getTransport("smtp");
    transport.connect(smtpHost, "liyu@yiguo.com", "5201314");
    transport.sendMessage(testMessage, testMessage.getAllRecipients());
    transport.close();
    System.out.println("Message sent!");
    }
    
    
    
    ________________________________________
    APP内上滑：driver.swipe(250, 300, 250, 1400, 0); 
    APP内下滑：     driver.swipe(250,1400, 250,300 , 0); 
    
    ________________________________________
    //driver.navigate().forward(); // 前进
    //driver.navigate().back(); // 后退
    driver.navigate().refresh(); // 刷新
    ________________________________________
    String 字符串截取转成int：
    String getScreen="2015-02-05-16-44";
    String Value="2015-02-05-16-49";
    // int index= getScreen.substring(13, 1);
        String getScreen1 = getScreen.substring(14, 16);
        String  Value2 = Value.substring(14, 16);
    System.out.print(getScreen1);
    System.out.print(Value2);
        Integer.parseInt(getScreen1);
        Integer.parseInt(Value2);    
    int sum =Integer.parseInt(Value2) -Integer.parseInt(getScreen1); 
    System.out.print(sum);
    
    ________________________________________
     动作Action：
    
    /*** * 切换WEB页面查找元素 */
    public static void switchtoWeb(){
    try {
         Set<String> contextNames = demotestcase.driver.getContextHandles();
         for (String contextName : contextNames) {
           // 用于返回被测app是NATIVE_APP还是WEBVIEW，如果两者都有就是混合型App
           if(contextName.contains("WEBVIEW")||contextName.contains("webview")){
           demotestcase.driver.context(contextName);
           System.out.println("跳转到web页 开始操作web页面"); 
           }
         }
    }catch (Exception e) {
         e.printStackTrace();
    }
    }
    /*** * 截图 文件名: 内容-年月日时分秒 */
    public static String getScreen(String name){
    SimpleDateFormat df = new SimpleDateFormat("yyyy-MM-dd-HH-mm-ss");
    String picname=finalElement.phoneScreens+name+df.format(new Date()).toString()+".png";
            File screen = demotestcase.driver.getScreenshotAs(OutputType.FILE);
            System.out.println(picname);
            File screenFile = new File(picname);
            try {
                FileUtils.copyFile(screen, screenFile); 
            } catch (IOException e) {
                e.printStackTrace();
            }
            return picname;
    }
    
    /*** * 检查网络 * @return 是否正常 */
    public static boolean checkNet(){
    String text=demotestcase.driver.getNetworkConnection().toString();
    if(text.contains("Data: true"))
    return true;
    else
    return false;
    }
    
    /*** * 根据UIautomator底层方法得到对应desc的view * @param desc名 * @return View */
    public static WebElement getViewbyUidesc(String name){
    return demotestcase.driver.findElementByAndroidUIAutomator("new UiSelector().descriptionContains(\""+name+"\")");
    }
    /*** * 根据UIautomator底层方法得到对应text的view * @param text名 * @return View */
    public static WebElement getViewbyUitext(String name){
    return demotestcase.driver.findElementByAndroidUIAutomator("new UiSelector().textContains(\""+name+"\")");
    }
    /*** * 绝对坐标 传入长宽的像素点 * @param 宽度从左到右的像素点 * @param 长度从上到下的像素点 */
    public static void clickScreen(int i,int j){
    int x=demotestcase.driver.manage().window().getSize().width;
    int y=demotestcase.driver.manage().window().getSize().height;
    demotestcase.driver.tap(1, i, j, 200);
    }
    /*** *** 相对坐标 传入长宽的百分比 * @param 宽度从左到右的百分比 * @param 长度从上到下的百分比** */
    public static void clickScreen100(int i,int j){
    int x=demotestcase.driver.manage().window().getSize().width;
    int y=demotestcase.driver.manage().window().getSize().height;
    demotestcase.driver.tap(1, x*i/100, y*j/100, 200);
    }
    /*** * log记录 * @param 图片保存路径 * @param Exception参数 * @param AssertionError参数 * @param 测试用例名 */
    public static void getlog(String text, Exception error, AssertionError assertError, String testname){
    SimpleDateFormat df = new SimpleDateFormat("MM-dd-HH-mm");
    System.out.println("当前时间"+df.format(new Date()));
    String filename=finalElement.errorfile+testname+"-"+df.format(new Date()).toString()+".txt";
    File file=new File(finalElement.errorfile);
    if(!file.exists())
    file.mkdirs();
    try {
       File f = new File(filename);
       if (!f.exists()) 
       f.createNewFile();
    FileWriter fw = new FileWriter(f, true);
    PrintWriter pw = new PrintWriter(fw);
    pw.append(testname+" 测试failed\r\n");
    pw.append("截图保存为:"+text+"\r\n");
    try{
    pw.append("eclipse报错为:\n"+error.toString()+"\r\n");
    error.printStackTrace(pw);
    } catch (Exception e){}
    try{
    pw.append("断言报错为:"+assertError.toString()+"\r\n");
    assertError.printStackTrace(pw);
    } catch (Exception e){}  
    pw.flush();
    pw.close();
    file=new File(finalElement.errorlog);
    if(!file.exists())
    file.mkdirs();
    String cmd="cmd /c \"adb logcat -d *:E *:S |grep \"com.yiguo.app\" >"+finalElement.errorlog+testname+"-"+df.format(new Date()).toString()+".txt\"";
    //System.out.println(cmd);
    Runtime.getRuntime().exec(cmd);
    } catch (Exception e) {
    e.printStackTrace();
    }
    }
    
    ________________________________________
    直接文本点击：
    driver.findElementByAndroidUIAutomator("new UiSelector().textContains(\"发现\")").click();
    
       driver.findElementByAndroidUIAutomator("new UiSelector().textContains(\"朋友圈\")").click();