Skip to content

Known-issues.md

Latest commit

 

History

History
121 lines (79 loc) · 4.64 KB

Known-issues.md

File metadata and controls

121 lines (79 loc) · 4.64 KB

Known Issues ⚠️

This document lists known issues and their workarounds. For the latest updates, check the GitHub Issues page.

Application Crashes

Crash After Affinity Window Appears

Issue: Some users report that the application crashes immediately after the Affinity window is displayed.

Status: Open (#89)

Workaround:

  • Try a different Wine version (9.14 recommended for older systems)
  • Check GPU drivers are up to date
  • Use vkd3d-proton or DXVK instead of OpenCL (see Hardware Acceleration)

Installation Issues

GLIBC Version Error

Issue: wine: could not load ntdll.so: /lib/x86_64-linux-gnu/libc.so.6: version 'GLIBC_2.38' not found

Workaround:

  • Use the AppImage installer instead
  • Update your system's GLIBC (may require system upgrade)
  • Use a distribution with newer dependencies

Wine mscoree.dll Error

Issue: wine: could not load mscoree.dll

Workaround:

  • Reinstall Wine using the GUI installer
  • Try a different Wine version
  • Use the guide method instead of scripts

Sudo Authentication Failing on Fingerprint-Enabled Systems

Issue: Sudo authentication fails when fingerprint authentication is enabled on the system.

Status: Open (#68)

Workaround:

  • Temporarily disable fingerprint authentication during installation
  • Use sudo -i to get a root shell before running the installer
  • Configure sudo to use password authentication for the installer

Distribution-Specific Issues

Unsupported Distributions

Issue: Bazzite, Linux Mint, Zorin OS, Manjaro, Ubuntu, Pop!_OS, and Debian are not officially supported.

Workaround: Use the AppImage installer instead. See System Requirements for details.

PikaOS GUI Installer Not Working

Issue: The Python GUI installer does not work on PikaOS.

Workaround: Use the AppImage installer instead.

Read-Only Filesystem Support (SteamOS, Silverblue, etc.)

Issue: The installer may not work correctly on read-only filesystems like SteamOS or Silverblue.

Status: Open (#10)

Workaround:

  • Use the AppImage installer
  • Install to a writable location (user home directory)
  • Use overlay filesystems if available

Hardware Acceleration Issues

AMD/Intel GPU OpenCL Issues

Issue: OpenCL may not work correctly on AMD and Intel GPUs.

Workaround: Use vkd3d-proton or DXVK instead of OpenCL. See Hardware Acceleration for details.

Note: We cannot fix AMD/Intel GPU OpenCL issues as we do not have access to these GPUs for testing.

Application Features

Microsoft Edge WebView2 Runtime Not Working

Issue: The Microsoft Edge WebView2 Runtime is broken and does not work properly in Wine. This affects features in Affinity v3 that rely on WebView2, such as the Help system and some web-based dialogs.

Status: Known limitation - cannot be fixed

Impact:

  • Help system in Affinity v3 may not work
  • Some web-based dialogs may fail to load
  • Canva sign-in dialog may not function properly

Workaround:

  • Use the application's built-in help files if available
  • Access documentation online instead of using in-app help
  • This is a Wine limitation and cannot be resolved until Wine improves WebView2 support

Note: Do not open issues about WebView2 - this is a known limitation that cannot be fixed.

Wine Version Issues

Wine 10.17 Bugs

Issue: Wine 10.17 has major bugs and issues.

Workaround: The installer does not use Wine 10.17. Use Wine 10.10 (recommended) or 9.14 (legacy fallback). See Wine Versions for details.

Feature Requests

Affinity Pen Path Fix

Status: Open (#53)

Request to add Affinity pen path fix to the Wine runner.

Alternate Wine Builds

Status: Open (#41)

Discussion about using alternative Wine builds for improved compatibility.

Getting Help

If you encounter an issue not listed here:

  1. Check the GitHub Issues page to see if it's already reported
  2. Search existing issues for similar problems
  3. Join the Discord Community for support
  4. Create a new issue with detailed information about your system and the problem