Getting Started

Project Setup

Editor

Core Concepts

Assets and Resources

Animations

Components

GUI

Physics

Sound

Input

Game logic

Files

Working with files

Network Connections

Rendering

Workflow

Debugging

Optimization

Monetization

Android

iOS

Consoles

HTML5

Desktop

Engine extensions

← Back to Manuals

This translation is community contributed and may not be up to date. We only maintain the English version of the documentation. Read this manual in English

性能分析

Defold 包含与引擎和构建流程集成的性能分析工具，用于查找性能、内存和资源使用问题。运行时性能分析数据可由多种功能使用：

基础分析器和游戏内可视化分析器适用于所有平台。
Remotery 分析器和交互式 Web 帧分析器适用于桌面和移动平台。
HTML5 构建可将 Defold scope 发布到浏览器的 Web Performance API。

App Manifest 中的 Profiler 设置控制是否将分析器代码链接到构建中。Debug Only 是默认值，None 会排除分析器，Always 则在 Debug 和 Release 构建中都包含它。game.project 中的 profiler 设置控制运行时行为，但不会将已排除的分析器代码重新链接到构建中。尤其是 Track CPU 控制 CPU 使用率采样，它与 App Manifest 选项相互独立。

运行时可视化性能分析器

包含分析器支持的构建具有运行时可视化分析器，可将实时信息叠加显示在运行中的应用程序上：

function on_reload(self)
    -- 在热重载时切换可视化性能分析器。
    profiler.enable_ui(true)
end

Visual profiler

可视化性能分析器提供了许多不同的功能，可用于改变可视化性能分析器呈现其数据的方式：

profiler.set_ui_mode()
profiler.set_ui_view_mode()
profiler.view_recorded_frame()

有关性能分析器功能的更多信息，请参阅性能分析器 API 参考。

Web 性能分析器

运行包含分析器支持的桌面或移动构建时，可以通过浏览器访问交互式帧分析器和资源分析器。

Remotery 帧性能分析器

帧性能分析器允许您在游戏运行时对其进行采样，并详细分析各个帧。要访问性能分析器：

在目标设备上启动您的游戏。
选择 Debug ▸ Open Web Profiler 菜单。

帧性能分析器分为几个部分，都提供对运行游戏的不同视图。按右上角的暂停按钮可以暂时停止性能分析器更新视图。

Web profiler

当您同时使用多个目标时，可以通过更改页面顶部的连接地址字段以匹配目标启动时控制台中显示的 Remotery 性能分析器 URL 来手动切换它们：

INFO:ENGINE: Defold Engine 1.3.4 (80b1b73)
INFO:DLIB: Initialized Remotery (ws://127.0.0.1:17815/rmt)
INFO:ENGINE: Loading data from: build/default

采样时间轴: 采样时间轴将显示在引擎中捕获的数据帧，每个线程一个水平时间轴。Main 是运行所有游戏逻辑和大部分引擎代码的主线程。Remotery 用于性能分析器本身，Sound 用于声音混合和播放线程。您可以放大和缩小（使用鼠标滚轮）并选择单个帧以在帧数据视图中查看帧的详细信息。
帧数据: 帧数据视图是一个表格，其中当前选定帧的所有数据都被分解为详细信息。您可以查看在每个引擎作用域中花费了多少毫秒。
全局属性: 全局属性视图显示一个计数器表。它们使您可以轻松地，例如，跟踪绘制调用的数量或特定类型组件的数量。

Max Sample Count 设置限制每个线程每帧记录的分析器样本数。如果分析器报告超出限制，请先检查原生扩展的性能分析代码中是否有未配对的 scope begin/end。只有当正常帧确实包含超过配置限制的 scope 时才提高上限。

资源性能分析器

资源性能分析器允许您在游戏运行时检查它并详细分析资源使用情况。要访问性能分析器：

在目标设备上启动您的游戏。
打开浏览器并浏览到 http://localhost:8002

资源性能分析器分为 2 个部分，一个显示游戏中当前实例化的集合、游戏对象和组件的层次视图，另一个显示所有当前加载的资源。

Resource profiler

集合视图: 集合视图显示游戏中当前实例化的所有游戏对象和组件的层次列表，以及它们来自哪个集合。当您需要深入了解并了解在任何给定时间在游戏中实例化了什么以及对象来自何处时，这是一个非常有用的工具。
资源视图: 资源视图显示当前加载到内存中的所有资源、它们的大小以及对每个资源的引用数量。当您需要了解在任何给定时间加载到内存中的内容时，这对于优化应用程序中的内存使用非常有用。

HTML5 浏览器性能时间线

HTML5 的浏览器时间线使用 Web Performance API，而不是 Remotery。要记录 Defold scope：

确保所选 App Manifest 分析器模式在当前运行的构建变体中包含分析器支持。
在 game.project 中启用 Performance Timeline Enabled（profiler.performance_timeline_enabled）。
启动 HTML5 构建并打开浏览器开发者工具。
在浏览器的 Performance 面板中录制会话，然后在生成的时间线中查看 Defold scope。

此浏览器时间线与游戏内可视化分析器和交互式 Remotery Web 分析器均相互独立。