自 2025 年 3 月 27 日起,我们建议您使用 android-latest-release
而非 aosp-main
构建 AOSP 并为其做出贡献。如需了解详情,请参阅 AOSP 的变更。
处理来自结果报告程序的日志文件
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
在某些情况下,只能访问测试结果还不够,必须具有日志文件才能让总体结果变得完整。
日志接口
任何结果报告程序或测试事件均可通过实现 ILogSaverListener
来访问日志,该接口支持报告程序通过不同的回调来接收日志:
testLogSaved
:在记录了文件时立即调用。这会通知记录了新文件。随时都会调用此事件。
logAssociation
:按测试事件的顺序调用。这可确保正在记录的文件与正在进行的事件之间存在很强的关联。
通过实现此接口,结果报告程序可以访问并使用所记录文件的引用。
何时使用 logAssociation
logAssociation
是一个稍微有些复杂的事件,因为它依赖于事件的上下文才能得到正确解释。例如,如果调用了 testStart
,那么来自 logAssociation
的日志将归属于正在进行的测试用例。
利用这种强大的关联,可以正确放置日志。
本页面上的内容和代码示例受内容许可部分所述许可的限制。Java 和 OpenJDK 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-03-26。
[null,null,["最后更新时间 (UTC):2025-03-26。"],[],[],null,["# Handle log files from a result reporter\n\nIn some cases, having access to only the test results isn't enough; having\nthe log files is necessary to complete the overall results.\n\nLog interface\n-------------\n\nAny result reporter or [test event](/docs/core/tests/tradefed/architecture/result-reporter#core_interface)\ncan have access to the logs by implementing\n[`ILogSaverListener`](https://android.googlesource.com/platform/tools/tradefederation/+/refs/heads/android16-release/invocation_interfaces/com/android/tradefed/result/ILogSaverListener.java),\nwhich lets a reporter receive the logs through different callbacks:\n\n- `testLogSaved`: Called right away when a file is logged. This notifies a new file has been logged. This is called at any time.\n- `logAssociation`: Called in order with the test events. This ensures a strong association between the file being logged and the events in progress.\n\nBy implementing this interface, the result reporter can have access to the\nlogged file references and use them.\n\nWhen to use logAssociation\n--------------------------\n\n`logAssociation` is a slightly more complicated event as it relies on the\ncontext of the events to be properly interpreted. For example, if the\n`testStart` has been called, the log from `logAssociation` belongs to the test\ncase in progress.\n\nThis strong association allows for correct placement of logs."]]