目录
Appium 理念
Appium是基于以下的四个理念设计来满足移动平台测试自动化的要求的：
1）您不应该因为需要自动化测试您的应用而不得不以任何形式去重新编译或者修改你的app
2）您不应该把自己固定在一门特定的语言和一个特定的框架上去实现和运行你的测试
3）当说到测试自动化APIs的时候，一个移动测试框架不应该做“重新发明轮子”的事情，
4）一个移动测试自动化框架应该是开源的，无论是在精神上，实际上，还是名义上！
使用Appium进行自动化测试有两个好处
Appium在不同平台中使用了标准的自动化APIs，所以在跨平台时，不需要重新编译或者修改自己的应用。
Appium支持Selenium WebDriver支持的所有语言，如java、Object-C、JavaScript、Php、Python、Ruby、C#、Clojure，或者Perl语言，更可以使用Selenium WebDriver的Api。Appium支持任何一种测试框架.Appium实现了真正的跨平台自动化测试。（本文主要介绍Python的用法）
Appium架构
Appium 是一个用Node.js编写的HTTP server，它创建、并管理多个 WebDriver sessions 来和不同平台交互，如 iOS ，Android等等.
Appium 开始一个测试后，就会在被测设备（手机）上启动一个 server ，监听来自 Appium server的指令. 每种平台像 iOS 和Android都有不同的运行、和交互方式。所以Appium会用某个桩程序“侵入”该平台，并接受指令，来完成测试用例的运行
被测试 app：
运行在真实设备或者模拟器中。这个测试系统运行起来交互关系是这样的：测试程序（Test scrip），告诉 Appium Server 要做什么操作。比如要去点击界面的一个元素。怎么告诉 Appium Server ？它们之间有 http 的连接，通过 http 请求发送命令给 Appium Server ，Appium Server 接收到测试程序的命令后，再发出命令给设备上运行的控制程序（这程序由Appium Server注入到设备里面运行），控制程序调用相应自动化库里面的方法去执行界面的控制。
Appium API
# 元素定位
driver.find_element_by_id("id") # id定位
driver.find_element_by_name("name") # name定位
driver.find_element_by_link_text("text") # 链接名定位
driver.find_element_by_partial_link_text("text") # 通过元素部分可见链接文本定位
driver.find_element_by_tag_name("name") # 通过查找html的标签名称定位元素
driver.find_element_by_xpath("xpath") # 路径定位
driver.find_element_by_class_name("android.widget.LinearLayout") # 类名定位
driver.find_element_by_css_selector("css") # css选择器定位
driver.find_element_by_android_uiautomator # uiautomator
# 元素集合复数定位
driver.find_elements_by_id("id") # id元素集合
driver.find_elements_by_name("name") # name元素集合
driver.find_elements_by_link_text("text") # 链接名元素集合
driver.find_elements_by_partial_link_text("text") # 部分元素可见链接集合
driver.find_elements_by_tag_name("name") # html标签名集合
driver.find_elements_by_xpath("xpath") # 路径定位集合
driver.find_elements_by_class_name("android.widget.LinearLayout") # 类名定位集合
driver.find_elements_by_css_selector("css") # css选择器定位集合
# 输入框输入
driver.element.send_keys("中英")
# 锁定屏幕
driver.lock(5)
# 把当前应用置于后台
driver.background_app(5)
# 收起键盘
driver.hide_keyboard()
# 打开一个应用或者activity，仅安卓端
driver.start_activity('com.example.android.apis', '.Foo')
# 打开下拉通知栏 仅Android
driver.open_notifications()
# 拖动元素，将元素origin_el拖到目标元素destination_el
driver.drag_and_drop(self, origin_el, destination_el):
# 检查app是否已安装
driver.is_app_installed('com.example.android.apis')
# 安装应用到设备
driver.install_app('path/to/my.apk')
# 删除应用
driver.remove_app('com.example.android.apis')
# 模拟设备摇晃
driver.shake()
# 关闭应用
driver.close_app()
# 启动 (Launch)
# 根据服务关键字 (desired capabilities) 启动会话 (session) 。请注意这必须在设定 autoLaunch=false 关键字时才能生效。
# 这不是用于启动指定的 app/activities ————你可以使用 start_activity 做到这个效果————
# 这是用来继续进行使用了 autoLaunch=false 关键字时的初始化 (Launch) 流程的。
driver.launch_app()
# 应用重置，相当于重新卸载安装
driver.reset()
# 可用上下文 (context) 列出所有的可用上下文
# 翻译备注：context可以理解为 可进入的窗口 。例如，对于原生应用，可用的context和默认context均为NATIVE_APP。
# 详情可查看对混合应用进行自动化测试
driver.contexts
# 列出当前上下文
driver.current_context
# 切换到默认的上下文 (context)
# 将上下文切换到默认上下文
driver.switch_to.context(None)
# 获取应用的字符串
driver.app_strings
# 按键事件 (Key Event)给设备发送一个按键事件
driver.keyevent(176)
# 获取当前的activity
driver.current_activity
# 触摸动作(TouchAction) / 多点触摸动作(MultiTouchAction)
action = TouchAction(driver)
action.press(element=el, x=10, y=10).release().perform()
# 滑动(Swipe)模拟用户滑动
# 注意：appium滑动规则是x从左到右变大，y从上到下变大
driver.swipe(start=75, starty=500, endx=75, endy=0, duration=800)
# 捏 (Pinch)捏屏幕 (双指往内移动来缩小屏幕)
driver.pinch(element=el)
# 放大 (Zoom)放大屏幕 (双指往外移动来放大屏幕)
driver.zoom(element=el)
# 滑动到某个元素 (Scroll To)
todo: python
# 从设备中拉出文件 (Pull File)
driver.pull_file('Library/AddressBook/AddressBook.sqlitedb')
# 推送文件到设备中去
data = "some data for the file"
path = "/data/local/tmp/file.txt"
driver.push_file(path, data.encode('base64'))
# 断言
Assert.assertEquals("I am a div", div.getText()); //跳转到指定页面并在该页面所以用元素id进行交互
# 检查文本是否符合预期
assertEqual('I am a div', div.text)
# 输入法是否有活动 返回真假
is_ime_active(self):
# 返回当前安卓设备可用的输入法
driver.available_ime_engines(self):
# 激活安卓设备中的制定输入法
driver.activate_ime_engine(self, engine):
# 关闭当前的输入法（android）
driver.deactivate_ime_engine(self):
# 打开安卓设备上的位置定位设置
driver.toggle_location_services()