ProfilingManager.RequestProfiling Método

Definición

Espacio de nombres:: Android.OS

Ensamblado:: Mono.Android.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Solicitud de generación de perfiles del sistema.

[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

Parámetros

profilingType: ProfilingType

Tipo de generación de perfiles que se va a recopilar.

parameters: Bundle

Agrupación de parámetros relacionados con la solicitud. Si la agrupación contiene parámetros no reconocidos, se producirá un error en la solicitud con android.os.ProfilingResult#ERROR_FAILED_INVALID_REQUEST. Si los valores de los parámetros están fuera del intervalo admitido, se elegirá el valor más cercano posible en el intervalo. Se recomienda usar contenedores androidx para generar esto directamente.

tag: String

Datos definidos por el autor de la llamada para ayudar a identificar la salida. Los primeros 20 caracteres alfanuméricos, además de guiones, se reducirán y se incluirán en el nombre de archivo de salida.

cancellationSignal: CancellationSignal

para el autor de la llamada solicitó la cancelación. Los resultados se devolverán si están disponibles. Si es null, la aplicación solicitante no podrá detener la colección. La recopilación se detendrá después del tiempo de espera con las configuraciones proporcionadas o con los valores predeterminados del sistema.

executor: IExecutor

Ejecutor con el que se va a llamar. Solo se usará para el agente de escucha proporcionado en este método. Si es null y no se registran combinaciones globales de ejecutor y agente de escucha en el momento de la solicitud, se quitará la solicitud.

listener: IConsumer

Agente de escucha que se va a desencadenar con el resultado. También se desencadenarán los agentes de escucha globales registrados a través #registerForAllProfilingResults de . Si es null y no se registran combinaciones globales de agente de escucha y ejecutor en el momento de la solicitud, se quitará la solicitud.

Atributos: RegisterAttribute

Comentarios

Solicitud de generación de perfiles del sistema.

Nota: no se recomienda usar directamente esta API para la mayoría de los casos de uso. Considere la posibilidad de usar los contenedores de nivel superior proporcionados por AndroidX que construirán la solicitud correctamente, admitiendo las opciones disponibles con parámetros de solicitud simplificados.

Tanto un agente de escucha como un ejecutor deben establecerse en el momento de la solicitud para que la solicitud se considere para su cumplimiento. Los pares de agente de escucha o ejecutor se pueden establecer en este método, con #registerForAllProfilingResults, o ambos. El agente de escucha y el ejecutor deben establecerse juntos, en la misma llamada. Si no se establece ninguna combinación de agente de escucha y ejecutor, se descartará la solicitud y no se recibirá ninguna devolución de llamada.

Las solicitudes serán limitadas por la tasa y no se garantiza que se llene.

Puede haber un retraso antes de que comience la generación de perfiles. En el caso de los tipos de generación de perfiles continuos (seguimiento del sistema, muestreo de pila y generación de perfiles del montón), se recomienda iniciar la recopilación antes y detenerla cancellationSignal inmediatamente después del área de interés para asegurarse de que se captura la sección que desea generar perfiles. En el caso de los volcados de montón, se recomienda probar localmente para asegurarse de que el volcado de montón se recopila en el momento adecuado.

Java documentación para 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>).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Se aplica a