关于更新到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一起使用时,请务必更新子模块。
关于本报道,敬请提出您的意见及要求。