# android-automate

**Repository Path**: xiao-azhang/android-automate

## Basic Information

- **Project Name**: android-automate
- **Description**: 基于安卓无障碍服务开发的UI自动化中间件，采用客户端-服务端架构，服务端通过socket连接为客户端提供节点查询、点击输入等交互能力
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2024-06-10
- **Last Updated**: 2025-07-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 项目描述

该项目是基于安卓无障碍服务开发的安卓自动化中间件，用于进行UI自动化的数据采集。
项目的灵感和无障碍服务的使用借鉴于开源项目`AutoJs`，不同的是该项目采用`客户端与服务端`的架构方式，安卓手机作为服务端，PC电脑作为客户端，双方通过socket进行连接。

---

# 模块说明

## automate-server

该模块为安卓工程，使用SDK安卓10(API30)开发，主要实现无障碍服务的细化功能封装并暴露给客户端，建议使用`Android Studio`打开项目。

## automate-client

该模块为运行在PC端的客户端程序，主要进行一个示例演示和功能调试

---

# 使用说明

前置条件：连接上数据线，开启usb调试模式
`build`目录下的`release/app-release.apk`是一个已经打包编译并签名的apk，可以直接安装到手机上。

具体的使用见`automate-client`模块下的测试样例。

---
# 开发计划
- √ 协议制定与实现
- √ 控件查找
- √ 控件操作（点击、输入......）
- √ 全局操作（back键、home键、任务键）
- √ API封装
- √ 获取app相关信息（activity......）
- √ 对app的相关操作（启动......）
- √ 模拟手势
- √ 隐式等待
- ......

---

# 未完待续 ......