# 模拟器操作模块

**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**: 8
- **Forks**: 4
- **Created**: 2024-10-14
- **Last Updated**: 2026-04-24

## 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.74.0.0 （2026-04-24）

#### 新增

- 新增 `进程详细信息` 数据类型，包含进程ID、进程名、进程路径成员
- 新增 `雷神adb操作.分析ADB结果()` 统一分析ADB命令执行结果，支持成功判断和失败原因输出
- 新增 DLL命令 `取进程完整路径_` 用于获取指定进程的完整可执行文件路径

#### 优化

- 优化 `雷神_取安装目录()` 新增支持雷电模拟器14版本（#版本_雷电14）
- 优化 `雷神_取注册表()` 参数范围扩展，支持雷电模拟器14版本
- 优化 `雷神_取安装目录_全部()` 自动识别雷电模拟器14版本
- 优化 `雷神_取运行中模拟器目录()` 使用增强版进程枚举，一次获取所有进程信息，提高效率
- 优化 `雷神_取PID()` 使用增强版进程枚举，避免多次调用系统API
- 优化 `M_取运行中目录()` 使用增强版进程枚举，提高获取效率
- 优化 `雷神adb操作.上传文件()` 简化逻辑，移除自动重载文件系统功能，使用新的结果分析方法
- 优化 `雷神adb操作.下载文件()` 返回值改为逻辑型，新增错误信息参数，便于错误处理
- 优化 `雷神lsconsole操作.上传文件()` 修复目录判断逻辑，权限不足时直接返回错误提示
- 优化 `正则表达式类` COM库初始化逻辑，增加初始化状态追踪，避免重复初始化和销毁

#### 修复

- 修复 `雷神adb操作.上传文件()` 目录判断使用 `目录_是否存在()` 可能判断不准确的问题，改用 `文件_是否为目录()`
- 修复 `雷神lsconsole操作.上传文件()` 目录判断使用 `目录_是否存在()` 可能判断不准确的问题，改用 `文件_是否为目录()`

---

## 🤝贡献指南

### 提交问题

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

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)。