
WSABuilds 深度指南Windows 上安裝完整 Android【免費(fèi)下載鏈接】WSABuildsRun Windows Subsystem For Android on your Windows 10 and Windows 11 PC using prebuilt binaries with Google Play Store (MindTheGapps) and/or Magisk or KernelSU (root solutions) built in.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/ws/WSABuilds需要在 Windows 電腦上用一款只有 Android 版的工具時(shí)很多人第一反應(yīng)是開(kāi)一個(gè)完整的安卓模擬器但那又重又慢。而官方 WSA 已被微軟宣布停止支持且缺少 Play 商店和 root。WSABuilds 提供內(nèi)置 Google Play 商店MindTheGapps和 Magisk/KernelSU root 的預(yù)構(gòu)建 WSA 二進(jìn)制文件讓你在 Windows 10/11 上十幾分鐘裝好一套能用的 Android 環(huán)境。 技術(shù)背景為什么選預(yù)構(gòu)建的 WSA先看清三個(gè)選項(xiàng)的差異再?zèng)Q定要不要用它維度官方 WSA完整安卓虛擬機(jī)WSABuildsGoogle Play 商店無(wú)只有 Amazon Appstore看鏡像而定內(nèi)置 MindTheGappsRoot 權(quán)限無(wú)需要自行折騰內(nèi)置 Magisk / KernelSU資源占用低高低共享 Windows 進(jìn)程維護(hù)狀態(tài)微軟已宣布 EoS依賴第三方社區(qū) LTS 維護(hù)中技術(shù)基座很簡(jiǎn)單WSABuilds 本質(zhì)是微軟 WSA 的注冊(cè)式 Appx 包跑在 Windows 的 Virtual Machine Platform / Hyper-V 之上。它不做二次虛擬化整套安卓而是把系統(tǒng)鏡像、GApps 和 root 方案預(yù)先打進(jìn)包里你只需注冊(cè)即可運(yùn)行這是它比傳統(tǒng)虛擬機(jī)輕得多的原因。? 項(xiàng)目結(jié)構(gòu)速覽倉(cāng)庫(kù)按安裝—運(yùn)行—更新—文檔四層組織東西都在這些地方MagiskOnWSA/installer/—— 安裝入口。Run.bat一鍵安裝Install.ps1和MakePri.ps1分別負(fù)責(zé)注冊(cè) Appx 包和生成 PRI 容器文件x64/、arm64/子目錄對(duì)應(yīng)不同 CPU 架構(gòu)的腳本。MagiskOnWSA/libhoudini/—— ARM 轉(zhuǎn)譯層Houdini。x86 機(jī)器上跑 ARM 應(yīng)用時(shí)它通過(guò)etc/binfmt_misc/下的 binfmt 規(guī)則把 ARM 可執(zhí)行文件動(dòng)態(tài)分派給轉(zhuǎn)譯器執(zhí)行這就是 ARM 應(yīng)用能在你的 x86 電腦上運(yùn)行的原因代價(jià)是性能略低于原生。MagiskOnWSA/Update Check/—— 版本監(jiān)控腳本。WSARetailUpdateCheck.py、MagiskStableUpdateCheck.py、KernelSUUpdateCheck.py等持續(xù)追蹤各組件的新版本供維護(hù)者判斷何時(shí)發(fā)布新構(gòu)建。Documentation/—— 全部用戶文檔。WSABuilds/是主文檔安裝、升級(jí)、備份Fix Guides/收錄各錯(cuò)誤碼排查Usage Guides/是進(jìn)階教程遇到問(wèn)題先來(lái)這里找。 動(dòng)手指南10 分鐘裝好帶 Root 的 WSA前置條件系統(tǒng)版本W(wǎng)indows 11 Build 22000.526 及以上或 Windows 10 22H2 10.0.19045.2311 及以上硬件內(nèi)存最低 8GB建議 16GBC 盤至少 10GB 空閑CPU 為 x86_64 或 arm64分區(qū)格式安裝目錄所在的分區(qū)必須是 NTFSexFAT 不行系統(tǒng)功能在可選功能中啟用 Virtual Machine Platform 和 Windows Hypervisor Platform虛擬化BIOS/UEFI 中已開(kāi)啟虛擬化??上扔孟旅娴拿畲_認(rèn)狀態(tài)systeminfo | findstr /I 虛擬化如果之前裝過(guò)官方 WSA需先徹底卸載想保留數(shù)據(jù)就先備份見(jiàn)下文否則注冊(cè)會(huì)沖突。安裝步驟下載構(gòu)建去項(xiàng)目 Releases 頁(yè)面按你的系統(tǒng)選對(duì)應(yīng).7z文件區(qū)分 Windows 10/11、x64/arm64以及是否含 GApps/Magisk。不要下 Source code。解壓并改名為WSA用 7-Zip 解壓把解壓出來(lái)的文件夾改名為WSA。放到永久位置把WSA文件夾移到不會(huì)再動(dòng)的位置如C:\Documents\WSA。提示W(wǎng)SA 是注冊(cè)式安裝系統(tǒng)直接引用這個(gè)文件夾里的文件日后不能刪除或改名移動(dòng)位置會(huì)導(dǎo)致 WSA 無(wú)法啟動(dòng)。運(yùn)行安裝雙擊文件夾里的Run.bat腳本會(huì)自動(dòng)注冊(cè)包并拉起 WSA。若彈窗一閃而過(guò)、安裝沒(méi)成功就在管理員終端中手動(dòng)執(zhí)行替換為你的實(shí)際路徑cd C:\WSA PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1首次授權(quán)腳本跑完后 WSA 自動(dòng)啟動(dòng)首次會(huì)彈出診斷信息許可窗口有時(shí)彈兩個(gè)都點(diǎn)同意即可。收尾回到 PowerShell 窗口按任意鍵關(guān)閉窗口。驗(yàn)證成功在開(kāi)始菜單打開(kāi) Windows Subsystem for Android Settings能看到設(shè)置界面即安裝成功裝 GApps 版本的話打開(kāi) WSA 內(nèi)的 Play 商店能正常瀏覽即代表 GMS 就緒。?? 進(jìn)階玩法GPU 切換、磁盤遷移與 Magisk 模塊GPU 切換避坑什么時(shí)候需要Intel HD Graphics 530 及更老的核顯上 WSA 可能起不來(lái)或花屏Nvidia 顯卡也有已知的圖形兼容問(wèn)題。怎么操作WSA 設(shè)置 → Turn off 關(guān)掉 WSA → 切到 Graphics and Performance 標(biāo)簽 → 在 GPU used for apps 下拉框里換一張卡另一顆核顯/獨(dú)顯或最穩(wěn)的 Microsoft Basic Renderer。效果Basic Renderer 犧牲一點(diǎn)圖形性能換穩(wěn)定性是排查WSA 起不來(lái)時(shí)的首選對(duì)照確認(rèn)換卡能跑起來(lái)后再試回顯卡找平衡。詳細(xì)截圖版步驟見(jiàn) GPU 切換指南。把 WSA 數(shù)據(jù)遷到別的磁盤什么時(shí)候需要userdata.vhdx會(huì)越用越大把 C 盤吃滿。目標(biāo)磁盤必須是 NTFS建議預(yù)留 20GB。怎么操作先完整卸載 WSA 并刪掉%LOCALAPPDATA%\Packages下的MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe文件夾把 WSA 安裝到新磁盤裝好、數(shù)據(jù)用起來(lái)后關(guān)閉 WSA將Packages下該文件夾整體復(fù)制到目標(biāo)磁盤刪除原文件夾再在管理員命令行建目錄聯(lián)接右側(cè)替換為你的目標(biāo)路徑mklink /J %LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe D:\WSAData\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe效果WSA 以為數(shù)據(jù)還在 C 盤實(shí)際讀寫都落在 D 盤。完整步驟含保留現(xiàn)有數(shù)據(jù)的備份環(huán)節(jié)見(jiàn) 外盤遷移指南中文版。Magisk 模塊本地安裝什么時(shí)候需要Magisk 的在線模塊倉(cāng)庫(kù)已被官方下架Magisk 管理器里的模塊列表是空的但本地安裝模塊完全可用。怎么操作把模塊 zip 推到 WSA 里再調(diào)用 magisk 安裝需先 adb 連上見(jiàn)文末調(diào)試入口adb push module.zip /data/local/tmp adb shell su -c magisk --install-module /data/local/tmp/module.zip效果模塊立即生效重啟 WSA 后在 Magisk 管理器模塊頁(yè)可見(jiàn)。注意 WSA 的 system 分區(qū)由 Hyper-V 只讀掛載不要嘗試直接改 system 分區(qū)一切修改走 Magisk 模塊。 常見(jiàn)問(wèn)題速查注冊(cè) WSA 時(shí)報(bào) 0x80073CFx 系列錯(cuò)誤按 Fix Guides 里對(duì)應(yīng)錯(cuò)誤碼的文檔處理通用排查是手動(dòng)注冊(cè)拿詳細(xì)日志。先進(jìn) WSA 安裝目錄再執(zhí)行用報(bào)錯(cuò)里的 ActivityID 替換uuidAdd-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml Get-AppPackageLog -ActivityID uuid日志會(huì)給出失敗的具體原因常見(jiàn)為虛擬化未開(kāi)、組件缺失或路徑過(guò)長(zhǎng)參考FixPathTooLong.md。GApps 版在 Windows 11 上閃退 / 裝完打不開(kāi)2025 年 6 月之后的部分 Windows 11 版本上含 GApps 的構(gòu)建出現(xiàn)了崩潰問(wèn)題項(xiàng)目方正在修復(fù)。當(dāng)前可用的繞過(guò)方案有三換用文件名帶NoGApps的構(gòu)建、使用較老的 2211/2210 版構(gòu)建、或按官方 issue 中給出的臨時(shí)修復(fù)操作以倉(cāng)庫(kù) README 最新說(shuō)明為準(zhǔn)。裝完后 WSA 完全沒(méi)反應(yīng)、連閃屏都沒(méi)有的對(duì)照 WSA Does Not Load 排查文檔。adb 連不上 localhost:58526先確認(rèn) WSA 設(shè)置 → Developer 頁(yè)里開(kāi)發(fā)者模式已開(kāi)啟再記下該頁(yè)面顯示的 IP 地址改用 IP 直連試試adb connect localhost:58526若本地回環(huán)不通用 Developer 頁(yè)顯示的 IP 執(zhí)行adb connect ip:5555。升級(jí)后老應(yīng)用卡加載頁(yè)或閃屏升級(jí)構(gòu)建后先清出問(wèn)題的應(yīng)用的數(shù)據(jù)和緩存或卸載重裝仍不行就做一次干凈安裝先備份userdata.vhdx見(jiàn) 備份與恢復(fù)文檔。 版本策略與升級(jí)流程項(xiàng)目目前維護(hù)兩條構(gòu)建線以 Releases 頁(yè)面最新標(biāo)注為準(zhǔn)構(gòu)建線特點(diǎn)適合誰(shuí)LTS長(zhǎng)期支持基線 WSA 版本保持穩(wěn)定Magisk / KernelSU / GApps 隨新 Release 更新當(dāng)前為 LTS 7 Hotfixv2407.40000.4.0GApps 版默認(rèn)捆綁 Magisk日常使用、求穩(wěn)非 LTS跟隨 WSA 新版本迭代不含捆綁 Magisk需要新 WSA 特性、可接受嘗鮮升級(jí)流程不丟應(yīng)用和數(shù)據(jù)WSA 設(shè)置里點(diǎn) Turn off等加載圈消失確保 WSA-System-Control、WSAPacman 等工具未運(yùn)行。下載目標(biāo)版本.7z用 7-Zip 打開(kāi)它內(nèi)部的版本子文件夾如WSA_2xxx.xxxxx...。全選子文件夾內(nèi)文件解壓到你現(xiàn)有的 WSA 安裝目錄。提示替換時(shí)選對(duì)所有項(xiàng)目執(zhí)行此操作替換文件選替換目標(biāo)中的文件。重新運(yùn)行Run.bat打開(kāi) WSA 設(shè)置 → About確認(rèn)版本號(hào)已更新。提示升級(jí)前建議把userdata.vhdx位于%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\復(fù)制一份備份升級(jí)翻車時(shí)這是唯一的數(shù)據(jù)出口。 社區(qū)與維護(hù)現(xiàn)狀項(xiàng)目 Discord官方答疑社區(qū)安裝問(wèn)題、升級(jí)咨詢優(yōu)先來(lái)這里問(wèn)響應(yīng)最快。GitHub Issues提交 bug、請(qǐng)求自定義構(gòu)建如特定 Magisk / GApps 組合走這里維護(hù)者會(huì)在 issue 里同步修復(fù)進(jìn)度。XDA 論壇 WSA 專帖長(zhǎng)期討論串適合查歷史問(wèn)題的解決脈絡(luò)。維護(hù)狀態(tài)客觀說(shuō)明微軟已宣布 WSA 于 2025 年 3 月起停止官方支持Amazon Appstore 及依賴應(yīng)用不再更新WSABuilds 因此進(jìn)入 LTS 維護(hù)模式——倉(cāng)庫(kù)不歸檔繼續(xù)為 WSA ≥ 2311.40000.5.0 的版本發(fā)布更新 Magisk、KernelSU 和 GApps 的新構(gòu)建后續(xù)計(jì)劃以倉(cāng)庫(kù)內(nèi)公告為準(zhǔn)。? 調(diào)試入口與學(xué)習(xí)路徑日常調(diào)試主要靠三個(gè)入口ADBadb connect localhost:58526需開(kāi)發(fā)者模式是裝模塊、推文件、看日志的主力通道。Logcatadb logcat或直接讀文件%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalState\diagnostics\logcat應(yīng)用閃退原因基本都能在里面找到。WSA 設(shè)置 About 頁(yè)核對(duì) WSA 版本、確認(rèn)升級(jí)是否生效。學(xué)習(xí)路徑建議都在倉(cāng)庫(kù)內(nèi)按順序讀安裝文檔 —— 全新安裝者的第一份材料含手動(dòng)注冊(cè)的排查方法使用指南 —— 裝好之后日常怎么用ADB、側(cè)載等排查總綱 —— 遇到問(wèn)題按圖索驥的入口鏈接到各具體錯(cuò)誤碼文檔裝好后從 GApps 版入手熟悉 Play 商店和 Magisk再按上面的進(jìn)階章節(jié)逐步加料比一上來(lái)就折騰全功能省時(shí)得多。最后提醒WSA 安裝文件夾是注冊(cè)式安裝的根目錄任何時(shí)候都不要?jiǎng)h除或改名動(dòng)大手術(shù)換構(gòu)建、遷磁盤、干凈安裝之前先把userdata.vhdx備份到別處。【免費(fèi)下載鏈接】WSABuildsRun Windows Subsystem For Android on your Windows 10 and Windows 11 PC using prebuilt binaries with Google Play Store (MindTheGapps) and/or Magisk or KernelSU (root solutions) built in.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/ws/WSABuilds創(chuàng)作聲明:本文部分內(nèi)容由AI輔助生成(AIGC),僅供參考