atx-agent 项目教程

最新推荐文章于 2024-11-19 12:24:52 发布

姬如雅Brina

最新推荐文章于 2024-11-19 12:24:52 发布

阅读量581

点赞数 5

本文链接：https://blog.youkuaiyun.com/gitblog_00096/article/details/142774357

版权

atx-agent 项目教程

atx-agent HTTP Server runs on android devices 项目地址: https://gitcode.com/gh_mirrors/at/atx-agent

1. 项目介绍

atx-agent 是一个运行在 Android 设备上的 HTTP 服务器，旨在屏蔽不同安卓机器的差异，并提供统一的 HTTP 接口供 openatx/uiautomator2 使用。该项目的主要目的是简化 Android 设备的自动化操作，通过统一的接口处理不同设备的差异，从而提高自动化测试和开发的效率。

atx-agent 项目使用 Go 语言编写，编译后生成一个二进制程序，运行在 Android 系统的后台。它通过多种方式处理截图、设备信息获取、应用安装、Shell 命令执行等操作，确保在不同设备上提供一致的接口。

2. 项目快速启动

2.1 安装

首先，从 GitHub Releases 下载适用于 linux_armv7 架构的二进制包。大多数 Android 设备都是 linux-arm 架构的。

# 下载二进制包
wget https://github.com/openatx/atx-agent/releases/download/v0.0.2/atx-agent_0.0.2_linux_armv7.tar.gz

# 解压
tar -xzf atx-agent_0.0.2_linux_armv7.tar.gz

2.2 部署

将解压后的 atx-agent 文件推送到 Android 设备上，并设置执行权限。

# 推送到设备
adb push atx-agent /data/local/tmp

# 设置执行权限
adb shell chmod 755 /data/local/tmp/atx-agent

2.3 启动

在设备上启动 atx-agent 服务。

# 启动 atx-agent 服务
adb shell /data/local/tmp/atx-agent server -d

默认情况下，atx-agent 监听的端口是 7912。

2.4 常用接口

假设设备的地址是 $DEVICE_URL（例如：http://10.0.0.1:7912），以下是一些常用的接口示例：

获取手机截图
```
curl $DEVICE_URL/screenshot
```
获取当前程序版本
```
curl $DEVICE_URL/version
```
获取设备信息
```
curl $DEVICE_URL/info
```

3. 应用案例和最佳实践

3.1 自动化测试

atx-agent 可以与 openatx/uiautomator2 结合使用，实现 Android 设备的自动化测试。通过统一的 HTTP 接口，可以轻松地控制设备进行截图、安装应用、执行 Shell 命令等操作，从而实现自动化测试流程。

3.2 远程控制

atx-agent 还可以用于远程控制 Android 设备。通过 HTTP 接口，可以远程执行 Shell 命令、获取设备信息、安装应用等操作，适用于远程管理、远程调试等场景。

3.3 数据采集

通过 atx-agent 提供的接口，可以方便地采集 Android 设备的各种数据，如设备信息、应用内存使用情况、CPU 信息等。这些数据可以用于分析设备性能、监控应用状态等。

4. 典型生态项目

4.1 openatx/uiautomator2

openatx/uiautomator2 是一个基于 uiautomator 的 Android 自动化测试框架。它通过 atx-agent 提供的 HTTP 接口，实现对 Android 设备的自动化操作。uiautomator2 提供了丰富的 API，可以方便地进行 UI 自动化测试。