ClientData

public class ClientData
extends Object

java.lang.Object
   ↳ com.android.tradefed.device.server.ClientData

Contient les données d'un ClientImpl.

Résumé

Classes imbriquées

class ClientData.HeapData

Informations sur le segment de mémoire. 

class ClientData.HeapInfo

 

class ClientData.HprofData

 

interface ClientData.IAllocationTrackingHandler

 

interface ClientData.IHprofDumpHandler

Gestionnaires capables d'agir sur les dumps HPROF. 

interface ClientData.IMethodProfilingHandler

Gestionnaires capables d'agir sur les informations de profilage des méthodes

class ClientData.Names

 

Constantes

String FEATURE_HPROF

Chaîne pour la fonctionnalité permettant de vider les fichiers hprof

String FEATURE_HPROF_STREAMING

Chaîne pour la fonctionnalité permettant le streaming direct des dumps hprof

String FEATURE_OPENGL_TRACING

Chaîne pour la fonctionnalité indiquant la compatibilité avec le traçage des appels OpenGL.

String FEATURE_PROFILING

Chaîne permettant d'activer/de désactiver le profilage des méthodes

String FEATURE_PROFILING_STREAMING

Chaîne permettant d'activer le streaming direct des données de profilage des méthodes

String FEATURE_SAMPLING_PROFILER

Chaîne permettant d'activer le profileur d'échantillonnage.

String FEATURE_VIEW_HIERARCHY

Chaîne pour la fonctionnalité indiquant la compatibilité avec la fourniture de la hiérarchie des vues.

String PRE_INITIALIZED

Nom temporaire de la VM à ignorer.

Constructeurs publics

ClientData(ClientImpl client, int pid)

Constructeur générique.

Méthodes publiques

void addFeature(String feature)
void addNativeAllocation(NativeAllocationInfo allocInfo)

ajoute un NativeAllocationInfo à ClientImpl

void addNativeLibraryMapInfo(long startAddr, long endAddr, String library)
void addThread(int threadId, String threadName)

Ajoute un fil de discussion à la liste.

void clearHprofData()
void clearNativeAllocationInfo()

Efface les informations malloc actuelles.

void clearThreads()
String getAbi()

Renvoie la variante ABI (32 bits ou 64 bits) de l'application, ou la valeur "null" si elle est inconnue ou non définie.

ClientData.AllocationTrackingStatus getAllocationStatus()

Renvoie l'état du suivi de l'allocation.

static ClientData.IAllocationTrackingHandler getAllocationTrackingHandler()
AllocationInfo[] getAllocations()

Renvoie la liste des allocations suivies.

byte[] getAllocationsData()

Renvoie les données brutes pour les allocations suivies.

String getClientDescription()

Renvoie la description du client.

String getDataDir()

Renvoie le répertoire de données de l'application.

ClientData.DebuggerStatus getDebuggerConnectionStatus()

Renvoie l'état de la connexion du débogueur.

ClientData.HprofData getHprofData()
static ClientData.IHprofDumpHandler getHprofDumpHandler()
String getJvmFlags()

Renvoie les indicateurs de VM utilisés ou la valeur "null" s'ils sont inconnus.

getMappedNativeLibraries()

Renvoie la liste des bibliothèques natives mappées en mémoire pour ce client.

static ClientData.IMethodProfilingHandler getMethodProfilingHandler()
ClientData.MethodProfilingStatus getMethodProfilingStatus()

Renvoie l'état du profilage de la méthode.

getNativeAllocationList()

Renvoie la liste des NativeAllocationInfo.

ClientData.HeapData getNativeHeapData()

Renvoie l'objet HeapData pour le code natif.

String getPackageName()

Renvoie le nom de package réel de l'application si le protocole est compatible.

String getPendingHprofDump()

Renvoie le chemin d'accès au fichier hprof côté appareil en cours d'écriture.

String getPendingMethodProfiling()

Renvoie le chemin d'accès au fichier de profilage de la méthode côté appareil en cours d'écriture.

int getPid()

Renvoie l'ID du processus.

ThreadInfo getThread(int threadId)

Renvoie le ThreadInfo par ID de thread.

ThreadInfo[] getThreads()

Renvoie la liste des threads sous forme d'objets ThreadInfo.

int getTotalNativeMemory()

Renvoie la mémoire native totale.

int getUserId()

Renvoie l'ID utilisateur du client.

ClientData.HeapData getVmHeapData()

Renvoie l'objet HeapData pour la VM.

getVmHeapIds()

Renvoie un itérateur sur la liste des ID de tas de VM connus.

ClientData.HeapInfo getVmHeapInfo(int heapId)

Renvoie les valeurs d'informations les plus récentes pour le tas de mémoire de la VM spécifié.

String getVmIdentifier()

Renvoie l'identifiant de la VM du client.

boolean hasFeature(String feature)

Renvoie "true" si ClientImpl est compatible avec le feature donné.

boolean hasPendingHprofDump()
boolean isNativeDebuggable()
boolean isValidUserId()

Renvoie la valeur "true" si l'ID utilisateur de ce client a été défini.

void removeThread(int threadId)

Supprime un fil de discussion de la liste.

void setAbi(String abi)
void setAllocationStatus(ClientData.AllocationTrackingStatus status)
static void setAllocationTrackingHandler(ClientData.IAllocationTrackingHandler handler)

Cette méthode est obsolète.

void setAllocationsData(byte[] data)
void setDebuggerConnectionStatus(ClientData.DebuggerStatus status)

Définit l'état de la connexion du débogueur.

void setHeapInfo(int heapId, long maxSizeInBytes, long sizeInBytes, long bytesAllocated, long objectsAllocated, long timeStamp, byte reason)

Définit les valeurs actuelles des informations sur le tas pour le tas spécifié.

void setHprofData(String filename)
void setHprofData(byte[] data)
static void setHprofDumpHandler(ClientData.IHprofDumpHandler handler)

Définit le gestionnaire pour recevoir des notifications lorsqu'un vidage HPROF a réussi ou échoué.

void setJvmFlags(String jvmFlags)
static void setMethodProfilingHandler(ClientData.IMethodProfilingHandler handler)

Définit le gestionnaire pour recevoir des notifications lorsqu'un vidage HPROF a réussi ou échoué.

void setMethodProfilingStatus(ClientData.MethodProfilingStatus status)
void setNames(ClientData.Names names)

Définit l'ID de processus et d'utilisateur (par exemple,

void setNativeDebuggable(boolean nativeDebuggable)
void setPendingHprofDump(String pendingHprofDump)

Définit le chemin d'accès côté appareil au fichier hprof en cours d'écriture.

void setPendingMethodProfiling(String pendingMethodProfiling)

Définit le chemin d'accès côté appareil au fichier de profil de méthode en cours d'écriture.

void setTotalNativeMemory(int totalMemory)
void setVmIdentifier(String ident)

Définit l'identifiant de la VM.

Constantes

FEATURE_HPROF

public static final String FEATURE_HPROF

Chaîne pour la fonctionnalité permettant de vider les fichiers hprof

Voir aussi :

Valeur constante : "hprof-heap-dump"

FEATURE_HPROF_STREAMING

public static final String FEATURE_HPROF_STREAMING

Chaîne pour la fonctionnalité permettant le streaming direct des dumps hprof

Voir aussi :

Valeur de constante : "hprof-heap-dump-streaming"

FEATURE_OPENGL_TRACING

public static final String FEATURE_OPENGL_TRACING

Chaîne pour la fonctionnalité indiquant la compatibilité avec le traçage des appels OpenGL.

Voir aussi :

Valeur constante : "opengl-tracing"

FEATURE_PROFILING

public static final String FEATURE_PROFILING

Chaîne permettant d'activer/de désactiver le profilage des méthodes

Voir aussi :

Valeur constante : "method-trace-profiling"

FEATURE_PROFILING_STREAMING

public static final String FEATURE_PROFILING_STREAMING

Chaîne permettant d'activer le streaming direct des données de profilage des méthodes

Voir aussi :

Valeur constante : "method-trace-profiling-streaming"

FEATURE_SAMPLING_PROFILER

public static final String FEATURE_SAMPLING_PROFILER

Chaîne permettant d'activer le profileur d'échantillonnage.

Voir aussi :

Valeur constante : "method-sample-profiling"

FEATURE_VIEW_HIERARCHY

public static final String FEATURE_VIEW_HIERARCHY

Chaîne pour la fonctionnalité indiquant la compatibilité avec la fourniture de la hiérarchie des vues.

Voir aussi :

Valeur de constante : "view-hierarchy"

PRE_INITIALIZED

public static final String PRE_INITIALIZED

Nom temporaire de la VM à ignorer.

Valeur constante : "

"

Constructeurs publics

ClientData

public ClientData (ClientImpl client, 
                int pid)

Constructeur générique.

Paramètres
client ClientImpl

pid int

Méthodes publiques

addFeature

public void addFeature (String feature)

Paramètres
feature String

addNativeAllocation

public void addNativeAllocation (NativeAllocationInfo allocInfo)

ajoute un NativeAllocationInfo à ClientImpl

Paramètres
allocInfo NativeAllocationInfo : NativeAllocationInfo à ajouter.

addNativeLibraryMapInfo

public void addNativeLibraryMapInfo (long startAddr, 
                long endAddr, 
                String library)

Paramètres
startAddr long

endAddr long

library String

addThread

public void addThread (int threadId, 
                String threadName)

Ajoute un fil de discussion à la liste.

Paramètres
threadId int

threadName String

clearHprofData

public void clearHprofData ()

clearNativeAllocationInfo

public void clearNativeAllocationInfo ()

Efface les informations malloc actuelles.

clearThreads

public void clearThreads ()

getAbi

public String getAbi ()

Renvoie la variante ABI (32 bits ou 64 bits) de l'application, ou la valeur "null" si elle est inconnue ou non définie.

Renvoie
String

getAllocationStatus

public ClientData.AllocationTrackingStatus getAllocationStatus ()

Renvoie l'état du suivi de l'allocation.

Renvoie
ClientData.AllocationTrackingStatus

getAllocationTrackingHandler

public static ClientData.IAllocationTrackingHandler getAllocationTrackingHandler ()

Renvoie
ClientData.IAllocationTrackingHandler

getAllocations

public AllocationInfo[] getAllocations ()

Renvoie la liste des allocations suivies.

Renvoie
AllocationInfo[]

getAllocationsData

public byte[] getAllocationsData ()

Renvoie les données brutes pour les allocations suivies.

Renvoie
byte[]

getClientDescription

public String getClientDescription ()

Renvoie la description du client.

Il s'agit généralement du nom du package défini dans le AndroidManifest.xml.

Renvoie
String la description du client ou null si la description n'a pas encore été envoyée par le client.

getDataDir

public String getDataDir ()

Renvoie le répertoire de données de l'application.

Renvoie
String

getDebuggerConnectionStatus

public ClientData.DebuggerStatus getDebuggerConnectionStatus ()

Renvoie l'état de la connexion du débogueur.

Renvoie
ClientData.DebuggerStatus

getHprofData

public ClientData.HprofData getHprofData ()

Renvoie
ClientData.HprofData

getHprofDumpHandler

public static ClientData.IHprofDumpHandler getHprofDumpHandler ()

Renvoie
ClientData.IHprofDumpHandler

getJvmFlags

public String getJvmFlags ()

Renvoie les indicateurs de VM utilisés ou la valeur "null" s'ils sont inconnus.

Renvoie
String

getMappedNativeLibraries

public  getMappedNativeLibraries ()

Renvoie la liste des bibliothèques natives mappées en mémoire pour ce client.

Renvoie

getMethodProfilingHandler

public static ClientData.IMethodProfilingHandler getMethodProfilingHandler ()

Renvoie
ClientData.IMethodProfilingHandler

getMethodProfilingStatus

public ClientData.MethodProfilingStatus getMethodProfilingStatus ()

Renvoie l'état du profilage de la méthode.

Renvoie
ClientData.MethodProfilingStatus

getNativeAllocationList

public  getNativeAllocationList ()

Renvoie la liste des NativeAllocationInfo.

Renvoie

getNativeHeapData

public ClientData.HeapData getNativeHeapData ()

Renvoie l'objet HeapData pour le code natif.

Renvoie
ClientData.HeapData

getPackageName

public String getPackageName ()

Renvoie le nom de package réel de l'application si le protocole est compatible. S'il n'y a pas de prise en charge du protocole, renvoie la tentative de dérivation du nom du package à partir du nom de l'application (pour maintenir la rétrocompatibilité) ou le nom de l'application en cas d'échec.

Renvoie
String

getPendingHprofDump

public String getPendingHprofDump ()

Renvoie le chemin d'accès au fichier hprof côté appareil en cours d'écriture.

Renvoie
String

getPendingMethodProfiling

public String getPendingMethodProfiling ()

Renvoie le chemin d'accès au fichier de profilage de la méthode côté appareil en cours d'écriture.

Renvoie
String

getPid

public int getPid ()

Renvoie l'ID du processus.

Renvoie
int

getThread

public ThreadInfo getThread (int threadId)

Renvoie le ThreadInfo par ID de thread.

Paramètres
threadId int

Renvoie
ThreadInfo

getThreads

public ThreadInfo[] getThreads ()

Renvoie la liste des threads sous forme d'objets ThreadInfo.

La liste est vide jusqu'à ce qu'une mise à jour du thread ait été demandée avec ClientImpl.requestThreadUpdate().

Renvoie
ThreadInfo[]

getTotalNativeMemory

public int getTotalNativeMemory ()

Renvoie la mémoire native totale.

Renvoie
int

getUserId

public int getUserId ()

Renvoie l'ID utilisateur du client.

Renvoie
int ID utilisateur s'il est défini, -1 sinon

getVmHeapData

public ClientData.HeapData getVmHeapData ()

Renvoie l'objet HeapData pour la VM.

Renvoie
ClientData.HeapData

getVmHeapIds

public  getVmHeapIds ()

Renvoie un itérateur sur la liste des ID de tas de VM connus.

L'appelant doit se synchroniser sur l'objet ClientData lors de l'itération.

Renvoie
itérateur sur la liste des ID de tas

getVmHeapInfo

public ClientData.HeapInfo getVmHeapInfo (int heapId)

Renvoie les valeurs d'informations les plus récentes pour le tas de mémoire de la VM spécifié.

Paramètres
heapId int : tas dont les informations doivent être renvoyées
Renvoie
ClientData.HeapInfo Map contenant les valeurs d'informations pour le tas spécifié. Renvoie null si l'ID du tas est inconnu.

getVmIdentifier

public String getVmIdentifier ()

Renvoie l'identifiant de la VM du client.

Renvoie
String

hasFeature

public boolean hasFeature (String feature)

Renvoie "true" si ClientImpl est compatible avec le feature donné.

Paramètres
feature String : fonctionnalité à tester.
Renvoie
boolean "true" si la fonctionnalité est prise en charge

hasPendingHprofDump

public boolean hasPendingHprofDump ()

Renvoie
boolean

isNativeDebuggable

public boolean isNativeDebuggable ()

Renvoie
boolean

isValidUserId

public boolean isValidUserId ()

Renvoie la valeur "true" si l'ID utilisateur de ce client a été défini. Seuls les appareils compatibles avec plusieurs utilisateurs renverront l'ID utilisateur à ddms. Pour les autres appareils ou les appareils plus anciens, ce paramètre ne sera pas défini.

Renvoie
boolean

removeThread

public void removeThread (int threadId)

Supprime un fil de discussion de la liste.

Paramètres
threadId int

setAbi

public void setAbi (String abi)

Paramètres
abi String

setAllocationStatus

public void setAllocationStatus (ClientData.AllocationTrackingStatus status)

Paramètres
status ClientData.AllocationTrackingStatus

setAllocationTrackingHandler

public static void setAllocationTrackingHandler (ClientData.IAllocationTrackingHandler handler)

Cette méthode est obsolète. Veuillez enregistrer une AndroidDebugBridge.IClientChangeListener auprès de AndroidDebugBridge.addClientChangeListener(com.android.tradefed.device.server.AndroidDebugBridge.IClientChangeListener).

Paramètres
handler ClientData.IAllocationTrackingHandler

setAllocationsData

public void setAllocationsData (byte[] data)

Paramètres
data byte

setDebuggerConnectionStatus

public void setDebuggerConnectionStatus (ClientData.DebuggerStatus status)

Définit l'état de la connexion du débogueur.

Paramètres
status ClientData.DebuggerStatus

setHeapInfo

public void setHeapInfo (int heapId, 
                long maxSizeInBytes, 
                long sizeInBytes, 
                long bytesAllocated, 
                long objectsAllocated, 
                long timeStamp, 
                byte reason)

Définit les valeurs actuelles des informations sur le tas pour le tas spécifié.

Paramètres
heapId int : tas dont les informations doivent être mises à jour
maxSizeInBytes long

sizeInBytes long : taille du tas, en octets.
bytesAllocated long : nombre d'octets actuellement alloués dans le tas.
objectsAllocated long : nombre d'objets actuellement alloués dans

setHprofData

public void setHprofData (String filename)

Paramètres
filename String

setHprofData

public void setHprofData (byte[] data)

Paramètres
data byte

setHprofDumpHandler

public static void setHprofDumpHandler (ClientData.IHprofDumpHandler handler)

Définit le gestionnaire pour recevoir des notifications lorsqu'un vidage HPROF a réussi ou échoué. Cette méthode est obsolète. Veuillez enregistrer un écouteur client et écouter CHANGE_HPROF.

Paramètres
handler ClientData.IHprofDumpHandler

setJvmFlags

public void setJvmFlags (String jvmFlags)

Paramètres
jvmFlags String

setMethodProfilingHandler

public static void setMethodProfilingHandler (ClientData.IMethodProfilingHandler handler)

Définit le gestionnaire pour recevoir des notifications lorsqu'un vidage HPROF a réussi ou échoué. Cette méthode est obsolète. Veuillez enregistrer un écouteur client et écouter CHANGE_HPROF.

Paramètres
handler ClientData.IMethodProfilingHandler

setMethodProfilingStatus

public void setMethodProfilingStatus (ClientData.MethodProfilingStatus status)

Paramètres
status ClientData.MethodProfilingStatus

setNames

public void setNames (ClientData.Names names)

Définit les noms de processus, d'ID utilisateur (profil personnel ou professionnel) et de package.

Il peut y avoir une course entre HELO et APNM. Plutôt que d'essayer d'imposer un ordre sur l'appareil, nous n'autorisons tout simplement pas le nom pré-initialisé à remplacer un nom spécifié.

Paramètres
names ClientData.Names

setNativeDebuggable

public void setNativeDebuggable (boolean nativeDebuggable)

Paramètres
nativeDebuggable boolean

setPendingHprofDump

public void setPendingHprofDump (String pendingHprofDump)

Définit le chemin d'accès côté appareil au fichier hprof en cours d'écriture.

Paramètres
pendingHprofDump String : fichier hprof

setPendingMethodProfiling

public void setPendingMethodProfiling (String pendingMethodProfiling)

Définit le chemin d'accès côté appareil au fichier de profil de méthode en cours d'écriture.

Paramètres
pendingMethodProfiling String : fichier en cours d'écriture

setTotalNativeMemory

public void setTotalNativeMemory (int totalMemory)

Paramètres
totalMemory int

setVmIdentifier

public void setVmIdentifier (String ident)

Définit l'identifiant de la VM.

Paramètres
ident String