Appium学习日记（三）——Windows系统测试桌面应用

Appium学习日记（三）——Windows系统测试桌面应用

一、环境搭建

1-1、WinAppDriver环境搭建

（1）开启开发者选项中的“开发人员模式”

（2）Windows sdk下载安装
  下载地址：https://developer.microsoft.com/en-us/windows/downloads/windows-10-sdk/

  正常安装就行。
（3）winAppDriver下载
  下载地址：https://github.com/microsoft/WinAppDriver/releases
  任选一个版本，打开如下图，接着根据需求选择合适自己的安装包下载即可。

  下载完成后，一键安装即可。

二、使用Appium连接WinAppDriver

2-1、启动WinAppDriver

  默认安装路径为：C:\Program Files\Windows Application Driver。点击WinAppDriver.exe。

2-2、启动Appium

（1）用管理员的方式打开Appium，设置端口和主机地址，点击“startServer”。


（2）最新的Appium Inspector已经和Appium剥离开了，去官网单独下载一个Appium Inspector。解压后直接用管理员的方式点击使用

（3）介绍一下DesiredCapabilities
  DesiredCapabilities 携带了一些配置信息，在启动session的时候是必须提供，如启动模式、apk/app配置、package/activity配置、浏览器配置、键盘配置等。

（4）设置好相关的DesiredCapabilities后，点击Start Session；如下图所示：

2-3、元素定位

注意： 每一个方法对应着一个findElementsBy***方法，后者返回一个Element集合List，表示一个符合查找规则的一个Element集合。

findElementByName
  在Android中，没有合适的方法可以找到控件的Name属性，但是大多数情况下可以用控件的text代替name。

findElementByAndroidUIAutomator
  使用UI Automator查找控件

WebElement el = driver.findElementByAndroidUIAutomator("new UiSelector().text(\"Add note\")");
1

findElementByClassName

WebElement el = driver.findElementByClassName("android.weight.TextView");
1

findElementById

WebElement el = driver.findElementById("android:id/title");
1

  如果目标设备的API Level低于18则UIAutomatorViewer不能获得对应的Resource ID，只有等于大于18的时候才能使用。

findElementByAccessibilityId

WebElement el = driver.findElementByAccessibilityId("menu_add_note_description");
1

  Accessibility ID在Android上面就等同于contentDescription

findEelementByXPath

WebElement el = driver.findElementByXPath("//android.widget.TextView[contains(@text,'Add note')]");  
1

  xPath是一种路径，在uiautomatorviewer中可以查看当前页面的元素层级，XPath就是用来描述这种层级关系的一种路径表达方式，

findElementByCssSelector
  这个方法是针对WebView容器下面的控件定位的，因为现在针对的是Native App暂时还没有用到，所以先标记下，今后需要的时候加上去。

findElementByLinkText
  这个方法是针对WebView容器下面的控件定位的，因为现在针对的是Native App暂时还没有用到，所以先标记下，今后需要的时候加上去。

findElementByPartialLinkText
  这个方法是针对WebView容器下面的控件定位的，因为现在针对的是Native App暂时还没有用到，所以先标记下，今后需要的时候加上去。

UI Automater定位元素

  UI Automator中主要通过UISelector类查找元素
通过文本信息定位

通过description定位

通过ResourceId定位

通过类名定位

通过层级关系

使用JUnit组织测试用例
  使用JUnit来组织Appium测试用例，可以添加@Before、@Test或者@After等注解来使测试代码的运行变得更加灵活。

  比如在开始测试之前，需要配置Capability和连接Appium服务器，而且一般需要安装应用或者打开应用的某个Activity。这时候可把这些操作放到一个方法中，并且方法添加@Before注解，则在运行的时候，@Before方法会先于@Test方法执行。

  同理，测试结束后需要关闭session，回收资源等等，可以把这些操作放到一个@After方法中，@After方法在所有@Test方法结束之后执行。

显式等待和隐式等待

  有时候，由于网络或者其他原因，页面跳转之后，某些元素没有立即显示出来，此时查找元素会失败。这种情况就需要引入显式等待和隐式等待。

线程等待
  直接使用Thread.sleep();

隐式等待

driver.manage().timeouts().implicitlyWait(30, TimeUnit.SECONDS);
1

  全局等待30秒，不管元素是否已经加载。

显式等待
  WebDriverWait 显示等待，显示等待时间可以通过 WebDriverWait 和 util 来决定,比如这个timeOut是60，如果该元素60s以内出现就不在等待。

WebDriverWait wait = new WebDriverWait(driver, 60);
    WebElement e= wait.until(new  ExpectedCondition<WebElement>() {
            @Override
            public WebElement apply(WebDriver d) {
                return d.findElement(By.id("q"));
            }
        })
1
2
3
4
5
6
7

  以下为在Visual Studio下的三个例子。

using Microsoft.VisualStudio.TestTools.UnitTesting;
using OpenQA.Selenium.Appium;
using OpenQA.Selenium.Appium.Enums;
using OpenQA.Selenium.Appium.Service;
using OpenQA.Selenium.Appium.Windows;
using System;
using System.Threading;

namespace PSDemoStartApp
{
    [TestClass]
    public class UnitTest1
    {
        [TestMethod]
        public void StartApplication()
        {
            var capabilities = new AppiumOptions();
            capabilities.AddAdditionalCapability(MobileCapabilityType.App, "D:/Program Files/Notepad++/notepad++.exe");
            capabilities.AddAdditionalCapability(MobileCapabilityType.PlatformName, "Windows");
            capabilities.AddAdditionalCapability(MobileCapabilityType.DeviceName, "WindowsPC");

            //start the driver

            var driver = new WindowsDriver<WindowsElement>(new Uri("http://127.0.0.1:4723/wd/hub"), capabilities);

            driver.Close();
            driver.Dispose();
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

using Microsoft.VisualStudio.TestTools.UnitTesting;
using OpenQA.Selenium.Appium;
using OpenQA.Selenium.Appium.Enums;
using OpenQA.Selenium.Appium.Service;
using OpenQA.Selenium.Appium.Windows;
using System;
using System.Threading;

namespace PSDemoStartApp
{
    [TestClass]
    public class UnitTest1
    {
        [TestMethod]
        public void StartApplication()
        {
            var capabilities = new AppiumOptions();
            capabilities.AddAdditionalCapability(MobileCapabilityType.App, "D:/Program Files/Notepad++/notepad++.exe");
            capabilities.AddAdditionalCapability(MobileCapabilityType.PlatformName, "Windows");
            capabilities.AddAdditionalCapability(MobileCapabilityType.DeviceName, "WindowsPC");

            //start the driver

            //var driver = new WindowsDriver(new Uri("http://127.0.0.1:4723/wd/hub"), capabilities);
            var appiumLocalServer = new AppiumServiceBuilder().UsingAnyFreePort().Build();
            appiumLocalServer.Start();
            var driver = new WindowsDriver<WindowsElement>(appiumLocalServer, capabilities);
            Thread.Sleep(2000);
            driver.Close();
            driver.Dispose();
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

using Microsoft.VisualStudio.TestTools.UnitTesting;
using OpenQA.Selenium;
using OpenQA.Selenium.Appium;
using OpenQA.Selenium.Appium.Enums;
using OpenQA.Selenium.Appium.Service;
using OpenQA.Selenium.Appium.Windows;
using System;
using System.Threading;

namespace PSDemoStartApp
{
    [TestClass]
    public class UnitTest1
    {
        [TestMethod]
        public void FindElementTest()
        {
            var driver = StartNTApplication();
            var elementFound = driver.FindElementByName("文件(F)");
            Assert.IsTrue(elementFound.Text == "文件(F)");
            var elementFound2 = driver.FindElement(By.Name("文件(F)"));
            Assert.IsTrue(elementFound.Text == elementFound2.Text);
            driver.CloseApp();
        }
        public WindowsDriver<WindowsElement> StartNTApplication()
        {
            var capabilities = new AppiumOptions();
            capabilities.AddAdditionalCapability(MobileCapabilityType.App, "C:/Windows/System32/notepad.exe");
            capabilities.AddAdditionalCapability(MobileCapabilityType.PlatformName, "Windows");
            capabilities.AddAdditionalCapability(MobileCapabilityType.DeviceName, "WindowsPC");

            //start the driver

            //var driver = new WindowsDriver(new Uri("http://127.0.0.1:4723/wd/hub"), capabilities);
            var appiumLocalServer = new AppiumServiceBuilder().UsingAnyFreePort().Build();
            appiumLocalServer.Start();
            var driver = new WindowsDriver<WindowsElement>(appiumLocalServer, capabilities);
            //Thread.Sleep(2000);
            //driver.Close();
            //driver.Dispose();
            return driver;
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45