突破限制：MagiskOnWSALocal实现多版本WSA共存的完整指南

你是否曾因工作需要在同一台电脑上测试不同版本的Android应用？是否想同时运行基于不同API level的WSA（Windows Subsystem for Android，Windows子系统Android）实例？MagiskOnWSALocal提供了灵活的多版本共存方案，让你无需频繁卸载重装即可拥有隔离的Android环境。本文将通过修改应用标识、定制安装路径和管理启动项三个关键步骤，帮助你在Windows系统中无缝运行多个WSA实例。

多版本共存的核心原理

WSA默认通过包名和注册表键值实现唯一性校验，阻止多实例安装。实现共存需要修改两个关键标识：

• Package Identity：在AppxManifest.xml中定义的应用唯一标识
• 注册表项：HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Uninstall下的应用注册信息

通过构建时修改这两个标识，系统会将不同配置的WSA识别为独立应用。以下是实现共存的架构示意图：

graph TD
    A[原始WSA包] -->|修改Package Name| B[WSA实例1]
    A -->|修改Package Name| C[WSA实例2]
    B --> D[独立数据目录]
    C --> E[独立数据目录]
    B --> F[独立注册表项]
    C --> G[独立注册表项]
    D & E & F & G --> H[系统级共存]

准备工作与环境要求

在开始前，请确保系统满足以下条件：

• Windows 11 专业版/企业版 22H2及以上
• 已启用虚拟化功能（在BIOS中开启Intel VT-x/AMD SVM）
• 已安装Git和Python 3.10+
• 至少10GB空闲磁盘空间（每个WSA实例约占用4-6GB）

通过以下命令克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/ma/MagiskOnWSALocal
cd MagiskOnWSALocal

安装依赖组件：

# Linux/macOS
chmod +x ./scripts/install_deps.sh
./scripts/install_deps.sh

# Windows
powershell -ExecutionPolicy Bypass -File .\installer\Install.ps1

构建多版本WSA的关键步骤

1. 定制编译参数

运行构建脚本时，通过修改--app-name参数区分不同实例：

# 构建实例1：稳定版Android 13 + Magisk稳定版
./scripts/run.sh --arch x64 --release-type retail --app-name "WSA-Stable" --magisk-ver stable

# 构建实例2：预览版Android 14 + Magisk测试版  
./scripts/run.sh --arch x64 --release-type insider_fast --app-name "WSA-Beta" --magisk-ver beta

注意：--app-name参数会影响生成的包名和安装目录，建议使用具有辨识度的名称

2. 修改应用标识文件

构建完成后，在输出目录中找到AppxManifest.xml，修改以下字段：

<!-- 原始配置 -->
<Package
  Name="MicrosoftCorporationII.WindowsSubsystemForAndroid"
  Publisher="CN=Microsoft Corporation, O=Microsoft Corporation, L=Redmond, S=Washington, C=US"
  Version="2311.40000.9.0">

<!-- 修改为 -->
<Package
  Name="Custom.WSA.Stable"  <!-- 唯一标识1 -->
  Publisher="CN=Custom, O=Custom, L=Local, S=Local, C=CN"
  Version="2311.40000.9.0">

3. 独立安装与注册表隔离

使用修改后的配置进行安装：

# 安装第一个实例
cd out/WSA-Stable_x64
powershell -ExecutionPolicy Bypass -File .\Install.ps1

# 安装第二个实例（在新终端中执行）
cd out/WSA-Beta_x64
powershell -ExecutionPolicy Bypass -File .\Install.ps1

安装脚本会自动处理注册表隔离，关键代码位于Install.ps1的119-123行：

[xml]$Xml = Get-Content ".\AppxManifest.xml";
$Name = $Xml.Package.Identity.Name;
Write-Output "Installing $Name version: $($Xml.Package.Identity.Version)"
$ProcessorArchitecture = $Xml.Package.Identity.ProcessorArchitecture;

管理与切换多版本实例

创建快捷启动器

为每个实例创建独立快捷方式，修改Run.bat文件：

:: WSA-Stable启动器
start "" "wsa://com.topjohnwu.magisk" --instance Stable

:: WSA-Beta启动器
start "" "wsa://com.topjohnwu.magisk" --instance Beta

查看已安装实例

通过PowerShell命令列出所有WSA实例：

Get-AppxPackage *WSA* | Select-Object Name, Version, InstallLocation

数据备份与迁移

各实例数据存储在独立目录，路径格式为：

%LOCALAPPDATA%\Packages\<PackageName>\LocalState

备份时直接复制对应目录即可，例如：

# 备份Stable实例数据
Copy-Item "%LOCALAPPDATA%\Packages\Custom.WSA.Stable\LocalState" "D:\WSA-Backups\Stable" -Recurse

常见问题与解决方案

安装冲突问题

症状：系统提示"已安装同名应用"
解决：检查AppxManifest.xml中的Name字段，确保每个实例完全唯一，建议格式：Custom.WSA.<标识>

性能资源占用

优化方案：通过WSA设置限制每个实例资源：

1. 打开对应WSA实例设置
2. 导航至"资源"选项卡
3. 设置CPU限制为"2核"，内存限制为"4GB"
4. 启用"后台应用暂停"功能

网络隔离问题

症状：不同实例网络相互干扰
解决：修改scripts/post-fs-data.sh添加网络命名空间隔离：

# 添加到文件末尾
ip netns add wsa-$APP_NAME
ip link set eth0 netns wsa-$APP_NAME

高级定制与扩展功能

集成不同GApps版本

通过--gapps-brand参数为不同实例安装差异化GApps：

# 实例1：最小化GApps
./scripts/run.sh --app-name "WSA-Mini" --gapps-brand "MindTheGapps" --gapps-variant "pico"

# 实例2：完整GApps  
./scripts/run.sh --app-name "WSA-Full" --gapps-brand "OpenGApps" --gapps-variant "stock"

详细GApps配置可参考Custom-GApps.md

KernelSU共存配置

如需为不同实例配置KernelSU，修改scripts/generateKernelSULink.py指定不同版本：

# 修改版本号区分不同实例的KernelSU
kernel_su_versions = {
    "WSA-Stable": "v0.7.0",
    "WSA-Beta": "v0.7.2"
}

KernelSU详细配置见KernelSU.md

总结与后续展望

通过本文介绍的方法，你已成功实现WSA多版本共存，主要收获包括：

• 掌握通过修改应用标识实现共存的核心技术
• 学会定制编译参数生成差异化WSA实例
• 能够管理多个隔离的Android运行环境

未来版本计划支持：

• 一键创建多实例的图形化工具
• 实例间数据共享机制
• 基于Docker的容器化隔离方案

如果你在实践中遇到问题，欢迎提交Issue或参与项目讨论。记得收藏本文，关注项目更新获取最新共存技巧！

提示：定期备份out目录和注册表项，防止系统更新导致配置丢失