ModAVD

简体中文

English

简体中文

English

深色模式

安装 ​

以 AUTO-MAS 为例。整个过程不需要管理员权限，开启 Windows 功能那一步除外。

开始前确认 ​

  • Windows 10 / 11，64 位；CPU 是 Intel 或 AMD 的 x86_64。
  • 显卡支持 Vulkan（独立显卡或较新的集成显卡）。
  • AUTO-MAS：推荐 v5.7.0 或更新。v5.7.0-beta.5 起支持 MAA 和全部 MFW 脚本，更早的版本见 Release 说明。
  • 找一块空间大的 NTFS 盘：
    • 补全组件时要约 6.5 GB 可用，装完以后组件和模拟器本体共占约 5 GB；
    • 每台实例第一次开机时，所在的盘要有 10 GB 以上可用；
    • 之后实例随游戏数据增长，一个游戏通常几十 GB。删掉游戏或文件以后，实例文件不会变小，但新写入会复用腾出来的空间。

1. 下载并解压 ​

从 Releases 下载 ModAVD-<版本>-win-x64.zip（下面以 0.36.0 为例）。

压缩包里没有外层文件夹，请右键「全部解压缩」，或用 7-Zip「解压到 ModAVD-0.36.0-win-x64\」，得到 ModAVD-0.36.0-win-x64 文件夹。不要用「解压到当前文件夹」，否则文件会直接散在压缩包所在的目录里。

把它放到一个只含英文、数字的路径，可以改名，例如 D:\ModAVD。

  • 路径里有中文时模拟器起不来，「补全组件」也会直接拒绝。
  • 不要放进 C:\Program Files 这类要管理员权限的目录。
  • 以后所有实例的数据都存在这个文件夹的 avd\ 里，挑空间大的盘。

解压后的文件夹里有：

路径内容
sdk\emulator\模拟器本体；resources\modavd\ 里是 arm64 执行桥
ModAVD.exe管理器（0.36.0 起）。补全组件、收集问题信息、复制配置信息也在这里做
tools\命令行 modavd.exe、装执行桥的 modavd-bridge.ps1（0.36.0 起）
components\轻量桌面 µLauncher 的安装包；0.36.0 起还有宿主输入法 modavd-ime.apk
说明.txt简短说明
LICENSES\许可证和第三方组件声明
modavd-manifest.json包里每个文件的大小和 SHA-256

0.38.1 及更早的包根还有「补全组件.bat」「收集问题信息.bat」「复制配置信息.bat」，tools\ 里有它们调用的 PowerShell 脚本。0.38.2 起这些都没有了，三件事改在管理器或命令行里做。

2. 补全组件 ​

adb 和系统镜像要在你的电脑上从官方渠道下载。两种做法，下载的东西一样：

  • 在管理器里：双击 ModAVD.exe。缺组件时主页上有一条横幅，点它上面的「补全组件」；也可以点顶栏的「电脑检查」，在没通过的「组件」一项下面点「补全组件」。
  • 用命令行：在文件夹的地址栏输入 cmd 回车，运行 tools\modavd.exe components fetch。

0.38.1 及更早的包里是包根的「补全组件.bat」，双击运行；0.38.2 起这个文件没有了。

下面的步骤两种做法相同，只是界面不一样：

  1. 选下载源。可选自动（按顺序试 googledownloads_cn → tencent → google）、只用其中一个、或自定义地址。
    • 管理器的对话框里直接选。选的在你点「同意并下载」时保存。
    • 命令行：还没存过下载源、而且是在控制台里运行时，用编号问一次，直接回车是自动；输入来自管道或文件，或者带了 --json、--accept-license 时不问。
    • 存过以后沿用，不再问。想换，在管理器的「设置」里选「组件下载源」（和更新源并排，选了就保存），或运行 tools\modavd.exe components source [auto|googledownloads_cn|tencent|google]，不带参数是看现在用的。
  2. 从选的下载源取来 Google《Android 软件开发套件许可协议》全文并显示，另存一份到 downloads\android-sdk-license.txt。
    • 管理器：全文显示在对话框里，读完点「同意并下载」；点「不同意」或关掉对话框，什么也不下载。
    • 命令行：输入 y 回车表示同意；直接回车或输入别的内容就退出，什么也不下载。
  3. 同意后下载两样东西，装进 sdk\：
    • 平台工具（adb）37.0.1，约 8 MB；
    • 系统镜像 Android 14（API 34）Google APIs x86_64 r14，约 1.5 GB，解压后约 4.2 GB。
  4. 选的是自动时，镜像按顺序试：googledownloads.cn → 腾讯云镜像 → dl.google.com。一个不通或校验不对就换下一个。
  5. 每个文件下完都核对大小和 SHA-1，通过后才解压。中途断了，再点一次「补全组件」或再运行一次命令，会接着下。
  6. 完成。管理器里这一项下面会显示进度（已下载的字节数、百分比、速度、剩余时间）和「取消」，做完自动重新检查；命令行显示「完成，可以在 AUTO-MAS 里添加这个文件夹了。」。

已经装好的组件会跳过，重复运行没有副作用。过程记录在 logs\fetch-components.log。

补全组件出错时 ​

管理器里失败时，那一项下面写出原因，按钮变成「重试」。命令行会把同样的原因打印出来。

提示怎么办
路径里有中文或其他非英文字符把整个文件夹挪到纯英文路径下，再运行
这里没有 sdk\emulator\emulator.exeRelease 压缩包没解压完整，重新解压，在解压出来的文件夹里运行
磁盘空间不够换一块空间更大的盘
取不到许可协议全文 / 所有镜像都没下成检查网络后重试；已下的部分会保留。也可以换一个下载源
下载源这次给的许可协议和你在管理器里同意的那份不一样什么也没有下载。重新点「补全组件」，读一遍现在的全文再同意
解压后的关键文件或版本校验失败：系统镜像（0.37.0–0.38.0 的包）这几版的「补全组件.bat」有个错，装系统镜像必然失败。在这个文件夹的地址栏输入 cmd 回车，运行 tools\modavd.exe components fetch，看完许可协议输入 y；已经下好的压缩包会直接用

下载太慢或总是失败时，可以用浏览器或下载工具手动下载下面两个文件，文件名不变放进文件夹里的 downloads\，再点「补全组件」或运行 tools\modavd.exe components fetch。它仍要联网取一次许可协议，然后会校验这两个文件，通过就直接用。装好后会删掉 downloads\ 里的这两个压缩包。

文件地址SHA-1
platform-tools_r37.0.1-win.ziphttps://dl.google.com/android/repository/platform-tools_r37.0.1-win.zipe03e78b1d80b396f1c3358e31251cb31740e1110
x86_64-34_r14.ziphttps://dl.google.com/android/repository/sys-img/google_apis/x86_64-34_r14.zipe0f6c9a0691aa27bd597d0deb1bcfdc943ac8ca7

把 dl.google.com/android/repository/ 换成 googledownloads.cn/android/repository/ 也能下到同样的文件。

3. 开启虚拟化 ​

模拟器要用「Windows 虚拟机监控程序平台」：

  1. 按 Win+R，输入 optionalfeatures 回车，打开「启用或关闭 Windows 功能」。
  2. 勾选「Windows 虚拟机监控程序平台」，确定。
  3. 重启电脑。

开了还是不行，多半是 BIOS 里没开 CPU 虚拟化。进 BIOS 打开 Intel VT-x 或 AMD SVM，具体位置看主板说明书。

4. 在 AUTO-MAS 里添加 ​

  1. 打开「模拟器管理」。
  2. 还没有模拟器配置的话，点「手动添加模拟器」，把模拟器类型选成「自动识别（推荐）」；已经有这种配置的直接用它。
  3. 在这个配置里点「管理模拟器」→「添加魔改 AVD（内测）」，选第 1 步解压的文件夹，点「检查」。
  4. 电脑检查全部通过后点「添加」。添加完会自动建好第一台实例。

「检查」里哪一项没通过，就按提示处理；虚拟化没通过见上一节。

不用 AUTO-MAS 时

双击包根的 ModAVD.exe 打开管理器，可以新建实例、开关机、看画面。命令行 tools\modavd.exe 的用法见管理器和命令行。

5. 第一次使用 ​

每台新实例都要先手动开一次机，装游戏、登录账号：

  1. 在设备列表里点这台实例的启动按钮。手动启动会显示模拟器窗口。
  2. 在窗口里从下往上滑，打开应用列表，用 Chrome 到游戏官网下载安卓安装包并安装。系统提示不允许安装未知应用时，按提示允许 Chrome 安装应用。
  3. 打开游戏，登录，下完首次资源，然后在 AUTO-MAS 里关闭实例。

回桌面请用窗口侧边工具栏的 ○ 键；从屏幕底边上滑回不了桌面。

之后由任务拉起时，有没有窗口跟着 AUTO-MAS 的「静默模式」走。具体怎么配合 MAA、M9A 等脚本，以 AUTO-MAS 的说明为准。

卸载 ​

先在 AUTO-MAS 的「管理模拟器」里移除这个模拟器，再删掉整个文件夹。崩溃转储（如果有）在 %TEMP%\AndroidEmulator\emu-crash-37.2.10-mas.db\，可以一并删掉；同一目录下名字里没有 -mas 的是官方模拟器的，不是本项目的。

Android 是 Google LLC 的商标。

文档按 Apache License 2.0 发布