• 2021-11-18

    python 自动安卓操作

    前言

    最近，由于某些原因，不得不在安卓上自动操作一些东西，就开始了本教程。目的就是为了用python写脚本，进而控制android手机操作一些内容，其实挺简单的，仅需要一点python基础就可以了

    准备

    由于需要操控android,一些准备是必不可少的

    ADB

    adb是安卓调试桥，必须在PC上安装

    adb下载地址:https://developer.android.google.cn/studio/releases/platform-tools

    image-20211118180508372

    选择你的操作端对应的SDK，然后解压复制全部文件到你希望的目录，并手动把adb.exe 所在目录添加到环境变量。

    或者在cmd窗口中执行(如果目录是D:\xxxx\adb.exe)

    1
    set PATH=%PATH%;D:\xxxx

    然后可以链接手机，通过

    1
    adb devices

    来验证安装结果。

    img

    uiautomator2

    安装这个包就比较简单，直接使用

    1
    pip install --pre -U uiautomator2

    等待安装完成就是，其次需要注意的是，建议将pip的下载源换到国内镜像，这样下载才比较流畅

    android 手机环境

    手机链接PC后，手机上打开开发者模式，如果没有，就在系统设置中，连点4次版本号，打开开发者模式

    然后开启允许USB调试，

    输入adb命令adb devices发现设备后，表示设备链接成功。

    后面在PC输入

    1
    python -m uiautomator2 init

    手机上就会安装好atx-agent

    应用

    连接

    因为是用python写脚本，就必须导入uiautomator2,

    1
    import uiautomator2 as u2  #依赖包

    连接方式有两种

    • wifi

      先获取到手机的IP，并且确保电脑可以ping通电脑

      IP可以在ATX这个软件上查看，也可以在wifi设置里查看

      如果手机的IP是12.222.42.001，就应该这样连接

      1
      2
      import uiautomator2 as u2  
      d = u2.connect('12.222.42.001')

    • USB

      使用usb连接就比较方便，可以通过adb device获取到，比如连接号是abcdefg,就该

      1
      2
      import uiautomator2 as u2
      d = u2.connect_usb('abcdefg')

      当然了，如果pc只连接了一台手机，就可以通过

      1
      2
      import uiautomator2 as u2
      d = u2.connect()

      直接连接了。

    简单用法

    • 点击click

      1
      d(text="点我").click()

    • 长按long click

      1
      d(text='长按我').long_click()

    • 输入文字set text

      1
      d(text='input').set_text('okk')

    • 检查并维持设备端守护进程处于运行状态

      1
      d.healthcheck()

    • 打开调试开关

      1
      2
      d.debug = True
      d.info

    • 安装应用，只能从URL安装

      1
      d.app_install('http://some-domain.com/some.txt')

    • 启动应用

      1
      d.app_start('com.eg.android.AlipayGphone') #引号内为包名称，这里为支付宝

    • 停止应用

      1
      2
      3
      4
      5
      #相当于'am force-stop'强制停止应用
      d.app_stop('com.eg.android.AlipayGphone') 

      #相当于'pm clear' 清空App数据
      d.app_clear('com.eg.android.AlipayGphone')

    • 停止所有正在运行的应用程序

      1
      2
      3
      4
      5
      # 停止所有
      d.app_stop_all()

      # 停止所有应用程序，除了com.examples.demo
      d.app_stop_all(excludes=['com.examples.demo'])

    • 跳过弹窗，禁止弹窗

      1
      2
      d.disable_popups() # 自动跳过弹出窗口 
      d.disable_popups(False) # 禁用自动跳过弹出窗

    • 获取设备信息

      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      # 获取基本信息
      d.info

      # 获取窗口大小
      print(d.window_size())
      # 设备垂直输出示例: (1080, 1920)
      # 设备水平输出示例: (1920, 1080)

      # 获取当前应用程序信息。对于某些android设备，输出可以为空
      print(d.current_app())

      #获取设备序列号
      print(d.serial)

      #获取WIFI IP
      print(d.wlan_ip)

      #获取详细的设备信息
      print(d.device_info)

    • 获取应用信息

      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      d.app_info("com.eg.android.AlipayGphone")
      # 会输出
      '''
      {
       "packageName": "com.eg.android.AlipayGphone", 
       "mainActivity": "com.eg.android.AlipayGphone.AlipayLogin", 
       "label": "支付寶", 
       "versionName": "10.2.13.9020", 
       "versionCode": 360, 
       "size": 108306104
      }
      '''
      # 保存应用程序图标
      img = d.app_icon("com.eg.android.AlipayGphone")
      img.save("icon.png")

    • 推送文件到设备

      1
      2
      3
      4
      5
      6
      7
      8
      9
      # push文件夹
      d.push("foo.txt", "/sdcard/")
      # push和重命名
      d.push("foo.txt", "/sdcard/bar.txt")
      # push fileobj
      with open("foo.txt", 'rb') as f:
       d.push(f, "/sdcard/")
      # 推动和更改文件访问模式
      d.push("foo.sh", "/data/local/tmp/", mode=0o755)

    • 从设备拉取一个文件

      1
      2
      3
      4
      d.pull("/sdcard/tmp.txt", "tmp.txt")

      # 如果在设备上找不到文件，FileNotFoundError将引发
      d.pull("/sdcard/some-file-not-exists.txt", "tmp.txt")

    • 打开\关闭屏幕

      1
      2
      d.screen_on()＃打开屏幕 
      d.screen_off() ＃关闭屏幕

    • 获取当前屏幕状态

      1
      d.info.get('screenOn') # 需要 Android> = 4.4

    • 硬键盘和软键盘操作

      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      16
      17
      d.press("home") # 点击home键
      d.press("back") # 点击back键
      d.press("left") # 点击左键
      d.press("right") # 点击右键
      d.press("up") # 点击上键
      d.press("down") # 点击下键
      d.press("center") # 点击选中
      d.press("menu") # 点击menu按键
      d.press("search") # 点击搜索按键
      d.press("enter") # 点击enter键
      d.press("delete") # 点击删除按键
      d.press("recent") # 点击近期活动按键
      d.press("volume_up") # 音量+
      d.press("volume_down") # 音量-
      d.press("volume_mute") # 静音
      d.press("camera") # 相机
      d.press("power") #电源键

    • 解锁屏幕

      1
      2
      3
      4
      d.unlock()
      # 相当于
      # 1. 发射活动:com.github.uiautomator.ACTION_IDENTIFY
      # 2. 按home键

    • 手势与设备的交互

      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      20
      21
      22
      23
      24
      25
      # 单击屏幕
      d.click(x,y) # x,y为点击坐标

      # 双击屏幕
      d.double_click(x,y)
      d.double_click(x,y,0.1) # 默认两个单击之间间隔时间为0.1秒

      # 长按
      d.long_click(x,y)
      d.long_click(x,y,0.5) # 长按0.5秒（默认）

      # 滑动
      d.swipe(sx, sy, ex, ey)
      d.swipe(sx, sy, ex, ey, 0.5) #滑动0.5s(default)

      #拖动
      d.drag(sx, sy, ex, ey)
      d.drag(sx, sy, ex, ey, 0.5)#拖动0.5s(default)
      # 滑动点 多用于九宫格解锁，提前获取到每个点的相对坐标（这里支持百分比）

      # 从点(x0, y0)滑到点(x1, y1)再滑到点(x2, y2)
      # 两点之间的滑动速度是0.2秒
      d.swipe((x0, y0), (x1, y1), (x2, y2), 0.2)
      # 注意：单击，滑动，拖动操作支持百分比位置值。例：
      d.long_click(0.5, 0.5) 表示长按屏幕中心

    • XPath

      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      20
      21
      22
      23
      24
      25
      26
      27
      28
      29
      30
      31
      32
      33
      34
      35
      36
      37
      38
      39
      40
      41
      42
      43
      44
      45
      46
      47
      48
      49
      50
      51
      52
      53
      54
      55
      56
      57
      58
      # 检索方向
      d.orientation
      # 检索方向。输出可以是 "natural" or "left" or "right" or "upsidedown"

      # 设置方向
      d.set_orientation("l") # or "left"
      d.set_orientation("r") # or "right"
      d.set_orientation("n") # or "natural"

      #冻结/ 开启旋转
      d.freeze_rotation() # 冻结旋转
      d.freeze_rotation(False) # 开启旋转

      ########## 截图 ############
      # 截图并保存到电脑上的一个文件中，需要Android>=4.2。
      d.screenshot("home.jpg")
       
      # 得到PIL.Image格式的图像. 但你必须先安装pillow
      image = d.screenshot() # default format="pillow"
      image.save("home.jpg") # 或'home.png'，目前只支持png 和 jpg格式的图像
       
      # 得到OpenCV的格式图像。当然，你需要numpy和cv2安装第一个
      import cv2
      image = d.screenshot(format='opencv')
      cv2.imwrite('home.jpg', image)
       
      # 获取原始JPEG数据
      imagebin = d.screenshot(format='raw')
      open("some.jpg", "wb").write(imagebin)

      #############################

      # 转储UI层次结构
      # get the UI hierarchy dump content (unicoded).（获取UI层次结构转储内容）
      d.dump_hierarchy()


      # 打开通知或快速设置
      d.open_notification() #下拉打开通知栏
      d.open_quick_settings() #下拉打开快速设置栏

      # 检查特定的UI对象是否存在
      d(text="Settings").exists # 返回布尔值，如果存在则为True，否则为False
      d.exists(text="Settings") # 另一种写法
      # 高级用法
      d(text="Settings").exists(timeout=3) # 等待'Settings'在3秒钟出现

      # 获取特定UI对象的信息
      d(text="Settings").info

      # 获取/设置/清除可编辑字段的文本(例如EditText小部件)
      d(text="Settings").get_text() #得到文本小部件
      d(text="Settings").set_text("My text...") #设置文本
      d(text="Settings").clear_text() #清除文本

      # 获取Widget中心点
      d(text="Settings").center()
      #d(text="Settings").center(offset=(0, 0)) # 基准位置左前

    • UI对象

      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      20
      21
      22
      23
      24
      25
      26
      27
      28
      29
      30
      31
      32
      33
      34
      35
      36
      37
      38
      39
      40
      41
      42
      43
      44
      45
      46
      47
      48
      49
      50
      # text、resourceId、description、className、xpath、坐标

      # 执行单击UI对象
      #text定位单击
      d(text="Settings").click()
      d(text="Settings", className="android.widget.TextView").click()

      #resourceId定位单击
      d(resourceId="com.ruguoapp.jike:id/tv_title", className="android.widget.TextView").click() 

      #description定位单击
      d(description="设置").click()
      d(description="设置", className="android.widget.TextView").click()

      #className定位单击
      d(className="android.widget.TextView").click()

      #xpath定位单击
      d.xpath("//android.widget.FrameLayout[@index='0']/android.widget.LinearLayout[@index='0']").click()

      #坐标单击
      d.click(182, 1264)

      # 等待元素出现(最多10秒），出现后单击 
      d(text="Settings").click(timeout=10)
      # 在10秒时点击，默认的超时0
      d(text='Skip').click_exists(timeout=10.0)
      # 单击直到元素消失，返回布尔
      d(text="Skip").click_gone(maxretry=10, interval=1.0) # maxretry默认值10,interval默认值1.0
      # 点击基准位置偏移
      d(text="Settings").click(offset=(0.5, 0.5)) # 点击中心位置，同d(text="Settings").click()
      d(text="Settings").click(offset=(0, 0)) # 点击左前位置
      d(text="Settings").click(offset=(1, 1)) # 点击右下

      # 执行双击UI对象
      d(text="设置").double_click() # 双击特定ui对象的中心
      d.double_click(x, y, 0.1) # 两次单击之间的默认持续时间为0.1秒

      #执行长按UI对象
      # 长按特定UI对象的中心
      d(text="Settings").long_click()
      d.long_click(x, y, 0.5) # 长按坐标位置0.5s默认

      # 将UI对象拖向另一个点或另一个UI对象
      # Android<4.3不能使用drag.
      # 在0.5秒内将UI对象拖到屏幕点(x, y)
      d(text="Settings").drag_to(x, y, duration=0.5)

      # 将UI对象拖到另一个UI对象的中心位置，时间为0.25秒
      d(text="Settings").drag_to(text="Clock", duration=0.25)

    • example

      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      20
      21
      22
      23
      24
      25
      26
      27
      28
      29
      30
      31
      32
      33
      34
      35
      36
      37
      38
      39
      40
      41
      # 等待10s
      d.xpath("//android.widget.TextView").wait(10.0)

      # 找到并单击
      d.xpath("//*[@content-desc='分享']").click()

      # 检查是否存在
      if d.xpath("//android.widget.TextView[contains(@text, 'Se')]").exists:
       print("exists")
       
      # 获取所有文本视图文本、属性和中心点
      for elem in d.xpath("//android.widget.TextView").all():
       print("Text:", elem.text)
       
      #获取视图文本
      for elem in d.xpath("//android.widget.TextView").all():
       print("Attrib:", elem.attrib)
       
      #获取属性和中心点
      #返回: (100, 200)
      for elem in d.xpath("//android.widget.TextView").all():
       print("Position:", elem.center())

      # xpath常见用法：
      # 所有元素
      //*

      # resource-id包含login字符
      //*[contains(@resource-id, 'login')]

      # 按钮包含账号或帐号
      //android.widget.Button[contains(@text, '账号') or contains(@text, '帐号')]

      # 所有ImageView中的第二个
      (//android.widget.ImageView)[2]

      # 所有ImageView中的最后一个
      (//android.widget.ImageView)[last()]

      # className包含ImageView
      //*[contains(name(), "ImageView")]

    • 其它

      更多用法 https://github.com/openatx/uiautomator2

    上一篇:
    ASCII 转换工具
    下一篇:
    简单理解栈溢出
    本文目录
    本文目录
    Copyright © 2019 - 2021 kuangtant | Powered by Hexo | Theme Bamboo
    本站总阅读量： 次 本站总访问量： 次 |