构建Web范例

最終更新: 2023年2月21日

此页面适用于Cubism 4.2及更早版本的旧版本。 点击此处查看最新页面

本页说明使用Visual Studio Code在Windows上转换Live2D Cubism SDK for Web中包含的TypeScript范例项目的步骤。

* 文章内容使用Cubism 4 SDK for Web R1。
方法和步骤可能因Cubism SDK的版本而异。 

必要的项目

·Live2D Cubism SDK for Web

这是SDK本体。从“官方下载页”下载。

·Node.js

这是JavaScript的执行环境。

·Visual Studio Code

这是本次使用的开发环境。该语言使用TypeScript。

安装作业

1. Visual Studio Code

安装并开启Visual Studio Code后,打开Cubism SDK for Web的顶层文件夹,并将以下内容安装为扩展功能。

·EditorConfig for VS Code

这是开发工具。
用于统一代码格式。

也可以通过在扩展功能的搜索窗口中输入“@recommended”来显示。

安装完成后,重启Editor使扩展功能有效。

2. Node.js

安装Node.js作为构建所需的各包的管理和JavaScript的执行环境。
使用官方网站上的安装程序进行安装。
安装完成后,打开命令提示符,查看是否可以使用以下pm命令。

node --version
npm --version


输出版本信息即为成功。

3. WebPack等构建和执行所需的各包

安装所需的包以导入Webpack Dev Server并解决TypeScript和JavaScript 依存关系。

您可以在打开Cubism SDK for Web文件夹的Visual Studio Code上,按“ctrl + shift + P”,从“Tasks: Run Task”选择“npm: install – Samples/TypeScript/Demo”来进行安装。

构建

构建时,在Visual Studio Code上打开Cubism SDK for Web的顶层目录,

将从菜单栏中通过Terminal → Run Build Task… 或“ctrl + shift + B”显示构建任务列表,选择“npm: build – Samples/TypeScript/Demo”等,并执行构建。

构建完成后会在Samples/TypeScript/Demo文件夹内创建一个dist文件夹,里面会输出JavaScript文件(bundle.js)。

执行

如果构建成功,下一步就是执行它。

要检查执行,请在打开Cubism SDK for Web的文件夹Visual Studio Code上按“ctrl + shift + P”,然后从“Tasks: Run Task”选择“npm: serve – Samples/TypeScript/Demo”,以开启简单的本地服务器。

在本地服务器开启的情况下,按F5键或从菜单栏中选择Debug> Start Debugging,即可开启Debugger for Chrome并进行调试。
当系统提示您仅第一次选择配置时,请选择remote web site with sourcemap。

浏览器开启成功、出现画面并显示模型,即为成功。

您也可以通过任意浏览器访问[npm: serve显示的地址]/Samples/TypeScript/Demo/,查看index.html。

这时候如果有端口冲突等,连接可能会被拒绝,所以在这种情况下,请检查“/Samples/TypeScript/Demo/package.json”中“serve”项目指定的端口号是否冲突。

// 在-p后面指定端口号
"serve": "serve ../../.. -p 5000",

此外,如果您将Debugger for Chrome用于开发目的,则连接URL在“/.vscode/launch.json”的“url”项目中指定,因此请同时检查。

"url": "http://localhost:5000/Samples/TypeScript/Demo/",
请问这篇文章对您有帮助吗?
关于本报道,敬请提出您的意见及要求。