Partilhar via

Criando uma tarefa em segundo plano no Windows 8.1 (aplicativos de dispositivo UWP)

Importante

Os metadados do dispositivo foram preteridos e serão removidos em uma versão futura do Windows. Para obter informações sobre a substituição dessa funcionalidade, consulte Metadados do contêiner do pacote de driver.

Seu aplicativo UWP pode sincronizar dados em seu dispositivo periférico. Se o seu aplicativo estiver associado a metadados do dispositivo, esse aplicativo de dispositivo UWP também poderá executar atualizações de dispositivo, como atualizações de firmware. Este artigo descreve como criar uma tarefa em segundo plano do dispositivo que usa o DeviceUseTrigger ou DeviceServicingTrigger. Os agentes em segundo plano do dispositivo que usam esses gatilhos estão sujeitos a políticas que garantem o consentimento do usuário e ajudam a preservar a vida útil da bateria enquanto os dispositivos estão sendo sincronizados e atualizados. Para saber mais sobre tarefas em segundo plano do dispositivo, veja Sincronização e atualização de dispositivos para aplicativos de dispositivo UWP.

Este artigo corresponde ao exemplo de dispositivo USB personalizado. O exemplo de dispositivo USB personalizado demonstra uma tarefa em segundo plano que executa a sincronização do dispositivo com o DeviceUseTrigger.

Embora a tarefa em segundo plano do dispositivo no exemplo de dispositivo USB personalizado apresente um DeviceUseTrigger, tudo o que foi discutido neste artigo também pode ser aplicado a tarefas em segundo plano do dispositivo que usam DeviceServicingTrigger. A única diferença entre usar os dois gatilhos são as verificações de política feitas pelo Windows.

O manifesto do aplicativo

Para usar uma tarefa em segundo plano do dispositivo, seu aplicativo deve declará-la no arquivo de manifesto do aplicativo em primeiro plano, como é feito para tarefas em segundo plano acionadas pelo sistema. Para saber mais, veja Sincronização e atualização de dispositivos para aplicativos de dispositivo UWP.

Neste exemplo de um arquivo de manifesto do pacote do aplicativo, DeviceLibrary.SyncContent é um dos pontos de entrada do aplicativo em primeiro plano. DeviceLibrary.SyncContent é o ponto de entrada para a tarefa em segundo plano que usa o DeviceUseTrigger.

<Extensions>
  <Extension Category="windows.backgroundTasks" EntryPoint="DeviceLibrary.SyncContent">
    <BackgroundTasks>
      <m2:Task Type="deviceUse" /> 
    </BackgroundTasks>
  </Extension>
</Extensions>

A tarefa em segundo plano do dispositivo

A classe de tarefa em segundo plano do dispositivo implementa a IBackgroundTask interface e contém o código real que você cria para sincronizar ou atualizar seu dispositivo periférico. A classe de tarefa em segundo plano é executada quando a tarefa em segundo plano é acionada e a partir do ponto de entrada fornecido no manifesto da aplicação.

A classe de plano de fundo do dispositivo no exemplo de dispositivo USB personalizado contém o código para executar uma sincronização com um dispositivo USB usando a tarefa em segundo plano DeviceUseTrigger . Para obter detalhes completos, faça o download do exemplo. Para saber mais sobre a implementação IBackgroundTask e a infraestrutura de tarefas em segundo plano do Windows, veja Suporte ao seu aplicativo com tarefas em segundo plano.

As principais partes da tarefa em segundo plano do dispositivo no exemplo de dispositivo USB personalizado incluem:

  1. A IoSyncBackgroundTask classe implementa a IBackgroundTask interface exigida pela infraestrutura de tarefas em segundo plano do Windows.

  2. A IoSyncBackgroundTask classe obtém a instância DeviceUseDetails passada para a classe no método Run da classe IoSyncBackgroundTask e usa essa instância para relatar o progresso ao aplicativo da Microsoft Store e para registar eventos de cancelamento.

  3. O método Run da classe IoSyncBackgroundTask também chama os métodos privados OpenDevice e WriteToDeviceAsync que implementam o código para sincronização do dispositivo em segundo plano.

O aplicativo em primeiro plano

O aplicativo em primeiro plano no exemplo de dispositivo USB personalizado registra e dispara uma tarefa em segundo plano do dispositivo que usa DeviceUseTrigger. Esta seção fornece uma visão geral das etapas que seu aplicativo em primeiro plano executará para registrar, acionar e manipular o progresso de uma tarefa em segundo plano do dispositivo.

O aplicativo em primeiro plano no exemplo de dispositivo USB personalizado executa as seguintes etapas para usar uma tarefa em segundo plano do dispositivo:

  1. Cria novos objetos DeviceUseTrigger e BackgroundTaskRegistration.

  2. Verifica se alguma tarefa em segundo plano foi registrada anteriormente por este aplicativo e as cancela chamando o método BackgroundTaskRegistration.Unregister na tarefa.

  3. O método privado SetupBackgroundTask regista a tarefa em segundo plano que será sincronizada com o dispositivo. O SetupBackgroundTask método é chamado a partir do SyncWithDeviceAsync método na próxima etapa.

    1. Inicializa o DeviceUseTrigger e salva-o para uso posterior.

    2. Cria um novo BackgroundTaskBuilder objeto e usa as suas Name as TaskEntryPoint propriedades e o SetTrigger método para registar o objeto da aplicação e o nome da tarefa em segundo plano DeviceUseTrigger. A BackgroundTaskBuilder propriedade do TaskEntryPoint objeto é definida como o nome completo da classe de tarefa em segundo plano que será executada quando a tarefa em segundo plano for acionada.

    3. Registra eventos de conclusão e progresso da tarefa em segundo plano para que o aplicativo em primeiro plano possa fornecer atualizações de conclusão e progresso ao usuário.

  4. O método privado SyncWithDeviceAsync regista a tarefa em segundo plano que sincronizará com o dispositivo e inicia a sincronização em segundo plano.

    1. Chama o SetupBackgroundTask método da etapa anterior e registra a tarefa em segundo plano que será sincronizada com o dispositivo.

    2. Chama o método privado StartSyncBackgroundTaskAsync que inicia a tarefa em segundo plano. Esse método fecha a alça do aplicativo relativa ao dispositivo, de forma a garantir que a tarefa em segundo plano seja capaz de abrir o dispositivo quando a tarefa for iniciada.

      Importante

      A tarefa em segundo plano precisará abrir o dispositivo para executar a atualização, portanto, o aplicativo em primeiro plano deve fechar suas conexões com o dispositivo antes de chamar RequestAsync.

    Em seguida, o método StartSyncBackgroundTaskAsync chama o método do objeto DeviceUseTrigger, que dispara a tarefa em segundo plano e retorna o objeto RequestAsync de DeviceTriggerResults, usado para determinar se a tarefa em segundo plano foi iniciada com êxito.

    Importante

    O Windows verifica se todas as verificações de política de iniciação de tarefas necessárias foram concluídas. Se todas as verificações de política forem concluídas, a operação de atualização será executada como uma tarefa em segundo plano fora do aplicativo em primeiro plano, permitindo que o aplicativo seja suspenso com segurança enquanto a operação estiver em andamento. O Windows também imporá quaisquer requisitos de tempo de execução e cancelará a tarefa em segundo plano se esses requisitos não forem mais atendidos.

  5. Finalmente, o método SyncWithDeviceAsync usa o objeto DeviceTriggerResults retornado de StartSyncBackgroundTaskAsync para determinar se a tarefa em segundo plano foi iniciada com êxito. Uma switch statement é usada para inspecionar o resultado de DeviceTriggerResults

  6. O aplicativo em primeiro plano implementa um manipulador de eventos privado OnSyncWithDeviceProgress que atualizará a interface do usuário do aplicativo com o progresso da tarefa em segundo plano do dispositivo.

  7. O aplicativo em primeiro plano implementa um manipulador de eventos privado OnSyncWithDeviceCompleted para lidar com a transição de tarefas em segundo plano para o aplicativo em primeiro plano quando a tarefa em segundo plano for concluída.

    1. Usa o método CheckResults do objeto BackgroundTaskCompletedEventArgs para verificar se alguma exceção foi lançada pela tarefa em segundo plano.

    2. O aplicativo em primeiro plano reabre o dispositivo para uso pelo aplicativo agora que a tarefa em segundo plano foi concluída e atualiza a interface do usuário para notificar o usuário.

  8. O aplicativo em primeiro plano implementa manipuladores de eventos de clique em botões privados da interface do utilizador para iniciar e cancelar a tarefa em segundo plano.

    1. O manipulador de eventos privado Sync_Click chama o SyncWithDeviceAsync método descrito nas etapas anteriores.

    2. O manipulador de eventos privado CancelSync_Click chama o método privado CancelSyncWithDevice para cancelar a tarefa em segundo plano.

  9. O método privado CancelSyncWithDevice desregista e cancela quaisquer sincronizações ativas de dispositivos para que o dispositivo possa ser reaberto usando o método BackgroundTaskRegistration.Unregister.

  • Last updated on