游戏引擎 / 系统课时

真机开发构建连接 Profiler

真机开发构建连接 Profiler

在 Unity 6 中,编辑器 Play 模式的帧耗时不能替代目标设备上的真实开销。本课以 Android 手机为例,完成开发构建、Player 自动回连 Profiler、帧数据核验与采样保存,得到一份可以重复对照的性能基线。

学习目标

  • 在 Build Profiles 中启用 Development Build 和 Autoconnect Profiler。
  • 在 Profiler 中确认采样来自设备 Player,而非 Editor。
  • 留存可复查的采样文件,并按顺序排查连接失败。

准备工程与目标设备

以下路径适用于 Unity 6.0~6.3(6000.0~6000.3)。在 Unity Hub 的 Installs 中为对应编辑器安装 Android Build Support、Android SDK & NDK Tools 和 OpenJDK。手机开启开发者选项与 USB 调试,插线后允许该电脑调试;使用无线采样时让手机与编辑器电脑处于可互通的局域网。

打开 File > Build Profiles,选择 Android 目标并切换到该平台。检查 Scene List:至少有一个已启用的起始场景,确保运行后能到达待测区域。记录设备型号、系统版本、分辨率、画质档位与目标帧率。例如目标 60 FPS 时,每帧预算约 16.67 ms;这只是验收阈值,不是预期测量值。

启用开发构建并运行 Player

  1. 在 File > Build Profiles 选中 Android 构建配置。
  2. 勾选 Development Build,再勾选此后可用的 Autoconnect Profiler。
  3. 保持 Deep Profiling Support 关闭,以免全面方法插桩显著改变耗时;Script Debugging 也无需为普通采样开启。
  4. 单击 Build and Run(部分界面显示 Build & Run),选择构建输出位置,将应用安装并启动到手机。

自动连接并不是手机主动寻找任意 Profiler。Unity 会在构建时把编辑器的连接地址写进 Player,Player 启动后尝试连接到该编辑器;换网络或更换电脑后,应重新构建或改用手动连接。

Android 开发构建设置与真机 Profiler 目标选择

选择正确数据源并录制

  1. 在编辑器打开 Window > Analysis > Profiler,查看顶部 Target Selection(旧布局可能称 Attach to Player)。目标应为正在运行的 Android Player,不能是 Play Mode 或 Edit Mode。
  2. 确认 Record 圆点处于启用状态。先让场景静置约 10 秒,再执行 10 秒移动和 10 秒固定战斗动作;没有战斗系统时,改为项目中可重复的高负载操作。
  3. 观察 CPU Usage 图表是否随设备操作连续加入新帧,再切换 Memory 检查内存趋势。选中某个 CPU 峰值帧,使用 Timeline 或 Hierarchy 查看对应采样。只有图表在更新、数据源名称正确,才算连接验收通过。

用脚本核对设备采样

为了区分真正的开发版 Player 与编辑器采样,可以在项目中创建 Assets/Scripts/ProfilerConnectionProbe.cs,将脚本挂到起始场景的一个激活 GameObject 上,然后重新 Build and Run。这个最小探针只读取帧编号,不修改角色或物理状态。

csharp
using Unity.Profiling;
using UnityEngine;

public sealed class ProfilerConnectionProbe : MonoBehaviour
{
    private static readonly ProfilerMarker Marker =
        new ProfilerMarker("ProfilerConnectionProbe.Update");

    private void Start()
    {
#if DEVELOPMENT_BUILD
        // 仅在开发版 Player 记录启动确认。
        if (!Application.isEditor)
            Debug.Log("ProfilerConnectionProbe: development player running");
#endif
    }

    private void Update()
    {
        using (Marker.Auto())
        {
            // 只读帧编号,用自定义标记验证逐帧采样链路。
            _ = Time.frameCount;
        }
    }
}

预期输出(设备端 Unity 日志中包含):

text
ProfilerConnectionProbe: development player running

同时,在 Player 数据源的 CPU Usage > Hierarchy 中展开脚本更新相关节点,应能找到 ProfilerConnectionProbe.Update 标记。日志出现只能证明开发构建已启动;只有这个标记随真机帧一起出现,才能证明当前 Profiler 收到了该 Player 的采样。

保存基线与处理连接失败

停止录制后,单击 Profiler 工具栏的 Save 图标,保存 .data 采样。Unity 6 默认将其列在项目的 ProfilerCaptures 中,存储路径可在 Profiler Preferences 修改。给文件附上设备型号、构建版本、采样日期和操作路线,例如 android-baseline-01.data;以后对比优化前后数据时,应使用同样的画质和动作。

如果没有帧数据,按顺序检查:Player 是否仍在运行、构建是否勾选 Development Build、Profiler 目标是否误选 Editor、Record 是否关闭。无线发现失败时,检查手机与电脑是否在同一子网、路由器隔离和防火墙;Android 还可使用 USB/ADB 方式连接。若启用自动连接后电脑 IP 已变化,应重新构建。开发版与采样本身会引入额外开销,最终帧率仍需用相同设备上的非开发构建复核。

官方参考:Unity 6 目标设备采样说明。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

真机开发构建连接 Profiler

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通