Skip to main content

Troubleshooting

This page contains solutions to common issues you might encounter while developing with the QWR SDK.

Common Issues​

Build Issues​

Unity Build Fails​

Problem: Unity build process fails with errors.

Solutions:

  1. Ensure you're using Unity 2021 LTS or newer
  2. Check that all QWR packages are properly imported
  3. Verify Android Build Support is installed
  4. Make sure target platform is set to Android

Package Import Errors​

Problem: QWR packages fail to import or show errors.

Solutions:

  1. Download the latest QWR SDK package
  2. Clear Unity's package cache: Window > Package Manager > Advanced > Reset Packages to defaults
  3. Restart Unity Editor
  4. Re-import packages one by one

Runtime Issues​

App Crashes on Launch​

Problem: Built app crashes immediately on QWR device.

Solutions:

  1. Check that VR mode is enabled in QWR Tools
  2. Verify Minimum API Level is set to Android 7.1 Nougat
  3. Ensure IL2CPP and ARM64 are selected in build settings
  4. Check device logs using adb logcat

Hand Tracking Not Working​

Problem: Hand tracking features don't respond.

Solutions:

  1. Ensure hand tracking is enabled in device settings
  2. Check that proper lighting conditions are met
  3. Verify QWRCameraRig is properly configured in scene
  4. Update to latest QWR SDK version

Development Environment​

ADB Device Not Detected​

Problem: adb devices doesn't show connected QWR device.

Solutions:

  1. Enable Developer Options on QWR device
  2. Enable USB Debugging in device settings
  3. Install proper USB drivers for your device
  4. Try different USB cable or port
  5. Restart ADB server: adb kill-server then adb start-server

Build Performance Issues​

Problem: Build process is very slow or uses too much memory.

Solutions:

  1. Close unnecessary applications during build
  2. Increase available RAM if possible
  3. Use SSD storage for Unity project
  4. Enable Unity's Incremental Build option
  5. Consider using Unity Cloud Build for large projects

Getting Help​

If you continue to experience issues:

  1. Check Documentation: Review our Getting Started guide
  2. Sample Projects: Try our Sample Projects to verify your setup
  3. Community Support: Join our Discord community for help from other developers
  4. Contact Support: Email us at [email protected]

Reporting Bugs​

When reporting issues, please include:

  • Unity version
  • QWR SDK version
  • Device model and firmware version
  • Steps to reproduce the issue
  • Error messages or logs
  • Screenshots or videos if applicable

This helps us provide faster and more accurate support.