Troubleshooting#

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

  1. Sometimes when connecting to the Purse dataset the purse may appear to have its variants unset, and appear white/grey, changing to a variant fixes this. We’re investigating this issue.

  2. 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.

      • Reset the Local Repository:

        • Open a terminal or PowerShell window.

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

      • Run the Following Commands:

        • To discard any local changes and reset the repository, execute the following commands:

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

      • Proceed with Setup:

        • After the reset, continue the setup process from Step 3 in the instructions under Setup Omniverse SDK > Clone the Kit Repository.

    • By following these steps, you will have a fresh checkout of the repository, ensuring that any template or configuration changes are properly applied.

      • Be cautious as this will remove any local modifications.

Client-side (Xcode)#

  1. Sometimes the first connection from client to server will fail, but a 2nd attempt at connecting will succeed.

  2. AVP is not showing within Xcode

    • Answer: Navigate to Window > Devices & Simulator.

    • Verify Apple Vision Pro is connected properly.

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

  3. Signing for “Configurator” requires a development team.

    • Answer: Select a development team in Signing & Capabilities editor.

  4. 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.

      • Answer: Append a character or number to the current identifier to create a unique identifier.

  5. Error (when build & run)

    • 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.

        • Answer: Select Configurator > Apple Vision Pro or Vision Pro.

  6. Why is Captcha service not displaying?

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

On this page