Back to Details

mumu-manager-cli

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

MuMuManager CLI

MuMuManager CLI

用途

Purpose

使用命令行查询和管理 MuMu 模拟器 12 的实例与应用配置，适合账号矩阵、批量开关、自动化脚本、运维排障等场景。
Use the command line to query and manage instances and application configurations of MuMu Emulator 12, suitable for scenarios such as account matrix management, batch startup/shutdown, automation scripts, and operation and maintenance troubleshooting.

前置要求

Prerequisites

  • 确保模拟器版本 V4.0.0.3179 或以上，否则部分命令不可用。
  • 定位 
    MuMuManager.exe
    ，常见路径：
    X:\Program Files\Netease\MuMuPlayer-12.0\shell\MuMuManager.exe
    ；本机路径示例：
    C:\Program Files\Netease\MuMu\nx_main\MuMuManager.exe
    。
  • 建议使用绝对路径，或将 
    nx_main
    目录加入 
    PATH
    。
  • Ensure the emulator version is V4.0.0.3179 or later, otherwise some commands will not be available.
  • Locate 
    MuMuManager.exe
    , common path: 
    X:\Program Files\Netease\MuMuPlayer-12.0\shell\MuMuManager.exe
    ; local path example: 
    C:\Program Files\Netease\MuMu\nx_main\MuMuManager.exe
    .
  • It is recommended to use an absolute path, or add the 
    nx_main
    directory to 
    PATH
    .

使用流程

Usage Process

  1. 先用 
    info
    确认可用实例；
    -v
    支持逗号分隔列表或 
    all
    。
  2. 选择需要的任务（创建/克隆/删除/重命名/导入/导出/ADB/应用/控制/设置）。
  3. 尽量缩小作用范围，谨慎对 
    all
    执行写操作。
  1. First use 
    info
    to confirm available instances; 
    -v
    supports comma-separated lists or 
    all
    .
  2. Select the required task (create/clone/delete/rename/import/export/ADB/app/control/setting).
  3. Try to narrow the scope of action, and be cautious when performing write operations on 
    all
    .

功能速查

Quick Feature Reference

实例管理

Instance Management

  • info
    查看实例状态与字段说明
  • create / clone / delete / rename
    创建/克隆/删除/重命名实例
  • import / export
    备份与恢复 
    .mumudata
    （可选 
    --zip
    ）
  • info
    View instance status and field descriptions
  • create / clone / delete / rename
    Create/clone/delete/rename instances
  • import / export
    Backup and restore 
    .mumudata
    (optional 
    --zip
    )

常见坑与规避

Common Pitfalls and Avoidance

  • 删除实例前先关闭该实例：
    control -v <index> shutdown
    。未关闭时可能返回 
    {"errcode": -1, "errmsg": "not handle cmd"}
    。
  • Shut down the instance before deleting it: 
    control -v <index> shutdown
    . If not shut down, it may return 
    {"errcode": -1, "errmsg": "not handle cmd"}
    .

启动与窗口控制

Startup and Window Control

  • control launch / shutdown / restart
    启动/关闭/重启实例
  • control show_window / hide_window / layout_window
    显示/隐藏/布局窗口
  • control launch / shutdown / restart
    Start/shutdown/restart instances
  • control show_window / hide_window / layout_window
    Show/hide/layout windows

应用管理

Application Management

  • control app install / uninstall / launch / close / info
    使用包名或 apk 路径
  • control app info -i
    查看已安装应用与当前前台应用
  • control app install / uninstall / launch / close / info
    Use package name or apk path
  • control app info -i
    View installed apps and current foreground app

系统工具

System Tools

  • control tool func
    常用功能（截图、刷新、主页、设置、安全等）
  • control tool downcpu
    降低 CPU
  • control tool location / gyro
    虚拟定位与重力感应
  • control shortcut create / delete
    创建/删除桌面快捷方式
  • control tool func
    Common functions (screenshot, refresh, home, settings, security, etc.)
  • control tool downcpu
    Reduce CPU usage
  • control tool location / gyro
    Virtual location and gyroscope simulation
  • control shortcut create / delete
    Create/delete desktop shortcuts

设备配置与仿真

Device Configuration and Simulation

  • setting
    读取/修改配置，支持 
    --all / --all_writable / --info / --path
  • simulation
    修改仿真属性（IMEI/IMSI/Android ID/MAC 等）
  • setting
    Read/modify configurations, supports 
    --all / --all_writable / --info / --path
  • simulation
    Modify simulation attributes (IMEI/IMSI/Android ID/MAC, etc.)

ADB 命令

ADB Commands

  • adb -c
    常用快捷命令（清理缓存/截图/录屏等）
  • adb -c "shell ..."
    执行自定义 shell 命令
  • adb -c
    Common shortcut commands (clear cache/screenshot/screen recording, etc.)
  • adb -c "shell ..."
    Execute custom shell commands

其他

Others

  • sort
    自动排列窗口
  • driver install / uninstall -n lwf
    安装/卸载驱动（可能需要管理员权限）
  • 辅助接口 
    api
    仅在必要时使用，稳定性依赖版本
  • sort
    Automatically arrange windows
  • driver install / uninstall -n lwf
    Install/uninstall driver (may require administrator privileges)
  • The auxiliary interface 
    api
    should only be used when necessary, and its stability depends on the version

参考

References

  • 详见 
    references/mumu-manager-cli.md
  • 快速定位关键词： 
    • control app
      应用管理
    • setting
      配置项与 JSON 修改
    • simulation
      仿真属性
    • adb
      ADB 命令
    • driver
      驱动管理
  • See 
    references/mumu-manager-cli.md
    for details
  • Quick keyword lookup: 
    • control app
      Application management
    • setting
      Configuration items and JSON modification
    • simulation
      Simulation attributes
    • adb
      ADB commands
    • driver
      Driver management