Upgrade to AR Foundation version 5

  • ARCore Extensions for Unity's AR Foundation supports both AR Foundation version 4 and 5.

  • To upgrade to AR Foundation 5.x, Unity 2021 or older users may need to update their package manifest to ensure compatibility.

  • AR Foundation 5.x requires the Input System package but maintains backward compatibility with the legacy input module by setting "Active Input Handling" to "Both".

  • Consult Unity's AR Foundation upgrade and migration guides for comprehensive instructions beyond package updates and input settings.

ARCore Extensions for Unity's AR Foundation supports both version 4 and version 5 of AR Foundation. To upgrade your existing AR project to AR Foundation 5.x from AR Foundation 4.x, follow these steps:

  1. Only in Unity 2021.x or older:
    Some Unity packages are bound to specific Unity Editor versions. You may need to edit the Package manifest in your Unity project to update to AR Foundation 5.x in certain Unity Editor versions. For more information, see Access AR Foundation 5.0 in Unity 2021.

    Ensure that the Packages/manifest.json contains these versions for the following packages:

    "dependencies": {
      -- other dependencies --
      "com.google.ar.core.arfoundation.extensions": "https://github.com/google-ar/arcore-unity-extensions.git#arf5",
      "com.unity.xr.arcore": "5.0.5",
      "com.unity.xr.arfoundation": "5.0.5",
      "com.unity.xr.arkit": "5.0.5",
      -- other dependencies --
    }
    
  2. AR Foundation 5.x requires the Input System package due to a dependency on TrackedPoseDriver. The ARCore Extensions Sample Scenes require the legacy input module.

    To support both the Input System package and the older Input Manager, in Project Settings > Player > Other Settings set Active Input Handling to Both.

  3. Follow other steps in Unity's AR Foundation upgrade and migration guides.