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

时间：2023-03-08 17:38:10

此文的目的主要是通过分析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所做的事情分步骤描述一下。
Appium服务器端从启动到case完成的活动分析

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"

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

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".

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

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

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

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

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

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

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

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

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

19. 关闭logcat

20. 关闭Uiautomator进程