能否通过JSFL为HTML5 Canvas文档设置Global Include脚本？

Animate CC的官方JSFL API文档确实没有公开直接操作HTML5 Canvas项目Global Include脚本的方法，手动操作也不会在历史面板留下可复用的命令，但我们可以通过修改文档的底层XML配置来实现自动化设置，这是目前可行的方案，我之前处理批量FLA转HTML5项目时亲测有效。

原理说明 #

HTML5 Canvas类型的FLA文档会把Global Include脚本的信息存储在文档的XML结构中，具体位于<scripts>节点下的<includeScripts>子节点里，每个包含的脚本对应一个带path属性的<script>节点。我们可以通过JSFL的doc.XML属性导出、修改再写回文档XML来完成配置。

具体实现代码 #

下面是一个可直接使用的JSFL函数，支持设置（替换）HTML5 Canvas文档的Global Include脚本：

function setGlobalIncludeScript(targetScriptPath) {
    // 获取当前活跃文档
    var activeDoc = fl.getDocumentDOM();
    
    // 校验文档类型
    if (!activeDoc || activeDoc.documentType !== "html5canvas") {
        fl.trace("错误：请确保当前打开的是HTML5 Canvas类型的FLA文档");
        return;
    }

    // 获取文档的完整XML结构
    var docXML = activeDoc.XML;
    var rootNode = docXML.firstChild;

    // 查找或创建<scripts>节点
    var scriptsNode = rootNode.getElementsByTagName("scripts")[0];
    if (!scriptsNode) {
        scriptsNode = docXML.createElement("scripts");
        rootNode.appendChild(scriptsNode);
    }

    // 查找或创建<includeScripts>节点
    var includeScriptsNode = scriptsNode.getElementsByTagName("includeScripts")[0];
    if (!includeScriptsNode) {
        includeScriptsNode = docXML.createElement("includeScripts");
        scriptsNode.appendChild(includeScriptsNode);
    }

    // 清空现有所有Global Include脚本（可选，若需追加可跳过此步骤）
    while (includeScriptsNode.firstChild) {
        includeScriptsNode.removeChild(includeScriptsNode.firstChild);
    }

    // 创建新的包含脚本节点
    var newScriptNode = docXML.createElement("script");
    newScriptNode.setAttribute("path", targetScriptPath);
    includeScriptsNode.appendChild(newScriptNode);

    // 将修改后的XML写回文档
    activeDoc.XML = docXML;
    fl.trace("成功设置Global Include脚本：" + targetScriptPath);
}

// ------------------------------
// 调用示例（替换为你的脚本路径）
// 支持相对路径（相对于FLA文件）或绝对路径
setGlobalIncludeScript("../shared_tools/global_utils.js");

额外说明 #

1. 路径选择：建议使用相对路径，这样在迁移项目时不需要修改脚本路径，路径相对于当前FLA文件的位置。
2. 脚本获取：如果需要读取当前文档已设置的Global Include脚本，可以通过遍历<includeScripts>下的<script>节点，提取path属性值来实现。
3. 测试建议：在批量处理前，先在单个FLA文件上测试脚本，确保XML修改不会破坏文档结构，建议提前备份文件。

内容的提问来源于stack exchange，提问作者Dre G