插件升级及版本兼容性

兼容性只在插件本体中会被考虑。样例文件会在任何可能的情况下改变。

文件兼容性

尽管EasyAR Sense Unity Plugin 是源码发布，但在不同版本间并不提供文件级别的兼容性。你需要将 EasyAR Sense Unity Plugin 当成一个整体，就像一组互相依赖的 "DLLs"。

EasyAR Sense兼容性

EasyAR Sense Unity Plugin内包含 EasyAR Sense。插件只能与同一个发布包中的 EasyAR Sense一同使用。在某些特殊情况下，如果EasyAR Sense Unity Plugin 在不同版本间改变不多，EasyAR Sense也是可以交换的。在这种情况下， Packages/com.easyar.sense/Runtime/Binding 和 Packages/com.easyar.sense/Runtime/BindingNR 文件夹中的所有文件需要来自于同一个EasyAR Sense发布版本。EasyAR没有在设计中提供这种兼容性，因此如果有需求，你应该自行检查可行性并自行承担风险。

接口兼容性

接口兼容性只在同一个小版本中会确保。大型接口改动会在发行说明中提及。

注意: EasyAR 不使用Unity所要求的 semantic versioning。主要区别是，minor版本号的变化也可能会引入不兼容的变化，虽然并不总是如此。

升级指引

使用 Package Manager window 删除老版本的 EasyAR Sense 包并添加新的包即可。在插件升级后，导入到工程中的Sample可能无法正常工作，建议删除老sample并使用新的包重新导入。

从4.2或更低版本迁移

如果你在从4.2或更低的版本上升级，需要删除老插件的所有文件，然后通过Unity的 Package Manager window 进行干净的导入。这些文件可能在 Assets/EasyAR 、 Assets/Plugins 、 Assets/Samples 和 Assets/StreamingAssets 文件夹中存在。

从4.3迁移

prefab已经标记为过时，并将在将来的发布中删除。只要有可能，请删除插件包prefab的使用。如果继续使用这些prefab会有warning log，且这些log中包含在新的插件中如何替代的简短指引。你可以可以阅读 从零创建可运行的工程 或新的样例来学习如何在这个版本中创建AR场景。

VIOCameraDeviceUnion 已经标记为过时，并将在将来的发布中删除。如果继续使用这个组件会有warning log，且这些log中包含在新的插件中如何替代的简短指引。你可以可以阅读 从零创建可运行的工程 或新的样例来学习如何在这个版本中创建AR场景。

一些其它API也有所改变，可以阅读 API参考手册 来了解新API的使用。

有一些公有方法的XML注释中标记为了 internal，且未列在 API参考手册 中，尽可能避免使用这些接口，它们可能会在今后的一些版本中被替代。