javadevelopuser/MobileManager

MobileManager 是一个强大的移动设备管理系统，基于 ADB (Android Debug Bridge) 实现设备控制和管理。系统采用 GoFrame + Vue3 Pure Admin + WebScrcpy 技术栈，提供设备管理、应用管理、远程控制等功能。

➤ MobileManager

观看合集视频-运行篇 | Watch Demo Video

基于 ADB 的移动设备管理系统 | ADB-based Mobile Device Management System

MobileManager 是一个强大的移动设备管理系统，基于 ADB (Android Debug Bridge) 实现设备控制和管理。系统采用 GoFrame + Vue3 Pure Admin + WebScrcpy 技术栈，提供设备管理、应用管理、远程控制等功能。

🚀 最近更新 (v2.1.0 - 2025-04-21)

• ✅ 主设备添加触摸事件支持
• ✅ 实现主从设备触摸事件同步操作
• ✅ 支持单个子设备独立的触摸事件
• ✅ 支持主从按键消息同步操作
• ✅ 支持单个设备独立按键操作

查看完整更新历史：更新日志

✨ 核心特性

• 📱 设备管理

  • 添加、编辑、删除设备
  • 设备分组管理
  • 批量设备操作
  • 设备状态监控

• 📦 应用管理

  • 应用安装/卸载
  • 应用启动控制
  • 批量应用操作
  • 应用上传管理

• 🖥️ 远程控制

  • 基于 WebScrcpy 的设备实时串流
  • 设备远程操作
  • 低延迟传输

• 🎯 批量操作

  • 多设备并行控制
  • 任务状态实时显示
  • 操作结果反馈

🛠️ 技术栈

后端技术

• GoFrame v2.0：基于 Golang 的 Web 开发框架
• SQLite：轻量级数据库
• ADB：Android 调试桥接

前端技术

• Vue 3：渐进式 JavaScript 框架
• TypeScript：类型安全
• Pure Admin：优雅的后台管理模板
• Element Plus：UI 组件库
• Pinia：状态管理
• WebScrcpy：设备串流控制

🚀 快速开始

环境要求

• Go 1.18+
• Node.js 16+
• ADB 工具（必须安装并配置环境变量）
• pnpm 包管理器

⚠️ 注意：本系统依赖 ADB (Android Debug Bridge) 环境，请确保在使用前已正确安装并配置 ADB，且可以在命令行中直接使用 adb 命令。

安装步骤

1. 克隆项目

git clone https://github.com/yourusername/MobileManager.git
cd MobileManager

2. 后端服务

cd backend
go mod tidy
mv backend\manifest\config\config.yaml.bak backend\manifest\config\config.yaml
go run main.go

3. 前端服务

cd frontend
pnpm install
rm frontend\.env && mv frontend\.env.bak frontend\.env
pnpm run dev

4. 串流服务（WebScrcpy）

cd wscrcpy
pnpm install
pnpm start

💡 提示：需要同时运行后端服务、前端服务和串流服务。建议在三个不同的终端窗口中分别启动各服务。

📚 功能列表

已实现功能

• ✅ 设备管理（添加/编辑/删除）
• ✅ 设备分组管理
• ✅ 设备远程串流控制
• ✅ 批量设备操作
• ✅ 应用管理（上传/安装/卸载/启动）
• ✅ 图片缓存刷新
• ✅ 任务状态显示
• ✅ 云机同步（多设备同步操作）
• ✅ 基于WebCodecs的视频流解码
• ✅ 多设备主从画面显示

开发计划

• 🔲 应用账号管理
• 🔲 脚本管理与执行
• 🔲 代理配置
• 🔲 设备性能监控
• 🔲 自动化测试支持

📦 项目结构

MobileManager/
├── backend/                # GoFrame 后端项目
│   ├── api/               # API 接口定义
│   ├── internal/          # 内部实现
│   └── manifest/          # 配置文件
├── frontend/              # Vue3 前端项目
│   ├── src/
│   │   ├── api/          # API 请求
│   │   ├── components/   # 组件
│   │   └── views/        # 页面
└── wscrcpy/              # WebScrcpy 集成

📄 贡献指南

欢迎提交 Issue 和 Pull Request！

📄 开源协议

本项目采用 Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0) 协议。

这意味着您可以：

• ✅ 自由使用、复制、修改和分享本项目
• ✅ 以任何形式重新分发本项目
• ❌ 不得将本项目用于商业目的

使用条件：

1. 署名：必须给出适当的署名，提供指向本许可证的链接，同时标明是否对原始内容作出修改
2. 非商业性：不得将本项目用于商业目的
3. 分享时保持许可协议一致：如果您修改了本项目，必须以相同的许可证分发您的贡献

本项目使用的第三方组件遵循其原有的许可证：

• ws-scrcpy - MIT 许可证