Aplazar la suspensión de aplicaciones con ejecución ampliada
En este artículo se muestra cómo usar la ejecución extendida para posponer cuándo se suspende la aplicación para que se pueda ejecutar mientras se minimiza o está bajo la pantalla de bloqueo.
Cuando el usuario minimiza la aplicación o cambia a otra, la primera entra en estado suspendido. Su memoria se mantiene, pero no ejecuta el código. Esto sucede en todas las ediciones del sistema operativo con una interfaz de usuario visual. Para obtener más detalles sobre cuándo se suspende la aplicación, consulta Ciclo de vida de la aplicación.
Hay casos en los que es posible que una aplicación tenga que seguir ejecutándose, en lugar de suspenderse, cuando el usuario se aleja de la aplicación o mientras se minimiza. Por ejemplo, una aplicación de recuento de pasos debe seguir ejecutándose y seguir los pasos incluso cuando el usuario navega para usar otras aplicaciones.
Si es necesario que una aplicación se siga ejecutando, la puede seguir ejecutando el sistema operativo o este puede solicitar que se siga ejecutando. Por ejemplo, al reproducir audio en segundo plano, el sistema operativo puede mantener una aplicación ejecutándose más tiempo si sigues estos pasos de Reproducción de contenido multimedia en segundo plano. De lo contrario, debes solicitar más tiempo manualmente. La cantidad de tiempo que puede llegar a realizar la ejecución en segundo plano puede ser de varios minutos, pero debe estar preparado para controlar la sesión que se va a revocar en cualquier momento. Estas restricciones de tiempo de ciclo de vida de la aplicación están deshabilitadas mientras la aplicación se ejecuta en un depurador. Por este motivo, es importante probar la ejecución extendida y otras herramientas para posponer la suspensión de la aplicación mientras no se ejecuta en un depurador o mediante los eventos de ciclo de vida disponibles en Visual Studio.
Crea una clase ExtendedExecutionSession para solicitar más tiempo para completar una operación en segundo plano. El tipo de ExtendedExecutionSession que se crea viene determinado por extendedExecutionReason que se proporciona al crearlo. Existen tres valores de enumeración ExtendedExecutionReason: Unspecified, LocationTracking y SavingData. Solo se puede solicitar una ExtendedExecutionSession en cualquier momento; si intenta crear otra sesión mientras una solicitud de sesión aprobada está activa actualmente, se producirá una excepción 0x8007139F iniciarse desde el constructor ExtendedExecutionSession que indica que el grupo o recurso no está en el estado correcto para realizar la operación solicitada. No use ExtendedExecutionForegroundSession y ExtendedExecutionForegroundReason; requieren funcionalidades restringidas y no están disponibles para su uso en las aplicaciones de la Tienda.
Ejecutar mientras está minimizada
Hay dos casos en los que se puede usar la ejecución extendida:
- En cualquier momento durante la ejecución en primer plano normal, mientras la aplicación está en estado de ejecución.
- Una vez que la aplicación ha recibido un evento de suspensión (el sistema operativo está a punto de mover la aplicación al estado suspendido) en el controlador de eventos de suspensión de la aplicación.
El código de estos dos casos es el mismo, pero la aplicación se comporta de forma un poco diferente en cada uno. En el primer caso, la aplicación permanece en estado de ejecución, incluso si se produce un evento que normalmente desencadenaría la suspensión (por ejemplo, el usuario que navega fuera de la aplicación). La aplicación nunca recibirá un evento de suspensión mientras la extensión de ejecución está en vigor. Cuando se elimina la extensión, la aplicación vuelve a ser apta para la suspensión.
En el segundo caso, si la aplicación realiza la transición al estado suspendido, permanecerá en un estado de suspensión durante el período de la extensión. Una vez que la extensión expira, la aplicación entra en estado suspendido sin notificación adicional.
Usa ExtendedExecutionReason.Unspecified cuando creas una ExtendedExecutionSession para solicitar tiempo adicional antes de que la aplicación pase al fondo para escenarios como el procesamiento multimedia, la compilación del proyecto o mantener activa una conexión de red. En dispositivos de escritorio que ejecutan Windows 10 para ediciones de escritorio (Home, Pro, Enterprise y Education), este es el enfoque que se debe usar si es necesario evitar que una aplicación se suspenda mientras está minimizada.
Solicita la extensión cuando se inicie una operación de larga duración para aplazar la transición al estado Suspendiendo que, de otro modo, se produciría al colocar la aplicación en segundo plano. En dispositivos de escritorio, las sesiones de ejecución extendida creadas con ExtendedExecutionReason.Unspecified tienen un límite de tiempo de reconocimiento de batería. Si el dispositivo está conectado a una toma eléctrica, no hay ningún límite en la duración del período de tiempo de ejecución extendida. Si el dispositivo funciona con batería, el período de tiempo de ejecución extendida puede ejecutarse hasta diez minutos en segundo plano.
Un usuario de tableta o portátil puede obtener el mismo comportamiento de larga duración(a costa de la duración de la batería), cuando la opción Permitir que la aplicación ejecute tareas en segundo plano está seleccionada en Uso de batería por la configuración de la aplicación . (Para encontrar esta opción en un portátil, vaya a Configuración>.Sistema>Batería>Uso de la batería por aplicación (el vínculo bajo el porcentaje de energía de la batería restante) > seleccione una aplicación >desactivada por Windows>, seleccione Permitir que la aplicación ejecute tareas en segundo plano.
En todas las ediciones del sistema operativo, este tipo de sesión de ejecución extendida se detiene cuando el dispositivo entra en modo de espera conectado. En dispositivos móviles que ejecutan Windows 10 Mobile, este tipo de sesión de ejecución extendida se ejecutará siempre que la pantalla esté encendida. Cuando la pantalla se apaga, el dispositivo intenta entrar en el modo de espera conectado de bajo consumo inmediatamente. En dispositivos de escritorio, la sesión seguirá ejecutándose si aparece la pantalla de bloqueo. El dispositivo no entrará en modo de espera conectado durante un período de tiempo después de apagar la pantalla. En la edición del sistema operativo de Xbox, el dispositivo entra en modo de espera conectado después de una hora, a menos que el usuario cambia el valor predeterminado.
Realizar un seguimiento de la ubicación del usuario
Especifica ExtendedExecutionReason.LocationTracking cuando crees una clase ExtendedExecutionSession si tu aplicación necesita registrar con regularidad la ubicación desde la clase Geolocator. Las aplicaciones de navegación y seguimiento de la forma física que necesitan controlar regularmente la ubicación del usuario deben usar este motivo.
Una sesión de ejecución extendida de seguimiento de ubicación puede ejecutarse siempre que sea necesario, incluido mientras la pantalla está bloqueada en un dispositivo móvil. Sin embargo, solo se puede ejecutar una sesión de este tipo por dispositivo. Una sesión de ejecución extendida de seguimiento de ubicación solo se puede solicitar en primer plano y la aplicación debe estar en estado En ejecución. Esto garantiza que el usuario es consciente de que la aplicación ha iniciado una sesión de seguimiento de ubicación extendida. Es posible usar el ubicador geográfico mientras la aplicación está en segundo plano mediante el uso de una tarea en segundo plano, o un servicio de aplicaciones, sin solicitar un seguimiento de la ubicación de sesión de ejecución ampliada.
Guardar datos críticos localmente
Especifica ExtendedExecutionReason.SavingData cuando crees una clase ExtendedExecutionSession para guardar los datos de usuario, si el hecho de no guardar los datos antes de que finalice la aplicación va a causar la pérdida de datos y una experiencia de usuario negativa.
No uses este tipo de sesión para extender el tiempo que tarda una aplicación en cargar o descargar datos. Si necesitas cargar datos, solicita una transferencia en segundo plano o registra el objeto MaintenanceTrigger para controlar la transferencia cuando exista corriente alterna disponible. Una sesión de ejecución extendida ExtendedExecutionReason.SavingData se puede solicitar cuando la aplicación está en primer plano y con el estado En ejecución, o bien en segundo plano y con el estado Suspendiendo.
El estado Suspendiendo es la última oportunidad durante el ciclo de vida de la aplicación que una aplicación puede funcionar antes de cerrarse. ExtendedExecutionReason.SavingData es el único tipo de ExtendedExecutionSession que se puede solicitar en el estado Suspending . Solicitar una sesión de ejecución extendida ExtendedExecutionReason.SavingData mientras la aplicación está en estado Suspendiendo causa un problema potencial que debes tener en cuenta. Si se solicita una sesión de ejecución extendida durante el estado Suspendiendo y el usuario solicita que se vuelva a iniciar la aplicación, puede parecer que tarda mucho tiempo en iniciarse. La causa es que el período de tiempo de la sesión de ejecución extendida debe finalizar para que la antigua instancia de la aplicación se pueda cerrar y se pueda iniciar una nueva. Para garantizar que no se pierda el estado de usuario se sacrifica el tiempo de rendimiento de inicio.
Solicitud, eliminación y revocación
Existen tres interacciones fundamentales con una sesión de ejecución extendida: la solicitud, la eliminación y la revocación. La realización de la solicitud se muestra en el siguiente fragmento de código.
Solicitud
var newSession = new ExtendedExecutionSession();
newSession.Reason = ExtendedExecutionReason.Unspecified;
newSession.Revoked += SessionRevoked;
ExtendedExecutionResult result = await newSession.RequestExtensionAsync();
switch (result)
{
case ExtendedExecutionResult.Allowed:
DoLongRunningWork();
break;
default:
case ExtendedExecutionResult.Denied:
DoShortRunningWork();
break;
}
La llamada a RequestExtensionAsync comprueba con el sistema operativo si el usuario ha aprobado la actividad en segundo plano de la aplicación y si el sistema tiene los recursos disponibles para permitir la ejecución en segundo plano. Solo se aprobará una sesión para una aplicación en cualquier momento, lo que hará que se denieguen llamadas adicionales a RequestExtensionAsync .
Puedes comprobar la clase BackgroundExecutionManager con antelación para determinar la enumeración BackgroundAccessStatus, que es la configuración de usuario que indica si la aplicación puede ejecutarse en segundo plano. Para obtener más información sobre estas configuraciones de usuario, consulta Battery awareness and background activity (Reconocimiento de batería y actividad en segundo plano).
La enumeración ExtendedExecutionReason indica la operación que tu aplicación está realizando en segundo plano. La cadena Description es una cadena en lenguaje natural que explica por qué la aplicación tiene que realizar la operación. Esta cadena no se presenta al usuario, pero puede estar disponible en una versión futura de Windows. El controlador de eventos Revoked es necesario para que una sesión de ejecución extendida pueda detener correctamente si el usuario (o el sistema) decide que la aplicación ya no se puede ejecutar en segundo plano.
Revocada
Si una aplicación tiene una sesión de ejecución extendida activa y el sistema requiere que se detenga la actividad en segundo plano porque una aplicación en primer plano requiere los recursos, se revoca la sesión. El período de tiempo de una sesión de ejecución extendida nunca termina sin activar primero el controlador de eventos Revoked.
Si el evento Revoked se activa para una sesión de ejecución extendida ExtendedExecutionReason.SavingData, la aplicación tiene un segundo para completar la operación que estaba ejecutando y finalizar el estado Suspendiendo.
La revocación puede producirse por muchas razones: se alcanzó el límite de tiempo de una ejecución, se alcanzó una cuota de energía en segundo plano o es necesario reclamar memoria para que el usuario pueda abrir una nueva aplicación en primer plano.
Este es un ejemplo de un controlador de eventos Revoked:
private async void SessionRevoked(object sender, ExtendedExecutionRevokedEventArgs args)
{
await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
{
switch (args.Reason)
{
case ExtendedExecutionRevokedReason.Resumed:
rootPage.NotifyUser("Extended execution revoked due to returning to foreground.", NotifyType.StatusMessage);
break;
case ExtendedExecutionRevokedReason.SystemPolicy:
rootPage.NotifyUser("Extended execution revoked due to system policy.", NotifyType.StatusMessage);
break;
}
EndExtendedExecution();
});
}
Dispose
El paso final es la eliminación de la sesión de ejecución extendida. Debes eliminar la sesión y cualquier otro activo que consuma mucha memoria, ya que, de lo contrario, la energía que usa la aplicación mientras espera que la sesión se cierre se contará en la cuota de energía de la aplicación. Para conservar la mayor cuota de energía posible para la aplicación, es importante eliminar la sesión al terminar el trabajo de la sesión para que la aplicación pueda cambiar al estado Suspendido más rápidamente.
Si eliminas la sesión tú mismo en lugar de esperar el evento de revocación, se reduce el uso de la cuota de energía de la aplicación. Esto significa que la aplicación podrá ejecutarse en segundo plano más tiempo en futuras sesiones, dado que tendrás más cuota de energía disponible para hacerlo. Debes mantener una referencia al objeto ExtendedExecutionSession hasta el final de la operación para poder llamar a su método Dispose.
A continuación se muestra un fragmento de código que cancela una sesión de ejecución extendida:
void ClearExtendedExecution(ExtendedExecutionSession session)
{
if (session != null)
{
session.Revoked -= SessionRevoked;
session.Dispose();
session = null;
}
}
Una aplicación solo puede tener un objeto ExtendedExecutionSession activo a la vez. Muchas aplicaciones usan tareas asincrónicas para completar operaciones complejas que requieren acceso a recursos, tales como los de almacenamiento, red o servicios basados en red. Si una operación requiere varias tareas asincrónicas para completarse, el estado de cada una de estas tareas debe tener en cuenta antes de eliminar el objeto ExtendedExecutionSession y de permitir que la aplicación se suspenda. Esto requiere el recuento de referencia del número de tareas que aún se están ejecutando y que no se elimine la sesión hasta que dicho valor sea cero.
Este es un ejemplo de código para administrar varias tareas durante un período de sesión de ejecución extendido. Para obtener más información sobre cómo usar esto en la aplicación, consulte el ejemplo de código vinculado a continuación:
static class ExtendedExecutionHelper
{
private static ExtendedExecutionSession session = null;
private static int taskCount = 0;
public static bool IsRunning
{
get
{
if (session != null)
{
return true;
}
else
{
return false;
}
}
}
public static async Task<ExtendedExecutionResult> RequestSessionAsync(ExtendedExecutionReason reason, TypedEventHandler<object, ExtendedExecutionRevokedEventArgs> revoked, String description)
{
// The previous Extended Execution must be closed before a new one can be requested.
ClearSession();
var newSession = new ExtendedExecutionSession();
newSession.Reason = reason;
newSession.Description = description;
newSession.Revoked += SessionRevoked;
// Add a revoked handler provided by the app in order to clean up an operation that had to be halted prematurely
if(revoked != null)
{
newSession.Revoked += revoked;
}
ExtendedExecutionResult result = await newSession.RequestExtensionAsync();
switch (result)
{
case ExtendedExecutionResult.Allowed:
session = newSession;
break;
default:
case ExtendedExecutionResult.Denied:
newSession.Dispose();
break;
}
return result;
}
public static void ClearSession()
{
if (session != null)
{
session.Dispose();
session = null;
}
taskCount = 0;
}
public static Deferral GetExecutionDeferral()
{
if (session == null)
{
throw new InvalidOperationException("No extended execution session is active");
}
taskCount++;
return new Deferral(OnTaskCompleted);
}
private static void OnTaskCompleted()
{
if (taskCount > 0)
{
taskCount--;
}
//If there are no more running tasks than end the extended lifetime by clearing the session
if (taskCount == 0 && session != null)
{
ClearSession();
}
}
private static void SessionRevoked(object sender, ExtendedExecutionRevokedEventArgs args)
{
//The session has been prematurely revoked due to system constraints, ensure the session is disposed
if (session != null)
{
session.Dispose();
session = null;
}
taskCount = 0;
}
}
Asegúrate de que la aplicación usa bien los recursos
El ajuste de uso de memoria y energía de la aplicación es esencial para garantizar que el sistema operativo permitirá que la aplicación siga ejecutándose cuando deje de ser la aplicación en primer plano. Usa las API de administración de memoria para ver cuánta memoria está usando la aplicación. Cuando más memoria use la aplicación, más difícil será para el sistema operativo mantener la aplicación en ejecución cuando otra aplicación esté en primer plano. El usuario es, en última instancia, quien controla toda la actividad en segundo plano que la aplicación puede llevar a cabo y quien tiene visibilidad sobre el impacto que la aplicación tiene sobre el uso de la batería.
Usa BackgroundExecutionManager.RequestAccessAsync para determinar si el usuario ha decidido que la actividad en segundo plano de la aplicación debe ser limitada. Ten en cuenta el uso de la batería y ejecuta aplicaciones en segundo plano solo cuando sea necesario completar una acción que requiera el usuario.
Vea también
Muestra de ejecución extendida
Ciclo de vida de la aplicación
Ciclo de vida de la aplicación: mantener las aplicaciones activas con tareas en segundo plano yadministración de memoria en segundo plano de ejecución extendida
Transferencias en segundo plano
Reconocimiento de la batería y actividad en segundo plano
Clase MemoryManager
Reproducir contenido multimedia en segundo plano
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de