appium client迷之一样的API(一)
之前的随笔说过,最近入坑使用appium server v1.7.1,本着对appium负责任的态度---不抛弃、不放弃,继续在新的app上用appium 折腾
前言
学习一门开源框架之前,必须搞清楚各个模块之间的关系,比如举例appium来说,得理清楚appium desktop、appium server 、appium client和使用语言(java、python)之间关系,这里不一一叙述。
-
本文使用的client版本
Appium-Python-Client (0.26)
-
本文使用的driver
appium-uiautomator2-driver
关于API 的碎碎言(后续会继续碎碎)
-
获取app的strings.xml的内容(android)
原方法:app_strings(language=None, string_file=None)
使用场景举例:
app支持多语言,通过脚本的方式获取各个语言下对应的字符串,与定义文档对比
-
获取app的strings.xml的内容(android)
原理说明:
实际是通过执行aapt d --values resources <apk>
获得,因此caps一定要包含apk的完整路径
app_strings()
支持获取多个语言的strings.xml内容,如果想要获取默认或者不同语言的strings怎么办呢?通过反编译apk可知,res文件夹结构如下
结合反编译后的结构和传递的参数可以推测,如果想要获取各种语言下的strings,只需要传language
参数值,如获取中文环境下的strings,language=zh
;然而想要获取默认的strings则没那么顺畅,如果你认为不传language参数就可以获取得到,那么我只能告诉你,想多了,不过记得旧版本可以哈,实际上不传任何参数则默认获取language=en
对应的strings。想要获取默认的strings,换了一种巧妙的方式,language随便传一个非语言代号,例如这里我的language参数设置为default
- 关于app的启动
原方法
launch_app()
start_activity(app_package, app_activity, **opts)
background_app(seconds)
- launch_app()
启动app,相当于先杀死app再重新启动,该方法实际执行了这段adb命令adb shell am start -W -n com.yf.smart.coros.alpha/com.yf.smart.weloopx.app.entry.SplashScreenActivity -S -a android.intent.action.MAIN -c android.intent.category.LAUNCHER -f 0x10200000
,对于依赖蓝牙连接其他设备的app来说,'杀死'会导致蓝牙断开,然后有时候并不是希望的结果 - start_activity(app_package, app_activity, **opts)
同样可以作为启动app来使用,可定制适合自己的启动方式或者启动其他app,必须参数app的package和activity,可选参数opts
opts详细:
- app_wait_package - Begin automation after this package starts (optional).
- app_wait_activity - Begin automation after this activity starts (optional). 启动一个activity时需要经过中间某个activity时需要填写
- intent_action - Intent to start (optional).
- intent_category - Intent category to start (optional).
- intent_flags - Flags to send to the intent (optional).
- optional_intent_arguments - Optional arguments to the intent (optional).
- dont_stop_app_on_reset - Should the app be stopped on reset (optional)? 表示要不要重置app,简单说,要不要杀死app来启动
-
background_app(seconds)
设置app后台多少秒后重启,app进入后台,其实是执行home键操作,重启则直接热启动app,不会杀死app - 模拟返回与home操作
原方法
press_keycode( keycode, metastate=None)
keyevent( keycode, metastate=None)
- press_keycode()
发送按键码,常见:4表示back,3表示home
可参考:https://developer.android.com/reference/android/view/KeyEvent.html - keyevent( keycode, metastate=None)
执行会报404,估计被uiautomator2 driver弃用了,所以不推荐使用
结语
一定要看API ,一定要看github!一定要看API ,一定要看github!一定要看API ,一定要看github!重要的话重复三遍