Skip to content

文字照实写、统一叫 ModAVD:更新说明、补全组件、问题包和配置信息 - #111

Merged
qiyinxi merged 5 commits into
ModAVD:mainfrom
qiyinxi:fix/update-hint-copy
Nov 9, 2026
Merged

qiyinxi merged 5 commits into
ModAVD:mainfrom
qiyinxi:fix/update-hint-copy

Conversation

@qiyinxi

@qiyinxi qiyinxi commented Nov 9, 2026 •

Copy link
Copy Markdown
Member

现在很多人不用 AUTO-MAS,单独用 ModAVD。管理器和命令行里有好几处文字是照「用户都在用 AUTO-MAS」写的,有一处还说错了;程序里还到处叫「魔改 AVD」。这个 PR 把它们改成照实说,名字统一成 ModAVD。只改文字,行为不变。

设置里的更新说明(说错了)

原文:「更新现在由 AUTO-MAS 发起(它调用 modavd update),会按这里选的更新源和 CDK 下载;这里先不能直接更新。」

  • AUTO-MAS(到 v5.8.0)更新魔改 AVD 用的还是它自己的更新器(app/utils/common/emulator2/avd/updater.py),不调用 modavd update。
  • 它的更新源和 Mirror 酱 CDK 读的是 AUTO-MAS 自己的设置(Update.MirrorChyanCDK),不读管理器这里的。管理器这里的设置只用于「检查更新」和命令行 modavd update,README「更新 ModAVD」一节也是这么写的。
  • 原文只告诉用 AUTO-MAS 的人怎么更新。

新文案:

这里暂时只能检查新版本。用 AUTO-MAS 的,在 AUTO-MAS 里更新(它用 AUTO-MAS 设置里的更新源和 CDK);不用 AUTO-MAS 的,关掉所有实例和管理器,把新版整包覆盖解压到这个文件夹,avd 文件夹不会被动到。这里的更新源和 CDK 只用于「检查更新」和命令行 modavd update。

不用 AUTO-MAS 时的做法照 ModAVD 发布说明「怎么更新」一节写。「更新」按钮的悬停提示改成「这里暂时不能直接更新」,按钮照旧不可用。

其他默认用户在用 AUTO-MAS 的文字

哪里 原来 现在
补全组件做完(管理器、命令行) 完成,可以在 AUTO-MAS 里添加这个文件夹了。 完成,可以新建实例了;用 AUTO-MAS 的,也可以在 AUTO-MAS 里添加这个文件夹了。
收集问题信息后没找到 AUTO-MAS(管理器、命令行、summary.txt 末尾) 没找到 AUTO-MAS 安装目录,反馈时请附上 AUTO-MAS 的 debug 文件夹里的日志 没找到 AUTO-MAS 安装目录。用 AUTO-MAS 的,反馈时请另附上它 debug 文件夹里的日志;不用 AUTO-MAS 的不用管。
summary.txt 的 AUTO-MAS 一节 同上 没找到 AUTO-MAS 安装目录(不用 AUTO-MAS 的不用管)
问题包的隐私说明 里面有:…实例配置、AUTO-MAS 日志(mas 文件夹);… 里面有:…实例配置;找到 AUTO-MAS 时还有它的日志(mas 文件夹);…
summary.txt 读不到 qemu 命令行时 多半是 AUTO-MAS 以管理员运行 多半是模拟器以管理员身份运行
复制配置信息:要人补的几行 AUTO-MAS 版本:/用的脚本(MAA / M9A / …):/效果… 怎么用的(自己玩 / AUTO-MAS 及版本 / MAA、M9A 等脚本):/效果…(命令行的提示相应改成「最后两行」)
复制配置信息:没开实例时 在 AUTO-MAS 里开着实例时再双击运行一次,就会列出来 开着实例时再生成一次,就会列出来
portBase 不合规的建议 改成 20000(和 AUTO-MAS 一样) 改成 20000(默认值)
换包后当场恢复也失败 下次更新或 AUTO-MAS 启动时会再按记录恢复 下次更新时会再按记录恢复(用 AUTO-MAS 的,它启动时也会)

没改的:说明不收 AUTO-MAS 配置和账号数据的话、--automas-version 的说明、问题包里 AUTO-MAS 一节的标题、「例如 AUTO-MAS 以管理员身份运行时」这类举例。它们本来就只在用 AUTO-MAS 时才相关。

名字统一叫 ModAVD

所有语言都只用 ModAVD,不再用「魔改 AVD」:日志、报错、命令行帮助、问题包和配置信息的标题都换掉,问题包文件名从 魔改AVD问题信息-<时间>.zip 改成 ModAVD-问题信息-<时间>.zip,和中文相邻时加空格(比如「ModAVD 实例 0 私有 adb 用不了」「--root 指定的 ModAVD 根目录不存在」)。

AUTO-MAS 只看 --json 里的错误码,不看消息文字(v5.8.0 的 avd/cli.py 按 code 判断),所以改名不影响对接。

测试

  • 问题包和配置信息的对照测试,基准文件是旧脚本 collect-info.ps1、report-config.ps1 的原样输出。这次照「隐私提示」第一行的做法,把有意改动的行(包括旧名字)列进对照表 reworded,基准文件不动。
  • 对照 AUTO-MAS 原逻辑的 Python 参考 avd/testdata/instances_ref.py 里的报错文字跟着换成 ModAVD;jsonord 的非 ASCII 样例换了文字,pycases.json 用 gen_pycases.py 重新生成(只变了这一条)。
  • gofmt、go vet ./...(含 darwin/arm64、linux/amd64)、go test ./... 全部通过;update.js 过了 node --check。没在管理器窗口里看显示效果。

文档跟着改的在 ModAVD/modavd.github.io#23(安装指南引用的那句、「补完最后三行」、问题包文件名),跟带这个 PR 的版本发布一起合。

原文说 AUTO-MAS 调用 modavd update、按这里的更新源和 CDK 下载,两处都不对:
AUTO-MAS 到 v5.8.0 还是用自己的更新器,更新源和 CDK 读它自己的设置。
改成写清这里只能检查新版本、用和不用 AUTO-MAS 各自怎么更新、这里的设置
管什么。按钮照旧不可用。
@qiyinxi qiyinxi added the bug Something isn't working label Nov 9, 2026
- 补全组件完成:先说可以新建实例了,再说用 AUTO-MAS 的可以去添加。
- 问题包没找到 AUTO-MAS:只请用 AUTO-MAS 的附上它的日志,不用的不用管
  (管理器、命令行、summary.txt 三处);隐私说明里 AUTO-MAS 日志写成
  找到它时才有;qemu 命令行读不到时不再说多半是 AUTO-MAS 以管理员运行。
- 复制配置信息:「AUTO-MAS 版本」「用的脚本」两行并成「怎么用的
  (自己玩 / AUTO-MAS 及版本 / MAA、M9A 等脚本)」;没开实例时不再叫人
  在 AUTO-MAS 里开着实例再双击运行。
- portBase 的建议写「默认值」,不写「和 AUTO-MAS 一样」;换包恢复失败的
  提示先说下次更新时恢复。

对照旧脚本输出的测试照原来的做法,把这些有意改动的行列进对照表,基准文件不动。
@qiyinxi qiyinxi changed the title 设置里的更新说明照实写:AUTO-MAS 用自己的更新器和设置 不再默认用户都用 AUTO-MAS:更新说明、补全组件、问题包和配置信息的文字 Nov 9, 2026
所有语言都只用 ModAVD 这个名字:日志、报错、命令行帮助、问题包和配置信息的
标题都换掉,问题包文件名改成 ModAVD-问题信息-<时间>.zip。和中文相邻时加空格。

AUTO-MAS 只看错误码,不看消息文字,改名不影响对接。对照旧脚本输出的测试把
旧名字列进有意改动的对照表;对照 AUTO-MAS 原逻辑的 Python 参考和 jsonord 的
样例跟着换了文字,pycases.json 用 gen_pycases.py 重新生成。
qiyinxi added a commit to qiyinxi/modavd.github.io that referenced this pull request Nov 9, 2026
首页中文标语改成「Windows 上的安卓模拟器」,和英文一致;问题包文件名跟管理器
改成 ModAVD-问题信息-<时间>.zip(ModAVD/ModAVDManager#111)。AUTO-MAS 界面上的
按钮名「添加魔改 AVD(内测)」是它自己的文字,照原样引用。
@qiyinxi qiyinxi changed the title 不再默认用户都用 AUTO-MAS:更新说明、补全组件、问题包和配置信息的文字 文字照实写、统一叫 ModAVD:更新说明、补全组件、问题包和配置信息 Nov 9, 2026
@qiyinxi
qiyinxi added this pull request to the merge queue Nov 9, 2026
@github-merge-queue
github-merge-queue Bot removed this pull request from the merge queue due to a conflict with the base branch Nov 9, 2026
@qiyinxi
qiyinxi added this pull request to the merge queue Nov 9, 2026
@github-merge-queue
github-merge-queue Bot removed this pull request from the merge queue due to a conflict with the base branch Nov 9, 2026
# Conflicts:
#	internal/adb/adb.go
#	internal/emu/start.go
@qiyinxi
qiyinxi added this pull request to the merge queue Nov 9, 2026
Merged via the queue into ModAVD:main with commit c3781b8 Nov 9, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant