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

[最近更新时间 : 2020/01/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来源]

因此,管理Framework源的结构在 src 文件夹中降低了一级,它与类似于 Cubism 4 SDK for Native 的框架配置的结构相匹配

由于此变更,Sample 端的每个源引用 Framework 源的位置发生了变更。

 

GitHub存储库

除了 Live2D GitHub CubismWebSamples 存储库中的包变更之外,Cubism 4 SDK for Web beta2 和更早的存储库是

  • CubismWebSamples
    • Core
    • 框架(包含源的目录)
    • Sample

它仅由 Cubism 4 SDK for Web R1或更高版本管理。

  • CubismWebFramework
    • src(包含框架源的目录)
  • CubismWebSamples
    • Core
    • 框架(子模块)
    • 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,
在每种情况下都需要执行以下步骤。

  • 如果您在不改变其结构的情况下使用框架
    1. 决定是否将Framework的结构改为“Framework/src”结构。
      • 如果这样做,请在进行结构变更后覆盖 Cubism 4 SDK for Web R1中的 Framework 文件夹。
      • 如果不改,根据结构对与Framework源码同名的文件进行区别,更新。
    2. 【仅当Framework的结构变更为“Framework / src”时】
         将引用框架的位置变更为正确的位置。
  • 当 Sample 不按原样使用,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/src。
  • 您是否使用 git submodule update 更新子模块?
    • 框架(CubismWebFramework)是 CubismWebSamples 的子模块,所以在与 Sample 一起使用时一定要更新子模块。

© 2010 - 2022 Live2D Inc.