WSAPatch在Windows 10上运行Android子系统详细安装配置指南

项目基础介绍

WSAPatch 是一款开源项目，由cinit发起，其核心目标是让Windows Subsystem for Android（WSA）能够在Windows 10操作系统上顺利运行。由于官方WSA通常仅支持Windows 11，此项目通过一系列补丁和配置调整，实现了在较早版本的Windows上的兼容。

主要编程语言：C++, CMake。

使用的关键技术和框架

• DLL Patching：通过对特定DLL（如icu.dll）进行修补，添加对Windows 10的支持。
• AppX Package Manipulation：修改WSA的.appxmanifest.xml文件，调整兼容性版本以适应Windows 10。
• 系统兼容性修复：利用编写的WsaPatch.dll来解决在Windows 10上运行WSA时遇到的系统级别限制。

准备工作与详细安装步骤

步骤1：环境检查与工具准备

确保你的电脑已升级至至少Windows 10 22H2版本（10.0.19045.2311或更高）。你需要的工具包括：

• Visual Studio 或 MSVC 工具链，用于编译源码。
• Git，用于克隆项目。

步骤2：下载项目源码

打开命令行工具，执行以下命令克隆WSAPatch到本地：

git clone https://github.com/cinit/WSAPatch.git
cd WSAPatch

步骤3：获取必要文件

• 下载Windows 11 22H2版本的icu.dll。如果你没有Windows 11，可以从项目中提供的original\dll\win11\22h2目录找到已签名的Microsoft版本。
• 获取WSA的.appx包，并解压获取到AppxManifest.xml以及相关文件。推荐按照LSPosed/MagiskOnWSALocal的说明自行提取或从其它可靠来源获得。

步骤4：构建WsaPatch.dll

使用Visual Studio的MSVC工具链，打开项目并编译WsaPatch.cpp以生成WsaPatch.dll。

步骤5：修改并打补丁

• 修改AppxManifest.xml：替换原文件中的MinVersion为你的当前Windows 10的具体构建号，例如如果显示的是OS Build 19044.2728，则修改为<MinVersion>10.0.19044.2728</MinVersion>。
• 删除定制安装节点：移除所有关于customInstall的XML标签。
• 补丁icu.dll：使用适当的方式或脚本将WsaPatch.dll作为导入DLL添加到icu.dll中。

步骤6：替换文件

将修改后的icu.dll和自制的WsaPatch.dll复制到WSA客户端目录。

步骤7：修改Appx包

• 执行批处理脚本Run.bat以注册修改后的WSA应用包。

注意事项

• NTFS分区要求：WSA只能安装在NTFS格式的磁盘分区上。
• 不可删除安装文件夹：一旦注册，WSA的相关文件需保留才能正常使用。
• 调试信息：若遇到问题，可通过查看项目文档和日志进行诊断。

完成以上步骤后，你应该能在Windows 10上成功启动并运行Android子系统了。记住，对于非技术人员来说，每一步都应谨慎操作，避免不当操作影响系统稳定性。如果过程复杂或遇到困难，考虑查找项目最新的社区讨论或更新的教程指导。