Troubleshooting

Please try the fixes here before opening an issue. In general, try fixes from top to bottom

App never opens (no loading screen)

• Try running CrossCode in the terminal (could also be cross-code)
• If the error looks like Error 71 (Protocol error) dispatching to Wayland display., try WEBKIT_DISABLE_DMABUF_RENDERER=1 CrossCode
• If neither of these work, please open an issue with the error that prints to the terminal if there is one.

App loads indefinitely

• On linux, loading should only take ~10s or less. On windows, it can take up to a couple minutes, especially if wsl is not already started. Please be patient before attempting other fixes.
• Rerun with --showMainWindow. If the app works after this, please open an issue. If a blank screen is shown, please open an issue with the error from the console.

Swift Toolchain not detected

• On linux, try using the deb or rpm instead of the AppImage
• On Windows, make sure you installed the toolchain inside of WSL, not on your main system
• Check the output of swift --version (on Windows, inside WSL). If it fails to run, your toolchain is broken.
  • You may have forgotten to install dependencies. Swiftly should've told you what you needed when you installed it, but if you missed it, you can find the info here: https://www.swift.org/install/linux/tarball. Just click on your distro under step 1 and run the command it shows

Symbol lookup error: ...

• Use the deb or rpm instead of the AppImage

Install SDK: Changing permissions of 'dsymutil': operation not permitted

• On Windows, Run wsl --shutdown in a terminal and try again

No devices found

• Ensure your device is connected via USB
• On Windows, try installing iTunes

No error reporting, autocomplete, etc

• Check the SourceKit-LSP Tab in the bottom console for errors
• Restart SourceKit with Build > Restart LSP
• Build your app and then restart SourceKit with Build > Restart LSP

Unable to login

• Try again (sometimes login randomly fails)
• Try a different anisette server in Edit > Preferences > Apple ID
• Reset Saved Credentials in Edit > Preferences > Apple ID

Too many certificates

• Select a certificate to revoke in Edit > Preferences > Certificates

The code execution cannot proceed because MSVCP140.dll was not found.

• Install vc_redist.x64 (or x86)

*** Signal 4: Backtracing from 0x7ff99fcf3d00... failed ***

• Ensure you are using WSL 2