ProfilingManager.RequestProfiling Méthode

Définition

Espace de noms:: Android.OS

Assembly:: Mono.Android.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Demander le profilage du système.

[Android.Runtime.Register("requestProfiling", "(ILandroid/os/Bundle;Ljava/lang/String;Landroid/os/CancellationSignal;Ljava/util/concurrent/Executor;Ljava/util/function/Consumer;)V", "", ApiSince=35)]
public void RequestProfiling(Android.OS.ProfilingType profilingType, Android.OS.Bundle? parameters, string? tag, Android.OS.CancellationSignal? cancellationSignal, Java.Util.Concurrent.IExecutor? executor, Java.Util.Functions.IConsumer? listener);

[<Android.Runtime.Register("requestProfiling", "(ILandroid/os/Bundle;Ljava/lang/String;Landroid/os/CancellationSignal;Ljava/util/concurrent/Executor;Ljava/util/function/Consumer;)V", "", ApiSince=35)>]
member this.RequestProfiling : Android.OS.ProfilingType * Android.OS.Bundle * string * Android.OS.CancellationSignal * Java.Util.Concurrent.IExecutor * Java.Util.Functions.IConsumer -> unit

Paramètres

profilingType: ProfilingType

Type de profilage à collecter.

parameters: Bundle

Ensemble de paramètres associés à la requête. Si le bundle contient des paramètres non reconnus, la requête échoue avec android.os.ProfilingResult#ERROR_FAILED_INVALID_REQUEST. Si les valeurs des paramètres ne sont pas prises en charge, la valeur la plus proche possible dans la plage est choisie. L’utilisation de wrappers androidx est recommandée pour générer cela directement.

tag: String

Les données définies par l’appelant pour aider à identifier la sortie. Les 20 premiers caractères alphanumériques, ainsi que les tirets, seront en minuscules et inclus dans le nom de fichier de sortie.

cancellationSignal: CancellationSignal

pour l’appelant a demandé l’annulation. Les résultats sont retournés si disponibles. S’il s’agit de null, l’application demandée ne pourra pas arrêter la collection. La collection s’arrête après expiration avec les configurations fournies ou avec les valeurs système par défaut

executor: IExecutor

Exécuteur à rappeler. Sera utilisé uniquement pour l’écouteur fourni dans cette méthode. S’il s’agit de null et qu’aucune combinaison d’exécuteur et d’écouteur global n’est inscrite au moment de la requête, la requête est supprimée.

listener: IConsumer

Écouteur à déclencher avec le résultat. Tous les écouteurs globaux inscrits via #registerForAllProfilingResults seront également déclenchés. S’il s’agit de null et qu’aucune combinaison d’écouteurs et d’exécuteurs globaux n’est enregistrée au moment de la demande, la requête est supprimée.

Attributs: RegisterAttribute

Remarques

Demander le profilage du système.

Remarque : l’utilisation directe de cette API n’est pas recommandée pour la plupart des cas d’usage. Envisagez d’utiliser les wrappers de niveau supérieur fournis par AndroidX qui construisent la requête correctement, prenant en charge les options disponibles avec des paramètres de requête simplifiés.

Un écouteur et un exécuteur doivent être définis au moment de la demande de traitement. Les paires écouteur/exécuteur peuvent être définies dans cette méthode, avec #registerForAllProfilingResults, ou les deux. L’écouteur et l’exécuteur doivent être définis ensemble, dans le même appel. Si aucune combinaison d’écouteurs et d’exécuteur n’est définie, la demande est ignorée et aucun rappel n’est reçu.

Les demandes seront limitées et ne sont pas garanties d’être remplies.

Il peut y avoir un délai avant le début du profilage. Pour les types de profilage continus (suivi du système, échantillonnage de pile et profilage de tas), nous vous recommandons de commencer la collecte tôt et de l’arrêter cancellationSignal immédiatement après la zone d’intérêt pour vous assurer que la section que vous souhaitez profiler est capturée. Pour les vidages de tas, nous vous recommandons de tester localement pour vous assurer que le vidage du tas est collecté au bon moment.

Java documentation pour android.os.ProfilingManager.requestProfiling(int, android.os.Bundle, java.lang.String, android.os.CancellationSignal, java.util.concurrent.Executor, java.util.function.Consumer<android.os.ProfilingResult>).

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.

S’applique à