Steam Deck 上 Waydroid 的卸载与升级完整指南安全移除 Android 环境与版本更新一步到位【免费下载链接】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-InstallerSteamOS-Waydroid-Installer 让 Steam Deck 能流畅运行 Android 应用与游戏但当你想安全卸载这套 Android 环境或想升级到支持新功能的版本时从哪下手往往让人犯难。尤其是 SteamOS 大版本更新后 Waydroid 神秘消失、游戏突然进不去这类状况几乎每个用户都会撞上一次。别急这篇指南把卸载与升级的路数一次讲透照着做就能把 Android 环境管理得明明白白。先回答一个问题你此刻需要的是卸载还是升级很多朋友一上来就问怎么删其实在动手之前先用 30 秒判断一下方向能省下不少冤枉路。卸载和升级是两条完全不同的路卸载是把 Android 环境整体搬走升级则是在保留数据的前提下换上新版本。你的现状推荐动作理由很久没用 Android 功能想腾出存储空间卸载系统镜像加应用数据通常能释放好几个 GB游戏打不开、反复报错怀疑环境坏了先升级再考虑卸载重装新版脚本往往已经修复了旧版问题SteamOS 更新后 Waydroid 不见了重跑安装脚本相当于升级SteamOS 更新会清掉 Waydroid这是正常现象想要假 WiFi、手柄映射、新游戏兼容等新特性升级项目持续更新新功能都靠版本迭代引入一个简单的判断口诀不想再用了就卸载还想继续用就升级出问题了先升级试试升级救不回来再卸载重装。想了解脚本当前支持哪些 SteamOS 版本与系统检查项可以翻翻仓库根目录下的sanity-checks.sh里面写得很清楚。动手前花 10 分钟做这三件事数据一个都不丢卸载和升级最大的顾虑就是我的东西会不会没了。Waydroid 的数据主要集中在两处Android 应用的数据与游戏存档存放在/home/deck/.local/share/waydroid目录下而整套自定义镜像则放在~/Android_Waydroid文件夹里。动手前按下面三步走基本可以高枕无忧备份游戏进度安卓游戏大多支持云存档先在游戏里手动同步一次单机游戏则直接拷贝存档目录。备份应用数据重要应用比如聊天、笔记类可以用安卓自带的备份功能或者直接把/home/deck/.local/share/waydroid整个目录复制到移动硬盘。确认 sudo 密码无论是卸载还是升级脚本都会要求输入 sudo 密码验证权限密码没设置过的话先到桌面模式终端里执行passwd设置一个。另外提醒一句SteamOS 本身是只读系统Waydroid 的安装和移除都会临时解锁再恢复只读全程由脚本自动完成你只需要确保网络稳定、电量充足、磁盘剩余空间不低于 10GB 即可。用桌面上的 Waydroid Toolbox 安全移除 Android 环境如果你走的是图形界面路线移除工作其实比你想象的简单——安装脚本已经在你的桌面放好了一个叫Waydroid Toolbox的工具箱它是整个移除过程的核心入口。双击打开工具箱你会看到一个选项列表里面包括 ADBLOCK广告拦截、AUDIO音频、SERVICE服务开关、GPU图形设置、LAUNCHER启动器、NETWORK网络等常用配置项以及我们这次要找的UNINSTALL卸载选项。选中 UNINSTALL 后系统会弹出 sudo 密码输入框验证通过后脚本会自动完成一连串操作停止 Waydroid 相关服务、移除容器与 Android 镜像、清理配置文件、把系统设置恢复原样整个过程大约 2 到 5 分钟。这里有个贴心的细节值得注意工具箱提供了两种卸载粒度——一种是卸载但保留 Android 用户数据另一种是连同用户数据一起完全移除。如果你只是暂时不用、之后还打算装回来选前者可以省去重新折腾数据的麻烦如果确定彻底告别再选完全移除。移除完成后Steam Deck 桌面上的工具箱图标可能还会残留重启一次设备就会自动清理干净。习惯命令行的用户卸载也可用这几条指令完成不习惯点图形界面的话打开桌面模式的终端Konsole同样能完成移除。这三条命令按顺序执行即可sudo systemctl stop waydroid-container sudo waydroid session stop sudo waydroid container stop这三条命令的作用分别是先停掉 Waydroid 的后台容器服务再结束当前会话最后关闭容器本体。想进一步把相关软件包也清理掉可以补一条sudo pacman -Rns waydroid。需要说明的是图形工具和命令行两条路最终达到的效果一致选择哪个纯看个人习惯对新手来说工具箱更稳妥对熟手来说命令行更干脆。升级不一定需要卸载两种版本更新路径对比好消息是升级并不需要先卸载再安装。项目专门准备了一条保留数据的更新通道走这条路你的应用和存档都能原样保留。路径一桌面上的 Waydroid Updater 一键升级推荐安装完成后桌面除了 Waydroid Toolbox还有一个Waydroid Updater的快捷方式。双击它脚本会自动完成拉取最新代码 → 重跑安装流程 → 保留现有数据的全过程。脚本内部会检测到这是一次重装而非全新安装从而跳过镜像下载、直接沿用你已配置好的环境整个过程基本不用人工干预。路径二手动克隆最新代码重装适合想换分支的用户想完全掌控更新过程或者想体验还在测试中的新功能可以在终端里手动操作。先打开终端进入主目录并克隆代码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参数的命令拉取的是测试分支——新功能会先在 testing 分支上打磨一到两周稳定后才合并进 main 分支。升级或卸载后翻车四个自救方法按顺序试操作过程中难免遇到状况别慌多数问题都有对应的解法。这里整理了出现频率最高的四个翻车现场按顺序排查基本都能解决。现象一卸载后桌面图标还在。这通常是 KDE 桌面菜单缓存没刷新重启一次 Steam Deck 就会消失如果还在说明手动清一下桌面的快捷方式文件即可。现象二升级后 Waydroid 启动不了。大概率是网络或空间问题。先确认网络通畅、/home分区剩余空间不低于 10GB再看一眼项目目录下的 logfile 安装日志通常错误原因就写在里面。现象三SteamOS 更新后 Waydroid 整个不见了。这是 SteamOS 更新机制导致的正常行为——系统更新会覆盖式写入Waydroid 自然被清掉。解决方式很简单重新跑一次安装脚本。唯一要注意的是如果这次更新换了新内核脚本可能检测到版本不匹配而直接退出这时候需要等作者发布适配新内核的版本或到仓库提交一个 issue 说明情况。现象四游戏模式里没有出现 Waydroid 快捷方式。常见原因是安装脚本是在 SSH 或虚拟终端会话里运行的导致 Steam 客户端无法正常添加快捷方式。确保你在桌面模式的 Konsole 里运行脚本重装一次即可解决。算笔账卸载能找回多少空间升级又能带来什么空口无凭我们用数据说话。一次完整的卸载大约能释放这些空间Android 系统镜像约 2 至 4GB应用与游戏数据视使用情况而定装了大型游戏的往往能到十几 GB缓存与临时文件通常在 1GB 上下浮动也就是说一台只装了基础应用的主机卸载后能轻松找回 4GB 以上常玩大型安卓游戏的话回收的空间翻几倍都不奇怪。而选择升级的回报同样实在项目最近几个版本引入了 libhoudini 兼容层让更多游戏可玩、假 WiFi 配置自动生效、手柄键位映射优化、广告拦截规则自动更新等改进几乎每一版都在解决真实痛点。想知道具体版本带来了什么翻翻 README 里的更新日志是最快的方式。让 Android 环境长期稳定服役的三个维护习惯卸载和升级都不是一锤子买卖养成下面三个习惯能让 Waydroid 一直处于健康状态每月看一眼更新关注项目是否有新版本发现更新后直接用 Waydroid Updater 升级即可成本极低。升级前扫一眼更新日志重点看是否有破坏性变更做到心中有数再动手。把备份当日常重要游戏进度随手同步云存档比任何事后补救都省事。另外如果你在排查问题可以多看两个文件sanity-checks.sh里是脚本运行前的系统自检逻辑版本、分区空间、sudo 密码、桌面模式等functions.sh里则是清理与恢复相关的函数理解了它们你就知道脚本每一步在做什么排查起来也更有的放矢。现在无论你是想给 Steam Deck 腾出空间、还是想让它解锁更多 Android 新特性方法都已经摆在眼前了不想用了就打开 Waydroid Toolbox 点 UNINSTALL想更新就双击 Waydroid Updater。两分钟就能开始别让一个吃灰的模拟环境占着宝贵的存储也别让旧版本挡着你体验新功能。动手试试吧你的 Steam Deck 会感谢你的。【免费下载链接】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），仅供参考