多平台打包
中文 | English
在仓库根目录运行以下命令,用本机 Unity MCP 回放本页示例。
python Docs/Manual/manual/tools/tutorials.py run multi-platform-build
点击展开 MCP 操作点击收起 MCP 操作
准备教学样例。${变量} 由配方提供。
{
"variables": {
"asset": "${fixture}/Tutorial_VehicleQueue.asset",
"package": "${fixture}/Docs_${runId}_Package.asset",
"pipeline": "${fixture}/Docs_${runId}_Pipeline.asset",
"packageGuid": "66dc2d51-e05e-4e6d-9afd-7cc47e11a00b"
},
"calls": [
{
"tool": "invoke",
"arguments": {
"path": "static:UnityEditor.AssetDatabase/CreateFolder",
"args": [
"${fixtureParent}",
"${folder}"
]
},
"expect": {
"regex": "\\(String\\) [a-f0-9]{32}"
}
},
{
"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"
}
]
}
为每个目标平台分别构建 .modpack。游戏需要与运行平台匹配的 AssetBundle。
前提
- 安装匹配的 Unity 版本和目标平台模块。
- 项目已加入 GameHub。若未加入,在 GameHub 中点 Add Path 指向该 Unity 工程。
- 本地
file:依赖(相邻UnityProject/Packages布局)可用,SDK 依赖与本平台构建保持一致。
创建软链接工程
- 在 GameHub 中选择要打包的目标平台。
- GameHub 为该平台创建软链接工程,点 Copy 复制该路径。
- 打开 Unity Hub,点 Add project from disk,填入第 2 步复制的路径。
- 点击版本号,把 Current Platform 改为与所创建的工程一致的平台,确认名称匹配后点 Open。
- 工程打开后,在 File → Build Settings 确认目标平台,等待导入完成。
GameHub 的链接工程共享源资源,各平台保留独立的 Library。GameHub 和 Unity Hub 步骤由读者完成,MCP 可以检查已打开工程的目标平台。
点击展开 MCP 操作点击收起 MCP 操作
样例读取当前 Windows 构建目标。按工程需要在编辑器里手动选择目标平台。
[
{
"tool": "inspect",
"arguments": {
"path": "static:UnityEditor.EditorUserBuildSettings/activeBuildTarget"
},
"expect": {
"contains": "(BuildTarget) StandaloneWindows64"
}
}
]
每个平台分别构建与校验
- 对该平台执行 BuildPipeline 的 Build Linked Objects to AssetBundle。
- 再对关联 ModPackage 执行 Package Mod Now。
- 保留生成的
.modpack和同名.modpack.json。核对包内平台、Unity 版本、资源清单与元数据,在对应平台的游戏中测试。
资源改动或平台切换后,重新执行前两个打包步骤。下方回放验证 Windows 教学包,Android 和 iOS 包需在对应环境另行验证。
点击展开 MCP 操作点击收起 MCP 操作
本机 MCP 使用 Windows 教学包,回放会校验归档、清单和 sidecar。
[
{
"tool": "invoke",
"arguments": {
"path": "static:UnityEditor.AssetDatabase/CopyAsset",
"args": [
"Packages/com.shanghaiwindy.coreresources/Editor/DocumentationSamples/preset-vehicle-queue/Tutorial_VehicleQueue.asset",
"${asset}"
]
},
"expect": {
"contains": "(Boolean) True"
},
"phase": "build"
},
{
"tool": "invoke",
"arguments": {
"path": "asset:${pipeline}/linkedObjects/Add",
"args": [
"@asset:${asset}"
]
},
"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": "modpack_plan",
"arguments": {
"pipeline": "${pipeline}"
},
"expect": {
"equals": {
"ok": true,
"built": false
},
"contains": "\"vehiclequeue\""
},
"phase": "build"
},
{
"tool": "modpack_build",
"arguments": {
"pipeline": "${pipeline}"
},
"expect": {
"equals": {
"ok": true,
"archiveExists": true,
"published": false,
"installed": false
}
},
"capture": {
"archivePath": {
"path": "archivePath"
}
},
"phase": "build"
},
{
"tool": "invoke",
"arguments": {
"path": "static:Frontend.Editor.ModPackageWorkshopMeta/WriteSidecar",
"args": [
"${archivePath}"
]
},
"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.Directory/CreateDirectory",
"args": [
"${fixture}/mods/Installs"
]
},
"expect": {
"contains": "DirectoryInfo"
},
"phase": "build"
}
]