更新至 AR Foundation 5.x 版（Beta 版）

注意： 适用于 Unity 的 AR Foundation 的 ARCore Extensions 与 AR Foundation 5.x 版兼容，但是，迁移现有项目可能需要执行比本文档中列出的更多步骤。您可以将本文档用作参考，但我们正在开发一个新版本，该新版本改进了对 5.x 和 6.x 版本的支持。

ARCore Extensions for Unity 的 AR Foundation 支持 AR Foundation 的 4.x 版本和 5.x 版本。如需将现有的 AR 项目从 AR Foundation 4.x 升级到 AR Foundation 5.x，请按以下步骤操作：

1. 仅在 Unity 2021.x 或更低版本中：
   某些 Unity 软件包绑定到特定的 Unity 编辑器版本。在某些 Unity 编辑器版本中，您可能需要修改 Unity 项目中的 Package manifest，以更新到 AR Foundation 5.x。如需了解详情，请参阅 Access AR Foundation 5.0 in Unity 2021。

   确保 Packages/manifest.json 包含以下软件包的这些版本：

   "dependencies": {
     -- other dependencies --
     "com.unity.xr.arcore": "5.0.5",
     "com.unity.xr.arfoundation": "5.0.5",
     "com.unity.xr.arkit": "5.0.5",
     -- other dependencies --
   }
   

2. 适用于 Unity 的 AR Foundation 的 ARCore 扩展程序使用 ARCORE_USE_ARF_5 自定义脚本符号来确定版本兼容性。为了与 AR Foundation 5.x 兼容，请添加 ARCORE_USE_ARF_5 自定义脚本符号：

   1. 在 Edit > Project Settings > Player > Other Settings 中，向下滚动到 Script Compilation。
   2. 使用 + 按钮添加 ARCORE_USE_ARF_5。
   3. 选择采用。

3. 由于依赖于 TrackedPoseDriver，AR Foundation 5.x 需要输入系统软件包。ARCore 扩展示例场景需要旧版输入模块。

   如需同时支持输入系统软件包和旧版输入管理器，请在 Project Settings > Player > Other Settings 中，将 Active Input Handling 设置为 Both。

4. 按照 Unity 的 AR Foundation 升级和迁移指南中的其他步骤操作。