WSAPatch 开源项目使用手册

WSAPatch 开源项目使用手册

项目概述

WSAPatch 是一个旨在让 Windows Subsystem for Android (WSA) 能在 Windows 10 系统上运行的补丁工具。这个项目通过一系列的自定义修补流程，解决了在不支持的系统版本上运行 WSA 的技术障碍。它兼容特定版本的 WSA 和 Windows 10，并且要求一定的手动操作和技术理解。

1. 项目目录结构及介绍

WSAPatch 的项目结构设计是为了便于开发者和用户进行编译和定制。以下是关键的目录和文件说明：

- `original/dll/win11/22h2`: 包含了从 Windows 11 22H2 提取的 `icu.dll` 文件，这些是必需的补丁组件，因为Windows 10的相应DLL缺少必要的函数。
- `src`: 源代码存放区，包含了如 `WsaPatch.cpp/h`, `Log.cpp/h` 等核心组件，用于构建补丁DLL。
- `CMakeLists.txt`: CMake构建脚本，指导如何编译整个项目。
- `LICENSE`: 许可证文件，表明该项目遵循 Unlicense 协议。
- `README.md`: 主要的英文读我文件，提供了详细的安装和使用指南。
- `README_zhs.md`: 针对中国用户的中文版本说明文档。

2. 项目启动文件介绍

WSAPatch 的运作并不依赖于单一的“启动文件”传统概念，而是通过一系列命令和脚本来实现功能。关键步骤涉及编译WsaPatch.dll、修改icu.dll以导入该DLL、调整AppxManifest.xml文件等，最后通过运行批处理文件（如 Run.bat）来注册修改后的WSA应用包，从而实现WSA在Windows 10上的启动。

3. 项目的配置文件介绍

AppxManifest.xml

• 作用: 这个XML文件是Windows应用包的核心配置文件，它定义了应用的基本信息、目标设备家族、权限需求等。
• 修改要点:
  • TargetDeviceFamily: 需要调整以匹配你的Windows 10版本号，确保WSA可以被正确识别和启动。
  • 删除定制安装节点: 包括 <rescap:Capability Name="customInstallActions"/> 及其相关扩展，这是为了适应旧版本Windows的限制。

其他配置考量

虽然项目没有传统的配置文件，但通过修改源码中的某些标志（例如在 WsaPatch.cpp 中的 wsapatch::kDebug），你可以开启调试模式，这对于开发和故障排除非常有用。

---

此文档提供了一个概览性的引导，具体操作步骤需参考项目中详细提供的英文或中文文档，尤其是README.md和README_zhs.md文件。成功应用WSAPatch需要用户有一定的技术背景，包括对Windows系统管理、编译环境以及命令行操作的熟悉。