『与善仁』Appium基础 — 16、APPium基础操作API
目录
1、前置代码
一个脚本中必须要编写的内容，写在前置代码中：
# server 启动参数
desired_caps = {}
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://127.0.0.1:4723/wd/hub', desired_caps)
2、安装和卸载APP
（1）把电脑中的APK安装包，安装到手机上。
安装方法：
driver.install_app(app_path)
参数：
app_path：脚本机器中APK文件路径
（2）卸载手机上已安装的APP。
卸载方法：
driver.remove_app(app_id)
参数：
app_id：需要卸载的app包名
（3）演示练习
# 1.导入appium
import time
from appium import webdriver
# 2.创建Desired capabilities对象，添加启动参数
desired_caps = {
"platformName": "Android", # 系统名称
"platformVersion": "7.1.2", # 系统版本
"deviceName": "127.0.0.1:21503", # 设备名称
"appPackage": "com.microvirt.launcher2", # APP包名
"appActivity": "com.microvirt.launcher.Launcher" # APP启动名
}
# 3.启动APP
# 声明手机驱动对象(实例化webdriver)
# 第一个参数为appium服务的地址，需要启动appium服务。
# 第二个参数为Desired capabilities对象
# 我们就先传入这两个参数就可以了。
driver = webdriver.Remote("http://127.0.0.1:4723/wd/hub", desired_caps)
# 4.操作APP
# 脚本机器中APK文件路径，注意前边要加一个r，不然解析地址时可能会报错。
app_path = r'C:\Users\L\Desktop\com.taobao.taobao_V9.15.0.apk'
# 安装apk
driver.install_app(app_path)
time.sleep(5)
# 要知道即将卸载的app的包名
app_id = "com.taobao.taobao"
# 卸载APP
driver.remove_app(app_id)
# 5.关闭APP
time.sleep(3)
driver.quit()
说明：
一般这两个命令很少使用，即使用命令安装
apk软件，一般我们也推荐使用adb命令。就不用把安装APP的代码写入脚本中，即使写入脚本，最终执行也是adb命令。如果公司的测试机充裕，我们就把APP的安装包放入手机，直接手动安装了。一般用到这两个命令是在一个脚本要去测试多个APP的时候，会用到这两个命令，在测试时把这几个APP先安装上，测试完成之后在卸载APP。但是这种情况也基本上不多，一般情况APP都单独测试。
3、判断APP是否已安装
使用的API：
driver.is_app_installed(bundle_id)
参数：
bundle_id: 传⼊app包名,返回结果为True(已安装) / False(未安装)
示例：
# 1.导入appium
import time
from appium import webdriver
# 2.创建Desired capabilities对象，添加启动参数
desired_caps = {
"platformName": "Android", # 系统名称
"platformVersion": "7.1.2", # 系统版本
"deviceName": "127.0.0.1:21503", # 设备名称
"appPackage": "com.microvirt.launcher2", # APP包名
"appActivity": "com.microvirt.launcher.Launcher" # APP启动名
}
# 3.启动APP
driver = webdriver.Remote("http://127.0.0.1:4723/wd/hub", desired_caps)
# 4.操作APP
# 脚本机器中APK⽂件路径
app_path = r'C:\Users\L\Desktop\com.taobao.taobao_V9.15.0.apk'
# 安装apk
driver.install_app(app_path)
time.sleep(5)
# 要知道即将卸载的APP的包名
bundle_id = "com.taobao.taobao"
result = driver.is_app_installed(bundle_id)
# 结果是result=true
print(result)
# 5.关闭APP
time.sleep(3)
driver.quit()
提示：一般我们用眼看APP是否安装就可以了，脚本中明确需要的时候再写。
4、关闭APP软件和关闭驱动对象
关闭APP软件和关闭驱动对象的区别：
-
driver.close_app()闭当前操作的APP，不会关闭驱动对象。
-
driver.quit()关闭驱动对象，同时关闭所有关联的APP。
5、发送文件到手机和获取手机中的文件
（1）发送文件到手机
代码片段：
# 导入base64库
import base64
# 将文件转换成二进制文件
with open(file_path,'rb') as fp:
data = str(base64.b64encode(fp.read()),'utf-8')
# print(data)
# 将转换格式的文件发送到手机
driver.push_file(path, data)
参数说明：
file_path：需要上传的文件路径。path：手机设备上的路径(例如：/sdcard/a.txt)data：文件内数据，要求base64编码。
说明：
Python3.x中字符都为unicode编码，需要先导入base64库进行编码和解码，先把文件转成base64格式的二进制文件，然后进行文件传递到手机，因为设备之间传递是二进制的。
（2）从手机中拉取文件
代码片段：
import base64
# 返回数据为base64编码的数据
data = driver.pull_file(path)
# base64解码
with open('a.txt','wb') as fp:
fp.write(base64.b64decode(data))
参数：
path：手机设备上的路径例如: /sdcard/a.txt
（3）示例：
# 1.导入appium
import time
from appium import webdriver
import base64
# 2.创建Desired capabilities对象，添加启动参数
desired_caps = {
"platformName": "Android", # 系统名称
"platformVersion": "7.1.2", # 系统版本
"deviceName": "127.0.0.1:21503", # 设备名称
"appPackage": "com.cyanogenmod.filemanager", # APP包名
"appActivity": ".activities.NavigationActivity" # APP启动名
}
# 3.启动APP
# 声明手机驱动对象(实例化webdriver)
# 第一个参数为appium服务的地址，需要启动appium服务。
# 第二个参数为Desired capabilities对象
# 我们就先传入这两个参数就可以了。
driver = webdriver.Remote("http://127.0.0.1:4723/wd/hub", desired_caps)
# 4.操作APP
# 4.1 发送文件到手机
file_path = r'C:\Users\L\Desktop\test.txt'
# 将文件转换成二进制文件
with open(file_path, 'rb') as fp:
data = str(base64.b64encode(fp.read()), 'utf-8')
# print(data)
# 将转换格式的文件发送到手机
path = r'/sdcard/test.txt'
driver.push_file(path, data)
# 4.2 从手机中拉取文件到电脑上
# 手机中文件的路径
path_app = '/sdcard/test.txt'
# 返回数据为base64编码的数据
data = driver.pull_file(path_app)
print(data)
# base64解码
with open('test.txt', 'wb') as fp:
fp.write(base64.b64decode(data))
# 提示：该文件会拉取到脚本文件所在的目录中
# 5.关闭APP
time.sleep(5)
driver.quit()
6、获取当前屏幕内元素结构（重点）
（也就是获取当前屏幕的源码）
使用的API：
driver.page_source
作用：
返回当前页面的文档结构，可以为后续判断特定的元素是否存在提供前提。
示例：
# 1.导入appium
import time
from appium import webdriver
# 2.创建Desired capabilities对象，添加启动参数
desired_caps = {
"platformName": "Android", # 系统名称
"platformVersion": "7.1.2", # 系统版本
"deviceName": "127.0.0.1:21503", # 设备名称
"appPackage": "com.android.settings", # APP包名
"appActivity": ".Settings" # APP启动名
}
# 3.启动APP
driver = webdriver.Remote("http://127.0.0.1:4723/wd/hub", desired_caps)
# 4.操作APP
# 获取当前页面源码
# 只是设置首页中的页面源码
source = driver.page_source
# # print(source)
# 将APP的页面源码保存到一个文件中
with open("source.txt", "w", encoding="UTF-8") as fp:
fp.write(source)
# 5.关闭APP
time.sleep(3)
driver.quit()
7、脚本内启动其他APP
使用的API：
driver.start_activity(appPackage,appActivity)
# 提示：appPackage,appActivity为所要启动APP的包名和启动名
示例：
# 从管理app页面中打开文件管理器app
# 1.导入appium
import time
from appium import webdriver
# 2.创建Desired capabilities对象，添加启动参数
desired_caps = {
"platformName": "Android", # 系统名称
"platformVersion": "7.1.2", # 系统版本
"deviceName": "127.0.0.1:21503", # 设备名称
"appPackage": "com.android.settings", # APP包名
"appActivity": ".Settings" # APP启动名
}
# 3.启动APP
driver = webdriver.Remote("http://127.0.0.1:4723/wd/hub", desired_caps)
# 4.操作APP
# 从设置APP页面启动文件管理器APP
time.sleep(3)
# 先用adb命令获取文件管理器的包名和启动名
# com.cyanogenmod.filemanager/.activities.NavigationActivity
driver.start_activity("com.cyanogenmod.filemanager", ".activities.NavigationActivity")
# 5.关闭APP
time.sleep(3)
driver.quit()
8、将应用程序置于后台运行（重点）
使用的API：
# 将应用置于后台运行(秒)
driver.background_app()
示例：
# 1.导入appium
import time
from appium import webdriver
# 2.创建Desired capabilities对象，添加启动参数
desired_caps = {
"platformName": "Android", # 系统名称
"platformVersion": "7.1.2", # 系统版本
"deviceName": "127.0.0.1:21503", # 设备名称
"appPackage": "com.android.settings", # APP包名
"appActivity": ".Settings" # APP启动名
}
# 3.启动APP
driver = webdriver.Remote("http://127.0.0.1:4723/wd/hub", desired_caps)
# 4.操作APP
time.sleep(3)
# 将设置APP置于后台运行
# 将应用在后台运行5秒,返回前台
driver.background_app(5)
# 提示：测试前最好把设备中所有后台运行的APP都关闭掉。
# 5.关闭APP
time.sleep(3)
driver.quit()
提示：在测试APP热启动的时候，就会常用到该命令。
