基于C#的Appium自动化测试框架（I）：程序结构

悠悠小仙仙

因为工作原因，使用的编程语言都是C#，但是国内相应的Appium资料少得可怜，Java版本的Appium也考虑过，但是奈何自己搞不定Eclipse这个编译环境【说白了就是因为懒……

无意中看到了外面的世界，然后发现国外的相关资料还是很多的，那还说啥？赶紧的，撸起袖子就是干。

前置条件:APPIUM环境搭建，Windows环境下的搭建教程还是很多的，按照教程操作就可以了。

测试环境：Visual Studio 2015+Genymotion模拟器+Custome Phone 6.0.0

源码下载地址：https://github.com/appium/appium-dot-exe

源码下载后先设置VS能自动去下载对应的Nuget包，更新的时候有条件的还是可以挂点什么东西，原因你懂的。更新完对应的Nuget包，该关联的引用也都关联上了，报的错也就自行消失了。

C#下的Appium框架实际上WPF格式的WinForm应用程序，具体的启动过程以及原理可以参考：http://www.cnblogs.com/oscarxie/p/6678142.html，但是这个不是今天的重点

顺带真的想吐槽笔记本小屏幕还要强行追求1920*1080的高分辨率，强行放大字体后截图看起来感觉怪怪的，调低分辨率就是满屏幕的马赛克……

我们先来看一段GitHub上的示范代码，这段代码的功能是设置Appium的相关参数，对Windows自带的计算器功能进行测试，测试结果则是调用了Nunit单元测试中的断言功能进行判断：

1. public class BasicScenarios
   
2.     {
   
3.         protected const string WindowsApplicationDriverUrl = "http://127.0.0.1:4723/wd/hub";
   
4.         protected static RemoteWebDriver CalculatorSession;
   
5.         protected static RemoteWebElement CalculatorResult;
   
6.         protected static string OriginalCalculatorMode;
   
7. 
   
8.         [ClassInitialize]
   
9.         public static void Setup(TestContext context)
   
10.         {
    
11.             // Launch the calculator app
    
12.             DesiredCapabilities appCapabilities = new DesiredCapabilities();
    
13.             appCapabilities.SetCapability("app", "Microsoft.WindowsCalculator_8wekyb3d8bbwe!App");
    
14.             appCapabilities.SetCapability("platformName", "Windows");
    
15.             appCapabilities.SetCapability("deviceName", "WindowsPC");
    
16.             CalculatorSession = new RemoteWebDriver(new Uri(WindowsApplicationDriverUrl), appCapabilities);
    
17.             Assert.IsNotNull(CalculatorSession);
    
18.             CalculatorSession.Manage().Timeouts().ImplicitlyWait(TimeSpan.FromSeconds(2));
    
19. 
    
20.             // Make sure we're in standard mode
    
21.             CalculatorSession.FindElementByXPath("//Button[starts-with(@Name, \"Menu\")]").Click();
    
22.             OriginalCalculatorMode = CalculatorSession.FindElementByXPath("//List[@AutomationId=\"FlyoutNav\"]//ListItem[@IsSelected=\"True\"]").Text;
    
23.             CalculatorSession.FindElementByXPath("//ListItem[@Name=\"Standard Calculator\"]").Click();
    
24. 
    
25.             // Use series of operation to locate the calculator result text element as a workaround
    
26.             // We currently cannot query element by automationId without using modified appium dot net driver
    
27.             // TODO: Use a proper appium/webdriver nuget package that allow us to query based on automationId
    
28.             CalculatorSession.FindElementByXPath("//Button[@Name=\"Clear\"]").Click();
    
29.             CalculatorSession.FindElementByXPath("//Button[@Name=\"Seven\"]").Click();
    
30.             CalculatorResult = CalculatorSession.FindElementByName("Display is  7 ") as RemoteWebElement;
    
31.             Assert.IsNotNull(CalculatorResult);
    
32.         }
    
33. 
    
34.         [ClassCleanup]
    
35.         public static void TearDown()
    
36.         {
    
37.             // Restore original mode before closing down
    
38.             CalculatorSession.FindElementByXPath("//Button[starts-with(@Name, \"Menu\")]").Click();
    
39.             CalculatorSession.FindElementByXPath("//ListItem[@Name=\"" + OriginalCalculatorMode + "\"]").Click();
    
40. 
    
41.             CalculatorResult = null;
    
42.             CalculatorSession.Dispose();
    
43.             CalculatorSession = null;
    
44.         }
    
45. 
    
46.         [TestInitialize]
    
47.         public void Clear()
    
48.         {
    
49.             CalculatorSession.FindElementByName("Clear").Click();
    
50.             Assert.AreEqual("Display is  0 ", CalculatorResult.Text);
    
51.         }
    
52. 
    
53.         [TestMethod]
    
54.         public void Addition()
    
55.         {
    
56.             CalculatorSession.FindElementByName("One").Click();
    
57.             CalculatorSession.FindElementByName("Plus").Click();
    
58.             CalculatorSession.FindElementByName("Seven").Click();
    
59.             CalculatorSession.FindElementByName("Equals").Click();
    
60.             Assert.AreEqual("Display is  8 ", CalculatorResult.Text);
    
61.         }
    
62. }

复制代码

从上面的代码我们可以得出，C#下的Appium可以分为以下三个步骤：

1.实例化DesiredCapabilities类并调用SetCapability方法设置对应的一些参数，对应的参数设置可以参考Java版的设置：

1. appCapabilities.setappCapabilitiesability("automationName", "Appium");//appium做自动化
   
2. //appCapabilities.setappCapabilitiesability("app", "C:\\software\\jrtt.apk");//安装apk
   
3. //appCapabilities.setappCapabilitiesability("browserName", "chrome");//设置HTML5的自动化，打开谷歌浏览器
   
4.         appCapabilities.setappCapabilitiesability("deviceName", "S4");//设备名称
   
5.         appCapabilities.setappCapabilitiesability("platformName", "Android"); //安卓自动化还是IOS自动化
   
6.         appCapabilities.setappCapabilitiesability("platformVersion", "4.4"); //安卓操作系统版本
   
7.         appCapabilities.setappCapabilitiesability("udid", "192.168.56.101:5555"); //设备的udid (adb devices 查看到的)
   
8.         appCapabilities.setappCapabilitiesability("appPackage","com.android.calculator2");//被测app的包名
   
9.         appCapabilities.setappCapabilitiesability("appActivity",".Calculator");//被测app的入口Activity名称
   
10.         appCapabilities.setappCapabilitiesability("unicodeKeyboard", "True"); //支持中文输入
    
11.         appCapabilities.setappCapabilitiesability("resetKeyboard", "True"); //支持中文输入，必须两条都配置
    
12.         appCapabilities.setappCapabilitiesability("noSign", "True"); //不重新签名apk
    
13.         appCapabilities.setappCapabilitiesability("newCommandTimeout", "30");

复制代码

2.设置Appium的服务地址：具体的服务地址是在Appium中进行设置的，同时连接手机，我们把设置好的地址复制过来就可以了。

new RemoteWebDriver(new Uri("http://172.xx.xx.169:4723/wd/hub"), capabilities);

3.调用RemoteWebDriver的类下提供的元素定位方法进行元素定位，并对应为好的元素进行对应的操作：Appium提供了以下定位元素的方法（这里的具体语法和Java相比有点区别，需要注意下）：

1. FindElement(By by);
   
2. FindElementByClassName(string className);
   
3. FindElementByCssSelector(string cssSelector);
   
4. FindElementById(string id);
   
5. FindElementByLinkText(string linkText);
   
6. FindElementByName(string name);
   
7. FindElementByPartialLinkText(string partialLinkText);
   
8. FindElementByTagName(string tagName);
   
9. FindElementByXPath(string xpath);

复制代码

同时，Appium也提供了以下的操作：

1. bool Displayed { get; } //判断元素是否存在
   
2. bool Enabled { get; } //判断元素是否启用
   
3. bool Selected { get; }//判断元素是否被选中
   
4. Size Size { get; }//获取元素的高度和宽度
   
5. string TagName { get; }//获取元素的文本（不含空格）
   
6. string Text { get; }//获取指定属性的值
   
7. void Clear();//清除元素内容
   
8. void Click();//点击
   
9. string GetAttribute(string attributeName);
   
10. string GetCssValue(string propertyName);//获取CSS属性的值
    
11. void SendKeys(string text);//将文本写入元素
    
12. void Submit();//提交此元素到服务器

复制代码

巴黎的灯光下

赞赞，写的太好了，学习了！

悠悠小仙仙

巴黎的灯光下 发表于 2017-6-29 15:33
赞赞，写的太好了，学习了！

谢谢支持！