Search Results for

    Show / Hide Table of Contents

    持续构建模组

    中文 | English

    在仓库根目录运行以下命令,用本机 Unity MCP 回放本页示例。

    python Docs/Manual/manual/tools/tutorials.py run continuous-build
    
    点击展开 MCP 操作点击收起 MCP 操作

    准备教学样例。${变量} 由配方提供。

    {
      "variables": {
        "package": "${fixture}/Docs_${runId}_Package.asset",
        "pipeline": "${fixture}/Docs_${runId}_Pipeline.asset",
        "packageGuid": "5cd6ae9b-1231-5334-90e0-87a3974c3d4a",
        "sight": "${fixture}/TutorialSight.asset",
        "gun": "${fixture}/TutorialSightGun.asset",
        "manifest": "${fixture}/pipeline.json",
        "destination": "${fixture}/Output",
        "expectedArchive": "${destination}/StandaloneWindows64_Docs_${runId}_Package.modpack",
        "rawDestination": "${fixture}/RawOutput",
        "otherPlatformDestination": "${fixture}/AndroidOutput"
      },
      "calls": [
        {
          "tool": "invoke",
          "arguments": {
            "path": "static:UnityEditor.AssetDatabase/CreateFolder",
            "args": [
              "${fixtureParent}",
              "${folder}"
            ]
          },
          "expect": {
            "contains": "(String)"
          }
        },
        {
          "tool": "invoke",
          "arguments": {
            "path": "static:UnityEditor.AssetDatabase/CreateAsset",
            "args": [
              "@static:UnityEngine.ScriptableObject/CreateInstance(ShanghaiWindy.Core.ModPackageData)",
              "${package}"
            ]
          },
          "expect": {
            "contains": "OK:"
          },
          "phase": "build"
        },
        {
          "tool": "invoke",
          "arguments": {
            "path": "static:UnityEditor.AssetDatabase/CreateAsset",
            "args": [
              "@static:UnityEngine.ScriptableObject/CreateInstance(ShanghaiWindy.Core.ModPackageBuildPiplineData)",
              "${pipeline}"
            ]
          },
          "expect": {
            "contains": "OK:"
          },
          "phase": "build"
        },
        {
          "tool": "inspect_set",
          "arguments": {
            "path": "asset:${package}/localizedModName/defaultName",
            "value": "Tutorial Package"
          },
          "expect": {
            "contains": "OK:"
          },
          "phase": "build"
        },
        {
          "tool": "inspect_set",
          "arguments": {
            "path": "asset:${package}/localizedDescription/defaultName",
            "value": "Documentation teaching package"
          },
          "expect": {
            "contains": "OK:"
          },
          "phase": "build"
        },
        {
          "tool": "inspect_set",
          "arguments": {
            "path": "asset:${package}/author",
            "value": "Documentation"
          },
          "expect": {
            "contains": "OK:"
          },
          "phase": "build"
        },
        {
          "tool": "inspect_set",
          "arguments": {
            "path": "asset:${package}/supportURL",
            "value": "https://doc.game.windyverse.net/"
          },
          "expect": {
            "contains": "OK:"
          },
          "phase": "build"
        },
        {
          "tool": "inspect_set",
          "arguments": {
            "path": "asset:${package}/guid",
            "value": "${packageGuid}"
          },
          "expect": {
            "contains": "OK:"
          },
          "phase": "build"
        },
        {
          "tool": "inspect_set",
          "arguments": {
            "path": "asset:${pipeline}/linkedModPackage",
            "value": "@asset:${package}"
          },
          "expect": {
            "contains": "OK:"
          },
          "phase": "build"
        }
      ]
    }
    

    官方模组仓库

    1. 在模组仓库的 GitHub Actions 中打开 Build modpack。填写受影响的 packs 与目标 platform。
    2. 验收构建时设置 publish=none,留空 release。工作流会裁剪依赖、拉取相应的 LFS、构建并验证。
    3. 从该次运行的 Artifacts 下载 .modpack 与同名 .modpack.json,核对平台、GUID 和版本。

    SDK 工程中的本地构建清单

    1. 在 ModPackageBuildPiplineData 中引用 ModPackageData 和要打包的资源。
    2. 在 JSON 的 infos 新增一项。把要一起构建的管线加到 modNames。直接位于 Assets/ModManager 的资产可以只填名称。位于子目录时写从工程根开始的完整资产路径,包括 .asset 后缀。
    3. 将每个平台的输出加到 copyInfo。当前活动平台为 Android 时只处理 Android 条目,为 StandaloneWindows64 时只处理 Windows 条目。先创建输出目录。isPackage=true 输出 .modpack。使用原始资源目录的流程可填 false。多个管线共用一个输出目录时,保持 isCleanDstFolder=false。设为 true 会在每个管线复制前清理目标目录。
    {
      "infos": [
        {
          "modNames": [
            "BuildPipline-Lua-ModeRes",
            "Assets/ModManager/Vehicles/BuildPipline-Vehicles.asset"
          ],
          "copyInfo": [
            { "platform": "Android", "dstDir": "Build/Ship/Android" },
            { "platform": "StandaloneWindows64", "dstDir": "Build/Ship/Windows" }
          ],
          "isPackage": true,
          "isCleanDstFolder": false
        }
      ]
    }
    
    1. 从编辑器入口调用 ShanghaiWindy.Editor.Utility_BuildPipline.BuildPiplineManifest(path)。核对相应目录的归档。可用 Frontend.Editor.ModPackageWorkshopMeta.WriteSidecar(archivePath) 生成同名 .modpack.json,再核对平台、GUID 与版本。
    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEditor.AssetDatabase/CreateAsset",
          "args": [
            "@static:UnityEngine.ScriptableObject/CreateInstance(ShanghaiWindy.Core.UserSightData)",
            "${sight}"
          ]
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEngine.JsonUtility/FromJsonOverwrite",
          "args": [
            "{\"displayName\": {\"defaultName\": \"Tutorial Sight\"}, \"guid\": \"d326f481-ac40-53f5-8d3c-2051b6713301\", \"drawCentralLineVert\": false, \"drawCentralLineHorz\": false, \"ballistics\": [{\"defaultVelocity\": 1430, \"defaultGravity\": 9.8, \"dynamicGravity\": true, \"dynamicVelocity\": true, \"crosshairDistances\": [{\"range\": 400, \"number\": 4, \"notchSize\": 2}], \"crosshairHorRanges\": [{\"range\": 10, \"number\": 10, \"notchSize\": 1}]}], \"lines\": [{\"points\": [{\"x\": 0.4, \"y\": 0.5}, {\"x\": 0.6, \"y\": 0.5}], \"thickness\": 2, \"isRelativeSize\": true}]}",
            "@asset:${sight}"
          ]
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEditor.EditorUtility/SetDirty",
          "args": [
            "@asset:${sight}"
          ]
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEditor.AssetDatabase/SaveAssets",
          "args": []
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "asset:${pipeline}/linkedObjects/Add",
          "args": [
            "@asset:${sight}"
          ]
        },
        "expect": {
          "contains": "OK:"
        },
        "phase": "build"
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEditor.EditorUtility/SetDirty",
          "args": [
            "@asset:${pipeline}"
          ]
        },
        "expect": {
          "contains": "OK:"
        },
        "phase": "build"
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEditor.AssetDatabase/SaveAssets",
          "args": []
        },
        "expect": {
          "contains": "OK:"
        },
        "phase": "build"
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:System.IO.Directory/CreateDirectory",
          "args": [
            "${destination}"
          ]
        },
        "expect": {
          "contains": "DirectoryInfo"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:System.IO.Directory/CreateDirectory",
          "args": [
            "${rawDestination}"
          ]
        },
        "expect": {
          "contains": "DirectoryInfo"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:System.IO.File/WriteAllText",
          "args": [
            "${manifest}",
            "{\"infos\": [{\"modNames\": [\"${pipeline}\"], \"copyInfo\": [{\"platform\": \"StandaloneWindows64\", \"dstDir\": \"${destination}\"}, {\"platform\": \"Android\", \"dstDir\": \"${otherPlatformDestination}\"}], \"isPackage\": true, \"isCleanDstFolder\": false}, {\"modNames\": [\"${pipeline}\"], \"copyInfo\": [{\"platform\": \"StandaloneWindows64\", \"dstDir\": \"${rawDestination}\"}], \"isPackage\": false, \"isCleanDstFolder\": false}]}"
          ]
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:ShanghaiWindy.Editor.Utility_BuildPipline/BuildPiplineManifest",
          "args": [
            "${manifest}"
          ]
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:System.IO.File/Exists",
          "args": [
            "${expectedArchive}"
          ]
        },
        "expect": {
          "contains": "(Boolean) True"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:Frontend.Editor.ModPackageWorkshopMeta/WriteSidecar",
          "args": [
            "${expectedArchive}"
          ]
        },
        "expect": {
          "contains": ".modpack.json"
        },
        "capture": {
          "sidecarPath": {
            "regex": "\\(String\\) (.+)"
          }
        },
        "phase": "build"
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:System.IO.File/ReadAllText",
          "args": [
            "${sidecarPath}"
          ]
        },
        "expect": {
          "contains": "${packageGuid}"
        },
        "phase": "build"
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:System.IO.Path/GetFullPath",
          "args": [
            "${expectedArchive}"
          ]
        },
        "expect": {
          "contains": ".modpack"
        },
        "capture": {
          "archivePath": {
            "regex": "\\(String\\) (.+)"
          }
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:ShanghaiWindy.Core.AssetBundleManager/LuaEnv/DoString",
          "args": [
            "local io = CS.System.IO\nassert(io.Directory.GetFiles('${rawDestination}', '*.usersight', io.SearchOption.AllDirectories).Length == 1)\nassert(io.Directory.GetFiles('${rawDestination}', '*.modpack', io.SearchOption.AllDirectories).Length == 0)\nassert(not io.Directory.Exists('${otherPlatformDestination}'))\nreturn 'Windows archive and raw output used their matching target; Android was skipped'\n",
            "docs-build-raw",
            "null"
          ]
        },
        "expect": {
          "contains": "Android was skipped"
        }
      }
    ]
    

    在命令行运行

    旧版 DoBuildPiplineManifest -config 入口已变更。使用一个无参数的静态 Editor 方法作为 Unity 的 -executeMethod 入口,在方法内读取清单位置并调用 BuildPiplineManifest(path)。命令行传入 Unity 安装路径、项目根目录、目标平台、入口方法与日志路径。Windows 可在 PowerShell 或 Git Bash 运行。完整命令见 Jenkins 自建构建。

    In this article
    Back to top Panzer War Document