WSABuilds 安装报错 0x80073CF6「Package could not be registered」排查与修复实战指南【免费下载链接】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本指南针对 WSABuildsMagiskOnWSA在 Windows 10/11 上通过Run.bat安装 WSA 时出现的部署失败错误0x80073CF6完整覆盖前置修复步骤、失败日志的获取方法以及日志中两类典型底层错误0x800706D9 端点映射失败、0x80073B06 启动画面无法识别的对应解决方案。读完本文后你将掌握从复现错误 → 抓取 ActivityID 日志 → 按日志定位根因 → 执行针对性修复的完整排障流程并能结合仓库中安装脚本的实际实现理解 WSA 包注册Add-AppxPackage -Register的失败环节。错误 0x80073CF6 的本质MSIX 包注册失败0x80073CF6是 Windows AppX 包管理器在执行包注册registration阶段返回的 HRESULT含义是包无法完成注册。WSA 是以 MSIX 包形式部署的 UWP 应用其安装的本质就是把AppxManifest.xml描述的包向 Windows 包注册表登记。任何环节出错依赖缺失、残留包冲突、文件系统/服务异常、资源文件损坏等都可能以这个统一的错误码抛出因此该错误没有唯一解法必须结合具体日志定位。典型的报错输出形如来自本仓库修复文档 Fix Error 0x80073CF6 中记录的真实报错样例Add-AppxPackage : Deployment failed with HRESULT: 0x80073CF6, Package could not be registered In E:\WSA\Install.ps1:102 Character:1 Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion CategoryInfo : WriteError: (E:\WSA\AppxManifest.xml:String) [Add-AppxPackage], IOException FullyQualifiedErrorId : DeploymentError,Microsoft.Windows.Appx.PackageManager.Commands.AddAppxPackageCommand注意FullyQualifiedErrorId为DeploymentError错误来源是AddAppxPackageCommand—— 即包管理器命令层而不是解压或权限层。结合安装脚本看错误发生的位置WSABuilds 预构建包内的安装入口是 Run.bat它只做一件事定位到自身所在目录然后以powershell.exe -ExecutionPolicy Bypass -File .\Install.ps1启动安装脚本见 Run.bat 第 22-29 行。真正执行注册的是 Install.ps1关键流程如下文件完整性检查读取filelist.txt并逐个Test-Path缺文件会直接报 Some files are missing in the folderInstall.ps1 第 83-88 行——这一步失败通常不是 0x80073CF6而更像是解压不完整资源合并可选若目录中同时存在MakePri.ps1和makepri.exe会先调用 MakePri.ps1 合并各语言.pri资源并更新AppxManifest.xml的Resources节点MakePri.ps1 第 20-60 行启用 VirtualMachinePlatform 功能Get-WindowsOptionalFeature检查未启用则Enable-WindowsOptionalFeatureInstall.ps1 第 110-120 行依赖包检查与安装解析AppxManifest.xml的PackageDependency对版本不足的依赖逐个执行Add-AppxPackage -PathInstall.ps1 第 122-142 行核心注册调用Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xmlInstall.ps1 第 165 行。报错行号如样例中的Install.ps1:102会随脚本版本浮动但命令形态一致。从源码结构看第 5 步失败后脚本还有一段兜底逻辑若系统中已存在旧的 WSA 安装会提示用户保留用户数据卸载旧包后重试注册Install.ps1 第 169-178 行——这也侧面说明残留的旧 WSA 注册信息正是 0x80073CF6 的常见诱因之一。前置修复步骤先做这 4 步再谈日志在深入日志前按顺序执行以下 4 个前置步骤相当比例的 0x80073CF6 会直接消失1. 确认安装所在分区/驱动器为 NTFS 格式。MSIX 部署依赖 NTFS 的文件系统特性从 FAT32/exFAT 分区安装是注册失败的已知诱因。2. 重新下载 WSA 构建产物.zip/.7z。文件在下载或解压过程中损坏会导致包资源不完整从而在注册阶段失败。配合安装脚本的filelist.txt完整性校验逻辑任何缺失文件都会被识别但校验不通过时报的是文件缺失而非注册错误——资源文件存在但内容损坏的只有重新下载才能排除。3. 若之前安装过 WSA先彻底卸载并手动清除残留目录。除了通过卸载程序/Remove-AppxPackage卸载外还需删除以下路径及其子目录中所有包含 WindowsSubsystemForAndroid 的文件夹C:\ProgramData\Microsoft\Windows\AppRepositoryC:\ProgramData\Microsoft\Windows\WindowsApps%localappdata%\ProgramData\Packages仓库中的卸载工具 WSAUninstaller.py 内部维护的残留目录清单与此一致还包括系统用户 profile 下的%LocalAppData%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe等路径可作为核对残留位置的参考。包名固定为MicrosoftCorporationII.WindowsSubsystemForAndroid签名者为8wekyb3d8bbwe。4. 重启计算机。如果问题在此后解决无需继续阅读下文如果错误依旧则必须抓取失败日志来定位根因。获取失败日志ActivityID 两步法日志抓取需要管理员权限。WSA 注册操作会生成一个 ActivityIDUUID包管理日志通过它索引。操作步骤打开 PowerShell管理员将工作目录切换到 WSA 安装目录即AppxManifest.xml所在目录手动执行与安装脚本第 165 行相同的注册命令让它失败并吐出 ActivityIDAdd-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml用返回的 UUID 查询该次失败操作的详细日志Get-AppPackageLog -ActivityID UUID日志中会显示真正导致注册失败的底层 HRESULT 与描述文本。根据原文档记录最常见的两类底层错误如下。Issue 10x800706D9 There are no more endpoints available from endpoint mapper该错误表明 COM 端点映射服务异常Windows 侧通常指向防火墙/网络相关服务状态损坏。Windows 防火墙场景确保 Windows 防火墙处于开启状态且推荐设置Recommended Settings已启用确保 Windows 防火墙服务正在运行未运行则将其启用重启计算机。第三方防火墙场景确保第三方防火墙处于开启且正常工作状态推荐设置已启用确保防火墙没有阻止或拦截新规则的写入/新条目的创建重启计算机。Issue 20x80073B06 Initial screen image for the current application context cannot be recognized日志样例形如Installing MagiskOnWSA... Add AppxPackage: Deployment failed due to HRESULT: 0x80073CF6, unable to register the package. AppxManifest.xml (24,27): Error 0x80073B06: Unable to install or update package MicrosoftCorporateII.WindowsSubsystemForAndroid_8wekyb3d8bbwe because the initial screen image for the current application context cannot be recognized. ... CategoryInfo : WriteError: (D:\WSA\WSA\AppxManifest.xml:String) [Add-AppxPackage], IOException FullyQualifiedErrorId : DeploymentError,Microsoft.Windows.Appx.PackageManager.Commands.AddAppxPackageCommand这个错误发生在包管理器解析AppxManifest.xml中声明的启动画面SplashScreen资源时——资源引用存在但对应的图像内容无法按当前应用上下文语言、DPI、对比度等被识别。WSABuilds 的构建流程中各语言的启动画面等视觉资源正是通过MakePri.ps1合并进resources.pri并同步到AppxManifest.xml的MakePri.ps1 第 53-60 行 会解析xml目录下各语言的 priconfig 并把Resource节点追加进清单。从源码结构看若构建产物中这些资源合并结果不完整或清单引用错位就会出现 0x80073B06。解决方案二选一视你的安装来源自构建场景使用 MagiskOnWSALocal 或 WSA-Script 自行构建删除之前构建的全部产物后重新构建使用 MagiskOnWSALocal 时务必先删除并重新克隆 git 仓库再构建避免旧缓存参与构建预构建场景使用 Releases 中的预构建包重新下载最新构建若问题依旧向项目方反馈如加入项目 Discord 社区协助排查。相关修复文档索引0x80073CF6属于安装前Pre-Install问题家族。若前置步骤与日志定位均无效可对照以下同类文档逐一排除文档说明Fix Error 0x80073CF0同族部署失败错误码Fix Error 0x80073CF9同族部署失败错误码Fix Error 0x80073CFB同族部署失败错误码Fix Error 0x80073CFD同族部署失败错误码Fix Error 0x80073D10同族部署失败错误码Extraction Errors解压阶段错误Fix Path Too Long路径过长导致的失败Fix Install.ps1Install.ps1 执行类问题Troubleshooting综合故障排查入口排障流程小结核对Run.bat是否在 NTFS 分区、是否以管理员权限运行重新下载构建产物彻底卸载旧 WSA 并清理AppRepository/WindowsApps/Packages下的WindowsSubsystemForAndroid残留可参照 WSAUninstaller.py 中的目录清单重启手动执行Add-AppxPackage -Register .\AppxManifest.xml复现错误用Get-AppPackageLog -ActivityID UUID抓取日志按日志中的底层错误码分流处理0x800706D9 走防火墙修复0x80073B06 走重建/重下流程仍无法解决时携带 ActivityID 与完整日志向项目社区求助。整个流程的仓库内证据链为入口 Run.bat → 主流程 Install.ps1第 165 行注册调用→ 资源合并 MakePri.ps1 → 卸载残留清单 WSAUninstaller.py可据此在自己的环境里逐环节核对。【免费下载链接】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），仅供参考