Common Errors

List of commonly encountered bugs and how to fix them

Signatures do not match

• Problem: A message like: failed to install TGTutorial.apk: Failure [INSTALL_FAILED_UPDATE_INCOMPATIBLE: Package com.DefaultCompany.tarsier1 signatures do not match the previously installed version; ignoring!]

• Solution 1: Open File > Build Settings > Player Settings and make sure that the Company Name at the top is the same as the Package Name under Other Settings, build the project again

• Solution 2: From the command line, run adb uninstall "nameOfPackageHere", then run adb install "yourBuildName.apk"

Collisions are not detected

• Problem: For some reason, when two things collide/when one thing enter the collider of the other, nothing happens.

• Trigger colliders: OnTriggerEnter, OnTriggerExit, etc.

  • At least one of the objects involved must have a rigidbody
  • IsTrigger must be on for only 1 object

• Non-trigger colliders: OnCollisionEnter, OnCollisionExit, etc.

  • At least one of the objects involved must have a non-kinematic rigidbody (IsKinematic needs to be unchecked)
  • IsTrigger must be off for all objects involved

Weird shadows

• Problem: Do you see weird shadows that move with you when you pan in the editor or move your head in the headset like this?

  

• Solution: Find the render pipeline asset in your files (locate it via project settings --> graphics --> click on the asset in the scriptable render pipeline settings box). Open it in the inspector, open the shadows dropdown, and increase the number for distance.

There are things become invisible when they come close to the camera

• Problem: Things cut off or become invisible when they come close to my camera, especially after scaling the OVRCameraRig down, like this:

  

• Solution: Adjust the near clipping plane on the centerEyeAnchor camera to be smaller.

Player Settings or Project Settings don't work

• Problem: Unity crashes when I try to open Player Settings or Project Settings

• Solution: Most likely, it's the ProjectSettings/XRSettings.asset that has something weird happening. Uninstalling and re-installing packages while making sure your build settings are correct should fix this.

1. Go to Window > Package Manager and uninstall all XR-related installed packages.
2. Re-install the XR Plugin Management
3. Go to your player settings (File > Build Settings > Player Settings). Under XR Settings make sure that Virtual Reality Supported is not checked, because this options is deprecated.
4. In your project settings, go to XR Plug-in Management. Make sure you are on the Android tab and check Oculus. This should automatically install the Oculus XR plugin.
5. Go back to the package manager and make sure the Oculus XR Plugin is installed. If it's not, install it.

Builds don't run in the Quest

• Problem: You've built and installed your build onto the Quest, but when you open it in the headset, it's just black.

• Solution: Make sure all of your build settings, player settings, and project settings are correct by following these instructions. You may need to re-generate the Android Manifest file as well. You can do that by going to Oculus > Tools > Create store-compatible AndroidManifest.xml.