Troubleshooting#

Server-side (Kit App Template with XR Extensions)#

The purse’s variants are unset after connecting to the Purse dataset

Sometimes when connecting to the Purse dataset the purse may appear to have its variants unset, and appear white/grey

Change to a variant to fix this. We’re investigating this issue.

How to resolve template changes

If there has been a change to the template and its configuration, you will need to create a new app from the template by following the steps below:

Warning

These steps will delete all local changes and provide a fresh checkout of the repository.

  1. Reset the Local Repository:

    1. Open a terminal or PowerShell window.

    2. Navigate to the project directory where the repository is located.

  2. Run the Following Commands:

    git checkout --.
git clean -fxd .
git pull

    This command discards any local changes and resets the repository.

  3. After the reset, navigate to this page and continue the setup process from Step 3 in the Clone Kit Repo section.

After following these steps, you should now have a fresh checkout of the repository, ensuring that any template or configuration changes are properly applied.

Warning

Be cautious as this will remove any local modifications.

WSL Port Conflicts

If you’re using WSL, you may encounter port conflicts when running the client.

We recommend using a different port for the client, or shutting down WSL.

wsl --shutdown

Client-side (Xcode)#

Connection from client to server fails

Sometimes connecting from client to server fails, Try a 2nd attempt and it should succeed.

AVP is not showing within Xcode

  1. Navigate to Window > Devices & Simulator

  2. Verify Apple Vision Pro is connected properly.

  3. You might have to unplug it and replug it in.

Signing for “Configurator” requires a development team

Select a development team in Signing & Capabilities editor.

Failed Registering bundle identifier.

The app identifier cannot be registered to your development team because it is not available. Change your bundle identifier to a unique string again.

To create a unique identifier, append a character or number to the current identifier.

Build & Run errors

You may encounter the following errors:

  • A build only device cannot be used to run this target.

  • No supported visionOS devices are available. Connect a device to run your application or choose a simulated device as the destination.

Select Configurator > Apple Vision Pro or Vision Pro to solve the issue.

Captcha service does not displaying

Verify that Captcha is working by reaching the Captcha URLs listed in the docs.