关于更新到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一起使用时,请务必更新子模块。