构建发布面板详解

若已经构建过某一平台，则打开 构建发布 面板会进入 构建任务 页面。v3.0 各个平台的构建是以构建任务的形式进行，类似于下载任务：

在 构建发布 面板选择需要构建的平台，然后配置 。配置完成后，点击右下角的 构建 按钮即可跳转到 构建任务 页面执行构建流程。或者点击右上角的 关闭（X） 按钮也可以进入 构建任务 页面。

构建发布 面板上方有三个功能按钮：

• ：点击该按钮即可跳转到当前平台的官方手册文档。

• Import：点击该按钮即可导入保存了构建选项配置的 json 文件。

构建任务页面

在 构建任务 页面可以查看当前平台的构建进度及构建结果。

• 正在构建中：进度条显示为 蓝色。
• 构建成功：进度条到达 100%，输出实际构建时间并显示为 绿色。
• 构建失败：进度条到达 100%，提示构建失败原因或者报错信息，并显示为 红色。

• 新建构建任务：点击该按钮即可返回 构建发布 面板，选择新的平台进行构建。

• ：打开构建调试工具，点击该按钮即可打开构建调试工具，查看在构建过程中产生的全部日志信息包括调用栈。

• ：清空构建缓存。为了复用可被重复利用的构建结果，以便重新构建时加快构建速度、降低内存占用等，构建过程中的很多处理都添加了缓存管理机制，例如压缩纹理、自动图集生成、引擎编译、资源序列化 JSON 等。
  正常情况下这部分缓存数据是不需要手动清理的，但如果是在特殊情况下需要避免缓存干扰，可以点击该按钮来清空缓存数据。

  项目相关的资源缓存会存储在项目目录下，引擎编译相关的缓存则存储在全局目录下，开发者可根据自己的需要选择清空项目缓存、全局缓存，或者全部清空。

  

各个平台的构建是以构建任务的形式进行，类似于下载任务。平台构建任务的名称取决于 构建发布 面板中的 发布路径 选项，具体可查看 构建选项 文档。

每个构建任务都配置了相应的功能按钮方便使用。

构建任务右上方的移除（X）按钮 用于移除当前构建任务，可选择 仅移除构建记录 或者 删除源文件。删除源文件 即删除对应平台构建后生成在 目录下的项目发布包。

构建任务左下方的按钮包括：

• ：点击该按钮即可返回 构建发布 面板，修改对应平台上一次构建时配置的构建选项，然后点击右下方的 构建 按钮重新构建。详情请参考下方 修改构建选项 部分的内容。

• ：点击该按钮即可返回 构建发布 面板，查看对应平台上次构建时配置的构建选项。

• ：点击该按钮即可打开对应平台在构建过程中产生的日志文件或者日志文件所在目录，可通过 偏好设置 -> 构建发布 -> 日志文件打开方式 进行设置。更多内容请参考下方 构建日志信息查看 部分的内容。

构建任务右下方的按钮，主要用于各个平台在构建完成后根据平台要求执行生成、运行、上传等发布流程。Build 按钮则是用于重新构建。

各个平台具体的发布流程，可参考：

• 发布到小游戏平台

点击构建任务左下方的编辑按钮，即可返回 构建发布 面板修改上次构建时配置的构建选项，以便重新构建。因为只能修改当前平台上一次构建时的构建选项配置，所以页面中的 发布平台 项为置灰状态，不可修改。

当前平台上一次构建时的构建选项配置可点击编辑按钮右侧的 按钮查看。

修改完成后点击 构建 按钮就会清空上次构建后生成的项目发布包并重新构建。或者点击 构建发布 面板右上方的 X 按钮返回 构建任务 页面，再点击平台构建任务右下方的 构建 按钮也可以重新构建。

注意：

1. 原生平台为了避免误删除已定制的内容，在重新构建时仅更新项目资源，不会覆盖原有的原生工程内容。因此在返回 构建发布 面板修改之前配置的构建选项时，原生平台相关的构建选项为 禁用 状态。如果需要重新生成工程请新建构建任务。
2. 从 v3.3 开始，原生平台在重新构建时，构建选项 游戏名称 为置灰状态，不可修改。

如果修改配置后没有点击 构建 按钮重新构建，修改的配置也会被保存起来。若当前 构建发布 面板中的配置与上次构建后生成的 目录下的项目发布包中的配置不一致，构建发布 面板的上方会显示黄色的 * 号键。

由于构建过程会产生非常多的日志信息，默认情况下只有错误信息才会打印到编辑器的 控制台 面板中。

如果需要查看所有的日志信息有以下几种操作方式：

• 打开构建调试工具

  通过点击主菜单中的 开发者 -> 打开构建调试工具 或者点击 构建任务 页面右上方的 按钮，即可查看在构建过程中打印出的全部日志信息包括调用栈。

构建过程中依旧可以添加新的构建任务，此时新的构建任务会加入到构建队列中。 在构建的过程中，可以点击构建任务右侧的 X 按钮来中断当前的构建任务。