境的更新、重裝與徹底卸載完整指南)
Steam Deck 上 Waydroid 環(huán)境的更新、重裝與徹底卸載完整指南【免費(fèi)下載鏈接】SteamOS-Waydroid-InstallerScript to easily install / uninstall Android via Waydroid on the Steam Deck running on SteamOS stable, beta or MAIN!項(xiàng)目地址: https://gitcode.com/gh_mirrors/st/SteamOS-Waydroid-Installer在 Steam Deck 上裝好 Android 環(huán)境只是第一步真正考驗(yàn)人的是之后的日子系統(tǒng)更新了要不要重裝游戲閃退要不要重置玩膩了想徹底刪除又怕刪不干凈。這套由SteamOS-Waydroid-Installer驅(qū)動(dòng)的 Waydroid 環(huán)境維護(hù)起來(lái)其實(shí)比想象中簡(jiǎn)單關(guān)鍵是選對(duì)路徑。這篇完整指南會(huì)帶你從判斷處境開始一步步走完升級(jí)、修復(fù)、卸載三條路并附上常見報(bào)錯(cuò)的對(duì)照解法讓你以后不再為維護(hù)發(fā)愁。先對(duì)號(hào)入座你現(xiàn)在屬于哪種處境別急著敲命令先花 30 秒定位自己的狀態(tài)。你的需求基本逃不出下面三種情況你的現(xiàn)狀典型表現(xiàn)推薦路徑一切正常想嘗鮮或修 Bug想玩新游戲、想要新功能路徑一安全升級(jí)應(yīng)用閃退、無(wú)法啟動(dòng)、配置越改越亂裝過(guò)舊版本、手動(dòng)改過(guò)配置路徑二卸載重裝不再需要 Android 環(huán)境想釋放空間、恢復(fù)原廠狀態(tài)路徑三徹底卸載無(wú)論走哪條路動(dòng)手前請(qǐng)先過(guò)一遍這套前置條件檢查表對(duì)應(yīng)項(xiàng)目里的sanity-checks.sh會(huì)自動(dòng)替你校驗(yàn)處于桌面模式不能在 ssh 或虛擬終端里跑安裝腳本SteamOS 版本為3.7.x 穩(wěn)定版或 beta3.8 及以上有已知風(fēng)險(xiǎn)見下文避坑紅線home 分區(qū)剩余空間不少于 10GB已經(jīng)設(shè)置好sudo 密碼網(wǎng)絡(luò)連接正常能訪問(wèn)鏡像服務(wù)器確認(rèn)無(wú)誤就可以放心往下走了。路徑一安全升級(jí)讓 Waydroid 跟上最新版本先給你吃顆定心丸Waydroid 的升級(jí)本質(zhì)上就是重新拉取最新腳本 重跑一遍安裝腳本會(huì)自動(dòng)處理內(nèi)核模塊、Android 鏡像下載、ARM 翻譯層等一系列臟活累活你基本只需要負(fù)責(zé)確認(rèn)。第一步選對(duì)分支項(xiàng)目用main和testing兩個(gè)分支維護(hù)版本別搞混了分支特點(diǎn)適合誰(shuí)main已經(jīng)過(guò) 1-2 周驗(yàn)證最穩(wěn)追求穩(wěn)定的日常用戶testing新特性優(yōu)先發(fā)布可能有 Bug想搶先體驗(yàn)的嘗鮮派第二步重新拉取腳本并安裝打開終端Konsole輸入下面這組命令升級(jí)到穩(wěn)定分支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想體驗(yàn)測(cè)試分支的話把第一條命令換成帶-b testing的版本即可git clone --depth1 -b testing https://gitcode.com/gh_mirrors/st/SteamOS-Waydroid-Installer安裝過(guò)程大約 5 分鐘取決于網(wǎng)速。另外桌面上那個(gè)Waydroid-Updater快捷方式也是干這件事的懶得敲命令就雙擊它。為什么要走重跑腳本這條路因?yàn)槟_本更新得很勤——從更新日志看幾乎每個(gè)月都有新鏡像、新翻譯層和新游戲兼容修復(fù)舊版本的問(wèn)題很可能已經(jīng)被新版本順手修掉了。第三步升級(jí)后的驗(yàn)收清單跑完腳本別急著關(guān)按這個(gè)清單確認(rèn)一下回到游戲模式啟動(dòng)Android_Waydroid_Cage看能否正常進(jìn)入系統(tǒng)在設(shè)置里核對(duì) Android 版本號(hào)支持 Android 11 / Android 13 及對(duì)應(yīng)的 TV 版本裝一個(gè)游戲?qū)崪y(cè) ARM 翻譯層是否生效比如《植物大戰(zhàn)僵尸 2》路徑二卸載重裝最高效的排障手段如果你遇到的是怎么修都修不好的疑難雜癥記住一條鐵律先卸載、再安裝往往比硬修快得多。腳本迭代這么快你踩的坑八成在新版本里已經(jīng)被填平了。第一步通過(guò) Waydroid Toolbox 卸載在桌面模式下找到Waydroid Toolbox圖標(biāo)并雙擊打開這個(gè)工具箱集成了 ADBLOCK廣告攔截、AUDIO音頻、SERVICE服務(wù)開關(guān)、GPU顯卡、LAUNCHER啟動(dòng)器、NETWORK網(wǎng)絡(luò)和UNINSTALL卸載等多個(gè)選項(xiàng)。選擇UNINSTALL后工具箱會(huì)提示你輸入 sudo 密碼進(jìn)行授權(quán)。這里有一個(gè)貼心的小分支值得注意卸載時(shí)可以選擇保留 Android 用戶數(shù)據(jù)還是連同數(shù)據(jù)一起完整卸載。如果你只是想去掉舊配置、重新安裝選保留數(shù)據(jù)就能省去重新登錄賬號(hào)的麻煩。第二步重新安裝卸載完成后回到路徑一重新 clone 最新代碼并執(zhí)行安裝即可。整個(gè)卸載—重裝周期大約 5-10 分鐘換來(lái)一個(gè)干凈且最新的環(huán)境這筆賬怎么算都劃算。進(jìn)階命令行操作如果你是喜歡掌控一切的高級(jí)用戶也可以直接用 systemd 停掉容器服務(wù)sudo systemctl stop waydroid-container不過(guò)說(shuō)句實(shí)在話普通用戶完全沒(méi)必要手動(dòng)折騰Waydroid Toolbox 一個(gè)選項(xiàng)就能搞定還不會(huì)因?yàn)樯賱h了某個(gè)配置文件留下后遺癥。路徑三徹底卸載把 Android 環(huán)境干干凈凈送走決定徹底告別了放心卸載比你想象中溫柔按下面三步走就能還你一個(gè)原汁原味的 SteamOS。第一步進(jìn)入桌面模式按下Steam 按鈕 → 電源 → 切換至桌面等待系統(tǒng)完成切換。為什么要切桌面因?yàn)樾遁d工具是圖形化的而且腳本本身也要求必須運(yùn)行在桌面會(huì)話里直接終端操作容易踩坑。第二步啟動(dòng) Waydroid Toolbox 并選擇 UNINSTALL雙擊桌面上的Waydroid Toolbox選擇UNINSTALL。工具箱會(huì)自動(dòng)完成下面這些操作全程不需要你操心停止 Waydroid 相關(guān)服務(wù)與容器卸載已安裝的軟件包與內(nèi)核模塊移除 Android 鏡像、配置文件與啟動(dòng)項(xiàng)清理桌面快捷方式并恢復(fù)系統(tǒng)只讀設(shè)置第三步卸載后的殘留檢查卸載完成后花一分鐘確認(rèn)沒(méi)有尾巴桌面和 KDE 菜單里是否還有 Waydroid 相關(guān)圖標(biāo)若有重啟一次一般就消失了~/Android_Waydroid目錄是否已不存在/var/lib/waydroid是否已清空全部干凈恭喜你存儲(chǔ)空間回來(lái)了——一個(gè) Android 鏡像加應(yīng)用數(shù)據(jù)通常能釋放2-4GB甚至更多。常見報(bào)錯(cuò)對(duì)照表遇到問(wèn)題先查這張表維護(hù)路上難免翻車我把最常見的幾個(gè)坑整理成了對(duì)照表先自查再求助報(bào)錯(cuò)現(xiàn)象可能原因解決辦法下載 Android 鏡像極慢或中斷連到了慢速鏡像源按 CtrlC 取消重新運(yùn)行腳本提示 hash mismatch / 下載損壞網(wǎng)絡(luò)波動(dòng)導(dǎo)致文件不完整重試一次仍失敗則帶截圖反饋提示 home 分區(qū)空間不足剩余空間低于 10GB清理 SteamOS 緩存后重試游戲模式里沒(méi)有生成快捷方式腳本在 ssh 會(huì)話中運(yùn)行改到桌面模式 Konsole 里重跑SteamOS 更新后 Waydroid 消失系統(tǒng)更新機(jī)制會(huì)清空環(huán)境屬正常行為重新運(yùn)行安裝腳本即可升級(jí)后無(wú)法啟動(dòng)網(wǎng)絡(luò)、空間或日志異常用journalctl -u waydroid-container查系統(tǒng)日志定位避坑紅線動(dòng)手前先記住這幾件事SteamOS 系統(tǒng)更新會(huì)清空 Waydroid這不是 Bug是 SteamOS 的更新機(jī)制決定的。重跑一遍安裝腳本就能恢復(fù)如果更新包含新內(nèi)核腳本會(huì)直接退出等待適配這種時(shí)候別硬來(lái)等項(xiàng)目發(fā)布配套模塊。SteamOS 3.8 及以上版本暫時(shí)別用。項(xiàng)目 README 頂部有明確警告在 3.8 上運(yùn)行可能破壞桌面模式動(dòng)手前務(wù)必先確認(rèn)系統(tǒng)版本。卸載前先備份。游戲存檔、重要應(yīng)用數(shù)據(jù)、自定義配置能備份就備份尤其是選擇完整卸載之前數(shù)據(jù)刪了就真沒(méi)了。動(dòng)手前看下空間。確保 home 分區(qū)至少有 10GB 空閑免得裝到一半磁盤滿了進(jìn)退兩難。讓環(huán)境保持健康的日常節(jié)奏維護(hù)不需要天天做但建議養(yǎng)成下面這個(gè)輕量級(jí)節(jié)奏每月一次看看項(xiàng)目有沒(méi)有新提交順手做一次升級(jí)按需清理刪除不用的 APK 和緩存保持 Android 內(nèi)部存儲(chǔ)清爽定期備份重要游戲進(jìn)度定期導(dǎo)出出了問(wèn)題先重裝不要長(zhǎng)時(shí)間帶著舊配置硬撐卸載重裝通常五分鐘解決寫在最后說(shuō)到底Waydroid 環(huán)境的維護(hù)沒(méi)有那么多玄學(xué)想要新功能就升級(jí)出了亂子就卸載重裝不想玩了就徹底刪除。把這三條路徑記在心里再加上那張報(bào)錯(cuò)對(duì)照表你就是 Steam Deck 上的 Android 管理大師了。別猶豫現(xiàn)在就打開 Konsole 檢查一下你的環(huán)境版本該升級(jí)的升級(jí)該清理的清理讓你的掌機(jī)始終保持最佳狀態(tài)?！久赓M(fèi)下載鏈接】SteamOS-Waydroid-InstallerScript to easily install / uninstall Android via Waydroid on the Steam Deck running on SteamOS stable, beta or MAIN!項(xiàng)目地址: https://gitcode.com/gh_mirrors/st/SteamOS-Waydroid-Installer創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 Steam Deck 上 Waydroid 環(huán)境的更新、重裝與徹底卸載完整指南
Steam Deck 上 Waydroid 環(huán)境的更新、重裝與徹底卸載完整指南【免費(fèi)下載鏈接】SteamOS-Waydroid-InstallerScript to easily install / uninstall Android via Waydroid on the Steam Deck running on SteamOS stable, beta or MAIN!項(xiàng)目地址: https://gitcode.com/gh_mirrors/st/SteamOS-Waydroid-Installer在 Steam Deck 上裝好 Android 環(huán)境只是第一步真正考驗(yàn)人的是之后的日子系統(tǒng)更新了要不要重裝游戲閃退要不要重置玩膩了想徹底刪除又怕刪不干凈。這套由SteamOS-Waydroid-Installer驅(qū)動(dòng)的 Waydroid 環(huán)境維護(hù)起來(lái)其實(shí)比想象中簡(jiǎn)單關(guān)鍵是選對(duì)路徑。這篇完整指南會(huì)帶你從判斷處境開始一步步走完升級(jí)、修復(fù)、卸載三條路并附上常見報(bào)錯(cuò)的對(duì)照解法讓你以后不再為維護(hù)發(fā)愁。先對(duì)號(hào)入座你現(xiàn)在屬于哪種處境別急著敲命令先花 30 秒定位自己的狀態(tài)。你的需求基本逃不出下面三種情況你的現(xiàn)狀典型表現(xiàn)推薦路徑一切正常想嘗鮮或修 Bug想玩新游戲、想要新功能路徑一安全升級(jí)應(yīng)用閃退、無(wú)法啟動(dòng)、配置越改越亂裝過(guò)舊版本、手動(dòng)改過(guò)配置路徑二卸載重裝不再需要 Android 環(huán)境想釋放空間、恢復(fù)原廠狀態(tài)路徑三徹底卸載無(wú)論走哪條路動(dòng)手前請(qǐng)先過(guò)一遍這套前置條件檢查表對(duì)應(yīng)項(xiàng)目里的sanity-checks.sh會(huì)自動(dòng)替你校驗(yàn)處于桌面模式不能在 ssh 或虛擬終端里跑安裝腳本SteamOS 版本為3.7.x 穩(wěn)定版或 beta3.8 及以上有已知風(fēng)險(xiǎn)見下文避坑紅線home 分區(qū)剩余空間不少于 10GB已經(jīng)設(shè)置好sudo 密碼網(wǎng)絡(luò)連接正常能訪問(wèn)鏡像服務(wù)器確認(rèn)無(wú)誤就可以放心往下走了。路徑一安全升級(jí)讓 Waydroid 跟上最新版本先給你吃顆定心丸Waydroid 的升級(jí)本質(zhì)上就是重新拉取最新腳本 重跑一遍安裝腳本會(huì)自動(dòng)處理內(nèi)核模塊、Android 鏡像下載、ARM 翻譯層等一系列臟活累活你基本只需要負(fù)責(zé)確認(rèn)。第一步選對(duì)分支項(xiàng)目用main和testing兩個(gè)分支維護(hù)版本別搞混了分支特點(diǎn)適合誰(shuí)main已經(jīng)過(guò) 1-2 周驗(yàn)證最穩(wěn)追求穩(wěn)定的日常用戶testing新特性優(yōu)先發(fā)布可能有 Bug想搶先體驗(yàn)的嘗鮮派第二步重新拉取腳本并安裝打開終端Konsole輸入下面這組命令升級(jí)到穩(wěn)定分支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想體驗(yàn)測(cè)試分支的話把第一條命令換成帶-b testing的版本即可git clone --depth1 -b testing https://gitcode.com/gh_mirrors/st/SteamOS-Waydroid-Installer安裝過(guò)程大約 5 分鐘取決于網(wǎng)速。另外桌面上那個(gè)Waydroid-Updater快捷方式也是干這件事的懶得敲命令就雙擊它。為什么要走重跑腳本這條路因?yàn)槟_本更新得很勤——從更新日志看幾乎每個(gè)月都有新鏡像、新翻譯層和新游戲兼容修復(fù)舊版本的問(wèn)題很可能已經(jīng)被新版本順手修掉了。第三步升級(jí)后的驗(yàn)收清單跑完腳本別急著關(guān)按這個(gè)清單確認(rèn)一下回到游戲模式啟動(dòng)Android_Waydroid_Cage看能否正常進(jìn)入系統(tǒng)在設(shè)置里核對(duì) Android 版本號(hào)支持 Android 11 / Android 13 及對(duì)應(yīng)的 TV 版本裝一個(gè)游戲?qū)崪y(cè) ARM 翻譯層是否生效比如《植物大戰(zhàn)僵尸 2》路徑二卸載重裝最高效的排障手段如果你遇到的是怎么修都修不好的疑難雜癥記住一條鐵律先卸載、再安裝往往比硬修快得多。腳本迭代這么快你踩的坑八成在新版本里已經(jīng)被填平了。第一步通過(guò) Waydroid Toolbox 卸載在桌面模式下找到Waydroid Toolbox圖標(biāo)并雙擊打開這個(gè)工具箱集成了 ADBLOCK廣告攔截、AUDIO音頻、SERVICE服務(wù)開關(guān)、GPU顯卡、LAUNCHER啟動(dòng)器、NETWORK網(wǎng)絡(luò)和UNINSTALL卸載等多個(gè)選項(xiàng)。選擇UNINSTALL后工具箱會(huì)提示你輸入 sudo 密碼進(jìn)行授權(quán)。這里有一個(gè)貼心的小分支值得注意卸載時(shí)可以選擇保留 Android 用戶數(shù)據(jù)還是連同數(shù)據(jù)一起完整卸載。如果你只是想去掉舊配置、重新安裝選保留數(shù)據(jù)就能省去重新登錄賬號(hào)的麻煩。第二步重新安裝卸載完成后回到路徑一重新 clone 最新代碼并執(zhí)行安裝即可。整個(gè)卸載—重裝周期大約 5-10 分鐘換來(lái)一個(gè)干凈且最新的環(huán)境這筆賬怎么算都劃算。進(jìn)階命令行操作如果你是喜歡掌控一切的高級(jí)用戶也可以直接用 systemd 停掉容器服務(wù)sudo systemctl stop waydroid-container不過(guò)說(shuō)句實(shí)在話普通用戶完全沒(méi)必要手動(dòng)折騰Waydroid Toolbox 一個(gè)選項(xiàng)就能搞定還不會(huì)因?yàn)樯賱h了某個(gè)配置文件留下后遺癥。路徑三徹底卸載把 Android 環(huán)境干干凈凈送走決定徹底告別了放心卸載比你想象中溫柔按下面三步走就能還你一個(gè)原汁原味的 SteamOS。第一步進(jìn)入桌面模式按下Steam 按鈕 → 電源 → 切換至桌面等待系統(tǒng)完成切換。為什么要切桌面因?yàn)樾遁d工具是圖形化的而且腳本本身也要求必須運(yùn)行在桌面會(huì)話里直接終端操作容易踩坑。第二步啟動(dòng) Waydroid Toolbox 并選擇 UNINSTALL雙擊桌面上的Waydroid Toolbox選擇UNINSTALL。工具箱會(huì)自動(dòng)完成下面這些操作全程不需要你操心停止 Waydroid 相關(guān)服務(wù)與容器卸載已安裝的軟件包與內(nèi)核模塊移除 Android 鏡像、配置文件與啟動(dòng)項(xiàng)清理桌面快捷方式并恢復(fù)系統(tǒng)只讀設(shè)置第三步卸載后的殘留檢查卸載完成后花一分鐘確認(rèn)沒(méi)有尾巴桌面和 KDE 菜單里是否還有 Waydroid 相關(guān)圖標(biāo)若有重啟一次一般就消失了~/Android_Waydroid目錄是否已不存在/var/lib/waydroid是否已清空全部干凈恭喜你存儲(chǔ)空間回來(lái)了——一個(gè) Android 鏡像加應(yīng)用數(shù)據(jù)通常能釋放2-4GB甚至更多。常見報(bào)錯(cuò)對(duì)照表遇到問(wèn)題先查這張表維護(hù)路上難免翻車我把最常見的幾個(gè)坑整理成了對(duì)照表先自查再求助報(bào)錯(cuò)現(xiàn)象可能原因解決辦法下載 Android 鏡像極慢或中斷連到了慢速鏡像源按 CtrlC 取消重新運(yùn)行腳本提示 hash mismatch / 下載損壞網(wǎng)絡(luò)波動(dòng)導(dǎo)致文件不完整重試一次仍失敗則帶截圖反饋提示 home 分區(qū)空間不足剩余空間低于 10GB清理 SteamOS 緩存后重試游戲模式里沒(méi)有生成快捷方式腳本在 ssh 會(huì)話中運(yùn)行改到桌面模式 Konsole 里重跑SteamOS 更新后 Waydroid 消失系統(tǒng)更新機(jī)制會(huì)清空環(huán)境屬正常行為重新運(yùn)行安裝腳本即可升級(jí)后無(wú)法啟動(dòng)網(wǎng)絡(luò)、空間或日志異常用journalctl -u waydroid-container查系統(tǒng)日志定位避坑紅線動(dòng)手前先記住這幾件事SteamOS 系統(tǒng)更新會(huì)清空 Waydroid這不是 Bug是 SteamOS 的更新機(jī)制決定的。重跑一遍安裝腳本就能恢復(fù)如果更新包含新內(nèi)核腳本會(huì)直接退出等待適配這種時(shí)候別硬來(lái)等項(xiàng)目發(fā)布配套模塊。SteamOS 3.8 及以上版本暫時(shí)別用。項(xiàng)目 README 頂部有明確警告在 3.8 上運(yùn)行可能破壞桌面模式動(dòng)手前務(wù)必先確認(rèn)系統(tǒng)版本。卸載前先備份。游戲存檔、重要應(yīng)用數(shù)據(jù)、自定義配置能備份就備份尤其是選擇完整卸載之前數(shù)據(jù)刪了就真沒(méi)了。動(dòng)手前看下空間。確保 home 分區(qū)至少有 10GB 空閑免得裝到一半磁盤滿了進(jìn)退兩難。讓環(huán)境保持健康的日常節(jié)奏維護(hù)不需要天天做但建議養(yǎng)成下面這個(gè)輕量級(jí)節(jié)奏每月一次看看項(xiàng)目有沒(méi)有新提交順手做一次升級(jí)按需清理刪除不用的 APK 和緩存保持 Android 內(nèi)部存儲(chǔ)清爽定期備份重要游戲進(jìn)度定期導(dǎo)出出了問(wèn)題先重裝不要長(zhǎng)時(shí)間帶著舊配置硬撐卸載重裝通常五分鐘解決寫在最后說(shuō)到底Waydroid 環(huán)境的維護(hù)沒(méi)有那么多玄學(xué)想要新功能就升級(jí)出了亂子就卸載重裝不想玩了就徹底刪除。把這三條路徑記在心里再加上那張報(bào)錯(cuò)對(duì)照表你就是 Steam Deck 上的 Android 管理大師了。別猶豫現(xiàn)在就打開 Konsole 檢查一下你的環(huán)境版本該升級(jí)的升級(jí)該清理的清理讓你的掌機(jī)始終保持最佳狀態(tài)?！久赓M(fèi)下載鏈接】SteamOS-Waydroid-InstallerScript to easily install / uninstall Android via Waydroid on the Steam Deck running on SteamOS stable, beta or MAIN!項(xiàng)目地址: https://gitcode.com/gh_mirrors/st/SteamOS-Waydroid-Installer創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考