尧图网页设计 
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-InstallerSteamOS-Waydroid-Installer 是专为 Steam Deck 打造的一站式安卓环境安装脚本它基于 Waydroid 容器技术让你在 SteamOS 上直接运行安卓应用与游戏并通过图形化的 Waydroid Toolbox 完成卸载、网络、音频等日常维护。无论你是刚接触掌机的安卓新手还是已经玩了一阵想清理环境的老玩家这篇指南都会带你安全地卸载或升级这套安卓环境。先想象一个真实场景你昨天还在 Steam Deck 上通过 Waydroid 玩《植物大战僵尸 2》今天一开机却发现安卓环境打不开了又或者你只是想腾出几个 GB 的存储空间却不知道该从哪个图标下手。别急看完这篇文章你就能自己搞定。先看这张表你的目标该走哪条路不同诉求对应的操作完全不同先对号入座再往下翻到对应章节能省下大量试错时间。你现在的情况推荐动作预估耗时应用数据想彻底移除安卓腾出存储空间桌面模式 → Waydroid Toolbox → UNINSTALL2–5 分钟可选保留或清空应用崩溃、游戏打不开想恢复干净状态先卸载再重新运行安装脚本约 10 分钟建议先备份已装旧版本想获得新功能与修复运行 Waydroid-Updater 一键更新5–10 分钟自动保留想抢先体验测试中的新特性克隆 testing 分支重新安装10 分钟左右自动保留动手之前先搞懂这三件事操作时心里才有底卸载不等于破坏 SteamOS。Waydroid 采用容器方案安卓系统跑在独立容器里卸载动作只清理安卓相关的组件和镜像不会触碰 SteamOS 本体所以大胆操作即可。卸载有两种颗粒度。Waydroid Toolbox 的 UNINSTALL 选项会先问你要不要保留安卓用户数据选保留下次重装还能找回应用与存档选彻底清空则连同镜像和配置一起抹掉释放最干净的空间。升级不完全等于重装。项目的更新脚本 Waydroid-Updater 会自动拉取最新代码并重新安装过程中保留你的数据配置这是绝大多数人最省心的升级方式。图形化卸载5 分钟用 Waydroid Toolbox 清理安卓环境这一步在做什么。通过安装脚本自带的维护工具 Waydroid Toolbox以图形界面完成卸载避免手动删除文件时漏掉残留配置。为什么要用工具箱。它内置了完整的卸载流程停止服务、移除容器与安卓镜像、清理配置文件、恢复系统设置一条龙处理比逐个敲命令安全得多。操作步骤。按下面五步走按下 Steam 按钮选择电源 → 切换至桌面进入桌面模式。在桌面或应用程序菜单中找到名为Waydroid Toolbox的图标双击打开。在图形界面中选择UNINSTALL选项。按提示输入你的 sudo 密码完成权限验证。在弹出的确认中选择保留数据或彻底清除然后等待进度条跑完。预期结果。安卓容器、镜像与配置文件被移除桌面上的 Waydroid 相关快捷方式也会一并清理。整个过程大约 2–5 分钟完成后回到游戏模式即可。命令行卸载不想开图形界面时的备选方案如果你更习惯终端操作或图形界面打不开也可以手动停止并清理 Waydroid 服务# 停止 Waydroid 容器服务这是卸载前必须做的一步 sudo systemctl stop waydroid-container.service # 分别结束会话与容器进程确保没有残留进程占用 sudo waydroid session stop sudo waydroid container stop # 移除 Waydroid 主程序包如需连用户数据一起清理可再加 --noconfirm sudo pacman -Rns waydroid需要说明的是手动卸载适合应急和排障日常使用仍推荐工具箱因为脚本还会顺带清理~/Android_Waydroid目录、系统服务配置和菜单残留手动方式容易遗漏。版本升级的两条路一键更新脚本与重装式更新路径一Waydroid-Updater 一键更新推荐多数人使用安装完成后脚本会在~/Android_Waydroid目录放下Waydroid-Updater.sh同时在桌面生成同名快捷方式双击或在终端运行即可# 进入存放 Waydroid 维护脚本的目录 cd ~/Android_Waydroid # 运行更新脚本自动拉取最新代码并重新安装保留你的数据 ./Waydroid-Updater.sh脚本会完成克隆最新仓库 → 全新安装 → 保留数据配置整套动作。适合希望始终停留在最新稳定版、又不想折腾手动步骤的人。路径二重新克隆再安装适合想顺手排障的人如果你遇到过疑难问题官方建议的排查思路就是先卸载、再克隆最新仓库重新安装因为新版本可能早已修复了你遇到的 bug# 回到主目录 cd ~/ # 克隆最新稳定版仓库main 分支 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安装过程中脚本会自动检测到这是一次重装直接复用已有数据并补齐缺失的配置全程大约 5 分钟视网速而定。安装结束后会询问是否返回游戏模式届时即可在游戏模式中通过 Waydroid 启动器进入安卓环境。路径三testing 分支尝鲜适合想提前体验新功能的人新功能会先在 testing 分支停留一到两周打磨想抢先体验就克隆这个分支# 克隆 testing 分支其中的功能会比稳定版更新 git clone --depth1 -b testing https://gitcode.com/gh_mirrors/st/SteamOS-Waydroid-Installer克隆后同样进入目录、执行脚本即可。注意 testing 分支可能存在尚未修复的问题尝鲜前记得备份重要数据。避坑区报错现象与解决办法对照表下面这些是社区里最高频的报错遇到时先对照这张表别急着重装系统。报错现象可能原因解决办法升级后 Waydroid 无法启动网络波动或存储空间不足检查网络连接确认/home分区至少预留 5GB、/var分区预留 100MB 以上再用journalctl -u waydroid-container查看日志卸载后桌面图标仍然存在快捷方式残留重启一次 Steam Deck若仍在手动删除桌面残留的 Toolbox / Updater 快捷方式下载安卓镜像特别慢连接到了慢速的 SourceForge 镜像按CtrlC中断当前下载重新运行脚本通常会切换到可用镜像SteamOS 系统更新后 Waydroid 不见了SteamOS 的更新机制会重置容器属正常现象直接重跑安装脚本即可若本次更新包含新内核脚本会立即退出说明内核尚未适配请等待作者更新在 SteamOS 3.8.x 上运行脚本当前版本与 3.8 不兼容可能导致桌面模式异常暂时不要使用等待作者发布兼容更新后再操作游戏模式下没有出现 Waydroid 快捷方式脚本是在 ssh 或虚拟终端会话中运行的Steam 客户端无法被调用务必在桌面模式的 konsole 终端里运行脚本另外要提醒一句由于 AUR 出现恶意软件事件作者出于安全考虑已暂时停用了安装脚本主程序并明确警告旧版本在 SteamOS 3.8.x 上会破坏桌面模式。如果你正处于 3.8.x请耐心等待作者推送适配更新不要强行绕过限制运行。高频问题 QAQ1卸载 Waydroid 会不会把 SteamOS 弄坏不会。Waydroid 运行在独立容器中卸载只清理安卓相关组件与镜像SteamOS 系统和你的游戏库不受影响。Q2卸载时想保留安卓应用数据该怎么做在 Waydroid Toolbox 的 UNINSTALL 步骤中选择保留数据即可下次重装后应用和数据仍可找回。Q3一键升级会弄丢游戏存档吗Waydroid-Updater 默认保留数据正常情况下存档不丢。不过跨大版本升级前稳妥起见建议先做一次备份。Q4SteamOS 系统更新后 Waydroid 没了是装坏了吗不是。这是 SteamOS 更新机制的正常现象容器会被重置。重新运行安装脚本就能恢复不需要额外排查。Q5怎么快速确认 Waydroid 当前是否正常运行在终端执行sudo systemctl status waydroid-container.service查看服务状态或用journalctl -u waydroid-container查看最近日志定位问题。定期维护与最佳实践每月做一次版本检查。关注项目更新节奏稳定版每月都会合并测试分支的修复保持更新能持续获得新功能、性能优化和安全修复。升级前看一眼更新日志。仓库 README 的 Whats New 会列出本次更新的重点比如新增的安卓版本支持、ARM 转译层改进、热门游戏的兼容性修复确认是否值得立刻升级。养成备份习惯。重装或升级前把~/Android_Waydroid目录和重要存档复制到外部存储成本很低关键时刻能救急。效率小贴士先卸载再安装是排障最快的组合拳。遇到疑难问题别纠结先卸载再重跑脚本多数问题就此解决。善用保留数据卸载做配置重置。当你只是想清掉旧的错误配置、又不想丢应用时这是比手动改配置更干净的选择。用日志代替猜谜。任何异常都先看journalctl -u waydroid-container日志里通常直接写明原因省去反复试错。收尾清单现在就照着做最常用的三个命令./Waydroid-Updater.sh一键升级、sudo systemctl stop waydroid-container.service应急停服、journalctl -u waydroid-container查日志。最常踩的三个坑在 SteamOS 3.8.x 上强跑旧脚本、在 ssh 会话里运行安装脚本导致快捷方式丢失、下载慢时直接关终端而不是CtrlC后重跑。最推荐的动作日常升级用 Waydroid-Updater想彻底清理或排障时先用工具箱卸载再克隆最新仓库重装。读完这篇文章你的下一步很简单先对照开头的决策表明确自己的目标然后按对应章节操作。如果是例行升级打开 Waydroid-Updater 点一下就好如果是遇到问题就走卸载 → 克隆最新仓库 → 重装的完整闭环。记住定期更新能让你始终享受最新的功能与修复而规范的卸载则能保证系统长久的稳定性。【免费下载链接】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），仅供参考 Steam Deck 的 Waydroid 卸载与升级完整指南：安卓环境移除与版本更新快速上手
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-InstallerSteamOS-Waydroid-Installer 是专为 Steam Deck 打造的一站式安卓环境安装脚本它基于 Waydroid 容器技术让你在 SteamOS 上直接运行安卓应用与游戏并通过图形化的 Waydroid Toolbox 完成卸载、网络、音频等日常维护。无论你是刚接触掌机的安卓新手还是已经玩了一阵想清理环境的老玩家这篇指南都会带你安全地卸载或升级这套安卓环境。先想象一个真实场景你昨天还在 Steam Deck 上通过 Waydroid 玩《植物大战僵尸 2》今天一开机却发现安卓环境打不开了又或者你只是想腾出几个 GB 的存储空间却不知道该从哪个图标下手。别急看完这篇文章你就能自己搞定。先看这张表你的目标该走哪条路不同诉求对应的操作完全不同先对号入座再往下翻到对应章节能省下大量试错时间。你现在的情况推荐动作预估耗时应用数据想彻底移除安卓腾出存储空间桌面模式 → Waydroid Toolbox → UNINSTALL2–5 分钟可选保留或清空应用崩溃、游戏打不开想恢复干净状态先卸载再重新运行安装脚本约 10 分钟建议先备份已装旧版本想获得新功能与修复运行 Waydroid-Updater 一键更新5–10 分钟自动保留想抢先体验测试中的新特性克隆 testing 分支重新安装10 分钟左右自动保留动手之前先搞懂这三件事操作时心里才有底卸载不等于破坏 SteamOS。Waydroid 采用容器方案安卓系统跑在独立容器里卸载动作只清理安卓相关的组件和镜像不会触碰 SteamOS 本体所以大胆操作即可。卸载有两种颗粒度。Waydroid Toolbox 的 UNINSTALL 选项会先问你要不要保留安卓用户数据选保留下次重装还能找回应用与存档选彻底清空则连同镜像和配置一起抹掉释放最干净的空间。升级不完全等于重装。项目的更新脚本 Waydroid-Updater 会自动拉取最新代码并重新安装过程中保留你的数据配置这是绝大多数人最省心的升级方式。图形化卸载5 分钟用 Waydroid Toolbox 清理安卓环境这一步在做什么。通过安装脚本自带的维护工具 Waydroid Toolbox以图形界面完成卸载避免手动删除文件时漏掉残留配置。为什么要用工具箱。它内置了完整的卸载流程停止服务、移除容器与安卓镜像、清理配置文件、恢复系统设置一条龙处理比逐个敲命令安全得多。操作步骤。按下面五步走按下 Steam 按钮选择电源 → 切换至桌面进入桌面模式。在桌面或应用程序菜单中找到名为Waydroid Toolbox的图标双击打开。在图形界面中选择UNINSTALL选项。按提示输入你的 sudo 密码完成权限验证。在弹出的确认中选择保留数据或彻底清除然后等待进度条跑完。预期结果。安卓容器、镜像与配置文件被移除桌面上的 Waydroid 相关快捷方式也会一并清理。整个过程大约 2–5 分钟完成后回到游戏模式即可。命令行卸载不想开图形界面时的备选方案如果你更习惯终端操作或图形界面打不开也可以手动停止并清理 Waydroid 服务# 停止 Waydroid 容器服务这是卸载前必须做的一步 sudo systemctl stop waydroid-container.service # 分别结束会话与容器进程确保没有残留进程占用 sudo waydroid session stop sudo waydroid container stop # 移除 Waydroid 主程序包如需连用户数据一起清理可再加 --noconfirm sudo pacman -Rns waydroid需要说明的是手动卸载适合应急和排障日常使用仍推荐工具箱因为脚本还会顺带清理~/Android_Waydroid目录、系统服务配置和菜单残留手动方式容易遗漏。版本升级的两条路一键更新脚本与重装式更新路径一Waydroid-Updater 一键更新推荐多数人使用安装完成后脚本会在~/Android_Waydroid目录放下Waydroid-Updater.sh同时在桌面生成同名快捷方式双击或在终端运行即可# 进入存放 Waydroid 维护脚本的目录 cd ~/Android_Waydroid # 运行更新脚本自动拉取最新代码并重新安装保留你的数据 ./Waydroid-Updater.sh脚本会完成克隆最新仓库 → 全新安装 → 保留数据配置整套动作。适合希望始终停留在最新稳定版、又不想折腾手动步骤的人。路径二重新克隆再安装适合想顺手排障的人如果你遇到过疑难问题官方建议的排查思路就是先卸载、再克隆最新仓库重新安装因为新版本可能早已修复了你遇到的 bug# 回到主目录 cd ~/ # 克隆最新稳定版仓库main 分支 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安装过程中脚本会自动检测到这是一次重装直接复用已有数据并补齐缺失的配置全程大约 5 分钟视网速而定。安装结束后会询问是否返回游戏模式届时即可在游戏模式中通过 Waydroid 启动器进入安卓环境。路径三testing 分支尝鲜适合想提前体验新功能的人新功能会先在 testing 分支停留一到两周打磨想抢先体验就克隆这个分支# 克隆 testing 分支其中的功能会比稳定版更新 git clone --depth1 -b testing https://gitcode.com/gh_mirrors/st/SteamOS-Waydroid-Installer克隆后同样进入目录、执行脚本即可。注意 testing 分支可能存在尚未修复的问题尝鲜前记得备份重要数据。避坑区报错现象与解决办法对照表下面这些是社区里最高频的报错遇到时先对照这张表别急着重装系统。报错现象可能原因解决办法升级后 Waydroid 无法启动网络波动或存储空间不足检查网络连接确认/home分区至少预留 5GB、/var分区预留 100MB 以上再用journalctl -u waydroid-container查看日志卸载后桌面图标仍然存在快捷方式残留重启一次 Steam Deck若仍在手动删除桌面残留的 Toolbox / Updater 快捷方式下载安卓镜像特别慢连接到了慢速的 SourceForge 镜像按CtrlC中断当前下载重新运行脚本通常会切换到可用镜像SteamOS 系统更新后 Waydroid 不见了SteamOS 的更新机制会重置容器属正常现象直接重跑安装脚本即可若本次更新包含新内核脚本会立即退出说明内核尚未适配请等待作者更新在 SteamOS 3.8.x 上运行脚本当前版本与 3.8 不兼容可能导致桌面模式异常暂时不要使用等待作者发布兼容更新后再操作游戏模式下没有出现 Waydroid 快捷方式脚本是在 ssh 或虚拟终端会话中运行的Steam 客户端无法被调用务必在桌面模式的 konsole 终端里运行脚本另外要提醒一句由于 AUR 出现恶意软件事件作者出于安全考虑已暂时停用了安装脚本主程序并明确警告旧版本在 SteamOS 3.8.x 上会破坏桌面模式。如果你正处于 3.8.x请耐心等待作者推送适配更新不要强行绕过限制运行。高频问题 QAQ1卸载 Waydroid 会不会把 SteamOS 弄坏不会。Waydroid 运行在独立容器中卸载只清理安卓相关组件与镜像SteamOS 系统和你的游戏库不受影响。Q2卸载时想保留安卓应用数据该怎么做在 Waydroid Toolbox 的 UNINSTALL 步骤中选择保留数据即可下次重装后应用和数据仍可找回。Q3一键升级会弄丢游戏存档吗Waydroid-Updater 默认保留数据正常情况下存档不丢。不过跨大版本升级前稳妥起见建议先做一次备份。Q4SteamOS 系统更新后 Waydroid 没了是装坏了吗不是。这是 SteamOS 更新机制的正常现象容器会被重置。重新运行安装脚本就能恢复不需要额外排查。Q5怎么快速确认 Waydroid 当前是否正常运行在终端执行sudo systemctl status waydroid-container.service查看服务状态或用journalctl -u waydroid-container查看最近日志定位问题。定期维护与最佳实践每月做一次版本检查。关注项目更新节奏稳定版每月都会合并测试分支的修复保持更新能持续获得新功能、性能优化和安全修复。升级前看一眼更新日志。仓库 README 的 Whats New 会列出本次更新的重点比如新增的安卓版本支持、ARM 转译层改进、热门游戏的兼容性修复确认是否值得立刻升级。养成备份习惯。重装或升级前把~/Android_Waydroid目录和重要存档复制到外部存储成本很低关键时刻能救急。效率小贴士先卸载再安装是排障最快的组合拳。遇到疑难问题别纠结先卸载再重跑脚本多数问题就此解决。善用保留数据卸载做配置重置。当你只是想清掉旧的错误配置、又不想丢应用时这是比手动改配置更干净的选择。用日志代替猜谜。任何异常都先看journalctl -u waydroid-container日志里通常直接写明原因省去反复试错。收尾清单现在就照着做最常用的三个命令./Waydroid-Updater.sh一键升级、sudo systemctl stop waydroid-container.service应急停服、journalctl -u waydroid-container查日志。最常踩的三个坑在 SteamOS 3.8.x 上强跑旧脚本、在 ssh 会话里运行安装脚本导致快捷方式丢失、下载慢时直接关终端而不是CtrlC后重跑。最推荐的动作日常升级用 Waydroid-Updater想彻底清理或排障时先用工具箱卸载再克隆最新仓库重装。读完这篇文章你的下一步很简单先对照开头的决策表明确自己的目标然后按对应章节操作。如果是例行升级打开 Waydroid-Updater 点一下就好如果是遇到问题就走卸载 → 克隆最新仓库 → 重装的完整闭环。记住定期更新能让你始终享受最新的功能与修复而规范的卸载则能保证系统长久的稳定性。【免费下载链接】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），仅供参考