MagiskOnWSA安装与配置指南

1. 项目基础介绍

MagiskOnWSA 是一个开源项目，旨在帮助用户在 Windows Subsystem for Android (WSA) 上集成 Magisk 和 OpenGApps。通过这个项目，用户可以在几分钟之内轻松地整合这些工具，无需具备 Linux 环境或高级技术知识。该项目主要使用 PowerShell 脚本进行自动化安装和配置。

2. 关键技术和框架

• PowerShell：用于编写安装脚本，自动化安装过程。
• Magisk：一款著名的 Android root 工具，提供系统级的操作权限。
• OpenGApps：用于在 Android 设备上安装 Google 应用的工具。
• Windows Subsystem for Android (WSA)：Windows 11 上的 Android 子系统，允许用户在 Windows 上运行 Android 应用。

3. 安装和配置准备工作

在开始安装之前，请确保您的电脑满足以下要求：

• 运行 Windows 11 操作系统。
• 已经启用 Windows Subsystem for Android。
• 安装了 GitHub Desktop 或者具备运行 GitHub Actions 的能力。
• 具备网络连接，用于下载必要的文件。

安装步骤

1. 克隆或下载项目： 使用 GitHub Desktop 克隆项目到本地，或者直接下载 zip 文件并解压。

2. 配置 GitHub Actions（可选）： 如果您希望通过 GitHub Actions 自动构建，请按照以下步骤操作：

   • 在 GitHub 上 fork 此仓库。
   • 转到您的 forked 仓库的 Actions 选项卡。
   • 点击 "Build WSA" 工作流。
   • 在工作流运行列表上方，选择 "Run workflow"。
   • 配置所需的版本选项，包括 Magisk 版本、OpenGApps 变体、root 方案、WSA 版本和架构。
   • 点击 "Run workflow" 并等待任务完成，然后下载生成的构建文件。

3. 手动安装 PowerShell 脚本：

   • 解压下载的文件。
   • 右键点击 "Install.ps1" 文件，选择 "使用 PowerShell 运行"。
   • 如果之前已经安装过 MagiskOnWSA，脚本将自动卸载旧版本并保留用户数据。
   • 如果安装的是官方 WSA 版本，请先卸载官方版本。如果需要保留数据，可以备份 %LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx 文件，安装后再恢复。

4. 完成安装：

   • 脚本执行完毕后，Magisk 和 Play Store 将会被启动。
   • 可以通过安装 LSPosed-zygisk（开启 zygisk）或 Riru 和 LSPosed-riru 来享受更多功能。

确保遵循上述步骤，您应该能够成功安装并配置 MagiskOnWSA。如果在安装过程中遇到问题，请查看项目的 README 文件或相关社区论坛以获取帮助。