升级
升级就是关掉所有实例后，把新的 Release 包整个解压到旧的根目录（例如 D:\ModAVD），覆盖同名文件。实例、游戏和登录状态都在 avd\ 里，新包里没有这个文件夹，不会被动到；AUTO-MAS 里也不用重新添加。
0.36.0 起包根多了 ModAVD.exe（管理器）和 tools\ 里的 modavd.exe（命令行）、modavd-bridge.ps1，components\ 里多了宿主输入法 modavd-ime.apk。只换 sdk\emulator\ 会少了它们。
哪些会换，哪些不动
| 路径 | 升级时 |
|---|---|
sdk\emulator\ | 模拟器本体，用新包里的覆盖。覆盖不会删掉新版拿掉的文件；想顺便清掉，解压前先删掉旧的这个文件夹（见步骤 3） |
ModAVD.exe（管理器，0.36.0 起） | 用新包里的覆盖 |
tools\：0.36.0 起有 modavd.exe（命令行）、modavd-bridge.ps1（arm64 执行桥的安装 / 卸载 / 检查）；0.38.1 及更早还有 fetch-components.ps1、collect-info.ps1、report-config.ps1 | 用新包里的覆盖。三个 .ps1 从 0.38.2 起不再随包发：用 modavd update 升级会自动删掉，手动覆盖时会留着，不碍事，可以自己删 |
components\：de.jrpie.android.launcher_57.apk（µLauncher）；0.36.0 起还有 modavd-ime.apk（宿主输入法） | 用新包里的覆盖 |
说明.txt、LICENSES\、modavd-manifest.json | 用新包里的覆盖 |
补全组件.bat、收集问题信息.bat、复制配置信息.bat（0.38.1 及更早的包根里有） | 0.38.2 起新包里没有，三件事改在管理器和命令行里做（见安装和反馈问题）。用 modavd update 升级会自动删掉这三个文件，手动覆盖时会留着，不碍事，可以自己删 |
avd\ | 不动，新包里没有这个文件夹。实例、游戏和登录状态都在这里 |
sdk\platform-tools\、sdk\system-images\ | 不动，新包里也没有。新版要求的版本变了时，Release 说明里会写，届时在管理器里再点「补全组件」，或运行 tools\modavd.exe components fetch |
mas-avd.json、logs\ | 不动。这是 AUTO-MAS 和模拟器自己写的 |
步骤
- 关掉所有实例：AUTO-MAS 里开的，以及 0.36.0 起管理器
ModAVD.exe里开的；开着ModAVD.exe的话，也把它的窗口关掉。稍等半分钟，模拟器的附属进程退出要十几秒；确认任务管理器里没有qemu-system-x86_64进程。 - 下载新的 Release 包。0.32.1 起压缩包里没有外层文件夹，
sdk\、tools\这些直接在压缩包的根上。 - （可选）想顺便清掉新版拿掉的旧文件，先删掉旧根目录里的
sdk\emulator\。只删这一个文件夹，avd\和sdk\下的其他文件夹都不要动。 - 把新包整个解压到旧的根目录，遇到同名文件一律替换。右键「全部解压缩」默认会新建一个和压缩包同名的文件夹，要把目标改成旧的根目录；用 7-Zip 时也是选旧的根目录作目标，不要用「解压到 <包名>\」。覆盖时提示文件被占用，是模拟器的附属进程还没退出，再等一会儿重试。
- 打开
sdk\emulator\source.properties，确认Pkg.BuildId是新版本号（例如mas-36）。 - 不用重新下载组件，AUTO-MAS 里也不用重新添加，照常开机即可。
从内测包升级
内测包（例如 ModAVD-37.2.10-mas25）自带 adb 和系统镜像，和「补全组件」下载的是同一版本，所以：
- 按上面的步骤把新包整个解压到内测包的根目录。内测包里没有的文件（例如
LICENSES\，以及 0.36.0 起的ModAVD.exe）会一起放进去； - 不需要再补全组件。在命令行里运行
tools\modavd.exe components fetch也没关系，它会显示组件都已齐全并跳过。
内测包里的旧实例可以直接用新版开机。
退回旧版本
先卸执行桥
退回 0.36.0 以前的版本之前，先在每一台实例上运行一次 tools\modavd.exe bridge <编号> uninstall，看到结果是「没装」再换包。
不先卸就退版，那台实例可能变成系统属性指着一个已经不存在的库，所有只有 arm64 版本的应用都跑不起来，界面上也看不出来。
版本太旧时
AUTO-MAS 会检查模拟器的版本号（Pkg.BuildId），太旧时拒绝开机并提示更新。按上面的步骤换成新版即可。
版本号怎么读
从 0.32.1 起版本号写成 0.<构建号>.<重新打包次数>：
- 0 表示还在内测；
- 构建号就是
Pkg.BuildId里的 mas-N，例如0.36.0是 mas-36； - 最后一位是不重新编译、只重新打包的次数。
0.32.1 的模拟器和之前发布的 37.2.10-mas32 相同，只是换成了新的包格式。