Appium 包结构

• 运行时的基本检查
• 节点版本（>= 4）
• CLI 参数检查
  • 包含所有可用和支持的CLI参数
  • 检是否有冲突和弃用
• 统一存放日志
• 统一存放npmlog, winston和appium-logger
• 启动AppiumDriver（继承Basedriver）
• 为iOS/Android/Selendroid/Fake Driver 建立会话
• 创建/删除Appium会话
• 启动baseServer (appium-express)
• 通过驱动给出的路径

appium-express (部分appium basedriver)

• 启动express server（允许x-domain-origin）
• 从AppiumDriver初始化
• 超时处理
• 提供一个用于测试的静态页面
• 将req/res事件记入日志

mobile-json-wire-protocol (部分appium basedriver)

• 提供了Appium命令列表
• 通过协议的驱动子类 -客户端和驱动程序之间的中间件
• 处理驱动程序的jwp代理
• 包含所有类型错误的错误类
• 消除错误响应
• 将参数封装/解封到命令中
• 检查所需参数，验证参数

appium basedriver

• 每个实例化都有一个单独的测试会话
• 包含对caps的约束 （platformName必须存在等）
• 验证功能
• 运行具有单个并发性的命令
• 处理会话重启
• 处理滑动选项
• DeviceSettings负责设备的get/update管理
• 包含基本命令
• 找到元素
• 创建/删除会话
• 处理超时
• 设备的set/update设置
• 为命令提供帮助方法

appiium iosdriver

• 也可以作为独立服务器运行（从appium-express继承了小部分服务）
• 支持的策略：“name”，“xpath”，“id”，“-ios uiautomation”，“class name”，“accessibility id”
• 可以启动一个模拟器或一个真实的设备（需要标明udid）
• 每个类型的说明
  • removeInstrumentsSocket
  • setBundleIdFromApp
  • createInstruments
  • runSimReset, isolateSimDevice, setLocale || runRealDeviceReset
  • setPreferences || runRealDeviceReset
  • startLogCapture
  • prelaunchSimulator || (noop)
  • startInstruments
  • onInstrumentsLaunch
  • configureBootstrap
  • setBundleId
  • setInitialOrientation
  • initAutoWebview
  • waitForAppLaunched
• 所有帮助说明都在driver.js中
• 包含一组更具体的功能约束
• 有使用appium-xcode构建和运行Safari（safari-launcher）的逻辑
• 实现iOSdriver的命令
• Selenium命令被编译为ui-automator命令
• 命令将会发送到uiAutoClient（appium-uiauto）
• 连接到appium远程调试器

appium-xcode

• 运行shell命令从Xcode返回有用的数据，比如
• getPath
• getVersion
• getAutomationTraceTemplatePath
• getMaxIOSSDK
• …
• 内置自动重试

appium-uiauto

• 封装 iOS UI Automation 框架的
• 通过socket连接进行通信
• 运行由sendCommand函数填充的命令队列
• 处理来自ui-automation的响应（作为缓冲区）
• 使用osascript旋转屏幕截图
• 提供bootstrap simulator/realdevice (dynamic-bootstrap)的方法
• 在iOS UI自动化上下文（非节点）中运行的JavaScript文件
• 负责执行实际的iOS UI Automation命令
• 参考 UIAutomation docs
• 命令流程就像
  • Webdriver 命令-> iOS driver 命令 -> uiauto-命令

appium-instruments

• 封装运行instruments的命令
• 很多exec调用与instruments二进制义互
• 所有这些都采取回调来获取结果
• 必须使用“iwd”包编译软件包
• 特殊的Instruments包不存在命令延迟 - 还包含较旧版本的iwd instrument（v4 - v7）

appium-ios日志

• 捕获iOS模拟器或实际设备的控制台，性能和崩溃日志
• 通过调用tail来从系统路径获取日志（模拟器设备）
• 或通过调用deviceconsole（实际设备）
• 使用远程调试器来抓取性能日志
• 崩溃日志保留在系统上的“.crash”文件中

appium-iOS-模拟器

• 封装iOS模拟器应用程序
• 启动和关闭（杀死所有）模拟器
• 更新设置和本地
• 更新/清除 safari
• 获取有关模拟器设备的元数据
• 使用simctl与模拟器通信
• 适用于Xcode 6和7

node-simctl

• 封装simctl二进制（cli实用程序来控制iOS模拟器）
• 作为xcrun的子命令执行（从命令行查找或调用开发人员工具）
• 包含功能
• 安装/删除应用程序
• 启动和关闭模拟器
• 创建/清除/删除设备
• 获取设备列表

appium-cookies

• 简单的包来创建和接收cookie
• 在appium-iosdriver中使用，以在Web上下文中实现jswonwire cookie命令

appium-chromedriver

• 封装 chromedriver
• 下载并安装chromedriver二进制文件
• 启动，重新启动并停止（或杀死所有）chrome实例
• 使用appium-jsonwp-proxy向驱动程序发送json wire protocol命令

jsonwp-proxy (部分appium basedriver)

• 允许将json wire协议命令发送到了解它的服务器（浏览器驱动程序）
• 解析json的响应
• 允许代理服务器的请求
• 用于在Chromium-Chromedriver和appium-selendroiddriver中进行通信

appium-androiddriver

• 类似于appium-iosdriver，它可以作为独立服务运行
• 自动化模拟器和实际设备上的本地，混合和移动Web应用程序
• 负责安装Android软件包到设备
• 如果需要，运行chromedriver会话
• 包含一组更具体的功能约束
• 使用appium-adb与emulator/simulator/realdevice进行交互
• 和appium-android-bootstrap来执行实际的命令
• 包含帮忙找出哪个网页视图属于哪个应用程序包，反之亦然

appium-adb

• 封装 Android Debug Bridge（adb）
• 包含一些基本的rpc到adb二进制的命令
• 容纳jar文件来运行特殊用例，例如签名，验证应用程序或移动清单
• 允许与webdriver协议无关的特殊（移动专用）模拟器命令
• 锁定屏幕
• 按返回按钮
• 按home按钮
• 设置/获取飞行模式
• 设置/获取wifi状态
• 捕获logcat
• 处理模拟器/模拟器动作（例如重启）

appium-androidbootstrap

• JavaScript界面​​和Java代码，用于与Android UI Automator进行交互
• 构建包含执行命令的逻辑的AppiumBootstrap.jar
• 对应的 iOS 上的 appium-uiauto
• 一旦启动，就会创建一个到设备的web scoket连接
• 应用程序提供启动/关闭/发送命令接口
• 命令流程如下：
• Selenium 命令 - > appium-adb - > appium-androidbootstrap - > 使用Android UI Automator 框架的 Java 代码

appium-uiautomator

• 启动和关闭uiautomator服务器由appium-android-bootstrap jar建立
• 命令流程就像
• appium-android-bootstrap:start -> appium-uiautomator:start -> appium-adb:install bootstrap

appium-selendroiddriver

• 类似于appium-androiddriver，它可以作为独立服务运行
• 使用appium-selendroid-installer下载并安装Selendroid
• 包含几个Selendroid特定的逻辑，以确保无缝集成
• 包含一组更具体的功能约束
• 使用jsonwp-proxy与服务器交互
• 使用appium-adb启用在Selendroid中未实现的命令

appium-selendroid 安装程序

• 包含并导出设置逻辑
• 下载Selendroid
• 确定AndroidManifest的位置
• 确定Server APK的位置
• 提取这两个文件
• 复制和清理文件

appium-android-ime

• 允许从 Android 设备发送和接收 unicode 字符
• 将文本编码为UTF-7将其发送到设备并将其重新编码为 Unicode
• 由 appium-androiddriver 和 appium-selendroiddriver 使用

appium-doctor

• 在启动Appium之前诊断，报告和修复常见的Node，iOS和Android配置问题
• 暴露cli命令“appium-doctor”
• 它检查
• Android:
  • android sdk存在并正确配置
  • env变量和路径检查
• iOS:
  • 安装了xcode（使用命令行工具）
  • 开发工具安全检查
  • auth检查
  • nodejs 检查

appium-gulp-plugins

• 具有定制插件的开发包使用交叉应用模块（仅适用于Appium开发）
• 包含任务
• e2e和单元测试（覆盖率报告）
• 将ES2016 转换成 ES5
• 静态代码分析（jshint）
• 开发人员的任务

appium-remote-debugger

• RPC客户端将Appium连接到iOS网页浏览
• 可以连接到WebKit devtools
• 仅适用于iOS
• 有两个rpc客户端类
• remote-debugger-rpc-client：使用连接到localhost的tcp6：27753
• webkit-rpc-client：使用WebSockets连接到ws：// localhost：27753 / devtools / page / $ {pageId}

node-teen_process

• 助手模块暴露：
• exec：在引擎盖下使用spawn的exec的ES7（async / await）实现
• SubProcess：在使用spawn时减少样板（特别是在async / await上下文中使用时）

appium 日志

• 运行时，日志器默认为 npmlog，
• 暴露了几乎所有的Appium软件包使用的getLogger函数
• 如果有一个已经运行的记录器，那么所有的东西都会记录

appium-support

• 用于支持跨应用程序包的库的实用程序函数。
• 为一些常见的操作提供封装，如
• 系统方法（isWindows，isLinux ...）
• 实用程序方法，如hasValue，escapeSpace
• 一堆fs方法
• plist帮助解析和更新plist文件

本文由 校长 翻译，由 lihuazhang 校验。