ProfilingManager Classe

Definizione

[Android.Runtime.Register("android/os/ProfilingManager", ApiSince=35, DoNotGenerateAcw=true)]
public sealed class ProfilingManager : Java.Lang.Object

[<Android.Runtime.Register("android/os/ProfilingManager", ApiSince=35, DoNotGenerateAcw=true)>]
type ProfilingManager = class
    inherit Object

Ereditarietà

Object

JavaObject

Object

ProfilingManager

Attributi

RegisterAttribute

Commenti

Questa classe consente al chiamante di: <ul><li>Request profiling e ascolto dei risultati. I tipi di profilatura supportati sono: tracce di sistema, dump dell'heap Java, profili heap e analisi dello stack.</li li Register triggers for the system to capture profiling on the apps behalf./li><>Register triggers for the system to capture profiling on the apps behalf.</li></ul>

L'API #requestProfiling può essere usata per iniziare la profilatura. La profilatura può essere terminata manualmente usando CancellationSignal fornito nella richiesta o a seguito di un timeout. Il timeout può essere l'impostazione predefinita del sistema o il chiamante definito nel bundle di parametri per i tipi di selezione.

I risultati della profilatura vengono recapitati alla directory dei dati dell'app richiedente e un puntatore al file verrà ricevuto usando i listener forniti dall'app.

Le app possono fornire listener in uno o entrambi i modi: <ul><li>Un listener specifico della richiesta incluso nella richiesta. Verrà attivato solo con un risultato della richiesta con cui è stato fornito.</li><li>Un listener globale fornito da #registerForAllProfilingResults. Verrà attivato per tutti i risultati appartenenti all'app. Questo listener è l'unico modo per ricevere i risultati dalle istanze di profilatura attivate dal sistema configurate con #addProfilingTriggers.</li></ul>

Le richieste sono limitate e non è garantito che vengano riempite. La limitazione della frequenza può essere disabilitata per i test locali dell'uso #requestProfiling del comando shell device_config put profiling_testing rate_limiter.disabled true

Per i test locali, è possibile accedere più facilmente ai risultati della profilatura abilitando la modalità di debug. In questo modo i file di output verranno mantenuti in una directory di sistema temporanea. I percorsi dei file conservati saranno disponibili in logcat. Il comportamento e il comando variano in base alla versione: <ul><li>Per Android versioni 16 e successive, la modalità di debug manterrà sia la modalità non crittografata (se applicabile) che i risultati elaborati nella directory temporanea. Può essere abilitato con il comando device_config put profiling_testing delete_temporary_results.disabled true shell e disabilitato impostando lo stesso valore su false. I risultati conservati sono accessibili in tutti i tipi di compilazione. </li><li>Per Android versione 15, la modalità di debug manterrà solo il risultato non risolto (se applicabile) nella directory temporanea. Può essere abilitato con il comando device_config put profiling_testing delete_unredacted_trace.disabled true shell e disabilitato impostando lo stesso valore su false. È possibile accedere al file non crittografato conservato solo nelle compilazioni con accesso radice. Per accedere al file di output redatto in un dispositivo non radice, le app possono copiare il file da /pkg/files/profiling/file.type a /pkg/cache/file.type. </li></ul>

Per testare i trigger di profilatura, abilitare la modalità di test per l'app con il comando device_config put profiling_testing system_triggered_profiling.testing_package_name com.your.app shell che: <ul><li>Assicurarsi che sia in esecuzione una traccia in background.</li><li>Consenti a tutti i trigger per il nome del pacchetto specificato di passare il limite di frequenza del livello di sistema. Questa modalità continuerà fino a quando non viene interrotta manualmente con il comando device_config delete profiling_testing system_triggered_profiling.testing_package_nameshell . </li></ul>

I risultati vengono elaborati e contengono informazioni specifiche solo sul processo di richiesta.

Nota: per una guida dettagliata sull'uso di questa API, vedere Acquisire i dati utente reali usando ProfilingManager , che illustra l'acquisizione della profilatura attraverso l'interpretazione dei risultati.

per android.os.ProfilingManager.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.