导出产物总览
本页解决什么问题:带你看懂发布面板里的 7 个目标、导出声明、一键导出、产物下载和不同失败该怎么处理。
打开导出面板
- 打开一个已有项目的陶泥儿对话。
- 点击聊天顶栏右侧的 发布。
- 打开全屏 导出产物面板。
陶泥儿回合正在执行时,发布 按钮会禁用。导出会读写项目文件,与正在进行的文件修改并发容易互相覆盖,先等当前回合结束。
备注
没有项目时不会显示发布入口。切换项目会关闭导出面板,避免把上一个项目的表单和产物带到新项目。
7 个目标卡片
首屏按固定顺序显示:
| 目标 | 产物或用途 | 宿主是否负责上传 |
|---|---|---|
| 陶泥儿 | 打包并提交到游戏广场,进入审核 | 由客户端发布链路提交 |
| Windows 桌面 | Windows 桌面包,通常是 ZIP | 否,用户自行分发 |
| Android | Android 安装包 APK | 否,用户自行安装或上架 |
| 单网页 | 单个 index.html | 否,用户自行托管或分发 |
| 小红书小工具 | 小工具代码包 | 否,用户自行到平台上传 |
| TapTap H5 小游戏 | H5 小游戏包 | 可让陶泥儿协助上传,或用户自行上传 |
| B站 Toy | Toy 包 | 可让陶泥儿协助上传,或用户自行上传 |
点击任一卡片进入该目标的工作台。进入后,顶部会把它收成一排目标页签,可从页签切换,也可点 概览 回到首屏。
导出声明开关
每张目标卡下方有一个 导出声明 开关:
- 开关表示这个目标是否属于本次项目对外交付的平台范围。
- 缺失声明文件时,所有目标默认开启。
- 关闭声明不会隐藏卡片,也不会禁止你单独进入该目标打包。
- 声明主要影响首屏的 导出全部:一键导出只处理已开启目标。
- 声明写入失败时,面板会提示;不要把界面上的开关状态当成已经成功保存。
注意
声明开关不是“平台已适配”证明。目标是否真的能打包,仍然要在工作台里点一次打包,由项目自己的构建脚本和产物检查决定。
一键导出
首屏下方的 导出全部 会按卡片顺序串行处理所有已开启目标。
- 确认需要交付的目标已打开声明开关。
- 点击 导出全部。
- 按钮变成 导出游戏包中...,不要重复点击。
- 每个目标完成后,卡片右上角出现结果点。
- 成功的目标会在卡片下方出现 下载包。
- 若存在失败,底部展开结果条。
一键导出的边界:
- 只调用各目标已有的构建命令,不重新读取或改写平台上传表单。
- 陶泥儿发布处于灰度确认、未命中或状态不可用时,会跳过陶泥儿,其他目标照常继续。
- 某些宿主环境错误或未知传输错误不会自动生成修复指令,结果点会保留,需要手动处理。
- 关闭面板会停止继续派发后续目标。已经完成的产物仍在项目的
.export/目录;下载按钮和本轮结果状态会随面板关闭或切换项目清空,重新打开后需要重新打包才会出现新的下载按钮。
结果条和逐个处理
结果条只在有目标未成功时出现,分两组列出:
- 还没有适配:项目缺少该目标的打包脚本或导出配置。
- 导出失败了:已有打包流程,但这次构建出错。
右侧可以:
- 关闭:收起结果条,不影响已经生成的产物。
- 选择模型:这一批修复会话共用一次模型选择。
- 逐个处理:为每个可修复目标新建一条会话,发送对应修复指令,回合结束后自动重跑构建。
修复期间会显示「正在处理 x/y」和当前目标。修复完成后,成功目标转成成功点;仍失败的目标保留失败点。
单个目标的导出流程
进入任一目标后,左侧是平台表单与产物区,右侧是与陶泥儿的导出对话。
通用步骤:
- 等待面板读取导出信息。
- 填写或确认平台字段。
- 表单会在停手后自动保存。
- 点击该目标的主按钮,例如 打包、打包小游戏、打包并发布。
- 构建成功后出现下载、打开所在文件夹或平台发布入口。
- 失败时按弹窗提示适配、修复或重新打包。
各目标的差异:
- 陶泥儿:只有 打包并发布 / 打包并更新,没有单独下载发行包。
- Windows / Android / 单网页:只生成本地产物,不替用户上传。
- 小红书小工具:生成代码包后,用户可复制名称与介绍、下载图标、前往平台发布。
- TapTap H5:生成小游戏包后,可让陶泥儿协助上传,或手动前往 TapTap 发布。
- B站 Toy:生成 Toy 包后,可让陶泥儿协助上传 / 更新,或手动前往 B站 发布。
产物下载
构建成功后,面板只提供真实存在的产物入口:
- 下载包 / 下载代码包 / 下载小游戏包 / 下载 Toy 包:打开系统保存对话框,把产物另存到你选择的位置。
- 打开所在文件夹:直接打开项目里的产物所在目录,适合自己复制或检查。
- 下载失败时弹窗会显示哪一份没保存下来、失败原因,并提供在文件管理器中定位原件的兜底入口。
提示
下载成功不会额外弹一个大提示。保存对话框完成后,落点就是你自己选择的位置;失败才会在面板里留下现场。
为什么会出现“还没配置好导出”
点击打包后,如果客户端发现项目没有对应的构建命令,会弹出 这个项目还没有配置好导出。
它表示项目还没有把该平台的打包流程落成项目自己的脚本,而不是“平台不支持”。
两个选择:
- 让陶泥儿帮我调通:让陶泥儿读取项目、补上打包脚本和必要配置。
- 我自己来:关闭弹窗,由你手动修改项目。
调通后再点打包。不要在没有脚本时反复点打包,它不会自己变好。
失败分类和处理
| 失败 | 含义 | 建议动作 |
|---|---|---|
| 项目结构不可用 | 客户端不知道从哪里构建 | 先运行一次预览,在运行失败面板里识别或更新项目布局 |
| 找不到打包脚本 | 项目还没有该目标的导出配置 | 使用“让陶泥儿帮我调通”或自行补脚本 |
| 构建命令失败 | 项目脚本跑完但返回失败 | 查看失败弹窗中的原因;可让陶泥儿来修,或修正后重新打包 |
| 构建超时 | 打包时间超过限制 | 先检查构建是否卡死、网络或工具链是否正常,再重试 |
| 产物不存在或无效 | 构建结束了,但没有交出正确文件 | 让陶泥儿检查脚本是否写到了约定产物位置 |
| 桌面端导出环境不可用 | 当前客户端无法执行导出 | 重新打开面板或重启客户端后重试 |
| 项目不可用 | 项目路径或状态已变化 | 回到项目列表重新打开项目 |
| 表单冲突 | 磁盘上的表单和你当前编辑的不一致 | 先处理冲突,再打包 |
| 表单字段有误 | 必填项为空、版本号格式不对等 | 按字段红字修正后再打包 |
失败弹窗如果有 让陶泥儿来修,说明问题在项目代码、构建脚本、导出配置或产物里,适合让智能体继续处理。没有这个按钮时,通常需要人工修环境或重新尝试。
宿主负责到哪里
客户端只负责:
- 读取和保存项目内的导出表单。
- 运行项目自己声明的构建命令。
- 检查产物是否存在、是否为空、是否是预期的大致格式。
- 把产物交给用户下载。
客户端不会:
- 替你安装所有第三方打包工具。
- 替你完成平台账号登录。
- 替你保证应用商店审核通过。
- 自动为所有平台生成签名。
- 承诺所有引擎都能直接导出。
上传责任按目标区分:
- 陶泥儿:客户端会提交到游戏广场并进入审核。
- 小红书:客户端只提供代码包和平台外链,用户自行登录上传。
- TapTap / B站:可能提供智能体协助上传或平台外链,最终仍需平台登录、授权和审核。
- Windows / Android / 单网页:客户端只到产物,分发和上架由你完成。
关闭面板后
- 关闭即卸载面板,表单之外的临时进度和结果点不会保留在界面上。
- 已写入项目的导出表单仍保留。
- 已生成的产物仍在项目里,可重新打开面板或到产物目录获取。
- 需要重新跑一键导出时,重新打开面板即可。
下一步:
- 发布到游戏广场,阅读 发布到陶泥儿。
- 生成 Windows、Android 或单网页,阅读 Windows、Android 与单网页。
- 先检查游戏是否能运行,阅读 运行与预览。