Appium服务器端从启动到case完成的活动分析

此文的目的主要是通过分析Appium Server打印出来的log，加深对Appium Server所扮演角色的理解。

这整一个过程是由一个Test Case开始执行到结束，测试的对象是SDK自带的NotePad.apk。 Test Case很简单：打开Notepad程序，然后点击安卓的Menu Options按钮调出“Add Note”菜单按钮，然后点击该按钮，然后完成测试。

1. package majcit.com.AppiumDemo;
2. import io.appium.java_client.AppiumDriver;
3. import java.io.File;
4. import java.net.URL;
5. import java.util.List;
6. import org.junit.Test;
7. import org.junit.After;
8. import org.junit.Before;
9. import org.openqa.selenium.By;
10. import org.openqa.selenium.WebElement;
11. import org.openqa.selenium.remote.CapabilityType;
12. import org.openqa.selenium.remote.DesiredCapabilities;
13. import org.openqa.selenium.remote.RemoteWebDriver;
14. import org.openqa.selenium.*;
15. import static org.hamcrest.Matchers.*;
16. import static org.hamcrest.MatcherAssert.assertThat;
17. /**
18. * Unit test for simple App.
19. */
20. public class NoetPadTest {
21. /**
22. * Create the test case
23. *
24. * @param testName name of the test case
25. */
26. private AppiumDriver driver;
27. @Before
28. public void setUp() throws Exception {
29. // set up appium
30. File classpathRoot = new File(System.getProperty("user.dir"));
31. File appDir = new File(classpathRoot, "apps");
32. File app = new File(appDir, "NotePad.apk");
33. DesiredCapabilities capabilities = new DesiredCapabilities();
34. capabilities.setCapability("deviceName","iPad Simulator");
35. //capabilities.setCapability("platformVersion", "4.2");
36. capabilities.setCapability("platformName", "Android");
37. capabilities.setCapability("app", app.getAbsolutePath());
38. //capabilities.setCapability("appPackage", "com.example.android.notepad");
39. //capabilities.setCapability("appActivity", "com.example.android.notepad.NotesList");
40. //capabilities.setCapability("appActivity", ".NotesList");
41. driver = new AppiumDriver(new URL("http://127.0.0.1:4723/wd/hub"), capabilities);
42. }
43. @After
44. public void tearDown() throws Exception {
45. driver.quit();
46. }
47. @Test
48. public void addContact() throws InterruptedException{
49. driver.sendKeyEvent(82);
50. try {
51. Thread.sleep(3000);
52. }catch(Exception e) {
53. System.out.println(e.getMessage());
54. }
55. WebElement el = driver.findElement(By.name("Add note"));
56. el.click();
57. try {
58. Thread.sleep(60000);
59. }catch(Exception e) {
60. System.out.println(e.getMessage());
61. }
62. }
63. }

下面我们就通过分析Log把Appium Server所做的事情分步骤描述一下。

1. 启动REST http服务器，默认监听本地4723端口，用于接收客户端（Test Case+Selenium/Appium Driver)发过来的JSON格式的命令指示。

2. 根据客户端提供的capabilities指示建立一个Android Sesision用于跟客户端保持后续通信

3. 通过”adb devices“命令检查安卓手机是否已经准备好

4.使用工具“aapt dump badging NotePad.apk"来获得Notepad的packageName和launchable activityName，注意示例代码中是没有指定这个两个capabilities的

5. 安卓手机shell调用命令获得机器的API Level是否已经超过16："adb.exe -s HT21atd05099 shell getprop ro.build.version.sdk"

6. 通过adb执行相应的shell命令检查目标应用是否已经存在：“pm list packages -3 com.example.android.notepad"

7. 目标机器上清理目标应用运行环境：该停止就停止该清空数据就清空数据

8. 建立Appium Server到目标机器上的端口转发

9. 把AppiumBootStrap.apk push到目标设备：这是目标机器上通过uiautomator工具（框架）运行的服务端，用于接受处理client端发送过来的命令

10. 把settings_apk-debuug.apk和unlock_apk-debug.apk push到目标设别：TBD

11. 保证uiautomator没有已经在跑

12. 通过adb把目标机器上的AppiumBootStrap跑起来："uiautomator runtest AppiumBootstrap.jar -c io.appium.android.bootstrap.Rootstrap".

13.通过adb在目标机器上 Launch notepad应用

14. 通知PC端目标应用已经在目标机器启动成功

15. 处理客户端发过来的”按下系统菜单“的命令：bootstrap把接受到的命令入队列，执行完成后通知客户端执行结果

16.定位”Add Note“菜单按钮：Bootstrap通过的UIAutomator的UISelector类根据Text获得菜单按钮的ID并返回给客户端

17. BootStrap执行”点击 Add Note菜单"命令

18. 测试完成，目标机器模拟点击Home按钮把目标应用放在后台

19. 关闭logcat

20. 关闭Uiautomator进程