安卓自动化框架。
cerium的Python项目详细描述
铈
Cerium is an umbrella project encapsulating a variety of tools and libraries enabling android automation.
cerium的源代码在Apache 2.0 license下提供。
欢迎来到阅读Cerium的文档
简介
Cerium:Android自动化的玩具
cerium是一个面向python的android自动化框架,可以安全地供人使用。
看,铈的力量:
>>>fromceriumimportAndroidDriver>>>driver=AndroidDriver()>>>driver.unlock(1997)# unlock your device by password>>>driver.auto_connect()# connect to your device via TCP/IP automaticallyNowyoucanunplugtheUSBcable,andcontrolyourdeviceviaWLAN.>>>driver.view_packgets_list(keyword='tencent')['com.tencent.mm','com.tencent.android.qqdownloader','com.tencent.tim']>>>driver.make_a_call(18268237856)# call me
cerium允许您发送organic,grass-fed命令,而无需手动操作。
Android Debug Bridge (adb)是一个通用的命令行工具,允许您与模拟器实例或连接的Android设备进行通信。这个项目是以它为基础的。
支持的Python版本
- Python3.6+
支持的平台
- Windows 10(其他平台尚未测试,暂时不打算正式支持)
安装
如果您的系统上有pip,您可以简单地安装或升级cerium:
pip install -U cerium
或者,您可以从PyPI下载源发行版,将其取消存档,然后运行:
python setup.py install
或者通过github.com:
git clone git@github.com:fjwCode/cerium.git
cd cerium
python setup.py install
Note: You may want to consider using virtualenv to create isolated Python environments.
Android Debug Bridge
cerium需要android调试桥工具来使用所选的android设备。默认情况下,cerium包含android debug bridge。您不需要自己设置环境变量
快速启动
- 列出连接的Android设备或模拟器。
- 显示android调试桥的版本。
fromceriumimportAndroidDriverdriver=AndroidDriver()print(driver.devices())print(driver.devices_l())# show devices and modelsprint(driver.version())
- 将本地文件/目录复制到设备。
- 从设备复制文件/目录。
- 拍摄设备显示的屏幕快照,然后将其复制到计算机上。
fromceriumimportAndroidDriverdriver=AndroidDriver()driver.push(local='README.md',remote='/sdcard/README.md')driver.pull(remote='/sdcard/README.md',local='README.md')driver.pull_screencap(local='screencap.png')
- 模拟手指点击。
- 模拟手指滑动
- 输入文本
fromceriumimportAndroidDriverdriver=AndroidDriver()driver.click(100,100)driver.swipe(100,200,100,100,duration=100)driver.send_keys("I'm White Turing.")
演示
作者
铈由White Turing(fujiawei@stu.hznu.edu.cn)写入和维护。