WSA Pacman: Double-Click Any APK to Install into WSA

The Problem

Installing an APK into WSA traditionally requires opening a command prompt, navigating to the ADB directory, connecting to WSA, and running `adb install`. That's 4+ commands for a simple task.

The Solution: WSA Pacman

WSA Pacman is a new feature in WSA Installer v1.2 that lets you install any APK by simply double-clicking it in Windows Explorer. It handles everything automatically.

How It Works

Step 1: Parse APK Metadata

When you double-click an APK file, WSA Pacman first extracts metadata using the embedded aapt++ tool:

• App name (e.g., 'Instagram')
• Package name (e.g., 'com.instagram.android')
• Version code and version name
• Minimum and target SDK
• App icon (extracted and watermarked)
• APK file size

Step 2: Check WSA Status

Verifies that WSA is installed and currently running. If WSA is stopped, it attempts to start it automatically.

Step 3: Connect ADB

Establishes an ADB connection to WSA at 127.0.0.1:58526. Uses exponential backoff with 15 attempts:

for attempt in range(15):
    result = subprocess.run(['adb', 'connect', '127.0.0.1:58526'])
    if 'connected' in result.stdout.decode():
        break
    time.sleep(2 ** attempt * 0.5)

Step 4: Detect Install Type

Determines whether this is a fresh install, update, downgrade, or reinstall by checking the package manager:

adb shell pm list packages com.instagram.android
# If empty → fresh install
# If exists → check version code for update/downgrade

Step 5: Install Application

Installs the APK using the appropriate method:

• Standard APK: `adb install app.apk`
• Split APKs (XAPK/APKS): `adb install-multiple base.apk split1.apk split2.apk`
• Update with data: `adb install -r app.apk`
• Downgrade: `adb install -d app.apk`

Step 6: Create Desktop Shortcut

Creates a Windows shortcut on the desktop with the app's icon (watermarked with the WSA Installer logo).

Supported Formats

• APK (.apk) — Standard Android application package
• XAPK (.xapk) — XAPK bundle (APK + OBB data files)
• APKS (.apks) — Split APKs bundle (Google Play App Bundle)
• APKM (.apkm) — APK Mirror bundle format
• AAB (.aab) — Android App Bundle (raw, not signed)

The Install Dialog

WSA Pacman shows a 6-step progress dialog during installation:

• Step 1: Parsing APK metadata — Extracting app info
• Step 2: Checking WSA status — Verifying subsystem
• Step 3: Connecting ADB — Establishing connection
• Step 4: Detecting install type — Checking existing
• Step 5: Installing application — Pushing to WSA
• Step 6: Creating desktop shortcut — Finalizing

Command-Line Usage

You can also install APKs from the command line:

REM Install single APK
app.py --wsa-pacman C:\Downloads\Instagram.apk

REM Install from network share
app.py --wsa-pacman \\server\share\app.apk

Error Handling

WSA Pacman handles common errors gracefully:

• WSA not installed → Shows installation prompt
• WSA stopped → Attempts to start automatically
• ADB connection failed → Retries with exponential backoff
• Insufficient storage → Shows required vs available space
• Incompatible architecture → Shows error with details
• Signature conflict → Offers uninstall first

Security Considerations

• APK signature verification is performed by WSA
• No automatic installation from untrusted sources
• User must explicitly double-click each APK
• Installation log is written to wsa_activity.log

What's Next

Future versions of WSA Pacman will add:

• Batch installation (select multiple APKs)
• QR code scanning for APK URLs
• Integration with package managers (Aurora Store)
• Automatic updates for installed apps