Appium - python

最新推荐文章于 2024-04-29 17:55:25 发布

XuMeng_first

最新推荐文章于 2024-04-29 17:55:25 发布

阅读量1.4k

点赞数

文章标签： appium python 开发语言

本文链接：https://blog.csdn.net/weixin_47347921/article/details/133140538

版权

一、appium的介绍

Appium是一款开源的自动化测试工具，其支持iOS和安卓平台上的原生的，基于移动浏览器的，混合的应用。Appium在不同平台中使用了标准的自动化APIs，所以在跨平台时，不需要重新编译或者修改自己的应用。Appium支持Selenium WebDriver支持的所有语言，如java、Object-C、JavaScript、 Php、Python、Ruby、C#、，或者Perl语言，更可以使用Selenium WebDriver的Api。Appium支持任何一种测试框架.Appium实现了真正的跨平台自动化测试。

二、appium 架构

appium 是一个node.js 编写的http server ,它的创建、并管理多个webDriver sessiion 来和不同平台交互，如ios,Android等等，appium 开始一个测试后，就会在被测设备（手机）上启动一个server,监听来自appium server 的指令，每种平台ios 和android 都有不同的运行、和交互方式。4所以appiium会用某个桩程序入侵该平台，并接受指令，来完成测试用例的运行

2.appium 的工作原理

client端发送自动化指令给appium server ，appium server 接收到client发送的指令后，转换为移动端能够识别的指令，然后发送给移动端设备，并对移动端设备进行操作。

工作流程，脚本请求--->4723端口appium server --->解析参数给pc端4724端口---->发送给设备4724端口---->通过设备4724端口发给bootstrap.jar --->bootstrap.jar把命令发给 uiautomator

注意：bootstrap.jar：是push到android手机上的一个应用程序，主要是接受appium server的执行并且运行这些测试指令。而指令的执行正式通过UIAutomator来驱动

1.appium安装

1.安装jdk

下载好后点击进行安装。安装好后进行环境变量的配置

打开计算机-》系统属性-》高级系统设置-》环境变量-》新建（系统变量），如图所示：

配置JAVA_HOME C:\Program Files\Java\jdk\jdk1.8.0_91（根据自己的安装磁盘决定盘符）

配置Path： ;%JAVA_HOME%/bin;%JAVA_HOME%/jre/bin; 追加进Path中；

配置CLASSPATH .;%JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar

验证：

验证一下JDK的环境是否配置好，win+r 输入cmd进入dos下输入java -version检查环境是否配置成功。

安装 Android sdk ---安装步骤类似jdk,不在赘述

验证：

2.安装Node.js

建议使用我提供下载的6.9.4版本，类似jdk，不再赘述

验证：

3.安装appium

下载：AppiumForWindows_1_4_16_1.zip

验证：

cmd打开命令行窗口，输入appium-doctor ，出现以下提示，All Checks were successful ,说明环境配置成功

4.安装依赖包

appium-pytho-client 目的是需要将python 与appium 关联起来，首先要安装python3.x ，进行环境配置。配置的默认环境是本地的python 环境，如果后期使用pycharm的虚拟环境，这需要在虚拟环境中再次安装。

在需要的环境下，输入：pip install Appium-Python-Client==1.3.0，（此处需要配合appium版本使用，所以需要指定版本安装）提示成功就可以了，我这边是已经安装过了。同时selenium的包要指定安装4.8.0，安装命令：pip install selenium==4.8.0

验证：出现successfully，就安装成功。

三、启动设备

1.appium 已经启动

双击该软件appium-desktop，启动appium服务器

点击start server,启动appium服务器

看到以上图形，代表服务启动成功

2.设备已连接

A.连接模拟器

adb命令进行连接模拟器

命令：adb connect 127.0.0.0.1:port

端口号：逍遥安卓模拟器：21503

B.连接真机：

安卓真机，需要在设置里面进入关于手机，里面连击版本号，会提示手机已进入开发者模式，在回到设置中查找开发者选项，开启USB调试，再次通过数据线连接手机即可。（如果提示手机连接模式，应该选择文件传输，不能选择仅充电）连接成功后，可以使用adb devices查看，如图：

3.被测软件已经安装：

将目标apk安装到目标机器上，如果是模拟器，如下图

四、启动目标app

此处我们以模拟器上的今日头条的apk为例代码如下：

代码如下：

import time
from appium import webdriver

def startUp():
    print("启动中")
    #启动参数设置dict数据格式
    desire_caps = {
        #通过adb devices获取，此处是模拟器所以填写的是ip和port
        "deviceName": "127.0.0.1:21503",
        # 使用哪个移动操作系统平台
        "platformName": "Android",
        # 使用移动操作平台的版本
        "platformVersion": "5.1.1",
        # app的包名，通过aapt dumpsys bading xxx.apk获取
        "appPackage": "com.ss.android.article.news",
        "appActivity": "com.ss.android.article.news.activity.MainActivity",
        "noReset": True,
        "unicodeKeyboard": True
        # "autoLaunch": False
    }
    driver = webdriver.Remote('http://127.0.0.1:4723/wd/hub',desire_caps)
    print("启动成功，等待6s关闭")
    time.sleep(6)
    #智能等待
    driver.implicitly_wait(1)
    time.sleep(4)
    driver.quit()

if __name__ == '__main__':
    startUp()

报错：
ValueError: Timeout value connect was <object object at 0x0000019A00694540>, but it must be an int, float or None.

其实是selenium版本和urllib3版本不兼容问题。更换urllib3版本：
pip uninstall urllib3
pip install urllib3==1.26.2
也可以更换selenium版本，参考以下文章：
https://blog.csdn.net/qq_48302722/article/details/130861992

APP启动参数说明：

参数	描述	值
appPackage	App的包名，通过aapt dumpsys badging xxx.apk获取	例如：'appPackage': 'com.jyibb.shell_customer',
platformName	使用哪个移动操作系统平台	例如：'platformName': 'Android'
platformVersion	移动操作系统版本	例如：'platformVersion': '5.1'
deviceName	使用的移动设备或模拟器的名称，通过adb devices获取	例如：'deviceName':'8TB6V4ZPZ54LPJ5P'
app	如果为第一次启动则需要通过该参数指定app安装包的位置，一般为绝对路径	例如：'app': ‘D:\shell_customer-debug.apk'
newCommandTimeout	在假定客户端退出并结束会话之前，Appium将等待来自客户端的新命令（以秒为单位）	例如 60
appActivity	通过aapt dumpsys badging xxx.apk获取	例如 appActivity': 'com.jyibb.module_launch_customer.SplashActivity',
udid	连接的物理设备的唯一设备标识符，此参数为ios 特有参数	例如：'udid':'1ae203187fc012g'
noReset	在此会话之前不要重置应用程序状态。	true， false
fullReset	执行完整的重置	true， false
unicodeKeyboard	解决输入中文的问题，否则不能用sendkeys输入中文	例如， ‘unicodeKeyboard':'True'
resetKeyboard	将键盘隐藏起来，默认 true	true， false
autolunch	Appium是否要自动启动或安装app	默认true ，该参数在设计框架时开启了lunchapp方法后使用可以避免每次第一个用例失败
automationName	UiAutomator2	有些手机定位不到元素，或调不动时，可以使用此参数

注意： "udid"：设备唯一标识，通过adb devices获取，显示的设备标识，如果当前连接了多台设备，可以通过此参数区分要启动的设备，安卓的deviceName不会校验正确性（可以随便写），ios必须校验系统版本：打开模拟器里面的设置，查看系统版本即可，类似手机操作系统，如下图

appPackage和appActivity获取：

1、将目标apk放在一个已知目录下

2、进入该目录的dos环境，输入以下命令

aapt dump badging jinritoutiao.apk |findstr package ----用来查看package
aapt dump badging jinritoutiao.apk |findstr activity ----用来查看activity

如果是linux或者mac 则把findstr换成grep

aapt dump badging d:\xxx.apk   #获取安装包的所有信息

adb devices(查看手机是否连接到电脑，可以看到设备名称)

adb shell 可以进入默认连接设备的linux环境

如果不想进入linux环境好需要输入命令进行操作的话可以通过一下方式：

adb shell ls -l(shell后直接跟命令)

如果是连接了多台设备，可以通过adb -s 127.0.0.1:21503 shell来进入指定设备的linux环境

adb shell pm list packages 列出所有的包名

adb shell dumpsys package com.android.xxx：查看某个包的具体信息

adb logcat | grep xxx:查看当前app的日志并过滤关键字

自动化测试用例的实现

以今日头条发微头条为例

手工执行用例的步骤：

前提：启动头条app，且是登录状态

1- 打开首页，点击发表按钮

2- 点击微头条，输入内容

3- 点击发布

4- 检查是否发表成功（数据库/页面）

自动化执行的步骤：

1、定位目标元素（坐标，元素属性），操作目标元素（点击，滑动，输入）

2、定位目标元素（坐标，元素属性），操作目标元素（点击，滑动，输入）

3、定位目标元素（坐标，元素属性），操作目标元素（点击，滑动，输入）

4、断言（接口状态码，数据库字段，app页面）

五、元素定位工具

1. uiautomator

Android SDK自带的一个工具，在sdk的tools目录下（一定关闭appium-desktop的自带的定位工具后打开，否则连接不上模拟器/真机）

找到sdk下的tools里面的uiautomatorviewer.bat

2. appium-desktop

优先使用desktop，启动appium-desktop，点击服务器右上角的查找按钮，界面如下

点击启动后：

3-monitor：Android SDK自带的一个工具，在tools目录下，此工具主要用来监控Android手机的运行情况，比如线程、堆内存，日志输出、等等。

六、元素定位方式

1. 单个元素定位

方法：find_element

用法：driver.find_element(By.属性,'属性值')，传递两个参数：一个是定位属性，一个是该属性的值

1. 通过id定位取resource-id的属性值，替换到xxx

driver.find_element(By.ID," xxxx ")

2. 通过class_name定位

取class的属性值，替换到xxx

driver.find_element(By.CLASS_NAME," xxxx ")

3. 通过xpath定位取xpath的属性值，替换到xxx

driver.find_element(By.XPATH," xxxx ")

4. 通过link_text定位取text属性值，替换到xxx

写法一：

driver.find_element(By.LINK_TEXT," xxxx ")

写法二：

driver.find_element_by_android_uiautomator("new UiSelector().text(\"+关注
\")")

5. 通过css_selector定位（webview）

driver.find_element(By.CSS_SELECTOR,"XXXX")

6. 通过name定位（webview） web view容器中的html页面可以用name定位，native并没有name属性

driver.find_element(By.NAME," xxxx ")

2. 多个元素定位

方法：find_elements

用法：与find_element方式一致，但是返回一个数组。可以通过数组的索引来访问具体的某个结果例如：通过ID定位到多个元素，我想点击第一个元素

driver.find_elements(By.ID,"xxxxx")[0].click()
# 或采用以下写法
list1 = driver.find_elements(By.ID,"xxxxx")
list1[0].click()

七、元素操作

找到元素后可以对元素进行的操作

1. click() 点击操作，也可以用tab实现点击操作

driver.find_element(By.ID," xxxx ").click()

2. clear() 清空输入框内容

driver.find_element(By.ID," xxxx ").clear()

3. send_keys() 输入框内输入内容

driver.find_element(By.ID," xxxx ").send_keys("test content")

4. text 获得元素的text内容

result = driver.find_element(By.XPATH," xxxx").text
print(result)

5. get_attribute() 通过传入xx属性，获取xx属性值

driver.find_element(By.ID,' xxxx ').get_attribute('text')

6. size 获取元素的大小，得到一个字典如：{'height': 48, 'width': 640}

driver.find_element(By.ID,' xxxx ').size

XuMeng_first

关注

0
点赞
踩
3

收藏

觉得还不错? 一键收藏
打赏
0
评论
Appium - python

Appium是一款开源的自动化测试工具，其支持iOS和安卓平台上的原生的，基于移动浏览器的，混合的应用。Appium在不同平台中使用了标准的自动化APIs，所以在跨平台时，不需要重新编译或者修改自己的应用。Appium支持Selenium WebDriver支持的所有语言，如java、Object-C、JavaScript、 Php、Python、Ruby、C#、，或者Perl语言，更可以使用Selenium WebDriver的Api。
复制链接

扫一扫