Steam Deck 上 Waydroid 环境的更新、重装与彻底卸载完整指南【免费下载链接】SteamOS-Waydroid-InstallerScript to easily install / uninstall Android via Waydroid on the Steam Deck running on SteamOS stable, beta or MAIN!项目地址: https://gitcode.com/gh_mirrors/st/SteamOS-Waydroid-Installer在 Steam Deck 上装好 Android 环境只是第一步真正考验人的是之后的日子系统更新了要不要重装游戏闪退要不要重置玩腻了想彻底删除又怕删不干净。这套由SteamOS-Waydroid-Installer驱动的 Waydroid 环境维护起来其实比想象中简单关键是选对路径。这篇完整指南会带你从判断处境开始一步步走完升级、修复、卸载三条路并附上常见报错的对照解法让你以后不再为维护发愁。先对号入座你现在属于哪种处境别急着敲命令先花 30 秒定位自己的状态。你的需求基本逃不出下面三种情况你的现状典型表现推荐路径一切正常想尝鲜或修 Bug想玩新游戏、想要新功能路径一安全升级应用闪退、无法启动、配置越改越乱装过旧版本、手动改过配置路径二卸载重装不再需要 Android 环境想释放空间、恢复原厂状态路径三彻底卸载无论走哪条路动手前请先过一遍这套前置条件检查表对应项目里的sanity-checks.sh会自动替你校验处于桌面模式不能在 ssh 或虚拟终端里跑安装脚本SteamOS 版本为3.7.x 稳定版或 beta3.8 及以上有已知风险见下文避坑红线home 分区剩余空间不少于 10GB已经设置好sudo 密码网络连接正常能访问镜像服务器确认无误就可以放心往下走了。路径一安全升级让 Waydroid 跟上最新版本先给你吃颗定心丸Waydroid 的升级本质上就是重新拉取最新脚本 重跑一遍安装脚本会自动处理内核模块、Android 镜像下载、ARM 翻译层等一系列脏活累活你基本只需要负责确认。第一步选对分支项目用main和testing两个分支维护版本别搞混了分支特点适合谁main已经过 1-2 周验证最稳追求稳定的日常用户testing新特性优先发布可能有 Bug想抢先体验的尝鲜派第二步重新拉取脚本并安装打开终端Konsole输入下面这组命令升级到稳定分支cd ~/ git clone --depth1 https://gitcode.com/gh_mirrors/st/SteamOS-Waydroid-Installer cd ~/SteamOS-Waydroid-Installer chmod x steamos-waydroid-installer.sh ./steamos-waydroid-installer.sh想体验测试分支的话把第一条命令换成带-b testing的版本即可git clone --depth1 -b testing https://gitcode.com/gh_mirrors/st/SteamOS-Waydroid-Installer安装过程大约 5 分钟取决于网速。另外桌面上那个Waydroid-Updater快捷方式也是干这件事的懒得敲命令就双击它。为什么要走重跑脚本这条路因为脚本更新得很勤——从更新日志看几乎每个月都有新镜像、新翻译层和新游戏兼容修复旧版本的问题很可能已经被新版本顺手修掉了。第三步升级后的验收清单跑完脚本别急着关按这个清单确认一下回到游戏模式启动Android_Waydroid_Cage看能否正常进入系统在设置里核对 Android 版本号支持 Android 11 / Android 13 及对应的 TV 版本装一个游戏实测 ARM 翻译层是否生效比如《植物大战僵尸 2》路径二卸载重装最高效的排障手段如果你遇到的是怎么修都修不好的疑难杂症记住一条铁律先卸载、再安装往往比硬修快得多。脚本迭代这么快你踩的坑八成在新版本里已经被填平了。第一步通过 Waydroid Toolbox 卸载在桌面模式下找到Waydroid Toolbox图标并双击打开这个工具箱集成了 ADBLOCK广告拦截、AUDIO音频、SERVICE服务开关、GPU显卡、LAUNCHER启动器、NETWORK网络和UNINSTALL卸载等多个选项。选择UNINSTALL后工具箱会提示你输入 sudo 密码进行授权。这里有一个贴心的小分支值得注意卸载时可以选择保留 Android 用户数据还是连同数据一起完整卸载。如果你只是想去掉旧配置、重新安装选保留数据就能省去重新登录账号的麻烦。第二步重新安装卸载完成后回到路径一重新 clone 最新代码并执行安装即可。整个卸载—重装周期大约 5-10 分钟换来一个干净且最新的环境这笔账怎么算都划算。进阶命令行操作如果你是喜欢掌控一切的高级用户也可以直接用 systemd 停掉容器服务sudo systemctl stop waydroid-container不过说句实在话普通用户完全没必要手动折腾Waydroid Toolbox 一个选项就能搞定还不会因为少删了某个配置文件留下后遗症。路径三彻底卸载把 Android 环境干干净净送走决定彻底告别了放心卸载比你想象中温柔按下面三步走就能还你一个原汁原味的 SteamOS。第一步进入桌面模式按下Steam 按钮 → 电源 → 切换至桌面等待系统完成切换。为什么要切桌面因为卸载工具是图形化的而且脚本本身也要求必须运行在桌面会话里直接终端操作容易踩坑。第二步启动 Waydroid Toolbox 并选择 UNINSTALL双击桌面上的Waydroid Toolbox选择UNINSTALL。工具箱会自动完成下面这些操作全程不需要你操心停止 Waydroid 相关服务与容器卸载已安装的软件包与内核模块移除 Android 镜像、配置文件与启动项清理桌面快捷方式并恢复系统只读设置第三步卸载后的残留检查卸载完成后花一分钟确认没有尾巴桌面和 KDE 菜单里是否还有 Waydroid 相关图标若有重启一次一般就消失了~/Android_Waydroid目录是否已不存在/var/lib/waydroid是否已清空全部干净恭喜你存储空间回来了——一个 Android 镜像加应用数据通常能释放2-4GB甚至更多。常见报错对照表遇到问题先查这张表维护路上难免翻车我把最常见的几个坑整理成了对照表先自查再求助报错现象可能原因解决办法下载 Android 镜像极慢或中断连到了慢速镜像源按 CtrlC 取消重新运行脚本提示 hash mismatch / 下载损坏网络波动导致文件不完整重试一次仍失败则带截图反馈提示 home 分区空间不足剩余空间低于 10GB清理 SteamOS 缓存后重试游戏模式里没有生成快捷方式脚本在 ssh 会话中运行改到桌面模式 Konsole 里重跑SteamOS 更新后 Waydroid 消失系统更新机制会清空环境属正常行为重新运行安装脚本即可升级后无法启动网络、空间或日志异常用journalctl -u waydroid-container查系统日志定位避坑红线动手前先记住这几件事SteamOS 系统更新会清空 Waydroid这不是 Bug是 SteamOS 的更新机制决定的。重跑一遍安装脚本就能恢复如果更新包含新内核脚本会直接退出等待适配这种时候别硬来等项目发布配套模块。SteamOS 3.8 及以上版本暂时别用。项目 README 顶部有明确警告在 3.8 上运行可能破坏桌面模式动手前务必先确认系统版本。卸载前先备份。游戏存档、重要应用数据、自定义配置能备份就备份尤其是选择完整卸载之前数据删了就真没了。动手前看下空间。确保 home 分区至少有 10GB 空闲免得装到一半磁盘满了进退两难。让环境保持健康的日常节奏维护不需要天天做但建议养成下面这个轻量级节奏每月一次看看项目有没有新提交顺手做一次升级按需清理删除不用的 APK 和缓存保持 Android 内部存储清爽定期备份重要游戏进度定期导出出了问题先重装不要长时间带着旧配置硬撑卸载重装通常五分钟解决写在最后说到底Waydroid 环境的维护没有那么多玄学想要新功能就升级出了乱子就卸载重装不想玩了就彻底删除。把这三条路径记在心里再加上那张报错对照表你就是 Steam Deck 上的 Android 管理大师了。别犹豫现在就打开 Konsole 检查一下你的环境版本该升级的升级该清理的清理让你的掌机始终保持最佳状态。【免费下载链接】SteamOS-Waydroid-InstallerScript to easily install / uninstall Android via Waydroid on the Steam Deck running on SteamOS stable, beta or MAIN!项目地址: https://gitcode.com/gh_mirrors/st/SteamOS-Waydroid-Installer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考