WSABuilds 安装失败排查Install.ps1 未被识别 / 缺失时的管理员手动安装指南【免费下载链接】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.项目地址: https://gitcode.com/GitHub_Trending/ws/WSABuilds导读在使用 WSABuilds 预构建包内置 MindTheGapps 与 Magisk/KernelSU安装 Windows Subsystem for Android™ 时常见的失败现象是运行Run.bat后命令行窗口一闪而过、从未弹出 UAC 管理员授权提示最终 WSA 并未安装成功。本指南以MagiskOnWSA/docs/Fixes/FixInstallps1.md为骨架结合仓库内 安装脚本 与 Run.bat 启动器 的源码实现系统讲解该问题的成因并给出以管理员身份手动执行 Install.ps1的完整可复现步骤。读完本文你将能独立完成 WSA 的兜底安装并理解 Install.ps1 在提权、依赖校验、虚拟化检查与 Appx 注册各环节的实际行为。一、问题现象与成因分析1.1 典型症状按照 安装指南 解压构建产物后双击目录内的Run.bat出现以下任一情况即属于本文所述问题黑色命令行窗口弹出后瞬间消失没有出现要求管理员授权的 UAC 弹窗系统提示Install.ps1is not recognized / missing未被识别或缺失安装流程未完成开始菜单中找不到 Windows Subsystem for Android 及其设置应用。1.2 根源Run.bat 的启动逻辑与权限链路从仓库源码可以看到Run.bat是整个安装流程的入口Run.bat 的核心逻辑如下echo off %~d0 cd %~dp0 if not exist Install.ps1 ( echo Install.ps1 is not found. echo Press any key to exit pausenul exit 1 ) else ( start powershell.exe -ExecutionPolicy Bypass -File .\Install.ps1 exit )由源码可以推断出 Install.ps1 is not found 的直接成因Run.bat会先检查当前所在目录下是否存在Install.ps1若不存在则立即报错退出。以下场景最容易触发触发场景说明解压不完整/文件被安全软件隔离目录中缺少Install.ps1、filelist.txt、AppxManifest.xml等关键文件双击的不是解压目录内的Run.bat从压缩包内直接运行或复制到其他位置导致相对路径失效安装包被标记为来自其他计算机触发 Internet 安全设置阻止文件运行Run.bat与Install.ps1均可能被拦截文件路径过长详见 FixPathTooLong超长路径会影响脚本对文件的访问而窗口消失且无管理员授权弹窗的另一层原因藏在 Install.ps1 的提权逻辑中脚本启动后会调用Test-Administrator检测当前进程是否具有管理员权限若没有则通过Start-Process -Verb RunAs重新以管理员身份拉起自身。一旦该提权过程被 UAC 策略、组策略或终端环境打断就会出现窗口一闪而过、WSA 未安装的结果——这正是本文需要手动兜底安装的原因。二、解决方案以管理员身份手动运行 Install.ps1当Run.bat自动流程失效时官方修复方案是绕开 Run.bat在管理员终端中直接执行 Install.ps1。按以下 6 步操作即可完成安装。步骤 1重新解压并缩短目录名重新下载/解压 WSA 构建包将解压得到的文件夹重命名为较短的名称名称可任选建议只包含字母与数字。示例对照改名前WSA_2XXX.XXXXXXX_XXXX_Release-Nightly-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X-RemovedAmazon改名后WSAArchive2XXX缩短目录名不仅为了便于输入命令更关键的是规避 Windows 路径长度上限MAX_PATH与解压工具对超长路径的兼容问题这两者都可能导致Install.ps1等文件看似存在却无法被脚本读取。步骤 2复制文件夹路径在文件资源管理器中右键点击该文件夹选择显示更多选项Show more options点击复制为路径Copy as path此时剪贴板中已包含带引号的完整路径如D:\WSAArchive2XXX。步骤 3打开管理员终端按Win X根据系统版本选择Windows 11选择Windows Terminal (Admin)Windows 10选择Windows PowerShell (Admin)在 UAC 提示中点击是确认以管理员身份运行。步骤 4切换到解压目录输入以下命令并回车将{X:\path\to\your\extracted\folder}连同花括号一起替换为步骤 2 复制的实际路径cd {X:\path\to\your\extracted\folder}示例cd D:\WSAArchive2XXX步骤 5以绕过执行策略方式运行 Install.ps1输入以下命令并回车PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1命令参数说明参数作用PowerShell.exe调用 Windows 自带的 Windows PowerShell 宿主与pwsh.exe即 PowerShell 7 相对-ExecutionPolicy Bypass临时绕过 PowerShell 脚本执行策略限制使.ps1脚本可直接运行不修改系统级策略-File .\Install.ps1指定执行当前目录下的安装脚本.\前缀表示相对当前工作目录步骤 6等待脚本执行并确认安装完成脚本将自动完成后续全部安装流程最终会启动 Magiskwsa://com.topjohnwu.magisk与 Play Storewsa://com.android.vending并输出All Done!提示。若脚本执行期间要求重启见下文 3.3 节虚拟化检测请重启后重新执行步骤 45。补充若手动运行后仍无法安装官方 安装指南 明确提示——如果此变通方法不起作用则说明你的 PC 不受 WSA 支持请优先核对 CPU 虚拟化VT-x/AMD-V是否在 BIOS 中开启。三、Install.ps1 安装流程源码解读为什么必须管理员运行手动运行只是恢复提权真正的安装动作全部由 Install.ps1 完成。理解其内部流程有助于判断每一步输出的含义。3.1 双重提权与自重启L20-L81脚本开头定义Test-Administrator函数判断当前会话权限非管理员时它会将当前用户的执行策略临时设为Bypass通过Start-Process -Verb RunAs以管理员身份重新启动自身若提权进程未创建或退出码非 0则输出Failed to launch start as Administrator并等待按键退出。源码路径MagiskOnWSA/installer/Install.ps1。这就是为什么Run.bat正常时应弹出 UAC 授权框——而本文场景中该提权环节失效所以必须由用户手动打开管理员终端。3.2 文件完整性校验L83-L99脚本通过Get-Content -Path .\filelist.txt读取构建时生成的清单逐一校验Test-Path若存在缺失文件会输出Some files are missing in the folder. Please try to build again.随后脚本检测MakePri.ps1与makepri.exe是否存在存在则先执行资源合并用于 WSA 设置应用的本地化。可见重新下载/解压完整构建包是前提——任何关键文件缺失都会在此阶段被拦截。3.3 开发者模式与虚拟化检查L101-L120通过reg add写入HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock下的AllowDevelopmentWithoutDevLicense为1开启开发人员模式侧载能力检查 Windows 可选功能VirtualMachinePlatform是否已启用若未启用则自动执行Enable-WindowsOptionalFeature并提示重启后再次运行脚本。这与 FixVirtError 描述的场景一致WSA 依赖 Hyper-V 虚拟化平台重启后需重跑Install.ps1。3.4 依赖包、旧版本处理与 Appx 注册L122-L178脚本解析AppxManifest.xml中的包名、版本与依赖声明逐一检查依赖包的已安装版本低于MinVersion时自动安装对应的*.appx依赖包若检测到已存在非开发模式安装的 WSA提示先卸载旧版输入y确认卸载时可选-PreserveApplicationData保留用户数据若存在正在运行的WsaClient先执行WsaClient /shutdown关闭 WSA最终通过Add-AppxPackage -Register .\AppxManifest.xml完成注册安装。由于上述步骤涉及注册表写入、系统可选功能开关与 Appx 包注册全程需要管理员权限这也从实现层面印证了以管理员身份运行的必要性。四、常见变体与关联问题速查手动安装成功后若仍遇到其他报错可按以下索引继续排查症状关联文档安装时提示文件无法被打开Internet 安全设置拦截InternetSecuritySettingsBlock.md安装失败但重跑 Install.ps1 可恢复InstallPs1FailedToUpdate.mdRun.bat执行即报 0x80073CF0 / CF6 / CF9 / CFB / CFD / D10 系列错误Fixes 目录 下对应的Fix Error 0x80073CF6.md等文档因路径过长导致脚本无法正常访问文件FixPathTooLong.md虚拟化VirtualMachinePlatform未启用FixVirtError.md安装后 Magisk/Play Store 图标缺失MissingIcons.md另外需注意仓库同时提供installer/x64/Install.ps1与installer/arm64/Install.ps1两个架构版本与根目录脚本相比x64/arm64 版本缺少Check-Windows11判断即不再优先选择pwsh.exe其余安装逻辑一致。使用时请确保运行的Install.ps1与构建产物架构多为 x64匹配。五、总结Install.ps1 is not recognized/missing与弹窗消失但未安装成功本质上是自动提权链路失效的外在表现其修复路径清晰明确重下并缩短目录名——规避文件缺失与路径过长两个前置隐患管理员终端 cd切换目录——恢复脚本运行所需的权限上下文PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1——绕过执行策略直接驱动脚本完成虚拟化检查、依赖安装与 Appx 注册全流程。该方案已在官方 安装指南 中作为标准兜底手段收录并明确若仍失败则 PC 不支持 WSA。当遇到同类安装问题时按本文步骤依次执行即可稳定复现官方预期的安装结果。【免费下载链接】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.项目地址: https://gitcode.com/GitHub_Trending/ws/WSABuilds创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 WSABuilds 安装失败排查：Install.ps1 未被识别 / 缺失时的管理员手动安装指南
WSABuilds 安装失败排查Install.ps1 未被识别 / 缺失时的管理员手动安装指南【免费下载链接】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.项目地址: https://gitcode.com/GitHub_Trending/ws/WSABuilds导读在使用 WSABuilds 预构建包内置 MindTheGapps 与 Magisk/KernelSU安装 Windows Subsystem for Android™ 时常见的失败现象是运行Run.bat后命令行窗口一闪而过、从未弹出 UAC 管理员授权提示最终 WSA 并未安装成功。本指南以MagiskOnWSA/docs/Fixes/FixInstallps1.md为骨架结合仓库内 安装脚本 与 Run.bat 启动器 的源码实现系统讲解该问题的成因并给出以管理员身份手动执行 Install.ps1的完整可复现步骤。读完本文你将能独立完成 WSA 的兜底安装并理解 Install.ps1 在提权、依赖校验、虚拟化检查与 Appx 注册各环节的实际行为。一、问题现象与成因分析1.1 典型症状按照 安装指南 解压构建产物后双击目录内的Run.bat出现以下任一情况即属于本文所述问题黑色命令行窗口弹出后瞬间消失没有出现要求管理员授权的 UAC 弹窗系统提示Install.ps1is not recognized / missing未被识别或缺失安装流程未完成开始菜单中找不到 Windows Subsystem for Android 及其设置应用。1.2 根源Run.bat 的启动逻辑与权限链路从仓库源码可以看到Run.bat是整个安装流程的入口Run.bat 的核心逻辑如下echo off %~d0 cd %~dp0 if not exist Install.ps1 ( echo Install.ps1 is not found. echo Press any key to exit pausenul exit 1 ) else ( start powershell.exe -ExecutionPolicy Bypass -File .\Install.ps1 exit )由源码可以推断出 Install.ps1 is not found 的直接成因Run.bat会先检查当前所在目录下是否存在Install.ps1若不存在则立即报错退出。以下场景最容易触发触发场景说明解压不完整/文件被安全软件隔离目录中缺少Install.ps1、filelist.txt、AppxManifest.xml等关键文件双击的不是解压目录内的Run.bat从压缩包内直接运行或复制到其他位置导致相对路径失效安装包被标记为来自其他计算机触发 Internet 安全设置阻止文件运行Run.bat与Install.ps1均可能被拦截文件路径过长详见 FixPathTooLong超长路径会影响脚本对文件的访问而窗口消失且无管理员授权弹窗的另一层原因藏在 Install.ps1 的提权逻辑中脚本启动后会调用Test-Administrator检测当前进程是否具有管理员权限若没有则通过Start-Process -Verb RunAs重新以管理员身份拉起自身。一旦该提权过程被 UAC 策略、组策略或终端环境打断就会出现窗口一闪而过、WSA 未安装的结果——这正是本文需要手动兜底安装的原因。二、解决方案以管理员身份手动运行 Install.ps1当Run.bat自动流程失效时官方修复方案是绕开 Run.bat在管理员终端中直接执行 Install.ps1。按以下 6 步操作即可完成安装。步骤 1重新解压并缩短目录名重新下载/解压 WSA 构建包将解压得到的文件夹重命名为较短的名称名称可任选建议只包含字母与数字。示例对照改名前WSA_2XXX.XXXXXXX_XXXX_Release-Nightly-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X-RemovedAmazon改名后WSAArchive2XXX缩短目录名不仅为了便于输入命令更关键的是规避 Windows 路径长度上限MAX_PATH与解压工具对超长路径的兼容问题这两者都可能导致Install.ps1等文件看似存在却无法被脚本读取。步骤 2复制文件夹路径在文件资源管理器中右键点击该文件夹选择显示更多选项Show more options点击复制为路径Copy as path此时剪贴板中已包含带引号的完整路径如D:\WSAArchive2XXX。步骤 3打开管理员终端按Win X根据系统版本选择Windows 11选择Windows Terminal (Admin)Windows 10选择Windows PowerShell (Admin)在 UAC 提示中点击是确认以管理员身份运行。步骤 4切换到解压目录输入以下命令并回车将{X:\path\to\your\extracted\folder}连同花括号一起替换为步骤 2 复制的实际路径cd {X:\path\to\your\extracted\folder}示例cd D:\WSAArchive2XXX步骤 5以绕过执行策略方式运行 Install.ps1输入以下命令并回车PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1命令参数说明参数作用PowerShell.exe调用 Windows 自带的 Windows PowerShell 宿主与pwsh.exe即 PowerShell 7 相对-ExecutionPolicy Bypass临时绕过 PowerShell 脚本执行策略限制使.ps1脚本可直接运行不修改系统级策略-File .\Install.ps1指定执行当前目录下的安装脚本.\前缀表示相对当前工作目录步骤 6等待脚本执行并确认安装完成脚本将自动完成后续全部安装流程最终会启动 Magiskwsa://com.topjohnwu.magisk与 Play Storewsa://com.android.vending并输出All Done!提示。若脚本执行期间要求重启见下文 3.3 节虚拟化检测请重启后重新执行步骤 45。补充若手动运行后仍无法安装官方 安装指南 明确提示——如果此变通方法不起作用则说明你的 PC 不受 WSA 支持请优先核对 CPU 虚拟化VT-x/AMD-V是否在 BIOS 中开启。三、Install.ps1 安装流程源码解读为什么必须管理员运行手动运行只是恢复提权真正的安装动作全部由 Install.ps1 完成。理解其内部流程有助于判断每一步输出的含义。3.1 双重提权与自重启L20-L81脚本开头定义Test-Administrator函数判断当前会话权限非管理员时它会将当前用户的执行策略临时设为Bypass通过Start-Process -Verb RunAs以管理员身份重新启动自身若提权进程未创建或退出码非 0则输出Failed to launch start as Administrator并等待按键退出。源码路径MagiskOnWSA/installer/Install.ps1。这就是为什么Run.bat正常时应弹出 UAC 授权框——而本文场景中该提权环节失效所以必须由用户手动打开管理员终端。3.2 文件完整性校验L83-L99脚本通过Get-Content -Path .\filelist.txt读取构建时生成的清单逐一校验Test-Path若存在缺失文件会输出Some files are missing in the folder. Please try to build again.随后脚本检测MakePri.ps1与makepri.exe是否存在存在则先执行资源合并用于 WSA 设置应用的本地化。可见重新下载/解压完整构建包是前提——任何关键文件缺失都会在此阶段被拦截。3.3 开发者模式与虚拟化检查L101-L120通过reg add写入HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock下的AllowDevelopmentWithoutDevLicense为1开启开发人员模式侧载能力检查 Windows 可选功能VirtualMachinePlatform是否已启用若未启用则自动执行Enable-WindowsOptionalFeature并提示重启后再次运行脚本。这与 FixVirtError 描述的场景一致WSA 依赖 Hyper-V 虚拟化平台重启后需重跑Install.ps1。3.4 依赖包、旧版本处理与 Appx 注册L122-L178脚本解析AppxManifest.xml中的包名、版本与依赖声明逐一检查依赖包的已安装版本低于MinVersion时自动安装对应的*.appx依赖包若检测到已存在非开发模式安装的 WSA提示先卸载旧版输入y确认卸载时可选-PreserveApplicationData保留用户数据若存在正在运行的WsaClient先执行WsaClient /shutdown关闭 WSA最终通过Add-AppxPackage -Register .\AppxManifest.xml完成注册安装。由于上述步骤涉及注册表写入、系统可选功能开关与 Appx 包注册全程需要管理员权限这也从实现层面印证了以管理员身份运行的必要性。四、常见变体与关联问题速查手动安装成功后若仍遇到其他报错可按以下索引继续排查症状关联文档安装时提示文件无法被打开Internet 安全设置拦截InternetSecuritySettingsBlock.md安装失败但重跑 Install.ps1 可恢复InstallPs1FailedToUpdate.mdRun.bat执行即报 0x80073CF0 / CF6 / CF9 / CFB / CFD / D10 系列错误Fixes 目录 下对应的Fix Error 0x80073CF6.md等文档因路径过长导致脚本无法正常访问文件FixPathTooLong.md虚拟化VirtualMachinePlatform未启用FixVirtError.md安装后 Magisk/Play Store 图标缺失MissingIcons.md另外需注意仓库同时提供installer/x64/Install.ps1与installer/arm64/Install.ps1两个架构版本与根目录脚本相比x64/arm64 版本缺少Check-Windows11判断即不再优先选择pwsh.exe其余安装逻辑一致。使用时请确保运行的Install.ps1与构建产物架构多为 x64匹配。五、总结Install.ps1 is not recognized/missing与弹窗消失但未安装成功本质上是自动提权链路失效的外在表现其修复路径清晰明确重下并缩短目录名——规避文件缺失与路径过长两个前置隐患管理员终端 cd切换目录——恢复脚本运行所需的权限上下文PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1——绕过执行策略直接驱动脚本完成虚拟化检查、依赖安装与 Appx 注册全流程。该方案已在官方 安装指南 中作为标准兜底手段收录并明确若仍失败则 PC 不支持 WSA。当遇到同类安装问题时按本文步骤依次执行即可稳定复现官方预期的安装结果。【免费下载链接】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.项目地址: https://gitcode.com/GitHub_Trending/ws/WSABuilds创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考