构建Web范例
最終更新: 2023年2月21日
本页说明使用Visual Studio Code在Windows上转换Live2D Cubism SDK for Web中包含的TypeScript范例项目的步骤。
* 文章内容使用Cubism 4 SDK for Web R1。
方法和步骤可能因Cubism SDK的版本而异。
必要的项目
这是SDK本体。从“官方下载页”下载。
这是JavaScript的执行环境。
这是本次使用的开发环境。该语言使用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/",