前言

本文介绍下，mac 电脑连接安卓手机的流程，为 python 自动化工具做准备。

前置知识：

homebrew 安装 2022 我用 MacBook Pro 整一年 【感想 与 踩坑指南】。

python 环境安装：Python 入门系列文章 - 环境搭建

ADB（安卓调试桥）

ADB是Android Debug Bridge的缩写，是一个命令行工具，允许开发者与Android设备或模拟器进行通信。ADB是Android SDK（软件开发工具包）的一部分，用于各种任务，例如安装和调试应用程序，在计算机和Android设备之间传输文件以及访问设备的shell以运行命令。

一些常见的ADB命令包括：

• adb devices：列出所有连接的Android设备或模拟器。
• adb install [apk_file]：在设备上安装APK（Android Package）文件。
• adb logcat：实时显示设备的系统日志。
• adb shell：在设备上打开shell，允许您直接运行命令。
• adb push [local_file] [remote_path]：将文件从计算机复制到设备。
• adb pull [remote_file] [local_path]：将文件从设备复制到计算机。

请注意，要使用 ADB，需要在计算机上安装 Android SDK 并在 Android 设备上启用USB调试。 官方文档

mac 电脑建议使用 homebrew 安装 SDK：

brew install android-platform-tools

adb kill-server adb devices // daemon not running; starting now at tcp:5037 // daemon started successfully

devices 指令执行后发现并没有出现设备列表，这是因为我们没有打开手机的开发者选项，所以adb 无法获取到设备信息。

启用开发者选项

安卓手机连接电脑，需要先开启手机的 usb 调试功能，以 小米手机为例：

打开设置 => 我的设备 => 全部参数 => MIUI版本（连续点击触发开发者模式），然后回到设置 => 更多设置 => 开发者选项 => usb 调试 => usb 安装（允许通过usb安装应用） => usb 调试（安全设置）（允许通过 usb 调试修改权限或模拟点击）

设置完成后，先 adb kill-server, 然后重新 adb devices 执行后发现，出现了

// daemon not running; starting now at tcp:5037 // daemon started successfully // List of devices attached // FYHU89PRAMHYMZJZ device

FYHU89PRAMHYMZJZ 就是当前设备的编号，需要记录下来，出现这个就说明连接成功了，后面 python 控制手机的一系列操作都需要用到。

atx-agent

atx-agent是一个用于自动化测试和控制Android设备的开源工具。它基于Python编写，可以在Windows、Linux和macOS等多个操作系统上运行。

atx-agent 提供了许多功能，包括：

• 设备连接管理：atx-agent 可以自动连接Android设备，并支持多台设备同时连接。
• 屏幕截图和录制：atx-agent 可以捕获设备的屏幕截图和录制视频。
• UI自动化测试：atx-agent 可以使用UI Automator和Appium等工具进行UI自动化测试。
• 执行ADB命令：atx-agent 可以执行常见的ADB命令，如安装应用程序、启动Activity等。
• 远程控制：atx-agent 可以通过网络进行远程控制，包括启动应用程序、输入文本、滑动屏幕等。

atx-agent 的优点是易于使用，具有灵活性和可扩展性。它还提供了完整的 Python API，可以方便地集成到现有的自动化测试框架中。

官方介绍了它的设计初衷：

这个项目的主要目的是为了屏蔽不同安卓机器的差异，然后开放出统一的HTTP接口供 openatx/uiautomator2使用。项目最终会发布成一个二进制程序，运行在Android系统的后台。 这个项目是如何屏蔽不同机器的差异的呢？举个例子来说，截图这个操作，大概需要3次判断才行。

1. 先判断minicap是否安装可用，然后minicap截图。毕竟minicap截图速度最快
2. 使用uiautomator2提供的接口截图。（模拟器除外）
3. 使用screencap截图，然后根据屏幕的旋转调整旋转方向。(一般只有模拟器用这种方式截图)

正是Android手机不同的表现形式，才导致了需要这么多的判断。而atx-agent就是为了将这些操作帮你处理了。然后提供统一的HTTP接口(GET /screenshot)供你使用。 更多

一键安装

python -m uiautomator2 init

手动安装

从 官方 下载二进制包，解压后看到有 atx-agent 文件，然后在此目录打开终端，执行下面指令：

（建议下载 linux_armv7.tar.gz 结尾的，因为目前的手机以 linux-arm 架构居多）；

$ adb push atx-agent /data/local/tmp $ adb shell chmod 755 /data/local/tmp/atx-agent # launch atx-agent in daemon mode $ adb shell /data/local/tmp/atx-agent server -d # stop already running atx-agent and start daemon $ adb shell /data/local/tmp/atx-agent server -d --stop

安装过程中可能会有几次弹窗授权，点允许，完成后，ATX 应用就安装到当前设备了。

总结

其实也可以用安卓模拟器来操作，不过我 m1 的电脑暂时没找到合适的模拟器；

python + 安卓手机，很适合做一些自动化工具，后续会更新相关文章，感兴趣的欢迎关注。