2026'dan itibaren, ana kararlı geliştirme modelimizle uyumlu olmak ve ekosistem için platform kararlılığını sağlamak amacıyla kaynak kodunu 2. ve 4. çeyreklerde AOSP'de yayınlayacağız. AOSP'yi oluşturmak ve AOSP'ye katkıda bulunmak için android-latest-release kullanın. android-latest-release manifest dalı her zaman AOSP'ye gönderilen en son sürümü referans alır. Daha fazla bilgi için AOSP'de yapılan değişiklikler başlıklı makaleyi inceleyin.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

IMetricCollector

public interface IMetricCollector
implements IDisableable, ILogSaverListener

com.android.tradefed.device.metric.IMetricCollector

Bilinen dolaylı alt sınıflar

AtraceCollector, AtraceRunMetricCollector, BaseDeviceMetricCollector, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector, CountTestCasesCollector, DebugHostLogOnFailureCollector, DeviceTraceCollector, FilePullerDeviceMetricCollector, FilePullerLogCollector ve diğer 16 toplayıcı.

AtraceCollector	Bir test sırasında izleme çalıştıran ve sonucu toplayıp günlük olarak çağırmaya kaydeden `IMetricCollector`.
AtraceRunMetricCollector	Belirtilen dizin altındaki tüm test dizinlerinden test cihazından izlemeleri toplar, test dizinini günlüğe kaydeder ve test dizini altındaki izleme dosyalarını işler ve metrikleri toplar.
BaseDeviceMetricCollector	`IMetricCollector`'nın temel uygulaması, `onTestRunStart(DeviceMetricData)` ve `onTestRunEnd(DeviceMetricData,Map)` üzerinde veri toplama işlemini başlatıp durdurmaya olanak tanır.
BluetoothConnectionLatencyCollector	Toplayıcı, cihazlara önceden tanımlanmış bir statsd süresi metriği yapılandırması gönderir ve her profil için Bluetooth bağlantı süresini toplar.
BluetoothConnectionStateCollector	Bu toplayıcı, BluetoothConnectionStateChanged metriklerini toplar ve her profil için bağlantı durumu numarasını kaydeder.
BluetoothHciSnoopLogCollector	DUT'ta Bluetooth HCI araştırma günlüğü kaydını etkinleştirmek ve her test için günlüğü toplamak üzere kullanılan toplayıcı.
BugreportzOnFailureCollector	Bir test durumu başarısız olduğunda bugreportz toplayın.
BugreportzOnTestCaseFailureCollector	Bir çalıştırmadaki test durumu başarısız olduğunda bugreportz toplayın.
ClangCodeCoverageCollector	Clang kapsam ölçümlerini cihazdan alıp test yapay nesneleri olarak kaydeden bir `BaseDeviceMetricCollector`.
CodeCoverageCollector	Java ve yerel kapsam ölçümlerini cihazdan alıp test yapay ürünleri olarak kaydeden bir `BaseDeviceMetricCollector`.
CountTestCasesCollector	Belirli bir `IRemoteTest` için test senaryolarının sayısını sayar ve raporlar.
DebugHostLogOnFailureCollector	Bir test durumu hatası oluştuğunda ana makine tarafı günlüklerini toplayıp günlüğe kaydeden toplayıcı.
DeviceTraceCollector	Bir test çalıştırması başladığında perfetto izini başlatacak ve sonunda izleme dosyasını kaydedecek toplayıcı.
FilePullerDeviceMetricCollector	Cihazdan gelen metrik anahtarını dinleyen ve bunları cihazdan dosya olarak çeken bir `BaseDeviceMetricCollector`.
FilePullerLogCollector	Cihaz tarafında bildirilen dosyanın kaydedicisi.
GcovCodeCoverageCollector	Cihazdan gcov kapsam ölçümlerini alıp bunları test yapıtları olarak kaydeden bir `BaseDeviceMetricCollector`.
GcovKernelCodeCoverageCollector	Gcov çekirdek kapsamı ölçümlerini debugfs'den ve cihazdan çıkarıp test yapıları olarak kaydeden bir `BaseDeviceMetricCollector`.
HostStatsdMetricCollector	statsd yardımcı programı komutlarını kullanarak ana makine tarafındaki statsd metriklerini toplayan bir `IMetricCollector`.
JavaCodeCoverageCollector	Cihazdaki Java kapsamı ölçümlerini alıp bunları test yapıtları olarak kaydeden bir `BaseDeviceMetricCollector`.
LogcatOnFailureCollector	Bir test durumu veya test çalıştırması başarısız olduğunda logcat'i yakalayıp günlüğe kaydeden toplayıcı.
LogcatTimingMetricCollector	Bir etkinliğin başlangıç ve bitiş sinyallerini logcat satırlarından ayrıştırmak için verilen normal ifade kalıplarını kullanarak bir veya birden çok tekrarlanan test sırasında logcat'ten zamanlama bilgilerini (ör. kullanıcı geçiş süresi) toplayan bir metrik toplayıcı.
ModuleLogcatCollector	Logcat toplayıcının modül için olan sürümü.
ModulePerfettoCollector	Bir test modülü başladığında ve sona erdiğinde ve cihaz yeniden başlatıldığında perfetto izlemeyi başlatacak toplayıcı.
PerfettoFilePullerCollector	Cihazdan Perfecto izleme dosyalarını çeken, isteğe bağlı olarak sıkıştıran ve test günlüklerine ekleyen bir toplayıcı.
PerfettoPullerMetricCollector	Bu sınıf kullanımdan kaldırılmıştır. Bunun yerine `PerfettoFilePullerCollector` ve `ERROR(/PerfettoTracePostProcessor)` özelliklerini kullanın.
RebootReasonCollector	Test çalıştırması sırasında cihazın yeniden başlatılmasını toplayan ve bunları nedene ve sayıya göre raporlayan toplayıcı.
RuntimeRestartCollector	Test çalıştırması sırasında çalışma zamanı yeniden başlatmalarının (sistem sunucusu kilitlenmeleri) zaman damgalarını toplayan toplayıcı (varsa).
ScreenRecordOnFailureCollector	Bir test durumu başarısız olduğunda ekran kaydını yakalayıp günlüğe kaydeden toplayıcı.
ScreenshotOnFailureCollector	Bir test durumu başarısız olduğunda ekran görüntüsü alıp günlüğe kaydeden toplayıcı.
ShowmapPullerMetricCollector	`FilePullerDeviceMetricCollector`'ın temel uygulaması, showmap dosyalarının cihazdan çekilmesine ve metriklerin toplanmasına olanak tanır.
TraceCmdCollector	Test sırasında trace-cmd kullanarak izleri toplayan ve bunları çağrıya kaydeden bir `IMetricCollector`.

Bu arayüz, eşleşen metrikleri toplamak için test sonuçları raporlanırken dekoratör olarak eklenir.

Bu arayüz, ITestInvocationListener uzatılsa bile olarak kullanılamaz. Yapılandırma kontrolü bunu reddeder. "metrics_collector" olarak kullanılmalıdır.

Toplayıcıların, çeşitli yerlerde yeniden kullanılabilecekleri için dahili bir durumu korumaları beklenmez. Dahili bir durumun gerçekten kullanılması gerekiyorsa init(IInvocationContext,ITestInvocationListener) üzerinde temizlenmelidir.

Özet

Herkese açık yöntemler
`default boolean`	`captureModuleLevel()` Toplayıcının modül düzeyinde yakalama için geçerli olup olmadığı ve başlatılıp başlatılmayacağı.
`default boolean`	`doesModuleContainFailure()` Mevcut modülde herhangi bir test durumu veya test çalıştırma hatası varsa true değerini döndürür.
`default void`	`enableDefaultMetricCollection()` Toplayıcıların varsayılan metrik toplama özelliğini etkinleştirmesine izin verir.
`default IMetricCollector.MetricCollectionLevel`	`getAlwaysOnCollectionLevel()`
`abstract List<IBuildInfo>`	`getBuildInfos()` Çağrıda bulunan derleme bilgilerinin listesini döndürür.
`abstract List<ITestDevice>`	`getDevices()` Çağırmada kullanılabilen cihazların listesini döndürür.
`abstract ITestInvocationListener`	`getInvocationListener()` Sonuçları yönlendirdiğimiz orijinal `ITestInvocationListener` değerini döndürür.
`default IMetricCollector.MetricCollectionLevel`	`getOnFailureCollectionLevel()`
`abstract ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Toplayıcının mevcut bağlamla başlatılması ve sonuçların nereye yönlendirileceği.
`default boolean`	`isDefaultMetricCollectionEnabled()` Toplayıcının, varsayılan metrik toplama kapsamında metrik toplayıp toplamadığı.
`abstract void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` Bir test durumu, varsayım hatasıyla başarısız olduğunda geri çağırma.
`abstract void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, TestDescription test)` Bir test durumu sona erdiğinde geri çağırma.
`abstract void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)` Bir test durumu sona erdiğinde geri çağırma.
`abstract void`	`onTestFail(DeviceMetricData testData, TestDescription test)` Bir test durumu başarısız olduğunda geri arama.
`default void`	`onTestModuleEnded()` Modülün sona erdiği etkinliğinin yakalanmasına izin verir.
`default void`	`onTestModuleStarted()` Modül başlatıldı etkinliğinin yakalanmasına izin verir.
`abstract void`	`onTestRunEnd(DeviceMetricData runData, Map<String, MetricMeasurement.Metric> currentRunMetrics)` Test çalıştırması sona erdiğinde geri arama.
`abstract void`	`onTestRunStart(DeviceMetricData runData)` Test çalıştırması başlatıldığında geri arama.
`default void`	`onTestRunStart(DeviceMetricData runData, int testCount)` Test çalıştırması başlatıldığında geri arama.
`default void`	`onTestRunStartBlocking()` Destekliyorsa bir toplayıcıyı manuel olarak başlatmak için açık geri çağırma.
`abstract void`	`onTestStart(DeviceMetricData testData)` Bir test durumu başlatıldığında geri arama.
`default void`	`setAlwaysOnCollectionLevel(IMetricCollector.MetricCollectionLevel level)` Toplayıcının hatalardan bağımsız olarak günlükleri toplaması gereken düzeyi ayarlar.
`default void`	`setModuleContainsFailure()` Modülde herhangi bir hata (test durumu, test çalıştırması) olup olmadığını ayarlar.
`default void`	`setOnFailureCollectionLevel(IMetricCollector.MetricCollectionLevel level)` Toplayıcının hatalar sırasında günlükleri toplaması gereken düzeyi ayarlar.

Herkese açık yöntemler

captureModuleLevel

public boolean captureModuleLevel ()

Toplayıcının modül düzeyinde yakalama için geçerli olup olmadığı ve başlatılıp başlatılmayacağı.

İadeler
`boolean`

doesModuleContainFailure

public boolean doesModuleContainFailure ()

Mevcut modülde herhangi bir test durumu veya test çalıştırma hatası varsa true değerini döndürür.

İadeler
`boolean`

enableDefaultMetricCollection

public void enableDefaultMetricCollection ()

Toplayıcıların varsayılan metrik toplama özelliğini etkinleştirmesine izin verir. Varsayılan metrik toplama etkinleştirildiğinde toplayıcı yalnızca belirtilen toplama düzeyinde toplama yapmalıdır.

getAlwaysOnCollectionLevel

public IMetricCollector.MetricCollectionLevel getAlwaysOnCollectionLevel ()

İadeler
`IMetricCollector.MetricCollectionLevel`

getBuildInfos

public abstract List<IBuildInfo> getBuildInfos ()

Çağrıda bulunan derleme bilgilerinin listesini döndürür.

İadeler
`List<IBuildInfo>`

getDevices

public abstract List<ITestDevice> getDevices ()

Çağırmada kullanılabilen cihazların listesini döndürür.

İadeler
`List<ITestDevice>`

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

Sonuçları yönlendirdiğimiz orijinal ITestInvocationListener değerini döndürür.

İadeler
`ITestInvocationListener`

getOnFailureCollectionLevel

public IMetricCollector.MetricCollectionLevel getOnFailureCollectionLevel ()

İadeler
`IMetricCollector.MetricCollectionLevel`

init

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Toplayıcının mevcut bağlamla başlatılması ve sonuçların nereye yönlendirileceği. Will only be called once per instance, and the collector is expected to update its internal context and listener. Init, test çalıştırması sırasında asla çağrılmaz, her zaman önce çağrılır.

Ne yaptığınızı bilmiyorsanız geçersiz kılmayın.

Parametreler
`context`	`IInvocationContext`: Devam eden çağırma işlemi için `IInvocationContext`.
`listener`	`ITestInvocationListener`: sonuçların yerleştirileceği `ITestInvocationListener`.

İadeler
`ITestInvocationListener`	Yeni dinleyici, orijinal dinleyicinin yerini alır.

Verdiği hatalar
`DeviceNotAvailableException`

isDefaultMetricCollectionEnabled

public boolean isDefaultMetricCollectionEnabled ()

Toplayıcının, varsayılan metrik toplama kapsamında metrik toplayıp toplamadığı.

İadeler
`boolean`

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Bir test durumu, varsayım hatasıyla başarısız olduğunda geri çağırma.

Parametreler
`testData`	`DeviceMetricData`: Test senaryosunun verilerini tutan `DeviceMetricData`.
`test`	`TestDescription`: Devam eden test durumunun `TestDescription`.

Verdiği hatalar
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, 
                TestDescription test)

Bir test durumu sona erdiğinde geri çağırma. Bu, temizleme zamanı olmalıdır.

Parametreler
`testData`	`DeviceMetricData`: Test senaryosunun verilerini tutan `DeviceMetricData`. `onTestStart(DeviceMetricData)` sırasındakiyle aynı nesne olacaktır.
`currentTestCaseMetrics`	`Map`: `testEnded(TestDescription,Map)`'ye iletilen metriklerin mevcut haritası.
`test`	`TestDescription`: Devam eden test durumunun `TestDescription`.

Verdiği hatalar
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)

Bir test durumu sona erdiğinde geri çağırma. Bu, temizleme zamanı olmalıdır.

Parametreler
`testData`	`DeviceMetricData`: Test senaryosunun verilerini tutan `DeviceMetricData`. `onTestStart(DeviceMetricData)` sırasındakiyle aynı nesne olacaktır.
`currentTestCaseMetrics`	`Map`: `testEnded(TestDescription,Map)`'ye iletilen metriklerin mevcut haritası.

Verdiği hatalar
`DeviceNotAvailableException`

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Bir test durumu başarısız olduğunda geri arama.

Parametreler
`testData`	`DeviceMetricData`: Test senaryosunun verilerini tutan `DeviceMetricData`.
`test`	`TestDescription`: Devam eden test durumunun `TestDescription`.

Verdiği hatalar
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

Modülün sona erdiği etkinliğinin yakalanmasına izin verir.

Verdiği hatalar
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

Modül başlatıldı etkinliğinin yakalanmasına izin verir.

Verdiği hatalar
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                Map<String, MetricMeasurement.Metric> currentRunMetrics)

Test çalıştırması sona erdiğinde geri arama. Bu, temizleme zamanı olmalıdır.

Parametreler
`runData`	`DeviceMetricData`: Çalıştırma için verileri tutan `DeviceMetricData`. `onTestRunStart(DeviceMetricData)` sırasındakiyle aynı nesne olacaktır.
`currentRunMetrics`	`Map`: `testRunEnded(long,Map)`'ye iletilen metriklerin mevcut haritası.

Verdiği hatalar
`DeviceNotAvailableException`

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

Test çalıştırması başlatıldığında geri arama.

Parametreler
`runData`	`DeviceMetricData`: Çalıştırma için verileri tutan `DeviceMetricData`.

Verdiği hatalar
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData, 
                int testCount)

Test çalıştırması başlatıldığında geri arama.

Parametreler
`runData`	`DeviceMetricData`: Çalıştırma için verileri tutan `DeviceMetricData`.
`testCount`	`int`: Bu test çalıştırmasındaki test senaryosu sayısı.

Verdiği hatalar
`DeviceNotAvailableException`

onTestRunStartBlocking

public void onTestRunStartBlocking ()

Destekliyorsa bir toplayıcıyı manuel olarak başlatmak için açık geri çağırma. Bu sayede, eşzamansız olan bazı test yaşam döngülerinin dışında kalmamız sağlanır.

Verdiği hatalar
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

Bir test durumu başlatıldığında geri arama.

Parametreler
`testData`	`DeviceMetricData`: Test senaryosunun verilerini tutan `DeviceMetricData`.

Verdiği hatalar
`DeviceNotAvailableException`

setAlwaysOnCollectionLevel

public void setAlwaysOnCollectionLevel (IMetricCollector.MetricCollectionLevel level)

Toplayıcının hatalardan bağımsız olarak günlükleri toplaması gereken düzeyi ayarlar.

NULL seviyesi, koleksiyonun olmamasıyla sonuçlanır.

Parametreler
`level`	`IMetricCollector.MetricCollectionLevel`: Günlüklerin toplanacağı `MetricCollectionLevel`.

setModuleContainsFailure

public void setModuleContainsFailure ()

Modülde herhangi bir hata (test durumu, test çalıştırması) olup olmadığını ayarlar.

setOnFailureCollectionLevel

public void setOnFailureCollectionLevel (IMetricCollector.MetricCollectionLevel level)

Toplayıcının hatalar sırasında günlükleri toplaması gereken düzeyi ayarlar.

NULL seviyesi, koleksiyonun olmamasıyla sonuçlanır.

Parametreler
`level`	`IMetricCollector.MetricCollectionLevel`: Günlüklerin toplanacağı `MetricCollectionLevel`.