ProfilingManager Classe

Définition

[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

Héritage

Object

JavaObject

Object

ProfilingManager

Attributs

RegisterAttribute

Remarques

Cette classe permet à l’appelant de : <ul><li>Request profilage et écouter les résultats. Les types de profilage pris en charge sont les suivants : traces système, vidages de tas Java, profils de tas et traces de pile.</li><li>Register déclenche le profilage du système pour capturer le profilage au nom des applications.</li></ul>

L’API #requestProfiling peut être utilisée pour commencer le profilage. Le profilage peut être terminé manuellement à l’aide de CancellationSignal fourni dans la demande ou à la suite d’un délai d’expiration. Le délai d’expiration peut être le système par défaut ou l’appelant défini dans le bundle de paramètres pour les types sélectionnés.

Les résultats du profilage sont remis au répertoire de données de l’application demandeur et un pointeur vers le fichier sera reçu à l’aide des écouteurs fournis par l’application.

Les applications peuvent fournir des écouteurs d’une ou des deux façons : <ul><li Li>A écouteur spécifique à la requête inclus dans la requête. Cela se déclenche uniquement avec un résultat de la demande avec laquelle elle a été fournie.</li li><>Un écouteur global fourni par .#registerForAllProfilingResults Cela sera déclenché pour tous les résultats appartenant à votre application. Cet écouteur est la seule façon de recevoir les résultats des instances de profilage déclenchées par le système configurées avec #addProfilingTriggers.</li></ul>

Les demandes sont limitées et ne sont pas garanties d’être remplies. La limitation de débit peut être désactivée pour les tests locaux de l’utilisation de #requestProfiling la commande shell device_config put profiling_testing rate_limiter.disabled true

Pour les tests locaux, les résultats du profilage sont accessibles plus facilement en activant le mode débogage. Cela conserve les fichiers de sortie dans un répertoire système temporaire. Les emplacements des fichiers conservés seront disponibles dans logcat. Le comportement et la commande varient selon la version : <ul><li>pour android versions 16 et ultérieures, le mode débogage conserve les résultats non adoptés (le cas échéant) et les résultats supprimés dans le répertoire temporaire. Elle peut être activée avec la commande device_config put profiling_testing delete_temporary_results.disabled true shell et désactivée en définissant cette même valeur sur false. Les résultats conservés sont accessibles sur tous les types de build. </li li><>pour Android version 15, le mode débogage conserve uniquement le résultat non adopté (le cas échéant) dans le répertoire temporaire. Elle peut être activée avec la commande device_config put profiling_testing delete_unredacted_trace.disabled true shell et désactivée en définissant cette même valeur sur false. Le fichier non adopté conservé est accessible uniquement sur les builds disposant d’un accès racine. Pour accéder au fichier de sortie supprimé sur un appareil non dérooté, les applications peuvent copier le fichier vers /pkg/files/profiling/file.type/pkg/cache/file.type. </li></ul>

Pour tester les déclencheurs de profilage, activez le mode de test pour votre application avec la commande device_config put profiling_testing system_triggered_profiling.testing_package_name com.your.app shell qui va : <ul><li>Vérifier qu’une trace en arrière-plan est en cours d’exécution.</li li><>Autoriser tous les déclencheurs pour le nom de package fourni pour passer le limiteur de débit au niveau du système. Ce mode continue jusqu’à ce qu’il soit arrêté manuellement avec la commande device_config delete profiling_testing system_triggered_profiling.testing_package_nameshell. </li></ul>

Les résultats sont supprimés et contiennent des informations spécifiques sur le processus demandeur uniquement.

Remarque : Consultez capturer des données utilisateur réelles à l’aide de ProfilingManager pour obtenir un guide détaillé sur l’utilisation de cette API, couvrant la capture du profilage tout au long de l’interprétation des résultats.

Java documentation pour android.os.ProfilingManager.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.