关于更新到Cubism 4 SDK for Web R1或更高版本的注意事项

最終更新： 2020年1月30日

概述

随着Cubism 4 SDK for Web R1从beta版本转为发布正式版本，包和存储库的结构已变更以提高便利性。
此变更是由于它的操作与Cubism 4 SDK for Native相同，并且避免了不需要用户管理的文件混合的情况。

结构变更点

包

在Cubism 4 SDK for Web beta2及更早版本中，由[包根文件夹]/Framework/[Framework源]构成，但在Cubism 4 SDK for Web R1或更高版本中，则为[包根文件夹]/Framework/src/[Framework源]，其中增加src文件夹，管理Framework源的结构降低一级，使它与Cubism 4 SDK for Native的Framework结构相匹配。

由于此变更，Sample端的每个源参考Framework源的位置发生了变更。

GitHub存储库

除了Live2D GitHub的CubismWebSamples存储库中的包变更之外，Cubism 4 SDK for Web beta2及更早的存储库仅由

• CubismWebSamples
  • Core
  • Framework（包含源的目录）
  • Sample

进行管理，在Cubism 4 SDK for WebR1或更高版本中如下所示，

• CubismWebFramework
  • src（包含Framework源的目录）
• CubismWebSamples
  • Core
  • Framework（子模块）
  • Samples

存储库管理与Cubism 4 SDK for Native相同。

由于此变更，CubismWebSamples已变更为以CubismWebFramework为子模块的结构。

---

如何从Cubism 4 SDK for Web beta2之前的项目更新

从Cubism 4 SDK for Web beta2之前的项目更新时，如果您在正在使用的项目上覆盖 Cubism 4 SDK for Web R1的包等，则变更将不会应用，或者会出现错误并且无法正常工作。

本节将介绍让使用Cubism 4 SDK for Web beta 2及更早项目的用户能够使用Cubism 4 SDK for Web R1的更新方法。

使用包时

如果已下载并使用Cubism 4 SDK for Web beta2或更早版本包的用户想要将其替换为Cubism 4 SDK for Web R1或更早版本的SDK，在各情况下都需要执行以下步骤。

在不变更Framework结构的情况下使用时

1. 决定是否将Framework的结构变更为“Framework/src”结构。

• 如果变更，则请在变更结构后覆盖Cubism 4 SDK for Web R1中的Framework文件夹。
• 如果不变更，则请根据结构对与Framework源码同名的文件进行区别更新。

2. 【仅当Framework的结构变更为“Framework/src”时】

• 将参考Framework的位置变更为正确的位置。

如果不按原样使用Sample，且Framework的结构和源被变更并使用时

• 请对与您正在使用的Framework源同名的文件进行区别更新。

* 如果按原样使用Sample，请变更各源中参考Framework的部分，或执行与Cubism 4 SDK for Web R1相同的操作。
* 根据环境的不同，即使执行上述步骤也可能无法应用更新，因此请根据项目环境进行变更。

使用Live2D GitHub存储库中的克隆时

如果使用Cubism 4 SDK for Web beta2或更早版本的存储库(CubismWebSamples)创建项目的用户想要将其替换为Cubism 4 SDK for Web R1或更高版本的SDK，步骤视环境而定，但更新时请注意以下事项。

• 项目参考Framework的位置是否有错误？
  • Framework源管理在Framework/src中。
• 是否使用git submodule update更新子模块？
  • Framework（CubismWebFramework）是CubismWebSamples的子模块，所以在与Sample一起使用时，请务必更新子模块。