Appium 基础操作 API

学习目标

1. 能够使用 appium 在脚本内启动其他 app
2. 能够使用 appium 获取包名和界面名
3. 能够使用 appium 关闭 app 和 驱动对象
4. 能够使用 appium 安装和卸载 app
5. 能够使用 appium 将应用置于后台

一. Appium 基础操作 API

前置代码

from appium import webdriver
desired_caps = dict()
# 手机参数
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '5.1'
desired_caps['deviceName'] = '192.168.56.101:5555'
# 应用参数
desired_caps['appPackage'] = 'com.android.settings'
desired_caps['appActivity'] = '.Settings'
# 获取driver
driver = webdriver.Remote('http://localhost:4723/wd/hub',desired_caps)
# 退出driver
driver.quit()

1.1 在脚本内启动其他 app

应用场景
如果一个应用需要跳转到另外一个应用，就可以使用这个 api 进行应用的跳转，就像我们通过外卖应用下订单之后会跳转到支付应用一样。

方法名和参数

# 脚本内启动其他app
# 参数：
# appPackage：要打开的程序的包名
# appActivity：要打开的程序的界面名
driver.start_activity(appPackage, appActivity)

示例
打开《设置》应用程序，等待三秒后跳转到《短信》应用程序

from appium import webdriver
desired_caps = dict()
# 手机参数
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '5.1'
desired_caps['deviceName'] = '192.168.56.101:5555'
# 应用参数
desired_caps['appPackage'] = 'com.android.settings'
desired_caps['appActivity'] = '.Settings'
# 获取driver
driver = webdriver.Remote('http://localhost:4723/wd/hub',desired_caps)
# 跳转到短信
driver.start_activity('com.android.mms', '.ui.ConversationList')
time.sleep(5)
# 退出driver
driver.quit()

1.2 获取 app 的包名和界面名

应用场景

当我们从一个应用跳转到另外一个应用的时候，想输出其包名、界面名或者想在报告中展现对应信息，我们就可以调用这个属性来进行获取。

属性名

# 获取包名
driver.current_package
# 获取界面名
driver.current_activity

示例
打开《设置》应用程序后输出当前的包名和界面名

from appium import webdriver
desired_caps = dict()
# 手机参数
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '5.1'
desired_caps['deviceName'] = '192.168.56.101:5555'
# 应用参数
desired_caps['appPackage'] = 'com.android.settings'
desired_caps['appActivity'] = '.Settings'
# 获取driver
driver = webdriver.Remote('http://localhost:4723/wd/hub',desired_caps)
# 打印当前包名
print(driver.current_package)
# 打印当前界面名
print(driver.current_activity)
# 退出driver
driver.quit()

结果

com.android.settings
.Settings

1.3 关闭 app 和 驱动对象

应用场景
有的时候我们需要关闭某个应用程序后，再打开新的应用。那么如何关闭应用程序呢？

方法名

# 关闭当前操作的app，不会关闭驱动对象
driver.close_app()
# 关闭驱动对象，同时关闭所有关联的app
driver.quit()

示例
打开《设置》，使用 close_app() 方法关闭，再尝试使用 quit() 方法，最后打印当前程序的包名，观察区别

from appium import webdriver
desired_caps = dict()
# 手机参数
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '5.1'
desired_caps['deviceName'] = '192.168.56.101:5555'
# 应用参数
desired_caps['appPackage'] = 'com.android.settings'
desired_caps['appActivity'] = '.Settings'
# 获取driver
driver = webdriver.Remote('http://localhost:4723/wd/hub',desired_caps)
# 关闭应用
driver.close_app()
# 退出driver
driver.quit()

结果
使用 quit() 后会报错，使用close_app() 不会报错
小结
close_app() 不会关闭驱动对象，只会关闭应用
quit() 会关闭驱动对象

1.4 安装和卸载以及是否安装 app

应用场景
一些应用市场的软件可能会有一个按钮，如果某一个程序已经安装则卸载，如果没有安装则安装

方法名

# 安装app
# 参数：
# app_path：apk路径
driver.install_app(app_path)

# 卸载app
# 参数：
# app_id：应用程序包名
driver.remove_app(app_id)

# 判断app是否已经安装
# 参数：
# app_id：应用程序包名
# 返回值：
# 布尔类型，True为安装，False为没有安装
driver.is_app_installed(app_id)

示例
如果《安智市场》已经安装，则卸载《安智市场》，如果没有则安装

from appium import webdriver
desired_caps = dict()
# 手机参数
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '5.1'
desired_caps['deviceName'] = '192.168.56.101:5555'
# 应用参数
desired_caps['appPackage'] = 'com.android.settings'
desired_caps['appActivity'] = '.Settings'
# 获取driver
driver = webdriver.Remote('http://localhost:4723/wd/hub',desired_caps)
if driver.is_app_installed("cn.goapk.market"):
driver.remove_app("cn.goapk.market")
else:
driver.install_app("/Users/Yoson/Desktop/anzhishichang.apk")
# 退出driver
driver.quit()

1.5 将应用置于后台

应用场景
银行类 app 会在进入后台一定时间后，如果再回到前台也页面会重新输入密码，如果需要自动化测试这# app放置到后台一定时间后再回到前台，模拟热启动

# app放置到后台一定时间后再回到前台，模拟热启动
# 参数：
# seconds：后台停留多少秒
driver.background_app(seconds)

示例
打开《设置》应用，进入后台 5 秒，再回到前台

from appium import webdriver
desired_caps = dict()
# 手机参数
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '5.1'
desired_caps['deviceName'] = '192.168.56.101:5555'
# 应用参数
desired_caps['appPackage'] = 'com.android.settings'
desired_caps['appActivity'] = '.Settings'
# 获取driver
driver = webdriver.Remote('http://localhost:4723/wd/hub',desired_caps)
time.sleep(3)
driver.background_app(5)
time.sleep(3)
# 退出driver
driver.quit()

注意点
热启动：表示进入后台回到前台
冷启动：关机再开这种切断电源的行为