自 2026 年起，为了与我们的主干稳定开发模型保持一致，并确保生态系统的平台稳定性，我们将在第 2 季度和第 4 季度向 AOSP 发布源代码。如需构建 AOSP 并为其贡献代码，请使用 android-latest-release。android-latest-release 清单分支将始终引用推送到 AOSP 的最新版本。如需了解详情，请参阅 AOSP 变更。

Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

CoverageMetadataCollector

public final class CoverageMetadataCollector
extends Object implements IConfigurationReceiver, ILogSaverListener

java.lang.Object
↳	com.google.android.tradefed.result.CoverageMetadataCollector

一个 ILogSaverListener，用于收集记录的覆盖率测量结果，并生成 CoverageMetadataProto 以供 Android 代码覆盖率服务处理。

摘要

公共构造函数
`CoverageMetadataCollector()`

公共方法
`void`	`invocationStarted(IInvocationContext context)` 报告测试调用的开始时间。
`void`	`logAssociation(String unusedDataName, LogFile logFile)` 在某些情况下，日志必须与测试用例紧密关联，但无法在直接 `testLogSaved(String,LogDataType,InputStreamSource,LogFile)` 回调中执行此操作。
`void`	`setConfiguration(IConfiguration configuration)` 注入正在使用的 `IConfiguration`。
`void`	`setLogSaver(ILogSaver logSaver)` 设置 `ILogSaver`，以便实现者可以保存文件。
`void`	`testLogSaved(String unusedDataName, LogDataType dataType, InputStreamSource unusedDataStream, LogFile logFile)` 在保存测试日志时调用。
`void`	`testModuleEnded()` 报告模块运行的结束时间。
`void`	`testModuleStarted(IInvocationContext moduleContext)` 报告模块运行的开始时间。
`void`	`testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)` 报告测试运行的结束时间。
`void`	`testRunStarted(String runName, int testCount)` 报告测试运行的开始时间。

公共构造函数

CoverageMetadataCollector

public CoverageMetadataCollector ()

公共方法

invocationStarted

public void invocationStarted (IInvocationContext context)

报告测试调用的开始时间。

将由 TradeFederation 框架自动调用。报告程序需要替换此方法，以支持多个设备报告。

参数
`context`	`IInvocationContext`：有关调用的信息

logAssociation

public void logAssociation (String unusedDataName, 
                LogFile logFile)

在某些情况下，日志必须与测试用例紧密关联，但无法在直接执行此操作。testLogSaved(String,LogDataType,InputStreamSource,LogFile)因此，此回调允许显式提供紧密关联。

参数
`unusedDataName`	`String`：数据的名称
`logFile`	`LogFile`：之前记录的 `LogFile`，应与测试用例关联。

setConfiguration

public void setConfiguration (IConfiguration configuration)

注入正在使用的 IConfiguration。

参数
`configuration`	`IConfiguration`

setLogSaver

public void setLogSaver (ILogSaver logSaver)

设置 ILogSaver，以便实现者可以保存文件。

参数
`logSaver`	`ILogSaver`：`ILogSaver`

testLogSaved

public void testLogSaved (String unusedDataName, 
                LogDataType dataType, 
                InputStreamSource unusedDataStream, 
                LogFile logFile)

在保存测试日志时调用。

应替换为 ITestInvocationListener.testLog(String,LogDataType,InputStreamSource)。

参数
`unusedDataName`	`String`：数据的 `String` 说明性名称。例如“device_logcat”。注意：dataName 在每次调用中可能不是唯一的。也就是说，实现者必须能够处理具有相同 dataName 的多次调用
`dataType`	`LogDataType`：数据的 `LogDataType`
`unusedDataStream`	`InputStreamSource`：数据的 `InputStreamSource`。实现者应调用 createInputStream 以开始读取数据，并确保在完成后关闭生成的 InputStream。
`logFile`	`LogFile`：包含已保存文件的元数据的 `LogFile`。

testModuleEnded

public void testModuleEnded ()

报告模块运行的结束时间。

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

报告模块运行的开始时间。此回调与 testModuleEnded() 相关联，并且在序列中是可选的。它仅在运行中使用模块（基于套件的运行程序）期间使用。

参数
`moduleContext`	`IInvocationContext`：模块的 `IInvocationContext`。

testRunEnded

public void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

报告测试运行的结束时间。FIXME：我们不能有两个具有不同类型的 Map<> 接口，因此我们必须在此处使用 HashMap。

参数
`elapsedTime`	`long`：设备报告的经过时间，以毫秒为单位
`runMetrics`	`HashMap`：在测试运行结束时报告的键值对，带有 `Metric`。

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

报告测试运行的开始时间。

参数
`runName`	`String`：测试运行名称
`testCount`	`int`：测试运行中的测试总数