-
Notifications
You must be signed in to change notification settings - Fork 1
Android Setup
Warning
Android support in WPR is currently experimental.
Compatibility, performance, and stability may vary heavily between devices.
Before running WPR on Android, ensure your device meets the following requirements.
| Requirement | Notes |
|---|---|
| Android Device | Required |
| Vulkan Support | Recommended |
| Android 10+ | Recommended |
| ARM64 Device | Recommended |
WPR generally works best on:
- newer Android devices
- Snapdragon-based devices
- devices with strong Vulkan driver support
Older devices may experience:
- crashes
- graphical corruption
- poor performance
WPR currently does not provide official releases.
You will need to:
- build the Android APK yourself
- or use a development build
See:
After building the APK:
- Transfer the APK to your Android device
- Open the APK
- Allow installation from unknown sources if prompted
- Install WPR
On first launch:
- WPR may request storage permissions
- shader caches may be generated
- startup may take longer than expected
This is normal.
To use a game with WPR:
- Launch WPR
- Import a supported XAP package
- Wait for processing/import
- Launch the game
Current primary focus:
- Windows Phone XNA titles
Limited / experimental:
- Silverlight titles
Unsupported:
- Native WinRT applications
Android primarily uses touchscreen controls.
Most Windows Phone games were designed around touch input, making Android a good fit for many titles.
Some games use device tilt controls.
Accelerometer support is currently experimental and behaviour may vary between devices.
Controller support is currently incomplete.
Some experimental gamepad functionality may exist internally, but proper controller support is not yet implemented.
WPR currently relies heavily on Vulkan rendering support.
Devices with poor Vulkan drivers may experience:
- startup crashes
- black screens
- missing textures
- rendering corruption
Some Android versions may require:
- media permissions
- file access permissions
Without these permissions, importing games may fail.
Possible causes:
- unsupported Android version
- incompatible architecture
- corrupted APK
Try:
- rebuilding the APK
- updating Android
- enabling installation from unknown sources
Possible causes:
- Vulkan issues
- unsupported rendering features
- incomplete compatibility
Try:
- Updating to the latest WPR version
- Reinstalling the game
- Checking the Compatibility List
- Testing another title
See:
Performance may vary depending on:
- GPU driver quality
- thermal throttling
- Vulkan support
- device hardware
- current WPR implementation state
Optimisation is still ongoing.
Some games may heavily stress the GPU.
If overheating occurs:
- reduce background apps
- allow the device to cool
- avoid charging while playing
- test lighter titles
To update:
- Build the latest APK
- Install over the existing version
- Re-test games if needed
Current Android limitations may include:
- incomplete compatibility
- graphics issues
- missing APIs
- broken audio in some titles
- incomplete controller support
- unstable accelerometer behaviour
Before opening an issue:
- Test the latest version
- Reinstall the game
- Check existing issues
- Verify the game status in the Compatibility List
If the issue still exists:
- open a GitHub issue
- include device information
- include logs if available
- include screenshots if useful
Thank you for helping test and preserve Windows Phone gaming ❤️