目录

Windows上采集设备的Profile(Android和HarmonyOS 3.1/4.0及以下)

前提条件

清理无关profile文件

使用工具包的clear_profile.bat清理手机中已经存在的profile文件,防止正式采集profile数据后,误将无关的profile文件一起导出。clear_profile.bat命令行格式如下:
// 若未输入path_to_profile_on_the_device路径,默认清理/data/local/tmp路径下的profile文件。
clear_profile.bat [path_to_profile_on_the_device]
  • 手机确保有删除path_to_profile_on_the_device路径下文件的权限,否则会删除失败。
  • 可不输入path_to_profile_on_the_device路径,不输入则默认清理/data/local/tmp目录下的profile文件。

采集profile数据

  1. 在手机上启动游戏,且关闭其它无关应用程序的后台,确保当前仅有待采集profile数据的游戏处于运行状态中。
  2. 游戏进入待采集profile数据的场景。

    为了达到更好的优化效果,请选择合适的游戏场景进行采集数据。

  3. 将trigger工具push到手机,输入如下命令,为trigger工具添加“执行”权限。
    chmod +x  trigger
  4. 执行工具包的trigger,触发开始采集profile数据。trigger命令行的参数说明如下:
    ./trigger -s scenario name [-p trigger_port] [-f profile folder]

    触发开始采集和触发结束采集的命令相同。

    参数

    必选(M)/可选(O)

    默认值

    说明

    scenario name

    M

    default

    您自定义的场景名称,例如“fight”,默认为“default”。

    说明:

    采集多个场景时需要配置不同的场景名,否则profile文件会被覆盖。

    trigger_port

    O

    3040

    采集profile数据时用到的端口号,要与调用提交插桩任务接口的入参portStart保持一致。

    说明:

    不同的so应配置不同的端口号,否则会导致冲突,影响profile采集。

    profile folder

    O

    当前路径

    profile数据输出的路径,默认为工具当前路径。

    开始采集profile数据的命令行示例如下:

    ./trigger -s fight -p 3041

  5. 等到游戏场景结束,再次执行相同命令行触发结束采集:
    ./trigger -s fight -p 3041

    如果需要采集多个so的profile,可以针对不同so,分别配置不同端口号,多次执行trigger工具命令,支持同时触发多个so采集。

  6. 您可以采集多个游戏场景的profile数据。单个场景的profile数据完成采集后,将生成so_name.fdata.scene_name的profile文件:
    • so_name为so名称,例如libunity.so。
    • scene_name为场景名称,例如fight。

导出profile文件

待所有游戏场景的profile数据都采集后,执行工具包的export_profile.bat,将手机上的profile数据打包成profile.tar并导出至PC。命令行格式如下:
// 若不输入path_to_profile_on_the_device路径,默认将/data/local/tmp路径下的profile文件打包成profile.tar并导出至本地
export_profile.bat [path_to_profile_on_the_device]

手机确保有读取path_to_profile_on_the_device路径的权限,否则将导出失败。