持续构建模组
中文 | 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"
}
]
}
官方模组仓库
- 在模组仓库的 GitHub Actions 中打开 Build modpack。填写受影响的
packs与目标platform。 - 验收构建时设置
publish=none,留空release。工作流会裁剪依赖、拉取相应的 LFS、构建并验证。 - 从该次运行的 Artifacts 下载
.modpack与同名.modpack.json,核对平台、GUID 和版本。
SDK 工程中的本地构建清单
- 在 ModPackageBuildPiplineData 中引用 ModPackageData 和要打包的资源。
- 在 JSON 的
infos新增一项。把要一起构建的管线加到modNames。直接位于Assets/ModManager的资产可以只填名称。位于子目录时写从工程根开始的完整资产路径,包括.asset后缀。 - 将每个平台的输出加到
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
}
]
}
- 从编辑器入口调用
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 自建构建。