✅ **查看 `atx-agent` 版本有 4 种可靠方法（按推荐顺序排列），全部基于 Android 系统原生命令，无需 root、无需 Python、100% 准确**。下面我为你逐条说明原理、命令、输出示例、适用场景，并指出 **最推荐的「黄金命令」**。 --- ## ✅ 方法 1：【黄金推荐】`adb shell ps | grep atx-agent`（最准、最快、最通用） ### 🔹 原理： `atx-agent` 是一个在 Android 后台运行的守护进程（Linux daemon），启动时会在 `ps` 进程列表中显示其完整路径和版本号（如 `/data/local/tmp/atx-agent-v1.24.5`）。 ### 🔹 命令（复制即用）： ```bash adb shell ps | grep atx-agent | grep -o "v[0-9.]\+" ``` ### 🔹 正确输出示例： ```text v1.24.5 ``` ### 🔹 为什么最推荐？ - ✅ **不依赖 Python 环境**（即使 `uiautomator2` 没装也能查） - ✅ **不依赖网络或端口**（`ps` 是系统级命令，100% 可靠） - ✅ **直接读取进程名中的版本字符串**（无解析误差） - ✅ **兼容所有 Android 版本（5.0+）** > ⚠️ 注意：如果输出为空 → `atx-agent` **根本没运行**（需执行 `uiautomator2 init`） --- ## ✅ 方法 2：`adb shell /data/local/tmp/atx-agent -v`（官方支持的版本命令） ### 🔹 原理： `atx-agent` 二进制文件内置 `-v`（version）参数，直接返回语义化版本号。 ### 🔹 命令： ```bash adb shell "/data/local/tmp/atx-agent -v" 2>/dev/null ``` ### 🔹 正确输出示例： ```text atx-agent version: v1.24.5 ``` ### 🔹 优点 & 注意： - ✅ 官方定义，语义清晰 - ❗ 需确保 `atx-agent` 已安装到 `/data/local/tmp/`（`uiautomator2 init` 默认位置） - ❗ 如果设备是 `arm64-v8a` 架构但误装了 `armeabi-v7a` 版本，此命令可能报 `not executable`（此时用方法 1 更鲁棒） --- ## ✅ 方法 3：`adb shell dumpsys package com.github.uiautomator | grep versionName`（查 APK 版本） ### 🔹 原理： `atx-agent` 的 Android 封装版（`com.github.uiautomator`）会以 APK 形式安装，其 `versionName` 即为 `atx-agent` 版本。 ### 🔹 命令： ```bash adb shell dumpsys package com.github.uiautomator | grep versionName ``` ### 🔹 正确输出示例： ```text versionName=1.24.5 ``` ### 🔹 优点 & 局限： - ✅ 适用于通过 `uiautomator2 init --apk` 安装的用户（GUI 方式） - ❌ 不适用于纯 `atx-agent` 二进制部署（如 `--no-apk` 模式） - ❌ 如果 APK 被卸载（只留二进制），此命令返回空 --- ## ✅ 方法 4：Python 中调用 `d.info['atxAgentVersion']`（仅当 uiautomator2 已连接） ### 🔹 原理： `uiautomator2` 在连接设备后，会主动从 `atx-agent` HTTP 接口 `/info` 获取版本信息并缓存。 ### 🔹 Python 代码： ```python import uiautomator2 as u2 d = u2.connect() print("atx-agent version:", d.info.get('atxAgentVersion', 'UNKNOWN')) ``` ### 🔹 输出示例： ```text atx-agent version: v1.24.5 ``` ### 🔹 优点 & 风险： - ✅ 一行 Python，适合脚本内嵌检查 - ❗ **前提：`atx-agent` 必须正在运行且 HTTP 端口（7912）可访问** - ❗ 如果 `atx-agent` 崩溃或端口被占，`d.info` 可能超时或返回旧缓存值 --- ## 🧪 附：一键全检命令（推荐保存为 `check_atx.sh`） ```bash #!/bin/bash echo "🔍 Checking atx-agent version..." echo "================================" echo "1️⃣ Method 1 (ps + grep):" adb shell ps | grep atx-agent | grep -o "v[0-9.]\+" || echo "❌ NOT RUNNING" echo -e "\n2️⃣ Method 2 (binary -v):" adb shell "/data/local/tmp/atx-agent -v" 2>/dev/null || echo "❌ Binary not found or not executable" echo -e "\n3️⃣ Method 3 (APK version):" adb shell dumpsys package com.github.uiautomator 2>/dev/null | grep versionName || echo "❌ APK not installed" echo -e "\n4️⃣ Method 4 (via uiautomator2):" python3 -c " import uiautomator2 as u2 try: d = u2.connect() ver = d.info.get('atxAgentVersion', 'UNKNOWN') print('✅', ver) except Exception as e: print('❌', e) " 2>/dev/null echo -e "\n💡 Tip: If all show 'NOT RUNNING', run:" echo " python3 -m uiautomator2 init --reinstall" ``` 运行： ```bash chmod +x check_atx.sh && ./check_atx.sh ``` --- ## 📌 终极结论：你应该记住的「一句话」 > ✅ **最可靠、最快速、最通用的命令是：** > ```bash > adb shell ps | grep atx-agent | grep -o "v[0-9.]\+" > ``` > **如果它输出 `v1.24.0` 或更高 → 你的 `atx-agent` 支持 `display_id`；否则必须升级。** ---