melodyplugin v0.4.4

Melody脚本项目文档

一、插件配置（使用vscode设置实现）

优先级：项目单独配置 > 工作空间配置 > 全局配置

1. packageOutputPath

脚本打包后的输出路径（文件夹），如果有配置则打包后会往此目录下输出脚本的Mpk文件和SourceMap文件

2. autoNpmUpdate

脚本编译前时是否自动执行npm update命令

二、项目配置

项目的相关配置由放置于项目根目录的projectConfig.json文件决定，文件内容示例如下：

{
    "scriptDataPaths": [
        "scriptData/normal.json",
        "scriptData/video1.json",
        "scriptData/videoChannelFromChatRecord.json",
        "scriptData/link.json"
    ],
    "scriptTaskConfig": "scriptTaskConfig/test.json",
    "debugIdPrefix": "[debug]",
    "minify": true
}

参数说明

1. scriptDataPaths

脚本执行数据文件数组，配置多个执行数据后可以在工作台面板快速切换当前选中的执行数据

2. scriptTaskConfig

脚本任务配置文件相对于项目根目录的路径

3. debugIdPrefix

Debug模式下运行脚本（包括普通运行指令和任务模式下isDebug为true的情况），自动给脚本ID（manifest文件里的id）添加的前缀，不需要前缀请填null

4. minify

编译脚本源代码的时候是否使用代码混淆（使用的话会同时会产生SoreceMap压缩包）

三、常用功能说明

1. 打包Mpk

执行命令【Package(打包)】，在多选框中勾选想要打包的项目点确定即可。若在vscode中配置了【packageOutputPath】，则在对应的路径下可以看到刚打包的项目输出文件夹。文件夹中包含脚本安装包（.mpk）文件，若项目开启了【minifiy】选项，还会有对应的SourceMap（.zip）文件，请妥善保管此文件，以便日后用于还原混淆后的代码

2. 恢复混淆后的代码调用栈

【步骤1】

执行命令【Load Source Map Folder(加载SourceMap文件夹)】加载SourceMap文件夹

【步骤2】

在弹出的对话框中选择与SourceMap对应的项目

【步骤3】

完成步骤1、2之后在【Melody工作台】面板中会显示当前已加载的SourceMap文件夹及其关联的项目，此时只需要执行命令【Trans To Source Code Track(转换为源代码调用栈)】，把混淆后的代码调用栈文本复制粘贴在输入框中后点确定，就会在【输出】面板中输出还原后的代码调用栈