Crear y registrar una tarea en segundo plano dentro del proceso

  • Artículo

API importantes

Este tema muestra cómo crear y registrar una tarea en segundo plano que se ejecuta en el mismo proceso que la aplicación.

Las tareas en segundo plano dentro del proceso son más fáciles de implementar que las tareas en segundo plano fuera del proceso. No obstante, son menos resistentes. Si se bloquea el código que se ejecuta en una tarea en segundo plano dentro del proceso, la aplicación también se bloqueará. Ten en cuenta también que DeviceUseTrigger, DeviceServicingTrigger y IoTStartupTask no pueden usarse con el modelo dentro del proceso. Activar una tarea en segundo plano de VoIP dentro de la aplicación tampoco es posible. Estas tareas y los desencadenadores aún son compatibles con el modelo de tarea en segundo plano fuera del proceso.

Ten en cuenta que la actividad en segundo plano puede finalizarse incluso cuando se ejecuta dentro del proceso en primer plano de la aplicación si se ejecuta más allá de los límites de tiempo de ejecución. Para algunos fines sigue siendo útil la resistencia de separar el trabajo en una tarea en segundo plano que se ejecuta en un proceso independiente. Mantener el trabajo en segundo plano como una tarea independiente de la aplicación en primer plano puede ser la mejor opción para el trabajo que no requiere la comunicación con la aplicación en primer plano.

Aspectos básicos

El modelo dentro del proceso mejora el ciclo de vida de la aplicación con mejores notificaciones para cuando la aplicación está en primer plano o en segundo plano. Dos nuevos eventos están disponibles en el objeto de aplicación de estas transiciones: EnteredBackground y LeavingBackground. Estos eventos encajan en el ciclo de vida de la aplicación en función del estado de visibilidad de la aplicación. Obtén más información sobre estos eventos y cómo afectan al ciclo de vida de la aplicación en Ciclo de vida de la aplicación.

En un nivel alto, controlarás el evento EnteredBackground para ejecutar el código que se ejecutará mientras la aplicación se ejecuta en segundo plano y controlarás LeavingBackground para saber cuándo tu aplicación se ha desplazado a un primer plano.

Registrar el desencadenador de tareas en segundo plano

La actividad en segundo plano dentro del proceso se registra de forma similar a la actividad en segundo plano fuera del proceso. Todos los desencadenadores en segundo plano empiezan con el registro con el uso de BackgroundTaskBuilder. El ensamblador facilita el registro de una tarea en segundo plano mediante la configuración de todos los valores necesarios en un solo lugar:

var builder = new BackgroundTaskBuilder();
builder.Name = "My Background Trigger";
builder.SetTrigger(new TimeTrigger(15, true));
// Do not set builder.TaskEntryPoint for in-process background tasks
// Here we register the task and work will start based on the time trigger.
BackgroundTaskRegistration task = builder.Register();

Nota:

Las aplicaciones universales de Windows deben llamar a RequestAccessAsync antes de registrar cualquier tipo de desencadenador en segundo plano. Para garantizar que la aplicación universal de Windows continúe funcionando correctamente después de publicar una actualización, se debe llamar a RemoveAccess y luego a RequestAccessAsync cuando se inicia la aplicación tras su actualización. Para obtener más información, vea Directrices para tareas en segundo plano.

Para actividades en segundo plano dentro del proceso no se configura TaskEntryPoint. Dejarlo en blanco habilita el punto de entrada predeterminado, un nuevo método protegido en el objeto de la aplicación denominado OnBackgroundActivated().

Una vez que se registra un desencadenador, se activará en función del tipo de desencadenador establecido en el método SetTrigger. En el ejemplo anterior se utiliza un TimeTrigger, que se activará quince minutos desde el momento en que se registró.

Adición de una condición para controlar cuándo se ejecutará la tarea (opcional)

Puedes agregar una condición para controlar cuándo se ejecutará la tarea después de que se produzca el evento del desencadenador. Por ejemplo, si no quieres que la tarea se ejecute hasta que el usuario esté presente, usa la condición UserPresent. Para obtener una lista de posibles condiciones, consulta SystemConditionType.

El siguiente código de muestra asigna una condición que requiere que el usuario esté presente:

builder.AddCondition(new SystemCondition(SystemConditionType.UserPresent));

Colocación del código de la actividad en segundo plano en OnBackgroundActivated()

Coloque el código de actividad en segundo plano en OnBackgroundActivated para responder al desencadenador en segundo plano cuando se activa. OnBackgroundActivated se puede tratar como IBackgroundTask.Run. El método tiene un parámetro BackgroundActivatedEventArgs , que contiene todo lo que entrega el método Run . Por ejemplo, en App.xaml.cs:

using Windows.ApplicationModel.Background;

...

sealed partial class App : Application
{
  ...

  protected override void OnBackgroundActivated(BackgroundActivatedEventArgs args)
  {
      base.OnBackgroundActivated(args);
      IBackgroundTaskInstance taskInstance = args.TaskInstance;
      DoYourBackgroundWork(taskInstance);  
  }
}

Para obtener un ejemplo más completo de OnBackgroundActivated , consulte Conversión de un servicio de aplicaciones para que se ejecute en el mismo proceso que su aplicación host.

Administración del progreso y la finalización de tareas en segundo plano

La finalización y el progreso de la tarea puede supervisarse del mismo modo que para las tareas en segundo plano en múltiples procesos (consulta Supervisión del progreso y la finalización de las tareas en segundo plano), pero probablemente verás que puedes rastrearlas más fácilmente mediante el uso de variables para realizar un seguimiento del estado de progreso o finalización en tu aplicación. Esta es una de las ventajas de ejecutar el código de actividad en segundo plano en el mismo proceso que la aplicación.

Administrar la cancelación de tareas en segundo plano

Las tareas en segundo plano dentro del proceso se cancelarán de la misma manera que las tareas en segundo plano fuera del proceso (consulta Administrar una tarea en segundo plano cancelada). Ten en cuenta que el controlador de eventos BackgroundActivated debe salir antes de que se produzca la cancelación o finalice todo el proceso. Si tu aplicación en primer plano se cierra inesperadamente al cancelar la tarea en segundo plano, comprueba que el controlador salió antes de que se produjera la cancelación.

El manifiesto

A diferencia de las tareas en segundo plano fuera del proceso, no es necesario agregar información de la tarea en segundo plano al manifiesto del paquete para ejecutar tareas en segundo plano dentro del proceso.

Resumen y pasos siguientes

Ahora debes comprender los conceptos básicos de cómo escribir una tarea en segundo plano dentro del proceso.

Consulta los siguientes temas relacionados para obtener referencia de las API, una guía conceptual sobre tareas en segundo plano e instrucciones más detalladas para escribir aplicaciones que usan tareas en segundo plano.

Temas con instrucciones detalladas sobre las tareas en segundo plano

Guía de tareas en segundo plano

Referencia de API de tareas en segundo plano