WSA Installer v1.2: WSA Pacman, APK Handler & Virtualization Bypass

What's New in v1.2

WSA Installer v1.2 is the biggest update since launch. It introduces WSA Pacman for double-click APK installation, an APK File Handler for Windows Explorer integration, a 3-phase system check, and automatic virtualization bypass for compatibility issues.

Deep Dive Series

This release includes 5 major features. Read the deep-dive for each:

• Part 1: WSA Pacman — Double-click any APK to install into WSA
• Part 2: APK File Handler — Windows Explorer integration with custom icons
• Part 3: 3-Phase System Check — System validation, bundle detection, virtualization bypass
• Part 4: Virtualization Bypass — Auto-fix 6 compatibility issues
• Part 5: Win10/Win11 Detection — Smart build selection

WSA Pacman — Double-Click APK Install

Install any APK, XAPK, APKS, or APKM file by simply double-clicking it in Windows Explorer. The tool automatically detects the file format, connects to WSA via ADB, and installs the app with a desktop shortcut.

• Supports APK, XAPK, APKS, APKM, and AAB formats
• Automatic ADB connection (15 attempts with retry)
• Detects install, update, downgrade, and reinstall
• Creates desktop shortcuts with watermarked icons
• 6-step progress dialog with real-time status

APK File Handler — Explorer Integration

WSA Installer registers itself as the Windows handler for APK files. This means APK files get custom icons in Explorer, and double-clicking them opens WSA Pacman automatically.

• Registers ProgIDs for 5 APK formats
• Sets open command: app.py --wsa-pacman "%1"
• Registers ApkIconShlExt.dll for per-file icons
• Auto-registers on normal app startup

3-Phase System Check

The installer now runs a comprehensive 3-phase system check before installation:

• Phase 1: System Validation — Windows version, virtualization, features
• Phase 2: Bundle Detection — Cache check, extraction, hash verification
• Phase 3: Virtualization Bypass — Auto-fix compatibility issues

Virtualization Bypass

When virtualization issues are detected, the installer automatically applies fixes:

• Hyper-V — Enables required features via DISM
• Problematic KBs — Uninstalls conflicting updates
• WSL2 — Configures compatibility settings
• Defender — Adds exclusion for WSA directory
• VBS — Disables Virtualization-Based Security if needed
• FsDepends — Fixes filesystem dependency issues

Win10/Win11 Detection

WSA Installer now detects your Windows version and uses the appropriate GitHub API source. Windows 10 users get WSAPatch-compatible builds, while Windows 11 users get the standard builds.

# Detection logic in app.py
if sys.getwindowsversion().major >= 10:
    if sys.getwindowsversion().build >= 22000:
        # Windows 11 — use standard builds
        source = "WSA-Installer/wsa-installer"
    else:
        # Windows 10 — use WSAPatch builds
        source = "WSA-Installer/wsa-installer-win10"

Updated Installation Flow

The installation flow has been updated to include the new features:

• 1. System Check — 3-phase validation with virtualization bypass
• 2. Bundle Check — Cache detection and extraction
• 3. Install WSA — 6-phase installation with 30-chunk parallel downloads
• 4. Play Store — 7-phase GApps integration
• 5. Complete — Shortcuts, service registration, APK handler

Updated CLI Arguments

New command-line arguments have been added for the new features:

REM WSA Pacman
app.py --wsa-pacman <path>     :: Install APK from path

REM APK Handler
app.py --register-apk         :: Register APK handler
app.py --unregister-apk       :: Unregister APK handler

REM System Check
app.py --bg-service           :: Run background service
app.py --headless             :: Headless background service

Migration from v1.1

Upgrading from v1.1 to v1.2 is seamless. The installer handles everything automatically:

• APK handler is auto-registered on first run
• Existing WSA installation is preserved
• Background service is updated in-place
• New features are available immediately

What's Next

With v1.2, WSA Installer becomes a complete Android app management platform on Windows. Future updates will add:

• WSA version management (install multiple versions side-by-side)
• Custom GApps selection (NikGapps, FlameGApps)
• WSA settings backup and restore
• ADB shell integration in the GUI
• Performance monitoring dashboard

"v1.2 is just the beginning. We're building the ultimate Android-on-Windows platform."