WSABuilds 安装 WSA 报错 0x80073CFD 修复指南Windows 10 版本过旧导致部署前置条件不满足【免费下载链接】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 / MagiskOnWSA 预构建包在 Windows 10 上执行Run.bat安装 Windows Subsystem for Android (WSA) 时出现0x80073CFD部署错误的专项排障指南。文章将完整解读该错误日志的含义、剖析其系统版本过旧的根因并结合本仓库的安装脚本与系统要求文档给出从更新 Windows 10 到验证安装成功的完整解决方案帮助读者区分该错误与同类 Appx 部署错误0x80073CF0/CF6/CF9/CFB 等的差异最终在自己的机器上顺利完成 WSA 安装。一、错误现象运行 Run.bat 安装 WSA 时中止并报 0x80073CFD在 WSABuilds 预构建方案中安装流程的入口是解压目录中的Run.bat。该脚本的作用非常纯粹先检查当前目录下是否存在Install.ps1若存在则调用 PowerShell 执行安装脚本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 )对应源码MagiskOnWSA/installer/Run.bat随后由 Install.ps1 完成管理员提权、读取filelist.txt、解析AppxManifest.xml、启用VirtualMachinePlatform功能最终通过Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml注册并部署 WSA 应用包详见 Documentation/WSABuilds/Installation.md 中的标准安装步骤。当 Windows 系统本身不满足 WSA 包的最低要求时Add-AppxPackage会在注册阶段直接中止终端窗口输出以下错误信息Registering AppxManifest.xml... Add-AppxPackage : Deployment failed with HRESULT: 0x80073CFD, Prerequisite for an install could not be satisfied. Windows cannot install package MicrosoftCorporationII.WindowsSubsystemForAndroid_2301.40000.7.0_x64__8wekyb3d8bbwe because this package is not compatible with the device. The package requires OS version 10.0.19044.2604 or higher on the Windows.Desktop device family. The device is currently running OS version 10.0.19043.2364. NOTE: For additional information, look for [ActivityId] 8b8599fb-55c1-0002-338b-868bc155d901 in the Event Log or use the command line Get-AppPackageLog -ActivityID 8b8599fb-55c1-0002-338b-868bc155d901该错误输出原文引自 MagiskOnWSA/docs/Fixes/Fix Error 0x80073CFD.md与其对应的顶层文档副本位于 Documentation/Fix Guides/Pre-Install Issues/Fix Error 0x80073CFD.md。二、逐行解读错误日志锁定版本过旧根因0x80073CFD对应的部署失败描述是Prerequisite for an install could not be satisfied安装的前提条件无法满足即系统无法满足该应用包声明的部署前置条件。上述日志中的关键信息如下日志内容含义Deployment failed with HRESULT: 0x80073CFD应用部署失败错误码为 0x80073CFD属于 Appx 部署前置条件不满足MicrosoftCorporationII.WindowsSubsystemForAndroid_2301.40000.7.0_x64__8wekyb3d8bbwe正在尝试部署的 WSA 包完整名称Family Name 后缀8wekyb3d8bbwe为微软应用包固定标识The package requires OS version 10.0.19044.2604 or higher on the Windows.Desktop device family该 WSA 包在桌面设备家族上要求的最低 OS 版本为10.0.19044.2604即 Windows 10 21H2 之上的某个累积更新版本The device is currently running OS version 10.0.19043.2364当前设备运行的 OS 版本为10.0.19043.2364Windows 10 21H1 的某个版本低于包要求Get-AppPackageLog -ActivityID ActivityId用于获取该次失败操作详细部署日志的诊断命令由此可见该错误的直接根因是Windows 10 系统版本过旧低于 WSA 包在AppxManifest.xml中声明的MinVersion要求因此安装器中止并给出包与设备不兼容的提示。需要特别说明的是错误日志中出现的具体版本号会随 WSA 构建版本变化。例如上述日志中的 WSA 构建2301.40000.7.0要求10.0.19044.2604而本仓库顶层 README.md 中的系统要求表格对 Windows 10 给出了更高标准Windows 10 22H210.0.19045.2311或更高并注明在更旧的 Windows 10 构建上使用 WSA 通常需要额外安装两个更新补丁见下文第四节。因此判断本机是否满足要求时应以实际下载的 WSA 包为准同时尽量把系统更新到最新。三、为什么是版本过旧从安装脚本看检查链虽然0x80073CFD是Add-AppxPackage在注册阶段由系统返回的错误但从仓库的安装脚本结构可以还原出部署的前置检查链路Run.bat以-ExecutionPolicy Bypass方式启动 Install.ps1脚本首先进行管理员权限自提升Test-AdministratorStart-Process -Verb RunAs并以Get-ComputerInfo判断是否 Windows 11Check-Windows11以选择pwsh.exe或powershell.exe随后启用注册表项AppModelUnlock\AllowDevelopmentWithoutDevLicense并检查、启用VirtualMachinePlatform可选功能脚本解析AppxManifest.xml读取包身份信息$Xml.Package.Identity.Name/.Version/.ProcessorArchitecture与依赖项$Xml.Package.Dependencies.PackageDependency对每个依赖检查已安装版本是否低于MinVersion不足则自动安装依赖包最后执行Add-AppxPackage ... -Register .\AppxManifest.xml完成注册部署——WSA 包自身的 OS 最低版本校验正是在这一步由系统完成的版本不满足时即抛出0x80073CFD。从源码结构可以推断脚本本身并不拦截Windows 10 版本过旧这一情况而是把校验交给系统部署引擎因此当用户看到0x80073CFD时说明系统已经明确告知包与设备不兼容正确做法是升级系统而非反复重试安装。四、解决方案将 Windows 10 更新到满足要求的最新版本关联文档给出的解决方案很明确且操作简单将 Windows 10 更新到最新版本。由于该错误由版本过旧触发更新系统后包的最低版本要求即可得到满足。以下两种官方途径均可完成更新方式一通过设置中的 Windows 更新打开设置 → 更新和安全 → Windows 更新点击检查更新安装系统列出的所有重要更新与累积更新直至系统提示你的设备已是最新。该方式最为直接适合绝大多数用户。方式二使用 Windows 10 更新助手Update Assistant如果 Windows 更新服务无法正常拉取更新例如长期未更新、更新服务异常或处于企业受限环境可以使用微软提供的Windows 10 Update Assistant工具访问微软官网下载页面下载 Windows 10 Update Assistant以管理员身份运行该工具工具会自动检测本机 Windows 10 版本并引导升级到最新的 Windows 10 版本22H2 及其累积更新按提示完成更新并重启使系统版本号提升到最新。说明关联文档原文分别提供了微软官方 Windows 更新指南与 Windows 10 Update Assistant 两个入口均为微软支持站点资源此处依据文档内容对两种途径的操作流程做了展开描述未收录外部链接地址。实际操作时请直接访问微软官方支持站点搜索 Windows 10 Update Assistant 获取对应工具。补充旧版 Windows 10 上的必备补丁KB5014032 / KB5022834仓库中的系统要求文档对旧版 Windows 10 上使用 WSA做了额外说明MagiskOnWSA/DLL/docs/README.md 中记载在 Windows 10 22H210.0.19042.2604 或更高上使用 WSA需要先安装 KB5014032再安装 KB5022834两个更新补丁顶层 README.md 的系统要求表格亦注明在更旧的 Windows 10 构建如 20H1 10.0.19041.264 及以上上使用 WSA 通常需要同样的两个补丁。因此在更新系统后若仍提示版本不满足请确认上述补丁是否已通过 Windows 更新一并安装它们通常包含在累积更新中手动安装时可从 Microsoft Update Catalog 按补丁编号搜索下载。五、更新后验证确认版本并重新安装更新并重启 Windows 10 后请按以下步骤验证并重装确认系统版本按Win R输入winver查看系统版本号是否已提升到 WSA 包要求之上例如 22H2 10.0.19045.x 系列且高于错误日志中提示的最低版本重新进入 WSA 解压目录再次以管理员身份双击运行Run.bat若安装仍失败可按照 Installation.md 的排查指引在解压目录下以管理员 PowerShell 手动执行Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml若命令失败并返回 ActivityId再执行Get-AppPackageLog -ActivityID ActivityId查看详细日志定位具体原因安装成功后WSA 会首次启动并弹出诊断信息同意窗口随后即可进入 WSA 设置使用。六、与相近 Appx 部署错误的区分0x80073CFD属于 WSA 安装失败错误家族中的一员仓库在MagiskOnWSA/docs/Fixes/与 Documentation/Fix Guides/Pre-Install Issues/ 下为不同错误码提供了专项修复文档常见区分如下错误码含义常见根因参考文档0x80073CFD安装前置条件不满足包与设备不兼容Windows 10 版本过旧低于包要求的 OS 版本Fix Error 0x80073CFD.md本文0x80073CFB包已安装且重新安装被阻止旧版本 WSA 残留未卸载Fix Error 0x80073CFB.md0x80073CF0包无法打开/无效或路径过长压缩包下载或解压损坏、目录名过长、非 NTFS 分区Fix Error 0x80073CF0.md0x80073CF6无法注册包系统组件或依赖问题Fix Error 0x80073CF6.md0x80073CF9安装位置不可用安装路径/分区异常Fix Error 0x80073CF9.md0x80073D10部署操作失败其他部署层面错误Fix Error 0x80073D10.md说明上表错误码的含义与常见根因依据仓库内对应修复文档的标题描述与内容归纳具体修复步骤请分别查阅各文档。七、预防建议与注意事项安装前先升级系统WSABuilds 的预构建包面向较新 WSA 版本其AppxManifest.xml声明的 OS 最低版本会随构建更新而水涨船高在 Windows 10 上安装前建议先通过 Windows 更新将系统升至 22H2 最新累积更新并确保 KB5014032、KB5022834 已随更新安装保持解压目录不被删除Add-AppxPackage -Register的本质是注册已有未打包文件因此安装完成后不可删除 WSA 解压目录否则 WSA 将无法运行详见 Installation.md 的注意事项安装分区必须为 NTFSWSA 仅支持安装在 NTFS 分区exFAT 等文件系统会导致部署失败见 README.md 系统要求区分错误码再动手遇到部署错误时先通过Get-AppPackageLog -ActivityID ActivityId查看日志确认错误码再对照上表选择对应的修复方案避免盲目升级或反复重装浪费时间。总而言之0x80073CFD是 WSA 安装过程中最容易识别也最容易修复的错误之一——它明确指向系统版本过旧这一根因。只要将 Windows 10 更新到满足 WSA 包要求的最新版本必要时补装 KB5014032 与 KB5022834重新运行Run.bat即可完成安装。【免费下载链接】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 安装 WSA 报错 0x80073CFD 修复指南：Windows 10 版本过旧导致部署前置条件不满足
WSABuilds 安装 WSA 报错 0x80073CFD 修复指南Windows 10 版本过旧导致部署前置条件不满足【免费下载链接】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 / MagiskOnWSA 预构建包在 Windows 10 上执行Run.bat安装 Windows Subsystem for Android (WSA) 时出现0x80073CFD部署错误的专项排障指南。文章将完整解读该错误日志的含义、剖析其系统版本过旧的根因并结合本仓库的安装脚本与系统要求文档给出从更新 Windows 10 到验证安装成功的完整解决方案帮助读者区分该错误与同类 Appx 部署错误0x80073CF0/CF6/CF9/CFB 等的差异最终在自己的机器上顺利完成 WSA 安装。一、错误现象运行 Run.bat 安装 WSA 时中止并报 0x80073CFD在 WSABuilds 预构建方案中安装流程的入口是解压目录中的Run.bat。该脚本的作用非常纯粹先检查当前目录下是否存在Install.ps1若存在则调用 PowerShell 执行安装脚本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 )对应源码MagiskOnWSA/installer/Run.bat随后由 Install.ps1 完成管理员提权、读取filelist.txt、解析AppxManifest.xml、启用VirtualMachinePlatform功能最终通过Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml注册并部署 WSA 应用包详见 Documentation/WSABuilds/Installation.md 中的标准安装步骤。当 Windows 系统本身不满足 WSA 包的最低要求时Add-AppxPackage会在注册阶段直接中止终端窗口输出以下错误信息Registering AppxManifest.xml... Add-AppxPackage : Deployment failed with HRESULT: 0x80073CFD, Prerequisite for an install could not be satisfied. Windows cannot install package MicrosoftCorporationII.WindowsSubsystemForAndroid_2301.40000.7.0_x64__8wekyb3d8bbwe because this package is not compatible with the device. The package requires OS version 10.0.19044.2604 or higher on the Windows.Desktop device family. The device is currently running OS version 10.0.19043.2364. NOTE: For additional information, look for [ActivityId] 8b8599fb-55c1-0002-338b-868bc155d901 in the Event Log or use the command line Get-AppPackageLog -ActivityID 8b8599fb-55c1-0002-338b-868bc155d901该错误输出原文引自 MagiskOnWSA/docs/Fixes/Fix Error 0x80073CFD.md与其对应的顶层文档副本位于 Documentation/Fix Guides/Pre-Install Issues/Fix Error 0x80073CFD.md。二、逐行解读错误日志锁定版本过旧根因0x80073CFD对应的部署失败描述是Prerequisite for an install could not be satisfied安装的前提条件无法满足即系统无法满足该应用包声明的部署前置条件。上述日志中的关键信息如下日志内容含义Deployment failed with HRESULT: 0x80073CFD应用部署失败错误码为 0x80073CFD属于 Appx 部署前置条件不满足MicrosoftCorporationII.WindowsSubsystemForAndroid_2301.40000.7.0_x64__8wekyb3d8bbwe正在尝试部署的 WSA 包完整名称Family Name 后缀8wekyb3d8bbwe为微软应用包固定标识The package requires OS version 10.0.19044.2604 or higher on the Windows.Desktop device family该 WSA 包在桌面设备家族上要求的最低 OS 版本为10.0.19044.2604即 Windows 10 21H2 之上的某个累积更新版本The device is currently running OS version 10.0.19043.2364当前设备运行的 OS 版本为10.0.19043.2364Windows 10 21H1 的某个版本低于包要求Get-AppPackageLog -ActivityID ActivityId用于获取该次失败操作详细部署日志的诊断命令由此可见该错误的直接根因是Windows 10 系统版本过旧低于 WSA 包在AppxManifest.xml中声明的MinVersion要求因此安装器中止并给出包与设备不兼容的提示。需要特别说明的是错误日志中出现的具体版本号会随 WSA 构建版本变化。例如上述日志中的 WSA 构建2301.40000.7.0要求10.0.19044.2604而本仓库顶层 README.md 中的系统要求表格对 Windows 10 给出了更高标准Windows 10 22H210.0.19045.2311或更高并注明在更旧的 Windows 10 构建上使用 WSA 通常需要额外安装两个更新补丁见下文第四节。因此判断本机是否满足要求时应以实际下载的 WSA 包为准同时尽量把系统更新到最新。三、为什么是版本过旧从安装脚本看检查链虽然0x80073CFD是Add-AppxPackage在注册阶段由系统返回的错误但从仓库的安装脚本结构可以还原出部署的前置检查链路Run.bat以-ExecutionPolicy Bypass方式启动 Install.ps1脚本首先进行管理员权限自提升Test-AdministratorStart-Process -Verb RunAs并以Get-ComputerInfo判断是否 Windows 11Check-Windows11以选择pwsh.exe或powershell.exe随后启用注册表项AppModelUnlock\AllowDevelopmentWithoutDevLicense并检查、启用VirtualMachinePlatform可选功能脚本解析AppxManifest.xml读取包身份信息$Xml.Package.Identity.Name/.Version/.ProcessorArchitecture与依赖项$Xml.Package.Dependencies.PackageDependency对每个依赖检查已安装版本是否低于MinVersion不足则自动安装依赖包最后执行Add-AppxPackage ... -Register .\AppxManifest.xml完成注册部署——WSA 包自身的 OS 最低版本校验正是在这一步由系统完成的版本不满足时即抛出0x80073CFD。从源码结构可以推断脚本本身并不拦截Windows 10 版本过旧这一情况而是把校验交给系统部署引擎因此当用户看到0x80073CFD时说明系统已经明确告知包与设备不兼容正确做法是升级系统而非反复重试安装。四、解决方案将 Windows 10 更新到满足要求的最新版本关联文档给出的解决方案很明确且操作简单将 Windows 10 更新到最新版本。由于该错误由版本过旧触发更新系统后包的最低版本要求即可得到满足。以下两种官方途径均可完成更新方式一通过设置中的 Windows 更新打开设置 → 更新和安全 → Windows 更新点击检查更新安装系统列出的所有重要更新与累积更新直至系统提示你的设备已是最新。该方式最为直接适合绝大多数用户。方式二使用 Windows 10 更新助手Update Assistant如果 Windows 更新服务无法正常拉取更新例如长期未更新、更新服务异常或处于企业受限环境可以使用微软提供的Windows 10 Update Assistant工具访问微软官网下载页面下载 Windows 10 Update Assistant以管理员身份运行该工具工具会自动检测本机 Windows 10 版本并引导升级到最新的 Windows 10 版本22H2 及其累积更新按提示完成更新并重启使系统版本号提升到最新。说明关联文档原文分别提供了微软官方 Windows 更新指南与 Windows 10 Update Assistant 两个入口均为微软支持站点资源此处依据文档内容对两种途径的操作流程做了展开描述未收录外部链接地址。实际操作时请直接访问微软官方支持站点搜索 Windows 10 Update Assistant 获取对应工具。补充旧版 Windows 10 上的必备补丁KB5014032 / KB5022834仓库中的系统要求文档对旧版 Windows 10 上使用 WSA做了额外说明MagiskOnWSA/DLL/docs/README.md 中记载在 Windows 10 22H210.0.19042.2604 或更高上使用 WSA需要先安装 KB5014032再安装 KB5022834两个更新补丁顶层 README.md 的系统要求表格亦注明在更旧的 Windows 10 构建如 20H1 10.0.19041.264 及以上上使用 WSA 通常需要同样的两个补丁。因此在更新系统后若仍提示版本不满足请确认上述补丁是否已通过 Windows 更新一并安装它们通常包含在累积更新中手动安装时可从 Microsoft Update Catalog 按补丁编号搜索下载。五、更新后验证确认版本并重新安装更新并重启 Windows 10 后请按以下步骤验证并重装确认系统版本按Win R输入winver查看系统版本号是否已提升到 WSA 包要求之上例如 22H2 10.0.19045.x 系列且高于错误日志中提示的最低版本重新进入 WSA 解压目录再次以管理员身份双击运行Run.bat若安装仍失败可按照 Installation.md 的排查指引在解压目录下以管理员 PowerShell 手动执行Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml若命令失败并返回 ActivityId再执行Get-AppPackageLog -ActivityID ActivityId查看详细日志定位具体原因安装成功后WSA 会首次启动并弹出诊断信息同意窗口随后即可进入 WSA 设置使用。六、与相近 Appx 部署错误的区分0x80073CFD属于 WSA 安装失败错误家族中的一员仓库在MagiskOnWSA/docs/Fixes/与 Documentation/Fix Guides/Pre-Install Issues/ 下为不同错误码提供了专项修复文档常见区分如下错误码含义常见根因参考文档0x80073CFD安装前置条件不满足包与设备不兼容Windows 10 版本过旧低于包要求的 OS 版本Fix Error 0x80073CFD.md本文0x80073CFB包已安装且重新安装被阻止旧版本 WSA 残留未卸载Fix Error 0x80073CFB.md0x80073CF0包无法打开/无效或路径过长压缩包下载或解压损坏、目录名过长、非 NTFS 分区Fix Error 0x80073CF0.md0x80073CF6无法注册包系统组件或依赖问题Fix Error 0x80073CF6.md0x80073CF9安装位置不可用安装路径/分区异常Fix Error 0x80073CF9.md0x80073D10部署操作失败其他部署层面错误Fix Error 0x80073D10.md说明上表错误码的含义与常见根因依据仓库内对应修复文档的标题描述与内容归纳具体修复步骤请分别查阅各文档。七、预防建议与注意事项安装前先升级系统WSABuilds 的预构建包面向较新 WSA 版本其AppxManifest.xml声明的 OS 最低版本会随构建更新而水涨船高在 Windows 10 上安装前建议先通过 Windows 更新将系统升至 22H2 最新累积更新并确保 KB5014032、KB5022834 已随更新安装保持解压目录不被删除Add-AppxPackage -Register的本质是注册已有未打包文件因此安装完成后不可删除 WSA 解压目录否则 WSA 将无法运行详见 Installation.md 的注意事项安装分区必须为 NTFSWSA 仅支持安装在 NTFS 分区exFAT 等文件系统会导致部署失败见 README.md 系统要求区分错误码再动手遇到部署错误时先通过Get-AppPackageLog -ActivityID ActivityId查看日志确认错误码再对照上表选择对应的修复方案避免盲目升级或反复重装浪费时间。总而言之0x80073CFD是 WSA 安装过程中最容易识别也最容易修复的错误之一——它明确指向系统版本过旧这一根因。只要将 Windows 10 更新到满足 WSA 包要求的最新版本必要时补装 KB5014032 与 KB5022834重新运行Run.bat即可完成安装。【免费下载链接】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），仅供参考