# 模拟器操作模块

**Repository Path**: fjcq/ZsEmuLib

## Basic Information

- **Project Name**: 模拟器操作模块
- **Description**: 易语言模拟器操作模块，支持：雷电模拟器、雷神模拟器、MuMu模拟器等等、同时内部的adb类也可以控制其他开启adb调试的所有安卓设备。
- **Primary Language**: 易语言
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 7
- **Forks**: 3
- **Created**: 2024-10-14
- **Last Updated**: 2026-02-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 雷电模拟器, 雷神模拟器, MuMu模拟器, 易语言, ADB

## README

# 雷神模拟器操作模块

[![Gitee](https://img.shields.io/badge/Gitee-项目主页-orange?logo=gitee)](https://gitee.com/fjcq/ZsEmuLib)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![Release](https://img.shields.io/badge/release-v1.71.0.0-blue)](CHANGELOG.md)

> ## 兼容雷电模拟器、雷神模拟器、MuMu模拟器，统一操作接口，助力开发与测试

---

## 目录

- 📖 [模块简介](#模块简介)
- 📦 [类模块说明](#类模块说明)
- 🛠️ [兼容性说明](#️兼容性说明)
- 🌐 [仓库链接](#仓库链接)
- 📝 [更新日志](#更新日志)

---

## 📖模块简介

本模块虽然名为**雷神模拟器操作模块**，但它兼容以下模拟器的所有操作：

- 雷电模拟器
- 雷神模拟器  
- MuMu模拟器

> 由于开发时间较长，为了兼容现有代码，模块名称及内部类模块名称保持不变。

---

## 📦类模块说明

### 雷神 adb 操作

✅ 兼容所有安卓设备，包括：

- 各类安卓模拟器
- 安卓真机设备

**主要功能**：

- 提供完整的ADB命令封装
- 支持文件上传、下载和管理
- 应用安装、卸载和管理
- 设备控制（重启、关机、截图等）
- 系统信息获取
- 自定义服务启动和管理

### 雷神 lsconsole 操作

🔹 仅适用于：

- 雷电模拟器（2.0及以上版本）
- 雷神模拟器

**主要功能**：

- 模拟器实例管理（启动、停止、新建、克隆）
- 模拟器配置修改
- 窗口管理（位置、尺寸调整）
- 性能参数设置

### 雷神 ls 操作

🔹 仅适用于：

- 雷电模拟器（2.0及以上版本）
- 雷神模拟器

**主要功能**：

- 获取模拟器详细信息
- 运行状态监控
- 配置参数查询
- 模拟器列表管理

### MuMu 管理器

🔸 仅适用于：

- MuMu模拟器12（4.0.0及以上版本）
- MuMu模拟器5（5.0.0及以上版本）

**主要功能**：

- 模拟器连接与断开
- 增强截图功能
- 文本输入（支持Unicode）
- 按键模拟
- 多点触控支持
- 应用显示标识获取

---

## 🛠️兼容性说明

本模块为开发者提供统一的操作接口，便于在不同模拟器平台上开发和测试。

> 虽然模块名称保留`雷神`字样，但功能已扩展至多个模拟器品牌，确保广泛兼容与实用性。

---

## 🌐仓库链接

项目代码和文档托管于Gitee：

[👉 止水/模拟器操作模块](https://gitee.com/fjcq/ZsEmuLib)

---

## 📝更新日志

### v1.71.0.0 （2025-12-10）

#### 优化

- 更名 `MuMu管理器.设置窗口()` 更名为 `MuMu管理器.移动窗口()` 更符合易语言开发习惯，比如 `组件.移动()`
- 更名 `三个操作类` 文件管理相关命令，为避免与核心库命令冲突，进行更名。
  `创建目录()`，`创建文件()`，`删除目录()`，`删除文件()`，
  更名为：
  `创建目录_模拟器()`，`创建文件_模拟器()`，`删除目录_模拟器()`，`删除文件_模拟器()`

#### 修复

- 修复 `MuMu管理器` 所有配置相关操作命令中，当 `索引` 为空时，无法读写默认配置的问题。
- 修复 `MuMu管理器.取性能()` 无法获取 `内存大小` 的问题。
- 修复 `MuMu管理器.窗口排序()` 无法正确排序的问题。
- 修复 `MuMu管理器.修改机型()` 当 `修改值` 为空时，无法移除自定义属性的问题。

---

## 🤝贡献指南

### 提交问题

如果您在使用过程中遇到问题或有改进建议，欢迎通过以下方式提交：

1. **Gitee Issues**：[提交问题](https://gitee.com/fjcq/ZsEmuLib/issues)
2. **详细描述**：请提供完整的错误信息、操作系统版本、模拟器类型和版本、复现步骤

### 代码贡献

1. Fork 本仓库
2. 创建您的特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交您的更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启一个 Pull Request

### 代码规范

- 遵循易语言代码规范
- 函数命名使用中文，清晰易懂
- 关键代码添加注释说明
- 确保向后兼容

---

## 📞联系方式

### 作者信息

- **作者**：止水
- **Gitee**：[fjcq](https://gitee.com/fjcq)
- **项目主页**：[止水/模拟器操作模块](https://gitee.com/fjcq/ZsEmuLib)

### 反馈渠道

- **技术交流**：QQ群 168746446

---

查看更多历史更新，请查阅[CHANGELOG.md](CHANGELOG.md)。